Skip to main content
The Moda agent skill is a small Markdown package — one SKILL.md plus a gotchas reference and six task 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 mandatory first-call get_moda_bootstrap handshake that loads workspace context and skips downstream lookups when defaults are unambiguous.
  • A consolidated gotchas reference covering the silent failures the tool signatures can’t communicate.
  • 6 recipes for the canonical design-task patterns (create / edit / find-a-template / 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:
Then enable the Moda plugin when prompted. The skill becomes active in any conversation that touches Moda.To update later:

​
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 get_moda_bootstrap first” handshake, a 13-bullet “what goes silently wrong” sheet, a recipe map, and pointers to references.
  • references/gotchas.md — single-page consolidated reference for non-obvious behaviors: the format_category default (an omitted category resolves to a generic other canvas at 1080×1080), 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/find-a-template.md — how to discover the team’s curated templates and themes (list_my_canvases vs search_canvases, the template_type filter, what an empty result means), and the “be aware of a template’s author-pinned instructions, don’t restate them, don’t contradict them” contract that governs the prompt written against a template.
  • recipes/bulk-variants.md — fan-out patterns for “make N variations of this”: windowed launch respecting the plan’s concurrency_cap (from get_moda_bootstrap), 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