> ## 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.

# Skills

> How your agent learns Moda's design workflow — CLI skills, claude.ai skill ZIPs, and load_skill on the connector.

Tools tell an agent *what it can call*. Skills tell it *how to make something good* — Moda's design doctrine, the format-by-format workflow, the verify loop, the failure modes that look like success. An agent with the tools and no skills produces plausible-looking, badly designed output.

The same nine workflows reach your agent three ways, depending on where it runs.

## The nine skills

| Skill            | What it makes                                                                                   |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| `moda-deck`      | Slide decks from a brief, doc, or repo → native editable PPTX                                   |
| `moda-one-pager` | One-pagers, multi-page reports, and print pieces → text-layer PDF                               |
| `moda-social`    | Social posts, carousels, static ads, banners → PNG/JPEG (a carousel comes back as a zip)        |
| `moda-diagram`   | Flowcharts, 2×2 matrices, org charts, UI wireframes and mockups → PNG/PDF                       |
| `moda-website`   | Live websites, published to a public `*.moda.page` URL                                          |
| `moda-video`     | Video and motion — generated clips, brand stingers, image-to-video, animation exports → MP4/GIF |
| `moda-brand`     | Brand-kit reads, creation, and canvas-vs-kit audits                                             |
| `moda-edit`      | Precise edits to an existing canvas, from its URL                                               |
| `moda-help`      | The meta skill — setup, auth and orgs, routing, troubleshooting                                 |

Every one of them opens with the same check (is the CLI or connector there, are you signed in, what is this account entitled to) and the same rules: deliverables over plumbing, an explicit verify loop, and anything that spends credits labeled with its cost class up front and a receipt after.

<Note>
  The connector's copies of these workflows route one thing differently: its tool surface reads sites but does not
  build or publish them, so **building or publishing** a website happens in the Moda app. The skill says so at the
  point it matters; on the CLI the `moda site` verbs do it directly. Brand kits are not a difference — `brand_create`
  is a connector tool, matching `moda brand create`. (Attaching logo images to a kit stays an app step on the
  connector; the CLI has `moda brand add-image`.)
</Note>

## With the CLI

```sh theme={null}
npx skills add moda-design/moda
```

That installs the skills for Claude Code, Codex, Cursor, and anything else that reads the standard skills directory. In Claude Code you can instead take them through the plugin, which keeps them updated through the marketplace:

```
/plugin marketplace add moda-design/moda
/plugin install moda@moda
```

Skills are hash-pinned once installed and never update behind your back — re-run `npx skills add moda-design/moda` to pick up a new release. The CLI updates separately (`npm i -g @moda-design/moda`).

## With the connector: `load_skill`

The [Moda connector](/agents/mcp-connector) serves the same guidance itself, so a chat host needs no upload at all. `load_skill` is a normal tool call — free, fast, and always current, because the server is the one holding the text.

```
load_skill(name: "moda-deck")
```

The tool's own description carries the whole routing table, so the model can pick the right guide without loading
anything first. Forty-plus entries, in four groups:

| Kind                            | What it serves                                                                                                                                                                                                  |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Format workflows (9)            | The skills above — `moda-deck`, `moda-one-pager`, `moda-social`, `moda-diagram`, `moda-website`, `moda-video`, `moda-brand`, `moda-edit`, `moda-help`                                                           |
| Authoring depth (4)             | `markup` (every element, attribute, fill, and effect), `edit-code`, `reading-and-verifying`, `gotchas`                                                                                                          |
| Design and format depth (10)    | `design-quality`, `brand`, `deck-design`, `deck-playbooks`, `document-design`, `templates`, `export`, `omni-and-media`, `motion-recipes`, `video`                                                               |
| Moda's own design registry (21) | The per-format notes Moda's in-app agent works from — `slides`, `carousel`, `charts`, `diagram`, `prints`, `ui-design`, `shaders`, `paths`, `animation`, `logo-design`, `tiktok-safe-area`, `web-ads`, and more |

Good moments to call it: before authoring a format for the first time in a conversation, when a fill or effect gets rejected, and when a result looks wrong. The guides are free — a model that reads one first is cheaper overall than one that guesses and repairs.

## With claude.ai: skill ZIPs

Uploading the skills to claude.ai as **Agent Skills** gets you host-level auto-invocation: Claude matches the request against each skill's description and pulls the right one in without being told. This complements the connector's `load_skill` — the connector still works with no skills uploaded at all.

<Steps>
  <Step title="Turn on code execution" icon="toggle-on">
    **Settings → Capabilities → Code execution and file creation**. Skills ride that capability.
  </Step>

  <Step title="Download the ZIPs" icon="download">
    Grab the `moda-<skill>.skill.zip` files from the
    [latest release](https://github.com/moda-design/moda/releases/latest).
  </Step>

  <Step title="Upload each one" icon="upload">
    **Settings → Capabilities → Skills** (also at [claude.ai/customize/skills](https://claude.ai/customize/skills)) →
    **+ → Upload skill**. The upload format takes one skill per ZIP, so nine skills means nine uploads.
  </Step>
</Steps>

<Note>
  **Team and Enterprise admins:** upload the same ZIPs once under **Organization settings → Skills → + Add**. They are
  provisioned to every member and enabled by default — zero end-user setup.
</Note>

Uploaded skills are static snapshots: a new Moda release means re-uploading (one admin action for an org). The connector's `load_skill` never goes stale, which is why it is the better default if you only want one.

## Which should I use?

| Where your agent runs            | Do this                                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Anything with a shell            | `npx skills add moda-design/moda`                                                                         |
| claude.ai / Claude Desktop       | Nothing required — `load_skill` works out of the box. Upload the ZIPs on top if you want auto-invocation. |
| An MCP client that is not Claude | `load_skill`, called explicitly                                                                           |

Whichever route you take, the content is generated from one source, so the workflow your agent learns is the same across transports.