AGENTS.md

1# skills
2 
3This directory holds **functional skills** — capabilities the agent
4invokes mid-task to do work on user input. Each skill is a folder with a
5`SKILL.md` (frontmatter + body) and any side files (`assets/`,
6`references/`, scripts, …) the workflow needs.
7 
8If the entry primarily *renders* a design artifact (deck, prototype,
9image/video/audio template) it belongs under `../design-templates/`
10instead. See `specs/current/skills-and-design-templates.md` for the
11full split.
12 
13## Daemon plumbing
14 
15- Listed under `/api/skills` (functional only). User-imported skills
16  shadow built-in entries with the same frontmatter `name`.
17- Asset routes (`/api/skills/:id/example`, `/api/skills/:id/assets/*`)
18  span both functional skills and design templates so existing
19  `srcdoc`-rewritten URLs keep resolving after the split.
20- Integrations → Skills surfaces this directory only. Renderable templates are
21  read from the design-templates registry by the New project "Start from" rails;
22  the redesigned home no longer has a top-level Templates tab.
23 
24## Adding a skill
25 
261. Create `skills/<my-skill>/SKILL.md` with `name`, `description`,
27   `triggers`, and `od.mode: utility` (or `design-system`) frontmatter.
282. Drop any side files alongside; reference them from the body using
29   the relative-from-skill-root paths the daemon advertises in the
30   skill preamble.
313. The daemon's lazy scanner picks the entry up on the next
32   `/api/skills` request — no rebuild required during local dev.
33 
34## Curated design / creative catalogue
35 
36This directory also ships a curated catalogue of design and creative
37skills hand-picked from `VoltAgent/awesome-agent-skills` and
38`ComposioHQ/awesome-claude-skills`. Each entry is a lightweight stub —
39frontmatter + a short body that points at the upstream repo — so the
40Integrations → Skills surfaces a rich, filterable list out of the box
41without vendoring every upstream workflow.
42 
43- `od.category` on these stubs powers the new category filter row in
44  Integrations → Skills (e.g. `image-generation`, `video-generation`,
45  `audio-music`, `slides`, `documents`, `design-systems`, `figma`,
46  `animation-motion`, `3d-shaders`, `diagrams`, `creative-direction`,
47  `marketing-creative`, `screenshots`, `web-artifacts`).
48- The seed script lives at `scripts/seed-curated-design-skills.ts` and
49  is **idempotent**: running it again only creates folders that don't
50  already exist, so a hand-edited stub is never overwritten. Delete the
51  folder under `skills/` and re-run the script to refresh an entry.
52- Stubs intentionally do not vendor upstream assets. To run an upstream
53  workflow with its original scripts and references, copy the upstream
54  folder into your active agent's skills directory (Claude Code, Codex,
55  Cursor, etc.) — the body of each stub explains how.
56