Skip to content
cccskills
FreePublished on GitHub

codex-design-md

Use for DESIGN.md visual identity contracts; author, scaffold, lint, diff, and export design contracts with the upstream spec and CLI.

The English summary is being prepared. Showing the original description.

See how to install

Files included (8)

  • SKILL.md2.0 KB
  • agents/openai.yaml276 B
  • assets/design-md-template.md3.3 KB
  • references/cli-commands.md3.0 KB
  • references/integration-playbook.md2.1 KB
  • references/spec-essentials.md2.7 KB
  • scripts/design_context.py7.2 KB
  • scripts/design_contract.py29.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

  1. Activate when the user mentions DESIGN.md, design tokens, Tailwind theme export, DTCG export, or a reusable visual identity contract.
  2. Activate on $design-md, "create a design contract", "lint DESIGN.md", or "export design tokens".
  3. Load alongside codex-frontend-design when UI work needs both creative direction and a durable source-of-truth file.
  4. Auto-load when frontend-specialist is active and the task needs persistent design-system artifacts.

Decision Flow

  1. If no DESIGN.md exists, scaffold one first with scripts/design_contract.py scaffold.
  2. Use references/spec-essentials.md to keep tokens and sections inside the canonical format.
  3. Validate with scripts/design_contract.py lint before relying on the contract.
  4. Compare revisions with scripts/design_contract.py diff when the contract changes.
  5. Export to Tailwind or DTCG with scripts/design_contract.py export only after lint is clean.

Rules

  • Treat DESIGN.md as 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-frontend-design (references/ for OKLCH palettes, typography, layouts, motion) for the visual vocabulary.
  • Prefer validation and diff evidence over aesthetic claims.

Reference Files

  • references/spec-essentials.md
  • references/cli-commands.md
  • references/integration-playbook.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work — guides completion of development work by presenting structured options for merge, PR, or cleanup

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when a project has 50+ files, missing context, or explicit $codex-genome request; generates multi-layer project context to reduce hallucination.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when the task involves reading, creating, or editing `.docx` documents, especially when formatting or layout fidelity matters; prefer `python-docx` plus the bundled `scripts/render_docx.py` for visual checks.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use for documents, reports, memos, guides, academic papers, or formal text that needs clear structure, reliable tone, formatting, and diagrams.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when frontend, backend, mobile, data, DevOps, or security work needs domain routing and at most four focused references.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

See all skills by Bang-isme

Report a problem with this skill