New theme

.agents/skills/new-theme/SKILL.md — 104 lines of instruction that ship inside the starter. This page is generated from it, so it says what the skill does without republishing it.

When an agent picks this up

The skill description, verbatim — this is the text an agent matches your request against:

Add or customise a theme preset in a ZeroDirs directory site. Covers the three-part registration (preset CSS file, @import in global.css, entry in src/config/presets.ts with OG hex colours) and the lighter-weight theme.tokens override path. Use when asked to change brand colours, corner radius, fonts, or to add a new colour scheme.

What it walks through

1. Path A — override tokens (no new files)
2. Path B — add a preset (three files, all required)
   • src/styles/presets/<name>.css
   • One @import in src/styles/global.css
   • One entry in PRESETS in src/config/presets.ts
3. Fonts
4. Verify

Commands it runs

pnpm check
pnpm test                       # tests/unit/theme.test.ts checks the registration triple
pnpm build
pnpm og:default                 # regenerate public/og-default.png with the new colours
pnpm og:default --check

Files it touches

site.config.ts · src/layouts/Base.astro · src/styles/global.css · src/config/schema.ts · src/styles/presets/warm.css · tests/unit/theme.test.ts · src/config/presets.ts

Using it

Skills load themselves — you describe the outcome, not the skill. “Add a Compliance category with an icon and seed it” is enough for an agent that can see .agents/skills/; Claude Code reads .claude/skills/, which pnpm skills:sync mirrors from .agents/ on every install. See Working with an agent.