Design Skill OS Pro Max ⚡

1# Design Skill OS Pro Max ⚡
2 
3<p align="center">
4  <a href="https://github.com/frhscopex/design-skill-os/releases"><img src="https://img.shields.io/github/v/release/frhscopex/design-skill-os?style=for-the-badge&color=blue" alt="GitHub Release"></a>
5  <a href="src/design-skill/SKILL.md"><img src="https://img.shields.io/badge/Reasoning%20Rules-161-green?style=for-the-badge" alt="161 Reasoning Rules"></a>
6  <a href="src/design-skill/SKILL.md"><img src="https://img.shields.io/badge/UI%20Styles-67-purple?style=for-the-badge" alt="67 UI Styles"></a>
7  <a href="src/design-skill/SKILL.md"><img src="https://img.shields.io/badge/Design%20Books-10-orange?style=for-the-badge" alt="10 Design Books"></a>
8  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License: MIT"></a>
9</p>
10 
11<p align="center">
12  <a href="https://www.npmjs.com/package/design-skill-os"><img src="https://img.shields.io/npm/v/design-skill-os?style=for-the-badge&logo=npm&label=npm" alt="npm"></a>
13  <a href="https://www.npmjs.com/package/design-skill-os"><img src="https://img.shields.io/npm/dm/design-skill-os?style=for-the-badge&label=npm%20downloads" alt="npm downloads"></a>
14  <a href="https://github.com/frhscopex/design-skill-os/stargazers"><img src="https://img.shields.io/github/stars/frhscopex/design-skill-os?style=for-the-badge&logo=github" alt="GitHub stars"></a>
15</p>
16 
17---
18 
19## 🧠 The Cognitive "Brain": Derived from 10+ Design Books
20 
21**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.
22 
23### 📚 The Source of Truth
24The intelligence core is distilled from the collective wisdom of masters:
25- **Milton Glaser** (*Art is Work*): Rejecting "schtick" for authenticity.
26- **Ellen Lupton** (*Thinking with Type*): Mastering the grid and typographic hierarchy.
27- **Michael Bierut** (*How to Use Graphic Design to...*): Using design as a tool for clear communication.
28- **Bruce Mau** (*MC24*): Designing for massive change and performativity.
29- **Donald Norman** (*The Design of Everyday Things*): Cognitive psychology and affordances.
30- **Debbie Millman** (*Brand Thinking*): Mapping the emotional resonance of identity.
31- **Charles & Ray Eames**: The philosophy that "The details are not the details; they make the design."
32 
33### 🛠 What the "Brain" Injects into your AI:
34- **[Section 2] Gestalt Sovereignty**: Forces the AI to use proximity, similarity, and closure to organize information naturally.
35- **[Section 5] Chromatic Mastery**: Implements the **60-30-10 Rule** and creates harmonious palettes based on industry psychology.
36- **[Section 8] Typographic Modular Scale**: Calculates line-height, leading, and pairing using the **Golden Ratio**.
37- **[Section 15] Digital Heuristics**: Applies the 10 core usability rules (Nielsen/Norman) to every interface layout.
38- **[Section 23] Red Team Audits**: Advanced adversarial self-critique based on **WCAG 2.1** and **Bruce Mau's performance metrics**.
39 
40---
41 
42 
43## ⚡ What's New: The Red Team Protocol
44 
45The AI no longer just "makes pixels"—it audits them. Every design of the **Design Skill OS** undergoes an automated "Red Team" gauntlet:
46 
47```text
481. HEURISTICS    -> Fixes UX friction & logic errors.
492. ACCESSIBILITY -> Ensures WCAG AA compliance (Contrast/Targets).
503. ANTI-SCHTICK  -> Strips "lazy" AI trends for authentic branding.
51```
52 
53 
54## 🔥 Features that Ignite Creativity
55 
56- **🧠 161+ Reasoning Rules**: Specialized logic for everything from SaaS dashboards to Luxury E-commerce.
57- **🎨 Chromatic Mastery**: Implements the **60-30-10 Rule** and the **Golden Ratio** for typographic hierarchy.
58- **🛡️ Red Team Swarm**: Built-in adversarial protocols that kill "lazy" design defaults before they reach you.
59- **📜 Narrative Synthesis**: Forces AI to define a "Call to Adventure" and entry point for every page.
60- **🛠️ Multi-Assistant Native**: Tailored templates for Claude Code, Cursor, Windsurf, Antigravity, and Move.
61 
62---
63 
64## 🚀 Installation & Setup
65 
66### **1. Global CLI Install**
67```bash
68npm install -g design-skill-os
69```
70 
71### **2. Prime Your Assistant**
72Initialize the skill for your specific AI stack. This injects the "Brain" directly into your project's configuration.
73 
74```bash
75# General Setup
76design-skill init --ai claude      # Claude Code / CLI
77design-skill init --ai cursor      # Cursor IDE
78design-skill init --ai windsurf    # Windsurf
79design-skill init --ai antigravity # Antigravity (Elite)
80design-skill init --ai all         # Global System Sync
81```
82 
83### **3. Global Deployment (Recommended)**
84Available across all your projects without redundant initialization:
85```bash
86design-skill init --ai claude --global
87```
88 
89---
90 
91## 📖 The "Master Designer" Workflow
92 
93Once installed, your AI agent gains instant access to the **Design Skill OS** core. Just chat naturally:
94 
95> "Build a luxury watch landing page using the Design Skill OS rules. Ensure a Red Team check for color-blindness and narrative arc."
96 
97**The Resulting Workflow:**
981.  **Discovery**: AI maps brand personality using Section 17 rules.
992.  **Strategy**: Defines the layout using the **Gestalt Principles** (Section 2).
1003.  **Execution**: Generates high-fidelity code with CSS variables and semantic HTML.
1014.  **Red Team**: Runs the **Adversarial Audit** (Section 23) to fix contrast and trend-chasing.
102 
103---
104 
105## 📂 Architecture Overview
106 
107```text
108┌─────────────────────────────────────────────────────────────────┐
109│  CORE SYSTEM: Design Skill OS                                   │
110├─────────────────────────────────────────────────────────────────┤
111│  src/design-skill/                                              │
112│     ├── SKILL.md        <-- The "Brain" (Knowledge Base)        │
113│     ├── data/           <-- 161+ Industry Reasoning Rules       │
114│     ├── scripts/        <-- AI Search & Logic Engine            │
115│     └── templates/      <-- High-Fidelity UI Patterns           │
116├─────────────────────────────────────────────────────────────────┤
117│  cli/                   <-- Dynamic Deployment Engine           │
118└─────────────────────────────────────────────────────────────────┘
119```
120 
121---
122 
123## 🏆 Supported Industry Rules
124 
125| Category | High-Fidelity Focus |
126| :--- | :--- |
127| **SaaS & Tech** | Efficiency, Clarity, Developer Tooling |
128| **Fintech** | Trust, Precision, Data Density |
129| **Luxury & E-com** | Emotion, Elegance, Storytelling |
130| **Healthcare** | Accessibility, Calm, Information Hierarchy |
131| **Creative Arts** | Portfolios, Branding, Experimental UI |
132 
133---
134 
135## 🤝 Contributing & Support
136 
137We build for the future of AI-human collaboration.
138- **Stars** are our fuel. If this helps you build better, drop a ⭐.
139- **PRs** are welcome. See `CLAUDE.md` for the contributor's style guide.
140 
141---
142 
143## 📄 License
144 
145This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for the full text.
146 
147---
148 
149 
150<p align="center">
151  <i>"The details are not the details. They make the design." — Charles Eames</i><br><br>
152  <b>Built with ❤️</b>
153</p>
154