https://github.com/frhscopex/design-skill-os
The elite design intelligence layer for AI agents, synthesized from 10+ legendary design books. It primes your AI with the collective strategic wisdom of master designers to generate high-intent UI/UX with zero "schtick."
https://github.com/frhscopex/design-skill-os
accessibility ai-design claude-ai claude-code claude-skills design design-skill-os design-system design-tools red-teaming skill-md skills ui-design uiux uiux-design uiuxdesigner ux-design
Last synced: 2 months ago
JSON representation
The elite design intelligence layer for AI agents, synthesized from 10+ legendary design books. It primes your AI with the collective strategic wisdom of master designers to generate high-intent UI/UX with zero "schtick."
- Host: GitHub
- URL: https://github.com/frhscopex/design-skill-os
- Owner: frhscopex
- License: mit
- Created: 2026-04-15T15:36:22.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T18:19:31.000Z (2 months ago)
- Last Synced: 2026-04-15T18:25:42.215Z (2 months ago)
- Topics: accessibility, ai-design, claude-ai, claude-code, claude-skills, design, design-skill-os, design-system, design-tools, red-teaming, skill-md, skills, ui-design, uiux, uiux-design, uiuxdesigner, ux-design
- Language: Python
- Homepage:
- Size: 65.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Design Skill OS Pro Max ⚡
---
## 🧠 The Cognitive "Brain": Derived from 10+ Design Books
**Design Skill OS** is not just a document; it's a professional-grade reasoning layer that transforms standard AI outputs into elite-level design masterworks. We have exhaustively synthesized principles from the "Design Bibles" to prime your AI agent with the strategic intent of a world-class Creative Director.
### 📚 The Source of Truth
The intelligence core is distilled from the collective wisdom of masters:
- **Milton Glaser** (*Art is Work*): Rejecting "schtick" for authenticity.
- **Ellen Lupton** (*Thinking with Type*): Mastering the grid and typographic hierarchy.
- **Michael Bierut** (*How to Use Graphic Design to...*): Using design as a tool for clear communication.
- **Bruce Mau** (*MC24*): Designing for massive change and performativity.
- **Donald Norman** (*The Design of Everyday Things*): Cognitive psychology and affordances.
- **Debbie Millman** (*Brand Thinking*): Mapping the emotional resonance of identity.
- **Charles & Ray Eames**: The philosophy that "The details are not the details; they make the design."
### 🛠 What the "Brain" Injects into your AI:
- **[Section 2] Gestalt Sovereignty**: Forces the AI to use proximity, similarity, and closure to organize information naturally.
- **[Section 5] Chromatic Mastery**: Implements the **60-30-10 Rule** and creates harmonious palettes based on industry psychology.
- **[Section 8] Typographic Modular Scale**: Calculates line-height, leading, and pairing using the **Golden Ratio**.
- **[Section 15] Digital Heuristics**: Applies the 10 core usability rules (Nielsen/Norman) to every interface layout.
- **[Section 23] Red Team Audits**: Advanced adversarial self-critique based on **WCAG 2.1** and **Bruce Mau's performance metrics**.
---
## ⚡ What's New: The Red Team Protocol
The AI no longer just "makes pixels"—it audits them. Every design of the **Design Skill OS** undergoes an automated "Red Team" gauntlet:
```text
1. HEURISTICS -> Fixes UX friction & logic errors.
2. ACCESSIBILITY -> Ensures WCAG AA compliance (Contrast/Targets).
3. ANTI-SCHTICK -> Strips "lazy" AI trends for authentic branding.
```
## 🔥 Features that Ignite Creativity
- **🧠 161+ Reasoning Rules**: Specialized logic for everything from SaaS dashboards to Luxury E-commerce.
- **🎨 Chromatic Mastery**: Implements the **60-30-10 Rule** and the **Golden Ratio** for typographic hierarchy.
- **🛡️ Red Team Swarm**: Built-in adversarial protocols that kill "lazy" design defaults before they reach you.
- **📜 Narrative Synthesis**: Forces AI to define a "Call to Adventure" and entry point for every page.
- **🛠️ Multi-Assistant Native**: Tailored templates for Claude Code, Cursor, Windsurf, Antigravity, and Move.
---
## 🚀 Installation & Setup
### **1. Global CLI Install**
```bash
npm install -g design-skill-os
```
### **2. Prime Your Assistant**
Initialize the skill for your specific AI stack. This injects the "Brain" directly into your project's configuration.
```bash
# General Setup
design-skill init --ai claude # Claude Code / CLI
design-skill init --ai cursor # Cursor IDE
design-skill init --ai windsurf # Windsurf
design-skill init --ai antigravity # Antigravity (Elite)
design-skill init --ai all # Global System Sync
```
### **3. Global Deployment (Recommended)**
Available across all your projects without redundant initialization:
```bash
design-skill init --ai claude --global
```
---
## 📖 The "Master Designer" Workflow
Once installed, your AI agent gains instant access to the **Design Skill OS** core. Just chat naturally:
> "Build a luxury watch landing page using the Design Skill OS rules. Ensure a Red Team check for color-blindness and narrative arc."
**The Resulting Workflow:**
1. **Discovery**: AI maps brand personality using Section 17 rules.
2. **Strategy**: Defines the layout using the **Gestalt Principles** (Section 2).
3. **Execution**: Generates high-fidelity code with CSS variables and semantic HTML.
4. **Red Team**: Runs the **Adversarial Audit** (Section 23) to fix contrast and trend-chasing.
---
## 📂 Architecture Overview
```text
┌─────────────────────────────────────────────────────────────────┐
│ CORE SYSTEM: Design Skill OS │
├─────────────────────────────────────────────────────────────────┤
│ src/design-skill/ │
│ ├── SKILL.md <-- The "Brain" (Knowledge Base) │
│ ├── data/ <-- 161+ Industry Reasoning Rules │
│ ├── scripts/ <-- AI Search & Logic Engine │
│ └── templates/ <-- High-Fidelity UI Patterns │
├─────────────────────────────────────────────────────────────────┤
│ cli/ <-- Dynamic Deployment Engine │
└─────────────────────────────────────────────────────────────────┘
```
---
## 🏆 Supported Industry Rules
| Category | High-Fidelity Focus |
| :--- | :--- |
| **SaaS & Tech** | Efficiency, Clarity, Developer Tooling |
| **Fintech** | Trust, Precision, Data Density |
| **Luxury & E-com** | Emotion, Elegance, Storytelling |
| **Healthcare** | Accessibility, Calm, Information Hierarchy |
| **Creative Arts** | Portfolios, Branding, Experimental UI |
---
## 🤝 Contributing & Support
We build for the future of AI-human collaboration.
- **Stars** are our fuel. If this helps you build better, drop a ⭐.
- **PRs** are welcome. See `CLAUDE.md` for the contributor's style guide.
---
## 📄 License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for the full text.
---
"The details are not the details. They make the design." — Charles Eames
Built with ❤️ by the Design Skill Collective.