Agent skills

NexDoc Design ships public Agent Skills: raw markdown files that teach an external agent how to call NexDoc. Agents should fetch these URLs directly (Content-Type: text/markdown). This page is the human overview.

These are not the internal sandbox skill that runs inside the design worker. They tell a client agent how to be a NexDoc user.

Public URLs

Prefer MCP when create_design / export_design are already connected. Use the REST skill when you have an NXD_API_KEY and no MCP client. The API reference matches these skills (notify-email, allowed uploads, brand-in-instructions, wait times).

Install (Cursor)

mkdir -p ~/.cursor/skills/nexdoc-design ~/.cursor/skills/nexdoc-mcp ~/.cursor/skills/nexdoc-api

curl -fsSL https://www.nexdoc.design/skills/nexdoc-design/SKILL.md \
  -o ~/.cursor/skills/nexdoc-design/SKILL.md
curl -fsSL https://www.nexdoc.design/skills/nexdoc-mcp/SKILL.md \
  -o ~/.cursor/skills/nexdoc-mcp/SKILL.md
curl -fsSL https://www.nexdoc.design/skills/nexdoc-api/SKILL.md \
  -o ~/.cursor/skills/nexdoc-api/SKILL.md
curl -fsSL https://www.nexdoc.design/skills/nexdoc-api/reference.md \
  -o ~/.cursor/skills/nexdoc-api/reference.md

For Claude Code, use ~/.claude/skills/ in place of ~/.cursor/skills/.

Set NXD_API_KEY (REST / stdio MCP only):

export NXD_API_KEY=nxd_live_...

Remote MCP at https://mcp.nexdoc.design/mcp uses OAuth and does not need a key in the client.

What the skills instruct the agent to do

1. Create a job and start a run (MCP create_design, or POST /v1/jobs then POST /v1/jobs/:id/runs)
2. Persist job_id and run_id immediately — generation often takes 1–20 minutes
3. Wait (poll / wait_for_run) or request email notification when the schema allows it
4. Return viewer_url; export PDF or HTML ZIP when the user wants a download
5. Publish only if the user explicitly asks for a public URL
6. On 402, send the user to app.nexdoc.design