Design — Unified Routing Hub
One skill to load for any visual work. Routes to specialized sub-skills by task type.
Route Table
You're doing...
Load this skill
Path
Sourcing components (21st.dev, Magic UI, Aceternity)
component-craft
~/.pi/agent/skills/component-craft/SKILL.md
Creative aesthetics (distinctive look, avoid AI slop)
frontend-design
~/.pi/agent/skills/frontend-design/SKILL.md
Composition & theory (hierarchy, color, spacing, Gestalt)
ui-design
~/.pi/agent/skills/ui-design/SKILL.md
Pattern research (what do real apps do?)
ui-patterns
~/.pi/agent/skills/ui-patterns/SKILL.md
Mobile web (viewport, touch, fluid type, safe areas)
mobile-first
~/.pi/agent/skills/mobile-first/SKILL.md
Stock photos (search + verify, zero broken images)
unsplash
~/.pi/agent/skills/unsplash/SKILL.md
shadcn/ui (accessible primitives, MCP server)
shadcn-ui
~/.pi/agent/skills/shadcn-ui/SKILL.md
Static art (posters, PDF, PNG, visual philosophy)
canvas-design
~/.pi/agent/skills/canvas-design/SKILL.md
Photo search (multi-source: Serper, Unsplash, Pexels)
photo-finder
~/.pi/agent/skills/photo-finder/SKILL.md
Pixel editing (erase text/watermarks from existing images, fix logos)
image-edit
~/.pi/agent/skills/image-edit/SKILL.md
Лебедев review (бизнес-линч, brutal design critique with screenshots)
artemy
~/.pi/agent/skills/artemy/SKILL.md
Design audit (find where defaults leak through your brand)
design-audit
~/.pi/agent/skills/design-audit/SKILL.md
Workflows
Build a page from scratch
1. ui-patterns → Research: what do the best apps do for this type of page?
2. ui-design → Plan: composition, hierarchy, color palette, typography
3. component-craft → Source: grab premium components from 21st.dev / Magic UI
4. shadcn-ui → Foundation: accessible primitives (dialog, tabs, forms)
5. unsplash → Photos: search + verify stock images for visual sections
6. frontend-design → Execute: apply distinctive aesthetics, no generic AI look
7. mobile-first → Audit: touch targets, fluid type, viewport, safe areas
Redesign / improve existing UI
1. ui-design → Diagnose: what's wrong (hierarchy? spacing? color?)
2. ui-patterns → Compare: what do competitors/best-in-class do?
3. component-craft → Upgrade: replace plain cards with image-overlay, glass, etc.
4. frontend-design → Polish: distinctive touches (motion, typography, texture)
5. mobile-first → Verify: does it work on 390px? Touch targets? Fluid type?
Need photos for content
1. photo-finder → Search Unsplash/Pexels/Serper, verify every URL loads
Create visual art / poster / PDF
1. canvas-design → Full pipeline: philosophy → canvas → refinement
Edit an existing image (remove text, erase element, fix logo)
1. image-edit → Inspect background type, scan coordinates, erase with alpha
2. browser-testing → Verify result in actual browser (cache gotcha!)
3. canvas-design → If 2 attempts fail — recreate the asset cleanly
Get a brutal design review
1. artemy → Бизнес-линч: screenshots + Lebedev-style critique in Russian
Audit design consistency (post-sprint)
1. design-audit → Find 7 common leak patterns (black buttons, mixed accents, etc.)
2. visual-qa-loop → Batch fix all findings
Quick Reference: Design Principles
These are the core rules baked across all sub-skills. Internalize them.
Visual Hierarchy (from ui-design)
Scale = importance. Larger draws eye first.
Max 3 typographic levels visible at once.
60/30/10 color distribution (dominant/secondary/accent).
8px spacing rhythm: 4, 8, 16, 24, 32, 48, 64.
No AI Slop (from frontend-design)
❌ Inter/Roboto/Arial everywhere
❌ Purple gradients on white
❌ Cookie-cutter layouts
✅ Intentional font pairing (display + body)
✅ Dominant color with sharp accent
✅ One memorable design decision per page
Mobile Reality (from mobile-first)
100dvh not 100vh
Inputs ≥ 16px (prevents iOS zoom)
Touch targets ≥ 44px
clamp() for fluid type: clamp(1rem, 0.9rem + 0.5vw, 1.125rem)
touch-action: manipulation (kills 300ms delay)
Component Quality (from component-craft)
Image cards: gradient overlay from-black/70 via-black/30 to-transparent
Hover: group-hover:scale-105 transition-transform duration-700
Glass: bg-white/5 backdrop-blur-xl border border-white/10
Always loading="lazy" on images below fold
Always <img> (not Next.js <Image>) for external URLs
Photos (from unsplash)
Every URL must pass HEAD check before embedding
Unsplash: ?w=800&q=80&auto=format (controlled size, auto WebP)
Pexels: use src.large2x for cards
Re-verify before deploy — URLs can die
Decision: Which Libraries?
Project type → Library choice:
SaaS dashboard → shadcn/ui + Tailwind (sober, functional)
Marketing/landing → Aceternity UI + Magic UI (animated, impressive)
Travel/content site → component-craft patterns + unsplash (photo-rich)
Design system → shadcn/ui as base, customize everything
Creative portfolio → frontend-design skill (push boundaries)
Mobile-first app → shadcn/ui + mobile-first skill (practical)
Checklist Before Shipping
From ui-design + mobile-first combined:
Hierarchy : Obvious where to look first, 3 clear typographic levels
Contrast : ≥ 4.5:1 text, ≥ 3:1 UI elements
Touch targets : ≥ 44px with ≥ 8px gap
Fluid type : All text uses clamp(), no fixed px
Images verified : HEAD-checked, lazy-loaded, <img> for external
Hover states : No layout shift, 150–300ms transitions
Mobile tested : 375px, 390px, 768px, 1024px, 1440px
No scroll issues : overscroll-behavior: contain on scroll containers
Reduced motion : prefers-reduced-motion respected
No emojis : Use SVG icons (Lucide, Heroicons) for everything. Emojis are amateur hour — only acceptable for user-generated content or chat bubbles, never in designed UI.
Skill Overlap Report
Area
Primary Skill
Also In
Status
Color theory
ui-design
frontend-design (briefly)
✅ No conflict — ui-design = theory, frontend-design = application
Typography
ui-design (scale, pairing)
mobile-first (fluid clamp)
✅ Complementary
Component sourcing
component-craft
shadcn-ui
✅ component-craft = premium/animated, shadcn = foundation
Photo search
photo-finder
—
✅ Merged (was unsplash + photo-finder)
Patterns
ui-patterns
component-craft
✅ ui-patterns = research/exploration, component-craft = implementation
Accessibility
shadcn-ui
ui-design (contrast checks)
✅ shadcn = baked-in a11y, ui-design = checklist
Mobile
mobile-first
ui-design (responsive checklist)
✅ mobile-first = deep technical, ui-design = high-level
Aesthetics
frontend-design
canvas-design
✅ frontend-design = web code, canvas-design = static art
1 --- 2 name: design 3 description: Unified design hub — routes to the right sub-skill for any visual/UI/UX task. Covers: component sourcing, aesthetics, composition, patterns, mobile, photos, canvas art, shadcn. Load this when doing any design work. 4 --- 5 6 # Design — Unified Routing Hub 7 8 One skill to load for any visual work. Routes to specialized sub-skills by task type. 9 10 ## Route Table 11 12 | You're doing... | Load this skill | Path | 13 |-----------------|----------------|------| 14 | **Sourcing components** (21st.dev, Magic UI, Aceternity) | `component-craft` | `~/.pi/agent/skills/component-craft/SKILL.md` | 15 | **Creative aesthetics** (distinctive look, avoid AI slop) | `frontend-design` | `~/.pi/agent/skills/frontend-design/SKILL.md` | 16 | **Composition & theory** (hierarchy, color, spacing, Gestalt) | `ui-design` | `~/.pi/agent/skills/ui-design/SKILL.md` | 17 | **Pattern research** (what do real apps do?) | `ui-patterns` | `~/.pi/agent/skills/ui-patterns/SKILL.md` | 18 | **Mobile web** (viewport, touch, fluid type, safe areas) | `mobile-first` | `~/.pi/agent/skills/mobile-first/SKILL.md` | 19 | **Stock photos** (search + verify, zero broken images) | `unsplash` | `~/.pi/agent/skills/unsplash/SKILL.md` | 20 | **shadcn/ui** (accessible primitives, MCP server) | `shadcn-ui` | `~/.pi/agent/skills/shadcn-ui/SKILL.md` | 21 | **Static art** (posters, PDF, PNG, visual philosophy) | `canvas-design` | `~/.pi/agent/skills/canvas-design/SKILL.md` | 22 | **Photo search** (multi-source: Serper, Unsplash, Pexels) | `photo-finder` | `~/.pi/agent/skills/photo-finder/SKILL.md` | 23 | **Pixel editing** (erase text/watermarks from existing images, fix logos) | `image-edit` | `~/.pi/agent/skills/image-edit/SKILL.md` | 24 | **Лебедев review** (бизнес-линч, brutal design critique with screenshots) | `artemy` | `~/.pi/agent/skills/artemy/SKILL.md` | 25 | **Design audit** (find where defaults leak through your brand) | `design-audit` | `~/.pi/agent/skills/design-audit/SKILL.md` | 26 27 --- 28 29 ## Workflows 30 31 ### Build a page from scratch 32 ``` 33 1. ui-patterns → Research: what do the best apps do for this type of page? 34 2. ui-design → Plan: composition, hierarchy, color palette, typography 35 3. component-craft → Source: grab premium components from 21st.dev / Magic UI 36 4. shadcn-ui → Foundation: accessible primitives (dialog, tabs, forms) 37 5. unsplash → Photos: search + verify stock images for visual sections 38 6. frontend-design → Execute: apply distinctive aesthetics, no generic AI look 39 7. mobile-first → Audit: touch targets, fluid type, viewport, safe areas 40 ``` 41 42 ### Redesign / improve existing UI 43 ``` 44 1. ui-design → Diagnose: what's wrong (hierarchy? spacing? color?) 45 2. ui-patterns → Compare: what do competitors/best-in-class do? 46 3. component-craft → Upgrade: replace plain cards with image-overlay, glass, etc. 47 4. frontend-design → Polish: distinctive touches (motion, typography, texture) 48 5. mobile-first → Verify: does it work on 390px? Touch targets? Fluid type? 49 ``` 50 51 ### Need photos for content 52 ``` 53 1. photo-finder → Search Unsplash/Pexels/Serper, verify every URL loads 54 ``` 55 56 ### Create visual art / poster / PDF 57 ``` 58 1. canvas-design → Full pipeline: philosophy → canvas → refinement 59 ``` 60 61 ### Edit an existing image (remove text, erase element, fix logo) 62 ``` 63 1. image-edit → Inspect background type, scan coordinates, erase with alpha 64 2. browser-testing → Verify result in actual browser (cache gotcha!) 65 3. canvas-design → If 2 attempts fail — recreate the asset cleanly 66 ``` 67 68 ### Get a brutal design review 69 ``` 70 1. artemy → Бизнес-линч: screenshots + Lebedev-style critique in Russian 71 ``` 72 73 ### Audit design consistency (post-sprint) 74 ``` 75 1. design-audit → Find 7 common leak patterns (black buttons, mixed accents, etc.) 76 2. visual-qa-loop → Batch fix all findings 77 ``` 78 79 --- 80 81 ## Quick Reference: Design Principles 82 83 These are the core rules baked across all sub-skills. Internalize them. 84 85 ### Visual Hierarchy (from `ui-design`) 86 - **Scale** = importance. Larger draws eye first. 87 - Max 3 typographic levels visible at once. 88 - 60/30/10 color distribution (dominant/secondary/accent). 89 - 8px spacing rhythm: 4, 8, 16, 24, 32, 48, 64. 90 91 ### No AI Slop (from `frontend-design`) 92 - ❌ Inter/Roboto/Arial everywhere 93 - ❌ Purple gradients on white 94 - ❌ Cookie-cutter layouts 95 - ✅ Intentional font pairing (display + body) 96 - ✅ Dominant color with sharp accent 97 - ✅ One memorable design decision per page 98 99 ### Mobile Reality (from `mobile-first`) 100 - `100dvh` not `100vh` 101 - Inputs ≥ 16px (prevents iOS zoom) 102 - Touch targets ≥ 44px 103 - `clamp()` for fluid type: `clamp(1rem, 0.9rem + 0.5vw, 1.125rem)` 104 - `touch-action: manipulation` (kills 300ms delay) 105 106 ### Component Quality (from `component-craft`) 107 - Image cards: gradient overlay `from-black/70 via-black/30 to-transparent` 108 - Hover: `group-hover:scale-105 transition-transform duration-700` 109 - Glass: `bg-white/5 backdrop-blur-xl border border-white/10` 110 - Always `loading="lazy"` on images below fold 111 - Always `<img>` (not Next.js `<Image>`) for external URLs 112 113 ### Photos (from `unsplash`) 114 - Every URL must pass HEAD check before embedding 115 - Unsplash: `?w=800&q=80&auto=format` (controlled size, auto WebP) 116 - Pexels: use `src.large2x` for cards 117 - Re-verify before deploy — URLs can die 118 119 --- 120 121 ## Decision: Which Libraries? 122 123 ``` 124 Project type → Library choice: 125 126 SaaS dashboard → shadcn/ui + Tailwind (sober, functional) 127 Marketing/landing → Aceternity UI + Magic UI (animated, impressive) 128 Travel/content site → component-craft patterns + unsplash (photo-rich) 129 Design system → shadcn/ui as base, customize everything 130 Creative portfolio → frontend-design skill (push boundaries) 131 Mobile-first app → shadcn/ui + mobile-first skill (practical) 132 ``` 133 134 --- 135 136 ## Checklist Before Shipping 137 138 From `ui-design` + `mobile-first` combined: 139 140 - [ ] **Hierarchy**: Obvious where to look first, 3 clear typographic levels 141 - [ ] **Contrast**: ≥ 4.5:1 text, ≥ 3:1 UI elements 142 - [ ] **Touch targets**: ≥ 44px with ≥ 8px gap 143 - [ ] **Fluid type**: All text uses `clamp()`, no fixed px 144 - [ ] **Images verified**: HEAD-checked, lazy-loaded, `<img>` for external 145 - [ ] **Hover states**: No layout shift, 150–300ms transitions 146 - [ ] **Mobile tested**: 375px, 390px, 768px, 1024px, 1440px 147 - [ ] **No scroll issues**: `overscroll-behavior: contain` on scroll containers 148 - [ ] **Reduced motion**: `prefers-reduced-motion` respected 149 - [ ] **No emojis**: Use SVG icons (Lucide, Heroicons) for everything. Emojis are amateur hour — only acceptable for user-generated content or chat bubbles, never in designed UI. 150 151 --- 152 153 ## Skill Overlap Report 154 155 | Area | Primary Skill | Also In | Status | 156 |------|--------------|---------|--------| 157 | Color theory | `ui-design` | `frontend-design` (briefly) | ✅ No conflict — ui-design = theory, frontend-design = application | 158 | Typography | `ui-design` (scale, pairing) | `mobile-first` (fluid clamp) | ✅ Complementary | 159 | Component sourcing | `component-craft` | `shadcn-ui` | ✅ component-craft = premium/animated, shadcn = foundation | 160 | Photo search | `photo-finder` | — | ✅ Merged (was unsplash + photo-finder) | 161 | Patterns | `ui-patterns` | `component-craft` | ✅ ui-patterns = research/exploration, component-craft = implementation | 162 | Accessibility | `shadcn-ui` | `ui-design` (contrast checks) | ✅ shadcn = baked-in a11y, ui-design = checklist | 163 | Mobile | `mobile-first` | `ui-design` (responsive checklist) | ✅ mobile-first = deep technical, ui-design = high-level | 164 | Aesthetics | `frontend-design` | `canvas-design` | ✅ frontend-design = web code, canvas-design = static art |