Polotno
Getting started

Build with AI

Set up Claude Code, Cursor, Codex, and other AI coding assistants to work with Polotno SDK — agent skills, MCP documentation search, and machine-readable docs

Polotno ships official tooling for AI coding assistants: skills that teach your agent the SDK, an MCP server for live documentation search, and machine-readable docs. Set these up before writing code — your assistant will know Polotno's APIs, patterns, and pitfalls instead of guessing.

Install skills

Skills are lightweight instruction packs your agent loads on demand. Polotno provides two in the polotno-project/skills repository:

  • polotno-sdk — SDK development assistant: core API patterns, a capability map of everything the SDK provides, and live documentation lookup.
  • polotno-design — headless design generation: produce a Polotno JSON design from a text brief, render it to PNG/PDF, and bulk-generate variants from data.

Claude Code

Installs both skills plus the documentation MCP server:

claude plugin marketplace add polotno-project/skills
claude plugin install polotno@polotno

Or from within a Claude Code session:

/plugin marketplace add polotno-project/skills
/plugin install polotno@polotno

Cursor, Copilot, Codex, Windsurf, Cline, and others

npx skills add polotno-project/skills

The skills CLI auto-detects which agents you have and installs the skills in each one's native format.

Manual setup

Copy the skill content from the repo into your agent's instructions file — skills/polotno-sdk/SKILL.md (with its capabilities.md) for SDK development:

PlatformFile
Cursor.cursorrules
GitHub Copilot.github/copilot-instructions.md
Codex / JulesAGENTS.md
Windsurf.windsurfrules

Live documentation search (MCP)

The Polotno skills are designed to look up API details in the live docs rather than carry stale copies. The Claude Code plugin above already includes the MCP server. For any other MCP-capable agent, add it to your MCP config:

{
  "mcpServers": {
    "polotno-documentation": {
      "command": "npx",
      "args": [
        "crawl-chat-mcp",
        "--id=67e312247a822a2303f2b8a7",
        "--name=polotno_documentation"
      ]
    }
  }
}

The server uses stdio transport and indexes both the documentation and the community forum. Works with Cursor, Cline, and any MCP-compatible editor. Requires Node.js 18+.

The same search powers the AI assistant widget on this docs site and on the community forum — ask questions like "How do I resize a page?" for instant cited answers.

Machine-readable docs

  • Markdown version of any docs page — append .md to the URL, e.g. /docs/store.md. Clean markdown, no navigation or scripts.
  • llms.txt — an LLM-oriented index of Polotno: core concepts, product pages, and documentation links.
  • llms-full.txt — the complete documentation as a single markdown document, for agents that want everything in one request.
  • AI info page — a condensed product brief for AI assistants.

Alternatives

Context7 also serves up-to-date Polotno documentation via MCP:

npx ctx7 setup

Use flags to target a specific editor: --cursor, --claude, --opencode. A free API key from context7.com/dashboard is recommended for higher rate limits.

What you can ask

Once set up, your assistant can answer with sources:

  • API questions – "What properties does TextElement have?"
  • Code examples – "How to add a rounded rectangle?"
  • Troubleshooting – "Why isn't my custom font loading?"

On this page