Generate a comprehensive web design reference sheet (docs/design/design-reference.md) and its companion enforcement skill (.agents/skills/{project-slug}/SKILL.md) for any website project. Extracts tokens from CSS files, validates completeness against a JSON schema scratchpad, inspects existing components, and produces a 12-section living document covering colours, typography, spacing, layout, borders, shadows, motion, component patterns, accessibility, dark mode, and Figma sync notes. Use when starting a new project, onboarding a design system, creating a Figma reference sheet, porting design tokens, or auditing existing styles. Triggers on: "create a design reference", "generate a style guide", "document the design tokens", "make a brand reference sheet", "create design docs", "port design tokens", "audit existing styles".
97
100%
Does it follow best practices?
Impact
89%
2.61xAverage score across 3 eval scenarios
Passed
No known issues
Colour is the fastest, most emotionally direct element of visual communication. Humans process colour before they read words or recognise shapes. Understanding colour psychology enables deliberate emotional and perceptual decisions in design.
Colour responses are a mix of:
No colour has a single fixed meaning — context always mediates response.
Psychological associations: Energy, urgency, passion, danger, excitement, appetite stimulation
Positive: Confidence, vitality, strength, love
Negative: Aggression, warning, anger
Industry use: Food (appetite), retail (sale/CTA), healthcare (urgency), sports, entertainment
Brand examples: Coca-Cola, Netflix, YouTube, Target, Red Cross
Web application: High-visibility CTAs, error states, warning alerts, sale badges
Caution: Overuse creates anxiety; avoid as primary in finance and healthcare brands
Psychological associations: Enthusiasm, creativity, warmth, affordability, approachability
Positive: Friendly, energetic, optimistic, adventurous
Negative: Can feel cheap or unsophisticated if not handled carefully
Industry use: Food, retail, fitness, children's brands, technology startups
Brand examples: Amazon, Harley-Davidson, Fanta, Mailchimp
Web application: Friendly CTAs, badge highlights, community/social features
Psychological associations: Optimism, clarity, warmth, caution, intellect
Positive: Cheerful, accessible, hopeful, stimulating
Negative: Warning, anxiety, visual fatigue at high saturation
Industry use: Children's, food, energy, optimism-led brands
Brand examples: McDonald's, IKEA, Snapchat, LEGO, Post-it
Web application: Warning states, highlights, accent pops — rarely a primary brand colour
Accessibility note: Yellow on white fails WCAG contrast; always pair with dark text/backgrounds
Psychological associations: Nature, growth, health, wealth, balance, harmony, go/permission
Positive: Calming, trustworthy, fresh, sustainable
Negative: Envy, inexperience (depending on shade)
Industry use: Finance (wealth/growth), health/wellness, environment, food, technology
Brand examples: Whole Foods, Starbucks, Spotify, John Deere, NHS
Web application: Success states, confirmation messages, eco/sustainability sections
Shade nuance:
Psychological associations: Trust, reliability, calm, professionalism, intelligence, depth
Positive: Dependable, serene, authoritative, loyal
Negative: Cold, distant, conservative, aloof
Industry use: Finance, technology, healthcare, government, corporate — the most universally
trusted colour in Western business contexts
Brand examples: Facebook, Samsung, Ford, PayPal, NHS, Twitter/X, American Express
Web application: Primary brand colour for trust-building, links (convention), info states
Shade nuance:
Psychological associations: Creativity, luxury, wisdom, mystery, spirituality, royalty
Positive: Imaginative, sophisticated, premium, magical
Negative: Artificial (no purple occurs in nature), distant
Industry use: Luxury goods, beauty/cosmetics, spirituality, creative agencies, children's
Brand examples: Cadbury, Hallmark, Twitch, FedEx (with orange), Milka
Web application: Premium/luxury accents, creative brands, beauty and wellness
Psychological associations: Romance, femininity, playfulness, compassion, sweetness
Positive: Nurturing, gentle, joyful, approachable
Negative: Perceived as gendered; can undermine authority
Industry use: Fashion, beauty, food, healthcare, children's, romance
Brand examples: Barbie, Victoria's Secret, T-Mobile, Glossier, Breast Cancer Now
Shade nuance:
Psychological associations: Reliability, warmth, earthiness, craftsmanship, naturalness
Positive: Grounded, honest, artisanal, heritage
Negative: Can feel dull or heavy without contrast
Industry use: Coffee, chocolate, organic/natural, heritage craft, furniture
Brand examples: UPS, Hershey's, M&Ms, Timberland
Web application: Warm neutrals for backgrounds, earthy brand palettes
Psychological associations: Sophistication, luxury, power, elegance, mystery, formality
Positive: Premium, timeless, authoritative
Negative: Heaviness, death, evil (cultural dependency)
Industry use: Luxury fashion, high-end automotive, technology, editorial
Brand examples: Chanel, Apple, Nike, Rolex, Louis Vuitton
Web application: Primary text, dark mode backgrounds, luxury brand primaries
Psychological associations: Purity, simplicity, cleanliness, space, minimalism
Positive: Fresh, modern, honest, open
Negative: Sterile, cold, clinical (context-dependent)
Industry use: Healthcare, technology, minimal/luxury, bridal
Web application: Background colour, negative space, breathing room, high-end minimal layouts
Psychological associations: Neutrality, balance, professionalism, sophistication, subtlety
Positive: Timeless, understated, versatile
Negative: Dull, lifeless, uncommitted
Use: Text, UI neutrals, supporting palette, background layering
Shade nuance: Warm greys (with brown/yellow undertone) feel inviting; cool greys (blue/green
undertone) feel more digital and corporate
Single hue at different values and saturations. Cohesive, sophisticated, restrained.
Use for: Minimal brands, luxury, premium services.
Adjacent colours on the colour wheel (e.g. blue + blue-green + teal). Harmonious, natural.
Use for: Brands wanting depth without tension (nature, wellness, calm tech).
Opposite colours on the wheel (e.g. blue + orange, red + green). High contrast, vibrant, energetic.
Use for: Sports brands, calls to action against a primary colour, packaging.
A base colour plus the two colours adjacent to its complement. Less tension than complementary, more interest than analogous.
Three colours evenly spaced on the wheel. Vibrant, playful, versatile.
Use for: Children's brands, creative agencies, bold consumer brands.
Four colours at 90° intervals. Rich and complex — requires careful balance.
Consistent use of a distinctive colour builds "colour equity" — the colour becomes associated with the brand before the logo is even read (Tiffany blue, Cadbury purple, Hermès orange).
Breaking convention can differentiate — but at the cost of inherited trust signals:
| Industry | Dominant palette | Breaking out |
|---|---|---|
| Finance | Navy, dark green, grey | N26 (black), Monzo (coral) |
| Healthcare | Blue, white, green | Lemonade (pink), Hims (green) |
| Technology | Blue, black, white | Figma (rainbow), Slack (purple/multicolour) |
| Food | Red, orange, yellow | Innocent (green), Oatly (cream/black) |
| Luxury | Black, navy, gold, white | Bottega Veneta (tan), Hermès (orange) |
A common starting framework:
| Property | Warm colours | Cool colours |
|---|---|---|
| Visual temperature | Warm | Cool |
| Spatial behaviour | Advance (come forward) | Recede (go back) |
| Perceived weight | Heavier | Lighter |
| Energy | Active, stimulating | Passive, calming |
| Application | CTAs, urgency, focus | Backgrounds, calm content, trust |