# Agent skills

Installable skills that teach any AI agent how to use the Paragraph API, CLI, SDK, and MCP server.

[Paragraph agent skills](https://github.com/paragraph-xyz/skill) are portable instructions that teach AI agents (Claude Code, Cursor, and others) how to work with Paragraph. They follow the [Agent Skills](https://agentskills.io/) standard.

The skills include working agreements, commands and endpoints with examples, JSON response shapes, and common patterns.

## [Available skills](https://docs.paragraph.com/developers/agent-skills#available-skills)

| Skill | Covers | Install required |
| --- | --- | --- |
| `paragraph-cli` | The [CLI](https://docs.paragraph.com/developers/cli) and [MCP server](https://docs.paragraph.com/developers/mcp) | Yes (`npm install -g @paragraph-com/cli`) |
| `paragraph-api` | The REST API and [TypeScript SDK](https://docs.paragraph.com/developers/sdk) | No |

## [Automatic discovery](https://docs.paragraph.com/developers/agent-skills#automatic-discovery)

Agents that support the [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) can discover Paragraph's published skill from [`/.well-known/agent-skills/index.json`](https://paragraph.com/.well-known/agent-skills/index.json).

## [Install](https://docs.paragraph.com/developers/agent-skills#install)

Install all skills:

```
npx skills add paragraph-xyz/skill
```

Install a specific skill:

```
npx skills add paragraph-xyz/skill --skill paragraph-api
npx skills add paragraph-xyz/skill --skill paragraph-cli
```

Or manually copy the `SKILL.md` file into your agent's skills directory:

| Agent | Path |
| --- | --- |
| Claude Code | `~/.claude/skills/<skill-name>/SKILL.md` |
| Cursor | `.cursor/skills/<skill-name>/SKILL.md` |
| Any agent | Check your agent's skill directory |

## [No install: paste a prompt](https://docs.paragraph.com/developers/agent-skills#no-install-paste-a-prompt)

If you can't install skills, you can paste a short prompt into your agent's context instead. It covers the MCP server, CLI, REST API, and SDK.

### Copy agent prompt

You can also give your agent complete knowledge of Paragraph's API by sharing [llms-full.txt](https://docs.paragraph.com/llms-full.txt). Every page on this docs site also has a Markdown variant (append `.md` to the URL).

## [Prefer MCP?](https://docs.paragraph.com/developers/agent-skills#prefer-mcp)

For MCP-compatible clients, you can skip skills entirely and use the hosted Paragraph MCP server. No CLI or API key required:

```
claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp
```

See the [MCP server guide](https://docs.paragraph.com/developers/mcp) for client-specific setup.

## [Resources](https://docs.paragraph.com/developers/agent-skills#resources)

[**View on GitHub** \\ \\ Explore the skills, contribute, or report issues.](https://github.com/paragraph-xyz/skill) [**Agent Skills standard** \\ \\ Learn about the portable skill format these skills follow.](https://agentskills.io/)

[MCP server\\ \\ Connect AI agents to Paragraph via the Model Context Protocol.](https://docs.paragraph.com/developers/mcp)