# Agent Skills

Arkiv's official agent skills work inside your AI coding assistant. They help you build faster.

Each skill gives your agent knowledge of Arkiv: the SDK, common patterns, and the wider Arkiv ecosystem. You do not need to copy text from the docs into the chat.

## What a Skill Is

A **skill** is a set of instructions and domain knowledge. You install it into your AI coding agent (Claude Code, Cursor, Cline, GitHub Copilot, and others). After you install a skill, your agent uses it when you ask about a related topic.

Skills follow the [Anthropic Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) spec. This spec works across runtimes.

## Available skills

Arkiv publishes its skills in a single repository: [`Arkiv-Network/skills`](https://github.com/Arkiv-Network/skills).

### `arkiv-best-practices`

This skill teaches your agent how to build on Arkiv:

- How the Arkiv SDK works (clients, queries, mutations, events)
- Best practices (project attributes, security, data modeling, error handling)
- Integration patterns (backend, React, wagmi)
- Common pitfalls and how to prevent them

```bash
# npm
npx skills add https://github.com/Arkiv-Network/skills --skill arkiv-best-practices

# pnpm
pnpm dlx skills add https://github.com/Arkiv-Network/skills --skill arkiv-best-practices

# bun
bunx skills add https://github.com/Arkiv-Network/skills --skill arkiv-best-practices
```

### `arkiv-feedback`

This skill walks you through reporting a bug or sharing a feature idea. You do not need to leave your editor.

The skill mirrors the official [issue forms](https://github.com/Arkiv-Network/reported-issues/issues/new/choose) on `Arkiv-Network/reported-issues`. It asks the right questions. Then it submits the issue for you with the GitHub CLI.

If `gh` is not installed, the skill saves a draft to disk. It also shows you the form in your browser.

```bash
# npm
npx skills add https://github.com/Arkiv-Network/skills --skill arkiv-feedback

# pnpm
pnpm dlx skills add https://github.com/Arkiv-Network/skills --skill arkiv-feedback

# bun
bunx skills add https://github.com/Arkiv-Network/skills --skill arkiv-feedback
```

## Install everything at once

```bash
# npm
npx skills add https://github.com/Arkiv-Network/skills --all

# pnpm
pnpm dlx skills add https://github.com/Arkiv-Network/skills --all

# bun
bunx skills add https://github.com/Arkiv-Network/skills --all
```

Pass `-g` (or `--global`) to install the skill at the user level instead of the current project. See `npx skills --help` for the full set of flags. The `pnpm dlx` and `bunx` commands work the same way.
**Tip:** You can also browse the repository at [skills.sh/arkiv-network/skills](https://skills.sh/arkiv-network/skills).

## Example prompts

Install the skills first. Open your AI agent. Try prompts such as these:

- *"Build a feature that lets users create and list posts stored on Arkiv"*
- *"Audit my project. Am I following Arkiv best practices?"*
- *"Set up a React hook that reads Arkiv entities with TanStack Query"*
- *"I hit a bug. Help me file it on the Arkiv reported-issues repo"*