> For the complete documentation index, see [llms.txt](https://docs.panora.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panora.exchange/ai/agent-skills.md).

# Agent Skills

## Agent Skills

Agent Skills are Markdown files (`SKILL.md`) that AI coding agents load on demand. They teach the agent how to integrate Panora correctly — which package, which method, exact-match token rules, fee-payer flow, error catalog.

Source repo: [`panora-exchange/agent-skills`](https://github.com/panora-exchange/agent-skills).

### Install

```bash
# All four skills (auto-detects Claude Code / Cursor / Codex)
npx skills add panora-exchange/agent-skills

# Or one at a time
npx skills add panora-exchange/agent-skills --skill panora
npx skills add panora-exchange/agent-skills --skill panora-sdk
npx skills add panora-exchange/agent-skills --skill panora-widget
npx skills add panora-exchange/agent-skills --skill panora-rest
```

The `skills` CLI ([vercel-labs/skills](https://github.com/vercel-labs/skills)) clones the repo and symlinks the SKILL.md files into `~/.claude/skills/`, `~/.cursor/skills/`, `~/.codex/skills/` etc.

### What each skill covers

| Skill               | Audience                                      | The agent loads it when...                                    |
| ------------------- | --------------------------------------------- | ------------------------------------------------------------- |
| **`panora`**        | Traders, ops devs, agents using the CLI / MCP | "Swap APT to USDC", "create a DCA", "list my limit orders"    |
| **`panora-sdk`**    | Node / browser app developers                 | "Integrate `@panoraexchange/swap-sdk`", "do a fee-payer swap" |
| **`panora-widget`** | Frontend engineers embedding swap UI          | "Embed Panora swap in my Next.js app"                         |
| **`panora-rest`**   | Python / Go / Rust / curl devs                | "Call the Panora API from Python"                             |

The agent picks the right skill based on the user's request — you don't pick.

### What's inside a skill

```
skills/<name>/
├── SKILL.md       ← frontmatter (name, description, tags) + main playbook
├── examples.md    ← end-to-end snippets the agent reads on demand
└── reference.md   ← full API reference (panora, panora-sdk)
```

### Manage installed skills

```bash
npx skills list -g                                  # what's installed
npx skills update                                   # pull latest
npx skills remove                                   # interactive
```

### Related

* MCP Servers — skills point at MCP tools; install both for the full experience.
* CLI — the `panora` skill's anchor package.
* [`panora-exchange/agent-skills`](https://github.com/panora-exchange/agent-skills) on GitHub.