Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moda.app/llms.txt

Use this file to discover all available pages before exploring further.

The Moda agent skill is a small Markdown package — one SKILL.md plus a few reference files and recipes — that you install into an AI agent. It teaches the agent how Moda’s MCP tools work, which one to call for a given user request, and the non-obvious behaviors it should respect (concurrency caps for bulk fan-out, brand-kit resolution order, conversation vs. canvas vs. template semantics, etc.). With the skill installed, the agent gets:
  • A first-call whoami discovery handshake that skips downstream lookups when defaults are unambiguous.
  • A consolidated gotchas reference covering the silent failures the tool signatures can’t communicate.
  • 5 recipes for the canonical design-task patterns (create / edit / fill-template / rebrand-template / bulk).
  • Clear guidance on find_brand_kits vs list_brand_kits so brand-kit lookups don’t take over the screen.
The skill works with any MCP-capable agent. Pick the install path that matches how you use Moda:

​
Install

Bundles the MCP server and the skill in one command:
claude /plugin marketplace add moda-design/skills
Then enable the Moda plugin when prompted. The skill becomes active in any conversation that touches Moda.To update later:
claude /plugin marketplace update moda-design/skills

​
What the agent learns

A short tour of the skill files, in order of how the agent uses them:
  • SKILL.md — orientation page. The “call whoami first” handshake, a 10-bullet “what goes silently wrong” sheet, a recipe map, and pointers to references.
  • references/tools.md — factual catalog of all 20+ MCP tools with parameter tables and defaults.
  • references/gotchas.md — single-page consolidated reference for non-obvious behaviors: format_category defaulting to slides, the wait-default asymmetry between start_design_task and remix_design, the canvas_id / template_canvas_id / conversation_id mutual-exclusion matrix, brand-kit resolution order, attachment role semantics, the not_ready export retry state, and more.
  • recipes/create-new-design.md, edit-existing-canvas.md, fill-template.md, rebrand-template.md — one short page per canonical design-task pattern. Mirrors the patterns documented at Design Task Recipes, but framed for an AI agent making tool-call decisions.
  • recipes/bulk-variants.md — fan-out patterns for “make N variations of this”: windowed launch respecting the plan’s concurrency_cap (from whoami), list_tasks(status="running") polling, deliver-as-queued UX.

​
Stay updated

The skill ships from the moda-design/skills GitHub repo. Watch the Releases page for changelogs. Each release also attaches moda-api.zip (the REST-API skill) and skills.zip (both skills bundled, for tooling that wants everything in one download). When a new version ships, claude /plugin marketplace update, npx skills add (re-run), or a re-upload of the zip all pull the latest.

​
See also