Skills

A skill is a folder under packages/skills/catalog/<name>/ containing a SKILL.md (Anthropic format), an optional templates/, optional scripts/, and optional tests/. The themarch runner reads the frontmatter, validates requires against the detected RepoSnapshot, and renders the templates with Handlebars + a few helpers (pascalCase, camelCase, kebabCase, snakeCase, pluralize, singularize).

SKILL.md frontmatter

Key	Required	Description
`name`	✅	lowercase kebab-case
`description`	✅	one-line summary, surfaced in `themarch skill list`
`version`		semver, defaults to `0.0.0`
`author`		defaults to `themarch`
`tags`		array of strings
`requires`		list of `{ <RepoSnapshot key>: value }` constraints
`inputs`		array of `{ name, type, required, description, default }`
`outputs`		informational list of files to expect
`adaptation`		free-form per-skill adaptation hints

Catalog

Category	Skills
Database	`add-table`, `add-rls`, `add-relation`, `add-index`, `add-event-sourced-aggregate`, `convert-prisma-to-drizzle`
API	`add-trpc-router`, `add-trpc-procedure`, `add-zod-schema`
Frontend	`add-page`, `add-server-action`, `add-shadcn-component`, `add-form`
Async	`add-inngest-workflow`, `add-cron-job`, `add-outbox`
Auth	`add-better-auth`, `add-protected-route`, `add-rbac-permission`
Testing	`add-test-e2e`, `add-test-unit`, `add-load-test`
Infra	`add-docker-service`, `add-github-action`, `add-env-var`
Meta	`add-mcp-server`, `add-cursorrules`, `add-claude-md`
Composite	`scaffold-feature`, `enhance-existing-repo`

Run themarch skill list for the live, formatted list.

Authoring a new skill

Create packages/skills/catalog/<name>/SKILL.md with the frontmatter above.
Add Handlebars templates under templates/. File paths can use {{var}} (or the __VAR__ convention for tools that dislike braces).
Add the skill name to the EXPECTED_SKILLS list in packages/skills/tests/catalog.test.ts to keep the catalog audit honest.
Submit a PR.