> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills Configuration

> Create reusable skill packages that teach Capy agents specific workflows — store them in your repo and reference them from task prompts for consistent results.

Skills are reusable instruction packages that teach agents specific workflows.

Store them in your repo at:

* `.agents/skills/` (recommended)
* `.claude/skills/` (also supported)

Each skill is a directory with a required `SKILL.md`, plus optional supporting files:

<Tree>
  <Tree.Folder name=".agents" defaultOpen>
    <Tree.Folder name="skills" defaultOpen>
      <Tree.Folder name="deploy" defaultOpen>
        <Tree.File name="SKILL.md" />

        <Tree.Folder name="references" />

        <Tree.Folder name="scripts" />

        <Tree.Folder name="assets" />
      </Tree.Folder>
    </Tree.Folder>
  </Tree.Folder>
</Tree>

* `SKILL.md`: required instructions
* `references/`, `scripts/`, `assets/`: optional

Agents get a list of available skills and selectively load relevant ones based on the task.

## Example skill

<Tree>
  <Tree.Folder name=".agents" defaultOpen>
    <Tree.Folder name="skills" defaultOpen>
      <Tree.Folder name="deploy" defaultOpen>
        <Tree.File name="SKILL.md" />

        <Tree.Folder name="scripts" defaultOpen>
          <Tree.File name="deploy.sh" />
        </Tree.Folder>
      </Tree.Folder>
    </Tree.Folder>
  </Tree.Folder>
</Tree>

`SKILL.md`:

```markdown theme={null}
# Deploy skill

Deploy the application to staging or production.

## When to use

- User asks to deploy, release, or push to staging/production

## Steps

1. Run `scripts/deploy.sh <environment>`
2. Verify deployment at the environment URL
3. Report success or failure

## When not to use

- For local development or testing
```

You can create skills manually or ask Build to scaffold them.