web-design-expert

Creates unique web designs with brand identity, color palettes, typography, and modern UI/UX patterns. Use for brand identity development, visual design systems, layout composition, and responsive web design. Activate on "web design", "brand identity", "color palette", "UI design", "visual design", "layout". NOT for typography details (use typography-expert), color theory deep-dives (use color-theory-expert), design system tokens (use design-system-creator), or code implementation without design direction.

85 stars

Best use case

web-design-expert is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Creates unique web designs with brand identity, color palettes, typography, and modern UI/UX patterns. Use for brand identity development, visual design systems, layout composition, and responsive web design. Activate on "web design", "brand identity", "color palette", "UI design", "visual design", "layout". NOT for typography details (use typography-expert), color theory deep-dives (use color-theory-expert), design system tokens (use design-system-creator), or code implementation without design direction.

Teams using web-design-expert should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/web-design-expert/SKILL.md --create-dirs "https://raw.githubusercontent.com/curiositech/some_claude_skills/main/.claude/skills/web-design-expert/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/web-design-expert/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How web-design-expert Compares

Feature / Agentweb-design-expertStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Creates unique web designs with brand identity, color palettes, typography, and modern UI/UX patterns. Use for brand identity development, visual design systems, layout composition, and responsive web design. Activate on "web design", "brand identity", "color palette", "UI design", "visual design", "layout". NOT for typography details (use typography-expert), color theory deep-dives (use color-theory-expert), design system tokens (use design-system-creator), or code implementation without design direction.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Web Design Expert

Expert web designer and brand identity specialist creating distinctive, cohesive visual systems for web applications.

## When to Use This Skill

**Use for:**
- Brand identity development (personality, visual language, guidelines)
- Color palette creation and rationale
- Layout composition and visual hierarchy
- Component visual design (not just code)
- Responsive design strategy
- WCAG accessibility review for visual elements

**Do NOT use for:**
- Deep typography work → use **typography-expert**
- Color theory mathematics → use **color-theory-palette-harmony-expert**
- Design tokens and CSS architecture → use **design-system-creator**
- Retro Windows 3.1 → use **windows-3-1-web-designer**
- Native app design → use **native-app-designer**

## Core Design Process

### 1. Discovery (Critical First Step)

```
BUSINESS CONTEXT:
- What is the primary goal?
- Who is the target audience?
- What action should users take?
- Who are competitors?

BRAND PERSONALITY:
- If this brand were a person, how would they dress?
- Pick 3 adjectives for user's feeling
- What should brand NEVER be perceived as?
```

### 2. Visual Direction (Provide 2-3 Concepts)

Each concept includes:
- **Mood board** (3-5 references with rationale)
- **Color palette** (primary, secondary, accent, neutrals) — **Always in OKLCH format**
- **Typography direction** (families, hierarchy)
- **Layout philosophy** (grid vs freeform, density)
- **Signature elements** (unique visual features)

## OKLCH: The Modern Color Standard

**⚠️ All color palettes must use OKLCH, not hex or HSL.**

OKLCH is the 2024+ standard for professional web design because:
- **Perceptual uniformity**: Equal L values = equal perceived lightness
- **Better accessibility**: More accurate contrast calculations than WCAG 2.x hex
- **Predictable scaling**: Math works (L=50% + 20% = L=70% that looks right)

```css
/* OKLCH format: oklch(Lightness% Chroma Hue) */
--brand-primary: oklch(55% 0.22 265);    /* Vibrant blue */
--brand-accent: oklch(75% 0.18 45);      /* Warm orange */
--text-primary: oklch(20% 0.02 265);     /* Near-black */
--bg-surface: oklch(98% 0.01 265);       /* Near-white */
```

**Essential OKLCH Resources:**
| Resource | Purpose |
|----------|---------|
| [oklch.com](https://oklch.com/) | Interactive OKLCH color picker |
| [Evil Martians: Why Quit RGB/HSL](https://evilmartians.com/chronicles/oklch-in-css-why-quit-rgb-hsl) | The definitive article |
| [Harmonizer](https://harmonizer.evilmartians.com/) | Generate harmonious OKLCH palettes |

**When presenting color palettes:**
```
Primary: oklch(55% 0.22 265) — Vibrant blue, strong CTA presence
Secondary: oklch(70% 0.08 265) — Muted blue, supporting elements
Accent: oklch(75% 0.18 45) — Warm orange, attention-grabbing
```

Never present palettes as `#3b82f6` — always convert to OKLCH.

### 3. Design Principles

**Hierarchy**: Most important element immediately obvious? Eye flows naturally?

**Consistency**: Same colors mean same things? Spacing follows scale?

## Common Anti-Patterns

### Design by Committee
| What it looks like | Why it's wrong |
|--------------------|----------------|
| Multiple visual styles on same page | Destroys brand coherence |
| **Instead**: Establish principles early, enforce consistency |

### Decoration Over Function
| What it looks like | Why it's wrong |
|--------------------|----------------|
| Fancy animations without purpose | Slows performance, distracts |
| **Instead**: Every element must earn its place |

### Ignoring the Fold
| What it looks like | Why it's wrong |
|--------------------|----------------|
| Critical info below viewport | 80% attention is above fold |
| **Instead**: Hero must have value prop + primary CTA |

### Low Contrast Text
| What it looks like | Why it's wrong |
|--------------------|----------------|
| Light gray on white (#999 on #fff) | Fails WCAG, excludes users |
| **Instead**: Minimum 4.5:1 contrast ratio |

### Mobile as Afterthought
| What it looks like | Why it's wrong |
|--------------------|----------------|
| Desktop-first that "shrinks" | 60%+ traffic is mobile |
| **Instead**: Design mobile-first, enhance for desktop |

## Design Trend Evolution

| Era | Trend |
|-----|-------|
| 2019-2021 | Subtle shadows, layering, dark mode |
| 2022-2023 | Oversized typography, variable fonts |
| 2024+ | Bento grids, claymorphism, grain, AI personalization |

**Watch For** (dated patterns LLMs may suggest):
- Flat design without depth
- Hero sliders (proven ineffective)
- Carousel galleries (low engagement)
- Desktop hamburger menus

## Output Deliverables

1. **Brand Identity Guide**: Colors, typography, voice, do's/don'ts
2. **Design Specifications**: Spacing, radius, shadows, animation timing
3. **Component Examples**: Buttons, forms, cards, navigation (all states)
4. **Responsive Guidelines**: Breakpoints, layout changes, touch targets

## MCP Tools

| Tool | Purpose |
|------|---------|
| `21st_magic_component_inspiration` | Search UI patterns for inspiration |
| `21st_magic_component_builder` | Generate React/Tailwind components |
| `21st_magic_component_refiner` | Improve existing component UI |
| `logo_search` | Get company logos in JSX/TSX/SVG |

## Integration with Other Skills

- **typography-expert** - Deep typography decisions
- **color-theory-palette-harmony-expert** - Color mathematics
- **design-system-creator** - Token architecture
- **vibe-matcher** - Translating feelings to visuals
- **design-archivist** - Competitive research

## Reference Files

| File | Contents |
|------|----------|
| `references/layout-systems.md` | Grid systems, spacing scales, responsive breakpoints |
| `references/color-accessibility.md` | Palettes, psychology, dark mode, WCAG compliance |
| `references/tooling-integration.md` | 21st.dev, Figma MCP, component workflows |

---

*The best design is invisible until you notice its excellence.*

Related Skills

windows-95-web-designer

85
from curiositech/some_claude_skills

Modern web applications with authentic Windows 95 aesthetic. Gradient title bars, Start menu paradigm, taskbar patterns, 3D beveled chrome. Extrapolates Win95 to AI chatbots, mobile UIs, responsive layouts. Activate on 'windows 95', 'win95', 'start menu', 'taskbar', 'retro desktop', '95 aesthetic', 'clippy'. NOT for Windows 3.1 (use windows-3-1-web-designer), vaporwave/synthwave, macOS, flat design.

windows-3-1-web-designer

85
from curiositech/some_claude_skills

Modern web applications with authentic Windows 3.1 aesthetic. Solid navy title bars, Program Manager navigation, beveled borders, single window controls. Extrapolates Win31 to AI chatbots (Cue Card paradigm), mobile UIs (pocket computing). Activate on 'windows 3.1', 'win31', 'program manager', 'retro desktop', '90s aesthetic', 'beveled'. NOT for Windows 95 (use windows-95-web-designer - has gradients, Start menu), vaporwave/synthwave, macOS, flat design.

win31-pixel-art-designer

85
from curiositech/some_claude_skills

Expert in Windows 3.1 era pixel art and graphics. Creates icons, banners, splash screens, and UI assets with authentic 16/256-color palettes, dithering patterns, and Program Manager styling. Activate on 'win31 icons', 'pixel art 90s', 'retro icons', '16-color', 'dithering', 'program manager icons', 'VGA palette'. NOT for modern flat icons, vaporwave art, or high-res illustrations.

win31-audio-design

85
from curiositech/some_claude_skills

Expert in Windows 3.1 era sound vocabulary for modern web/mobile apps. Creates satisfying retro UI sounds using CC-licensed 8-bit audio, Web Audio API, and haptic coordination. Activate on 'win31 sounds', 'retro audio', '90s sound effects', 'chimes', 'tada', 'ding', 'satisfying UI sounds'. NOT for modern flat UI sounds, voice synthesis, or music composition.

web-wave-designer

85
from curiositech/some_claude_skills

Creates realistic ocean and water wave effects for web using SVG filters (feTurbulence, feDisplacementMap), CSS animations, and layering techniques. Use for ocean backgrounds, underwater distortion, beach scenes, ripple effects, liquid glass, and water-themed UI. Activate on "ocean wave", "water effect", "SVG water", "ripple animation", "underwater distortion", "liquid glass", "wave animation", "feTurbulence water", "beach waves", "sea foam". NOT for 3D ocean simulation (use WebGL/Three.js), video water effects (use video editing), physics-based fluid simulation (use canvas/WebGL), or simple gradient backgrounds without wave motion.

web-cloud-designer

85
from curiositech/some_claude_skills

Creates realistic cloud effects for web using SVG filters (feTurbulence, feDisplacementMap), CSS animations, and layering techniques. Use for atmospheric backgrounds, weather effects, skyboxes, parallax scenes, and decorative cloud elements. Activate on "cloud effect", "SVG clouds", "realistic clouds", "atmospheric background", "sky animation", "feTurbulence", "weather effects", "parallax clouds". NOT for 3D rendering (use WebGL/Three.js skills), photo manipulation (use image editing tools), weather data APIs (use data integration skills), or simple CSS gradients without volumetric effects.

vaporwave-glassomorphic-ui-designer

85
from curiositech/some_claude_skills

Vaporwave + glassomorphic UI designer for photo/memory apps. Masters SwiftUI Material effects, neon pastels, frosted glass blur, retro-futuristic design. Expert in 2025 UI trends (glassmorphism, neubrutalism, Y2K), iOS HIG, dark mode, accessibility, Metal shaders. Activate on 'vaporwave', 'glassmorphism', 'SwiftUI design', 'frosted glass', 'neon aesthetic', 'retro-futuristic', 'Y2K design'. NOT for backend/API (use backend-architect), Windows 3.1 retro (use windows-3-1-web-designer), generic web (use web-design-expert), non-photo apps (use native-app-designer).

typography-expert

85
from curiositech/some_claude_skills

Master typographer specializing in font pairing, typographic hierarchy, OpenType features, variable fonts, and performance-optimized web typography. Use for font selection, type scales, web font optimization, and typographic systems. Activate on "typography", "font pairing", "type scale", "variable fonts", "web fonts", "OpenType", "font loading". NOT for logo design, icon fonts, general CSS styling, or image-based typography.

test-automation-expert

85
from curiositech/some_claude_skills

Comprehensive test automation specialist covering unit, integration, and E2E testing strategies. Expert in Jest, Vitest, Playwright, Cypress, pytest, and modern testing frameworks. Guides test pyramid design, coverage optimization, flaky test detection, and CI/CD integration. Activate on 'test strategy', 'unit tests', 'integration tests', 'E2E testing', 'test coverage', 'flaky tests', 'mocking', 'test fixtures', 'TDD', 'BDD', 'test automation'. NOT for manual QA processes, load/performance testing (use performance-engineer), or security testing (use security-auditor).

terraform-iac-expert

85
from curiositech/some_claude_skills

Terraform and OpenTofu infrastructure as code — module design, state management, multi-environment setups, remote backends, secrets management, CI/CD integration. NOT for Pulumi, CDK, Ansible, or Kubernetes manifests.

seo-visibility-expert

85
from curiositech/some_claude_skills

Comprehensive SEO, discoverability, and AI crawler optimization for web projects. Use for technical SEO audits, llms.txt/robots.txt setup, schema markup, social launch strategies (Product Hunt, HN, Reddit), and Answer Engine Optimization (AEO). Activate on 'SEO', 'discoverability', 'llms.txt', 'robots.txt', 'Product Hunt', 'launch strategy', 'get traffic', 'be found', 'search ranking'. NOT for paid advertising, PPC campaigns, or social media content creation (use marketing skills).

rest-api-design

85
from curiositech/some_claude_skills

Design REST API endpoints with Zod validation and OpenAPI documentation. Use when creating new API routes, validating request/response schemas, or updating API documentation. Activates for endpoint design, schema validation, error handling, and API docs.