Agent skills | Paragraph Docs
Agent skills
Installable skills that teach any AI agent how to use the Paragraph API, CLI, SDK, and MCP server.
Paragraph agent skills are portable instructions that teach AI agents (Claude Code, Cursor, and others) how to work with Paragraph. They follow the Agent Skills standard.
The skills include working agreements, commands and endpoints with examples, JSON response shapes, and common patterns.
Available skills
| Skill | Covers | Install required |
|---|---|---|
paragraph-cli |
The CLI and MCP server | Yes (npm install -g @paragraph-com/cli) |
paragraph-api |
The REST API and TypeScript SDK | No |
Automatic discovery
Agents that support the Agent Skills Discovery RFC can discover Paragraph's published skill from /.well-known/agent-skills/index.json.
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
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. Every page on this docs site also has a Markdown variant (append .md to the URL).
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 for client-specific setup.
Resources
View on GitHub \ \ Explore the skills, contribute, or report issues. Agent Skills standard \ \ Learn about the portable skill format these skills follow.
MCP server\ \ Connect AI agents to Paragraph via the Model Context Protocol.