SKILL.md or DESIGN.md

Both files describe the same visual rules. The difference is where the agent reads them.

DESIGN.md

It lives at the repo root. Cursor, Claude Code, Codex, Stitch, and Windsurf can be told to read it. YAML tokens are normative. The eight sections explain how to use them.

SKILL.md

It includes the same DESIGN.md plus a short install note. Claude Code reads .claude/skills/design/SKILL.md. Cursor can also keep a skill at .cursor/skills/<style>/SKILL.md.

Use them together

Keep DESIGN.md at the root so any tool can find it. Copy SKILL.md only for tools that read a skills folder. The editor exports both. The install command with --skill writes both places.