Paragraph Docs
Developers

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

SkillCoversInstall required
paragraph-cliThe CLI and MCP serverYes (npm install -g @paragraph-com/cli)
paragraph-apiThe REST API and TypeScript SDKNo

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:

AgentPath
Claude Code~/.claude/skills/<skill-name>/SKILL.md
Cursor.cursor/skills/<skill-name>/SKILL.md
Any agentCheck 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.

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

On this page