design-mastery — Claude Code plugin: what it does, how to install
design-mastery is a Claude Code plugin that applies established design principles to UI work. It supports layout analysis, design audits, style guides, and brand identity tasks.
MIT ★ 126 updated 2026-10-04
/plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code
/plugin install design-mastery@libreuiuxWhat design-mastery does
The plugin examines interface work through visual hierarchy, typography, color theory, composition, and Gestalt principles. Its guidance draws on designers such as Saul Bass, Massimo Vignelli, and Dieter Rams, along with movements including Bauhaus and Swiss design.
Workflows cover design audits, style guides, and brand identity. Run /design-audit, /style-guide, or /brand-identity for those tasks; prompts to @design-master can ask for layout analysis or a grid suggestion. The listed WCAG text contrast thresholds are 4.5:1 for AA and 7:1 for AAA.
What it helps with
- inspect a layout's visual hierarchy
- choose a type pairing for an interface
- build a color system and spacing scale
- review a component against design principles
- develop a brand identity
Example prompts for the agent
- Audit this component against design principles with
/design-audit. - Create a brand style guide with a color system and typography using
/style-guide. - Suggest a grid for this dashboard and apply visual hierarchy principles with
@design-master.
How to install design-mastery
Plugin marketplace
/plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code/plugin install design-mastery@libreuiuxStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about design-mastery
How do I install design-mastery in Claude Code?
Run these commands in order: /plugin marketplace add Ormus-Solutions/LibreUIUX-Claude-Code, then /plugin install design-mastery@libreuiux.
What does design-mastery do?
It applies principles of composition, typography, color, and Gestalt to UI work. Its workflows cover design audits, style guides, and brand identity.
Which designers and movements inform design-mastery?
The plugin draws on Saul Bass, Massimo Vignelli, and Dieter Rams, as well as Bauhaus and Swiss design.
Source text
design-mastery · MIT
# Design Mastery Plugin
> Timeless design principles from legendary designers and historic movements for modern UI/UX.
**Design Mastery** provides:
- **Timeless Principles** → Visual hierarchy, typography, color theory, composition, Gestalt
- **Legendary Designers** → Wisdom from Bass, Vignelli, Rams, Scher, Müller-Brockmann
- **Design Movements** → Bauhaus, Swiss International Style, Art Deco, Memphis, Minimalism
**Result**: UI/UX grounded in centuries of design excellence, not fleeting trends.
---
## Quick Start
### Apply Design Principles
```
@design-master analyze this layout and apply timeless principles
@design-master refine typography using golden ratio
@design-master suggest grid system for this dashboard
```
### Generate Style Guide
```
/style-guide create comprehensive style guide for brand
→ Generates: color system, typography scale, spacing, components
```
### Audit Existing Design
```
/design-audit analyze this component for design principles
→ Returns: strengths, weaknesses, specific improvements
```
### Create Brand Identity
```
/brand-identity develop brand system for [company]
→ Generates: brand strategy, visual identity, design system
```
---
## The Philosophy
> "Design is not just what it looks like and feels like. Design is how it works." — Steve Jobs
Great design emerges from the intersection of:
- **Function**: Solving real problems for real people
- **Form**: Visual beauty that serves communication
- **Feeling**: Emotional resonance that creates connection
- **Fundamentals**: Time-tested principles that transcend trends
---
## The 5 Design Master Toolkits
### 1. Visual Hierarchy
**Purpose**: Guide the eye through intentional composition
- **Scale**: Size relationships establish importance (golden ratio 1:1.618, major thirds)
- **Contrast**: Light/dark, thick/thin, curved/angular create focal points
- **Position**: F-pattern (reading), Z-pattern (scanning) for optimal attention
- **Density**: Strategic whitespace for breathing room and emphasis
- **Color**: Hue, saturation, brightness to guide the eye
**Example**:
```tailwind
<!-- Golden Ratio Scale -->
Display: text-7xl (72px)
Title: text-3xl (30px) [2.4:1 ratio]
Body: text-base (16px) [1.875:1 ratio]
```
---
### 2. Typography Excellence
**Purpose**: Type as voice, hierarchy as conversation
- **Pairing**: Contrast without conflict (serif + sans, geometric + humanist)
- **Hierarchy**: Display → Title → Body → Caption with clear purpose
- **Rhythm**: Consistent vertical spacing (4px/8px baseline grid)
- **Legibility**: Optimal line length (45-75 characters), adequate leading
- **Expression**: What does this font *say*?
**Example**:
```tailwind
<!-- Vignelli-inspired pairing -->
Heading: font-serif text-3xl font-light tracking-tight
Body: font-sans text-base leading-relaxed
```
---
### 3. Color Theory Application
**Purpose**: Color as communication, psychology as strategy
- **60-30-10 Rule**: Dominant (60%), secondary (30%), accent (10%) proportions
- **Psychological Impact**: Blue=trust, red=urgency, green=growth, purple=luxury
- **Accessibility**: WCAG contrast ratios (AA: 4.5:1 text, AAA: 7:1 text)
- **Harmony**: Complementary, analogous, triadic schemes with intention
- **Context**: Same color reads differently in different environments
**Example**:
```css
/* 60-30-10 Application */
--dominant: #f3f4f6; /* 60% - backgrounds */
--secondary: #1f2937; /* 30% - content areas */
--accent: #3b82f6; /* 10% - CTAs, highlights */
```
---
### 4. Composition & Layout
**Purpose**: Mathematical harmony creating visual balance
- **Rule of Thirds**: Divide canvas into 9 sections for natural balance
- **Golden Ratio**: 1:1.618 proportions found throughout nature and art
- **Grid Systems**: Swiss-style 12-column for predictable, harmonious layouts
- **Negative Space**: What you leave out is as important as what you include
- **Visual Weight**: Balance elements by size, color, complexity, position
**Example**:
```tailwind
<!-- Swiss 12-column grid -->
<div class="grid grid-cols-12 gap-8">
<aside class="col-span-3">Sidebar</aside>
<main class="col-span-9">Content</main>
</div>
```
---
### 5. Gestalt Principles
**Purpose**: How the mind perceives visual relationships
- **Proximity**: Elements near each other appear related
- **Similarity**: Elements that look alike appear grouped
- **Continuity**: The eye follows smooth paths
- **Closure**: The mind completes incomplete shapes
- **Figure/Ground**: Clear separation between subject and background
**Example**:
```tailwind
<!-- Proximity grouping -->
<div class="space-y-8"> <!-- Large gap between sections -->
<section class="space-y-2"> <!-- Small gap within section -->
<h2>Related Heading</h2>
<p>Related content stays together</p>
</section>
</div>
```
---
## The 5 Design Masters
### Saul Bass (1920-1996)
> "Design is thinking made visual."
**Legacy**: Film title sequences, corporate identity (AT&T, United Airlines, Hitchcock films)
**Core Lesson**: Simplicity is sophisticated
**Apply His Wisdom**:
- A logo should be so simple a child can draw it from memory
- Reduce to essentials - what can you remove?
- Bold, memorable shapes over complex decoration
**Example**:
```tailwind
<!-- Bass-inspired simplicity -->
<div class="border-l-4 border-blue-600 pl-4">
Simple, bold, memorable
</div>
```
📖 **Full profile**: [`skills/design-masters/references/saul-bass.md`](skills/design-masters/references/saul-bass.md)
---
### Massimo Vignelli (1931-2014)
> "If you can design one thing, you can design everything."
**Legacy**: NYC Subway map, American Airlines, Vignelli Canon
**Core Lesson**: Constraints liberate creativity
**Apply His Wisdom**:
- A few basic typefaces (his exhibition "A Few Basic Typefaces" used only four) - restraint breeds excellence
- Strict grids create freedom within structure
- Clarity over geographic accuracy (prioritize communication)
**Example**:
```css
/* Vignelli Canon: Limited, precise palette */
--font-display: 'Bodoni';
--font-body: 'Helvetica';
--font-mono: 'Courier';
/* That's it. No more fonts. */
```
**Full profile**: [`skills/design-masters/references/massimo-vignelli.md`](skills/design-masters/references/massimo-vignelli.md)
---
### Dieter Rams (1932-)
> "Good design is as little design as possible."
**Legacy**: Braun products, 10 Principles of Good Design, Apple's inspiration
**Core Lesson**: Remove the unnecessary until only the essential remains
**10 Principles**:
1. Innovative
2. Makes product useful
3. Aesthetic
4. Makes product understandable
5. Unobtrusive
6. Honest
7. Long-lasting
8. Thorough down to last detail
9. Environmentally friendly
10. As little design as possible
**Example**:
```tailwind
<!-- Rams-inspired minimalism -->
<button class="bg-gray-900 text-white px-4 py-2 rounded">
<!-- No gradients, shadows, or effects. Pure function. -->
Submit
</button>
```
**Full profile**: [`skills/design-masters/references/dieter-rams.md`](skills/design-masters/references/dieter-rams.md)
---
### Paula Scher (1948-)
> "It's through mistakes that you actually can grow."
**Legacy**: Pentagram partner, Public Theater identity, bold typography
**Core Lesson**: Break rules intentionally, knowing what you're breaking and why
**Apply Her Wisdom**:
- Bold, expressive typography as primary visual element
- Fearless experimentation with scale and placement
- Typography can carry entire visual identity
**Example**:
```tailwind
<!-- Scher-inspired bold typography -->
<h1 class="text-9xl font-black leading-none -tracking-wide">
BOLD
</h1>
```
**Full profile**: [`skills/design-masters/references/paula-scher.md`](skills/design-masters/references/paula-scher.md)
---
### Josef Müller-Brockmann (1914-1996)
> "The grid system is an aid, not a guarantee."
**Legacy**: A leading figure of the Swiss International Style, mathematical precision
**Core Lesson**: Grids create order, but knowing when to break them creates art
**Apply His Wisdom**:
- Use grids for 95% of layouts (predictable, harmonious)
- Break grid intentionally for emphasis (5% moments)
- Mathematical precision serving communication
**Example**:
```tailwind
<!-- Müller-Brockmann grid precision -->
<div class="grid grid-cols-12 gap-4">
<!-- 11 columns follow grid -->
<div class="col-span-11">Content</div>
<!-- 1 column breaks grid for emphasis -->
<div class="col-span-1 -rotate-90">Break</div>
</div>
```
**Full profile**: [`skills/design-masters/references/josef-muller-brockmann.md`](skills/design-masters/references/josef-muller-brockmann.md)
---
More masters (David Carson, Paul Rand) and every movement, principle, and brand topic have their own reference files in `skills/*/references/`; the skills load them when a task needs depth.
## The 5 Design Movements
### Bauhaus (1919-1933)
**Core Principle**: Form follows function
**Visual Markers**: Primary colors, geometric shapes, sans-serif type
**Apply It**: Strip ornament; let structure be the beauty
**Example**:
```tailwind
<div class="bg-red-600 w-24 h-24"><!-- Pure red square -->
<div class="bg-blue-600 w-24 h-24 rounded-full"><!-- Pure blue circle -->
```
📖 **Full movement**: [`skills/design-movements/SKILL.md`](skills/design-movements/SKILL.md)
---
### Swiss International Style (1950s-1960s)
**Core Principle**: Clarity through grid and restraint
**Visual Markers**: Helvetica, asymmetric layouts, objective photography
**Apply It**: Let the content breathe; invisible design is successful design
**Example**:
```tailwind
<!-- Swiss precision -->
<div class="grid grid-cols-3 gap-8 font-['Helvetica']">
Clarity. Precision. Grid.
</div>
```
---
### Art Deco (1920s-1930s)
**Core Principle**: Luxury through geometry
**Visual Markers**: Sunbursts, stepped forms, metallic accents, bold symmetry
**Apply It**: Celebrate craft; geometric precision can feel opulent
**Example**:
```tailwind
<!-- Art Deco stepped form -->
<div class="space-y-2">
<div class="h-4 w-32 bg-amber-600"></div>
<div class="h-4 w-24 bg-amber-600"></div>
<div class="h-4 w-16 bg-amber-600"></div>
</div>
```
---
### Memphis Group (1980s)
**Core Principle**: Rebel against minimalism with joy
**Visual Markers**: Squiggles, bold patterns, clashing colors, playful asymmetry
**Apply It**: Not everything needs to be serious; design can delight
**Example**:
```tailwind
<!-- Memphis playfulness -->
<div class="bg-gradient-to-r from-pink-500 via-yellow-400 to-cyan-500
rotate-2 border-4 border-black">
Joy!
</div>
```
---
### Minimalism (1960s-present)
**Core Principle**: Less, but better
**Visual Markers**: Whitespace, limited palette, essential elements only
**Apply It**: Every element must earn its place
**Example**:
```tailwind
<!-- Pure minimalism -->
<div class="max-w-prose mx-auto space-y-8 py-16">
<h1 class="text-4xl">Headline</h1>
<p class="text-base leading-loose">Content</p>
</div>
```
---
## Plugin Structure
```
design-mastery/
├── README.md # This file
├── .claude-plugin/plugin.json
│
├── skills/ # Knowledge base
│ ├── design-principles/
│ │ ├── SKILL.md # 5 toolkits
│ │ ├── assets/
│ │ │ └── principles-checklist.md
│ │ └── references/ # gestalt, hierarchy, composition, color, typography
│ ├── design-masters/
│ │ ├── SKILL.md # legendary designers
│ │ └── references/ # Bass, Vignelli, Rams, Scher, Müller-Brockmann, Carson, Rand
│ ├── design-movements/
│ │ ├── SKILL.md # historic movements
│ │ └── references/ # one file per movement, Arts and Crafts to flat design
│ ├── brand-systems/
│ │ ├── SKILL.md # Brand strategy & systems
│ │ ├── assets/
│ │ │ └── brand-canvas-template.md
│ │ └── references/ # logo, palettes, type pairing, voice
│ └── premium-saas-design/
│ └── SKILL.md # Define, Build, Review, Refine loop
│
├── commands/ # Slash commands
│ ├── style-guide.md # Generate style guides
│ ├── design-audit.md # Audit existing designs
│ ├── brand-identity.md # Create brand systems
│ └── premium-landing.md # Premium SaaS landing pages
│
├── agents/ # Specialist agents
│ ├── design-master.md # Timeless principles expert
│ ├── visual-historian.md # Movement & history expert
│ └── brand-architect.md # Brand strategy expert
│
└── evals/ # cases for `claude plugin eval plugins/design-mastery`
```
---
## Usage Examples
### Example 1: Typography Scale
```
@design-master create typography scale using golden ratio
Response:
- Display: 72px (hero headers)
- H1: 45px [1.6:1 ratio]
- H2: 28px [1.6:1 ratio]
- Body: 16px [1.75:1 ratio]
- Caption: 12px [1.33:1 ratio]
Rationale: Golden ratio (1.618) creates natural harmony...
```
### Example 2: Layout Audit
```
/design-audit analyze this dashboard layout
Response:
Strengths:
- Clear grid system (Swiss influence)
- Good use of whitespace
Weaknesses:
- Typography lacks hierarchy (all same size)
- Color doesn't follow 60-30-10 rule
Recommendations:
1. Apply golden ratio to typography (see scale above)
2. Redistribute colors: 60% gray-50, 30% white, 10% blue-600
3. Reference: Vignelli's restraint + Rams' minimalism
```
### Example 3: Brand System
```
/brand-identity create brand system for sustainable fashion startup
Generates:
- Brand Strategy (archetype, values, voice)
- Color System (60-30-10 applied)
- Typography Hierarchy
- Grid System
- Component Library Foundation
- Usage Guidelines
References: Bauhaus (form/function), Minimalism (restraint)
```
---
## When to Use This Plugin
### Perfect For:
- ✅ Establishing timeless design foundations
- ✅ Auditing existing designs for improvement
- ✅ Creating comprehensive style guides
- ✅ Learning why design works (not just what looks good)
- ✅ Building design systems from first principles
- ✅ Avoiding trendy designs that age poorly
### Combines Well With:
- **archetypal-alchemy** - Add psychological meaning to timeless structure
- **accessibility-compliance** - Ensure principles include all users
- **performance-optimization** - Beautiful AND fast
---
## Philosophy
### Why Study the Masters?
**Trends fade. Principles endure.**
- Saul Bass's work from 1960 still looks modern today
- Vignelli's subway map from 1972 remains the standard
- Rams' principles from 1980 inspired Apple's entire aesthetic
**The masters discovered patterns that transcend time.**
When you apply Bass's simplicity + Vignelli's grid + Rams' restraint, you create designs that won't look dated in 10 years.
### Timeless vs. Trendy
**Trendy** (ages poorly):
- Excessive gradients and shadows
- Overly decorative fonts
- Skeuomorphism taken too far
- Following every new CSS trick
**Timeless** (ages well):
- Strong visual hierarchy
- Mathematical typography scales
- Purposeful use of color
- Grid-based layouts
- Generous whitespace
---
## Contributing
### We Welcome:
- Additional design master profiles (Rand, Chermayeff, Bierut)
- More movement deep-dives (Constructivism, De Stijl, Postmodern)
- Real-world applications of principles
- Before/after examples showing transformations
### How to Contribute:
1. Study the existing master profiles for format
2. Focus on *why* principles work, not just *what* they are
3. Provide Tailwind/modern CSS examples
4. Reference primary sources (books, interviews, portfolios)
---
## Resources
### Books
- **Vignelli Canon** - Massimo Vignelli (free PDF)
- **Man and His Symbols** - Carl Jung (psychology of design)
- **Thinking with Type** - Ellen Lupton
- **The Elements of Typographic Style** - Robert Bringhurst
- **Grid Systems** - Josef Müller-Brockmann
### Online
- [Design Principles](https://principles.design/)
- [Awwwards](https://www.awwwards.com/) - Excellence in web design
- [Swiss Style Today](https://www.swissstyletoday.com/)
---
## License
Part of the LibreUIUX project - MIT License
---
*"Design is not decoration. It is communication. Every choice—color, type, space, shape—carries meaning. Make your meanings intentional."*
🎨 **Begin your design mastery**: `@design-master analyze my layout`
© Diego Bodart · MIT · Ormus-Solutions/LibreUIUX-Claude-Code