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

# Agent Skills

> Make AI agents work with Bluvo by installing the skill.md capability file

# Agent Skills

Bluvo publishes a machine-readable **skill file** at [`https://github.com/bluvoinc/sdk/blob/main/skill.md`](https://github.com/bluvoinc/sdk/blob/main/skill.md). This file tells AI agents what Bluvo can do, what inputs are needed, and what constraints apply, so coding assistants like Claude, Cursor, and Copilot can generate accurate Bluvo integrations out of the box.

***

## Install the Bluvo Skill

```bash theme={null}
npx skills add https://github.com/bluvoinc/sdk
```

This downloads Bluvo's capability summary and adds it to your agent's context. Any AI assistant that supports the skills protocol will automatically pick it up.

<Tip>
  **`llms.txt` vs `skill.md`**, what's the difference?

  * **`llms.txt`** is a directory, it lists every documentation page so agents know where to look things up.
  * **`skill.md`** is a capability summary, it tells agents what they can build, what inputs they need, and what constraints apply.

  Both are available at [`docs.bluvo.dev`](https://docs.bluvo.dev). Use `skill.md` when you want agents to *build* with Bluvo, and `llms.txt` when you want agents to *research* Bluvo's docs.
</Tip>

***

## What the Skill Enables

Once an agent has the Bluvo skill loaded, it can:

* **Scaffold exchange integrations**, generate OAuth2 connection flows for supported exchanges
* **Build withdrawal UIs**, wire up the full withdrawal state machine with quote, confirm, and status steps
* **Handle 2FA / SMS / KYC challenges**, implement the correct challenge-response patterns during withdrawals
* **Manage wallets server-side**, use `BluvoClient` for privileged operations like listing wallets and initiating withdrawals
* **Set up real-time updates**, configure WebSocket subscriptions for live withdrawal status

***

***

## SDK Sub-Skills

The Bluvo skill automatically references deeper SDK skill files that agents load on demand when they need implementation details:

* **`@bluvo/react`**, React hooks, Next.js patterns, and the `useBluvoFlow` hook
* **`@bluvo/sdk-ts`**, Core TypeScript state machine, REST client, and server-side `BluvoClient`

These are fetched from GitHub when the agent drills into a specific SDK package.

***

## Next Steps

<CardGroup cols={3}>
  <Card title="View skill.md" icon="robot" href="https://github.com/bluvoinc/sdk/blob/main/skill.md">
    Read the raw capability file that agents consume
  </Card>

  <Card title="Browse llms.txt" icon="book" href="https://docs.bluvo.dev/llms.txt">
    See the full documentation directory for AI agents
  </Card>

  <Card title="skill.md Spec" icon="file-lines" href="https://agentskills.io/specification">
    Learn about the skills protocol and specification
  </Card>
</CardGroup>