SKILL.md 和 DESIGN.md 怎么选
两份文件说的是同一套视觉规则。差别是 Agent 从哪里读到它。
DESIGN.md
放在仓库根目录。Cursor、Claude Code、Codex、Stitch、Windsurf 都可以被规则点名去读它。YAML token 是准绳，八节正文解释怎么用。
SKILL.md
内容包含同一份 DESIGN.md，末尾多一段安装说明。Claude Code 放在 .claude/skills/design/SKILL.md。Cursor 也可以把技能放到 .cursor/skills/<风格>/SKILL.md。
怎么一起用
根目录留 DESIGN.md，让任何工具都能找到。需要技能目录的工具再复制一份 SKILL.md。编辑器两个都能导出。安装命令加上 --skill 会同时写这两处。