Agent skillsLast updated on
Last updated on
Install the Paradoc agent skills into Claude Code, Claude.ai, or any agent that supports the Agent Skills specification
Paradoc ships two agent skills. A skill is a reference package that teaches an AI coding assistant how to use Paradoc, so it does not need to read the docs site mid-task. The assistant loads only the references the current task needs.
| Skill | Use it for |
|---|---|
paradoc | Authoring, filling, validating, rendering, and sealing artifacts with the TypeScript SDK, the paradoc CLI, raw JSON/YAML, the AI agent tools, or the hosted MCP server |
paradoc-react | Composing, checking, previewing, rendering, and sealing documents written in React with @paradoc/react and @paradoc/react-pdf |
Install paradoc-react on its own when composing documents in React is the only Paradoc work in play. Install both when you also author the artifacts.
The paradoc skill
The paradoc skill has three kinds of references:
| Kind | Files | What they cover |
|---|---|---|
| Surface | sdk, cli, schemas, ai-tools, mcp | How to work on each surface: TypeScript SDK, paradoc CLI, raw JSON/YAML, AI agent tools in your own code, hosted MCP |
| Topic | artifacts, fields, parties, annexes, logic, layers, templates, pdf, rendering, formatting, instructions, filling, sealing, essentials | Concepts that apply on every surface |
| Workflow | workflow-author-form | A staged pipeline for creating a form from requirements or converting a PDF form |
The skill activates when the assistant sees Paradoc work: @paradoc/* imports, the paradoc CLI, JSON/YAML artifacts, the AI tool packages, or mcp.paradoc.dev.
Installation
npx skills add https://github.com/paradoc-dev/paradoc --skill paradoc
npx skills add https://github.com/paradoc-dev/paradoc --skill paradoc-reactTo install manually:
git clone https://github.com/paradoc-dev/paradoc.git
cp -r paradoc/skills/skills/paradoc ~/.claude/skills/
cp -r paradoc/skills/skills/paradoc-react ~/.claude/skills/Fetch the skills from the site
An agent with no clone of the repository can read the skills from https://docs.paradoc.dev/.well-known/agent-skills/index.json, which follows the Agent Skills discovery index. Each entry gives a .tar.gz archive with SKILL.md and every reference, and a sha256 digest of the archive bytes to check before use. The same index is served at https://paradoc.dev/.well-known/agent-skills/index.json.
Pairing with MCP
The skills and the hosted MCP server do different jobs:
| Skills | MCP | |
|---|---|---|
| Provides | Reference and workflow guidance | Runtime tools: validate, fill, render, and the registry tools |
| Loaded | On demand by the agent | Connected as a tool server |
| Needs | Nothing | A Paradoc credential: an OAuth sign-in or an API key |
| Best for | Writing code, designing artifacts, debugging | Browsing the registry, rendering live artifacts |
To give your own agent Paradoc tools in code, use the AI tool packages instead of MCP.
Source
The skills live in the Paradoc repository under skills/. Issues and contributions are welcome there.