What is Design Skill OS?
Design Skill OS is an open-source design reasoning layer by frhscopex. A SKILL.md, industry rule data and a search script prime your coding agent with design principles, then a Red Team step audits the result for usability, accessibility and generic trends. A CLI initializes it for Cursor, Windsurf, Antigravity, Copilot and other tools.
Design Skill OS, also titled Design Skill OS Pro Max in its README, is a design knowledge layer for AI coding assistants. The core lives in src/design-skill: a SKILL.md, a data folder of industry reasoning rules, a search script and UI pattern templates.
The README says the principles are distilled from more than ten design books, covering topics such as Gestalt grouping, the 60-30-10 color rule, modular type scales and usability heuristics. Treat that as the author's description of the content.
What changes in your agent's output
- The agent maps brand personality first, defines a layout strategy, then generates code with CSS variables and semantic HTML.
- Palettes follow the 60-30-10 rule and type follows a modular scale, per the README's section list.
- A closing Red Team pass checks heuristics, accessibility against WCAG 2.1 and trend-chasing before you see the result.
- Page narrative gets an entry point, which the README calls a call to adventure.
Who it is for and who it is not for
Best for
- Developers who want one rule pack that a CLI can set up in several assistants.
- Projects where an adversarial audit step is more useful than a style catalog.
- Teams comparing rule packs; see also UI UX Pro Max for another large rule set.
Not for
- Anyone who needs active maintenance. The last push in the repository was in April 2026.
- A single-purpose fix, such as spacing or type only. For those use typeset or layout.
- Figma-accurate output, since the inputs are a brief and rules, not a design file.
Use it with UiChemy
Design Skill OS guides how the page is designed and audited. When the finished build must become an editable WordPress page, UiChemy AI to WordPress imports an existing AI build. Click Get Started on uichemy.com.
How to install Design Skill OS: Design Rules and Red Team Audit for AI Agents
npm install -g design-skill-osThe Copilot setup writes into .github/skills/design-skill-os and .github/copilot-instructions.md, per the README.Install the CLI
Run the command above. It installs the design-skill command globally.
Initialize for your assistant
Run design-skill init --ai cursor, --ai windsurf, --ai claude, --ai antigravity or --ai copilot. Use --ai all for a global system sync.
Make it global
Add --global, for example design-skill init --ai claude --global, to use it across projects. The README says global is not supported for Copilot, which installs into the repository.
Ask for it by name
Try: Build a luxury watch landing page using the Design Skill OS rules and run the Red Team check.
Check that it loaded
Open your assistant in the project and ask it to list the Design Skill OS sections it loaded. It should name the Red Team audit and the heuristics.
Key features
- 161 reasoning rulesIndustry-specific logic for products such as SaaS dashboards and luxury e-commerce, kept in the skill's data folder.
- 67 UI stylesThe README badges list 67 styles available to the recommendation step.
- Gestalt groupingProximity, similarity and closure are used to organize information on the page.
- Chromatic rulesThe 60-30-10 color rule and palettes tied to industry psychology.
- Typographic scaleLine height, leading and pairing are calculated from a modular scale based on the golden ratio.
- Digital heuristicsTen core usability rules are applied to each layout.
- Red Team auditAn adversarial self-critique covers heuristics, WCAG 2.1 accessibility and lazy design defaults.
- Narrative synthesisEach page is given an entry point and arc before layout is chosen.
- Multi-assistant setupA CLI initializes the rules for Cursor, Windsurf, Antigravity, GitHub Copilot and more, or all of them at once.
- Search scriptThe scripts folder holds a search and logic engine that the skill uses to look up rules.
Frequently asked questions
What is Design Skill OS?
Design Skill OS is an open-source design reasoning layer for AI coding assistants. It combines a SKILL.md, 161 industry reasoning rules, 67 UI styles, a search script and templates with a Red Team audit step. A CLI called design-skill initializes it for your tool.
How do I install Design Skill OS?
Run npm install -g design-skill-os, then design-skill init with an --ai target such as cursor, windsurf, claude, antigravity or copilot. Use --global for a user-wide install where supported. The README says global is not available for Copilot, which installs into the repository.
Does Design Skill OS work with Cursor, Windsurf and Claude Code?
Yes, per the README. It lists Claude Code, Cursor, Windsurf, Antigravity and GitHub Copilot as targets of the init command. Codex and Cline are not named there, so check their skills documentation before trying them.
What is the Red Team protocol?
It is the audit step at the end of a design run. The README describes three passes: heuristics to fix usability friction, accessibility to meet WCAG AA contrast and target size, and anti-schtick to strip lazy AI trends. The agent applies it to its own output.
Is Design Skill OS still maintained?
The repository's last push was on April 17, 2026, and it has 58 stars. The skill is a set of static rules, so it may still be useful, but you should expect fewer updates than a project with recent commits. Test it on a small page first.
Is Design Skill OS free?
The repository is MIT licensed. The CLI installs from npm, and the README mentions no paid plan or API key. Your coding assistant and any usage fees for it are separate, so check your own plan before running audits.
How does it compare with UI UX Pro Max?
Both are large rule packs for coding agents. Design Skill OS emphasizes a Red Team audit and design-book principles; read the UI UX Pro Max page for that pack's own scope. Try both on one brief and compare the output yourself.
Can it create a WordPress site?
No. It guides design decisions and code your agent writes. To import an AI build into WordPress as an editable page, UiChemy AI to WordPress is the route. Click Get Started on uichemy.com. For a plain component workflow, see ui-styling.


