AGENT SKILL
codex-design-md
Use for DESIGN.md visual identity contracts; author, scaffold, lint, diff, and export design contracts with the upstream spec and CLI.
- License 许可
- MIT
- 最近更新
- 2026-07-15
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- codex-design-md
- description
- Use for DESIGN.md visual identity contracts; author, scaffold, lint, diff, and export design contracts with the upstream spec and CLI.
- load_priority
- on-demand
02 资源文件 5
- 资产文件assets/design-md-template.md3.2 KB
- 参考文档references/cli-commands.md3.0 KB
- 参考文档references/integration-playbook.md2.1 KB
- 参考文档references/spec-essentials.md2.7 KB
- 脚本scripts/design_contract.py29.6 KB
03 SKILL.md 正文
TL;DR
Load when a project needs a durable design contract, not just one-off styling advice. This skill adds a structured DESIGN.md layer with typed tokens, ordered rationale sections, and validation/export tooling. No upstream source checkout is required for the default workflow.
Activation
- Activate when the user mentions
DESIGN.md, design tokens, Tailwind theme export, DTCG export, or a reusable visual identity contract. - Activate on
$design-md, "create a design contract", "lint DESIGN.md", or "export design tokens". - Load alongside
codex-design-systemwhen UI work needs both creative direction and a durable source-of-truth file. - Auto-load when
frontend-specialistis active and the task needs persistent design-system artifacts.
Decision Flow
- If no
DESIGN.mdexists, scaffold one first withscripts/design_contract.py scaffold. - Use
references/spec-essentials.mdto keep tokens and sections inside the canonical format. - Validate with
scripts/design_contract.py lintbefore relying on the contract. - Compare revisions with
scripts/design_contract.py diffwhen the contract changes. - Export to Tailwind or DTCG with
scripts/design_contract.py exportonly after lint is clean.
Rules
- Treat
DESIGN.mdas the durable source of truth for visual identity; do not scatter token decisions across ad-hoc prompts. - Keep the file canonical: YAML tokens first, then markdown sections in spec order.
- Use exact token values. Do not write vague prose where a token should exist.
- Pair this skill with
codex-design-systemfor palettes, typography, layouts, and motion vocabulary. - Prefer validation and diff evidence over aesthetic claims.
Reference Files
references/spec-essentials.mdreferences/cli-commands.mdreferences/integration-playbook.md
04 同仓库更多 Skills
codex-test-driven-development
Fixture stub for TDD skill.
★ 2
codex-subagent-execution
Fixture stub for subagent execution skill.
★ 2
codex-runtime-hook
Fixture stub for runtime hook skill.
★ 2
codex-plan-writer
Fixture stub for plan writer skill.
★ 2
codex-execution-quality-gate
Fixture stub for quality gate skill.
★ 2
codex-demo
Minimal fixture skill for Agency CLI skill-md parser tests.
★ 2