oh-my-design

oh-my-design is an open-source CLI tool that brings design systems to AI coding agents. It installs reusable skills, specialist roles, and quality-graded company design references directly into your existing coding agent workflows—no additional API keys, daemons, or MCP servers required. Supported agents include Claude Code, Codex, OpenCode, and Cursor. The installation adds 28 skills, 20 specialist sub-agents, and 440+ company DESIGN.md references to your project. Core output is a portable DESIGN.md file containing your design philosophy, decision tables with unique IDs, semantic tokens, and component contracts. Each token traces back to the decision that produced it, ensuring consistency. The system also generates component contracts with state matrices—including deliberately excluded states with reasons—and accessibility contracts. The `omd book` command serves your design system locally for preview and handoff. A derivation chain ensures each design decision constrains the next: philosophy → decision table → tokens → component contracts → layout grammar → build → render critique → DESIGN.md. Two numbered gates keep the system honest—GS7 fails tokens without decision references, and GS8 fails components built from scratch when matching presets exist. 54 slop gates and 8 system-fidelity gates are included. Existing reference formats are readable during migration. The package supports migration to DESIGN.md Core v2, a vendor-neutral portable contract that works when pasted into generic chat or attached to design tools. Installation is a single command: `npx oh-my-design-cli@latest`. After install, restart your agent and run `doctor` to verify. Workflows are initiated through natural language prompts rather than slash commands.