KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

design-skill-os

★ 42 Open GitHub ↗

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."

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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 GitHub Copilot.

---

## 🚀 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 copilot     # GitHub Copilot (repo-local .github/skills/design-skill-os + .github/copilot-instructions.md)
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
```

> Note: `--global` is not supported for `copilot`; use local repo install.

---

## 📖 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

---

## 🤝 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 ❤️

design-skill-os

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README