borghei/Claude-Skills / product-team/design-direction
design-direction
VerifiedTurns a product brief into a design-system spec: style direction, contrast-checked palette, type pairing, tokens, UX rules and chart choices. Use when starting a new product's UI, picking a palette or fonts, or auditing a token file.
references/directions.json
View on GitHub{
"version": 1,
"note": "Style directions. radius values are px; modes: yes | no | preferred. motion tier: calm | standard | expressive. pairing is the type pairing used when this direction replaces the product type's own default direction.",
"directions": [
{"id": "swiss-functional", "name": "Swiss Functional", "summary": "Grid-led layout, type does the work, one accent colour, almost no decoration.", "signatures": ["strict column grid", "large confident headings", "flat surfaces with hairline borders", "one accent used only for action"], "best_for": ["b2b software", "documentation", "internal tools", "agencies"], "avoid_when": ["the brand must feel playful", "audience expects warmth over precision"], "light": "preferred", "dark": "yes", "radius": {"sm": 2, "md": 4, "lg": 6}, "elevation": "flat", "motion": "calm", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "low", "perf_cost": "low", "pitfalls": ["grey-on-grey secondary text", "accent creeping into decoration until it stops meaning action"], "pairing": "neutral-ui"},
{"id": "calm-utility", "name": "Calm Utility", "summary": "Soft neutrals, generous spacing, rounded but not bubbly; built for daily repeated use.", "signatures": ["muted surfaces", "medium radius", "low-contrast dividers with strong text contrast", "quiet iconography"], "best_for": ["productivity", "personal finance", "notes and planning", "wellbeing"], "avoid_when": ["the product sells excitement", "dense data must fit one screen"], "light": "preferred", "dark": "yes", "radius": {"sm": 6, "md": 10, "lg": 16}, "elevation": "soft", "motion": "calm", "density": "comfortable", "type_ratio": 1.2, "a11y_risk": "medium", "perf_cost": "low", "pitfalls": ["pastel text failing 4.5:1", "everything the same visual weight so nothing leads"], "pairing": "neutral-ui"},
{"id": "dense-operational", "name": "Dense Operational", "summary": "Compact rows, tabular numbers, persistent navigation and status colour with meaning.", "signatures": ["compact spacing scale", "tabular figures", "sticky table headers", "status chips with text labels"], "best_for": ["admin consoles", "monitoring", "trading", "logistics", "analytics"], "avoid_when": ["first-time consumers", "marketing pages"], "light": "yes", "dark": "yes", "radius": {"sm": 2, "md": 4, "lg": 6}, "elevation": "flat", "motion": "calm", "density": "compact", "type_ratio": 1.2, "a11y_risk": "medium", "perf_cost": "medium", "pitfalls": ["status by colour alone", "touch targets shrunk with the spacing scale", "text below 12px"], "pairing": "plex-system"},
{"id": "editorial", "name": "Editorial", "summary": "Reading-first: serif display, measured line length, quiet chrome around the words.", "signatures": ["serif headlines", "60-75 character measure", "pull quotes and section rules", "image captions"], "best_for": ["publishing", "newsletters", "long-form content", "research", "law firms"], "avoid_when": ["the core task is data entry", "screens are mostly controls"], "light": "preferred", "dark": "yes", "radius": {"sm": 0, "md": 2, "lg": 4}, "elevation": "flat", "motion": "calm", "density": "spacious", "type_ratio": 1.333, "a11y_risk": "low", "perf_cost": "low", "pitfalls": ["three or more webfont families", "justified text with rivers", "light serif body at small sizes"], "pairing": "source-editorial"},
{"id": "warm-humanist", "name": "Warm Humanist", "summary": "Friendly rounded shapes, warm neutrals, human photography and plain-spoken copy.", "signatures": ["rounded sans", "warm off-white backgrounds", "illustration or real photography", "large tap targets"], "best_for": ["consumer services", "education", "community", "local services", "non-profits"], "avoid_when": ["enterprise buyers expect rigour", "dense tables dominate"], "light": "preferred", "dark": "yes", "radius": {"sm": 8, "md": 12, "lg": 20}, "elevation": "soft", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "low", "perf_cost": "medium", "pitfalls": ["stock photography that reads as fake", "warm accent too light for text"], "pairing": "brand-consumer"},
{"id": "trust-institutional", "name": "Trust Institutional", "summary": "Conservative structure, deep blue or green, explicit labels, nothing that looks like a trick.", "signatures": ["clear headings and breadcrumbs", "visible security and policy cues", "restrained colour", "full-width forms"], "best_for": ["banking", "insurance", "government", "healthcare administration", "legal"], "avoid_when": ["youth lifestyle brands", "entertainment"], "light": "preferred", "dark": "yes", "radius": {"sm": 2, "md": 4, "lg": 8}, "elevation": "soft", "motion": "calm", "density": "comfortable", "type_ratio": 1.2, "a11y_risk": "low", "perf_cost": "low", "pitfalls": ["walls of legal text with no hierarchy", "dated gradients standing in for trust"], "pairing": "public-service"},
{"id": "premium-restraint", "name": "Premium Restraint", "summary": "Few colours, wide margins, high-quality imagery and type that whispers rather than shouts.", "signatures": ["ivory or near-black grounds", "thin rules", "large imagery", "letter-spaced small caps used sparingly"], "best_for": ["luxury goods", "hospitality", "architecture", "high-end services", "fashion"], "avoid_when": ["price-led retail", "task-heavy apps"], "light": "yes", "dark": "yes", "radius": {"sm": 0, "md": 0, "lg": 2}, "elevation": "flat", "motion": "calm", "density": "spacious", "type_ratio": 1.333, "a11y_risk": "medium", "perf_cost": "medium", "pitfalls": ["thin light-weight body text failing contrast", "gold text on ivory", "hero images that block content"], "pairing": "quiet-luxury"},
{"id": "bold-block", "name": "Bold Block", "summary": "Big type, saturated colour blocks and hard edges; designed to be remembered.", "signatures": ["oversized headings", "full-bleed colour sections", "high-contrast buttons", "short punchy copy"], "best_for": ["consumer launches", "creator tools", "events", "marketing sites", "youth brands"], "avoid_when": ["clinical or financial anxiety", "long working sessions"], "light": "yes", "dark": "yes", "radius": {"sm": 0, "md": 6, "lg": 12}, "elevation": "flat", "motion": "expressive", "density": "comfortable", "type_ratio": 1.414, "a11y_risk": "medium", "perf_cost": "medium", "pitfalls": ["white text on mid-saturation blocks", "too many accent colours competing"], "pairing": "block-heavy"},
{"id": "playful-tactile", "name": "Playful Tactile", "summary": "Chunky rounded controls, cheerful colour, visible press states and rewarding feedback.", "signatures": ["thick outlines or offset shadows", "very rounded controls", "character illustration", "celebration moments"], "best_for": ["kids and family", "casual games", "language learning", "habit apps"], "avoid_when": ["professional tools", "sensitive topics"], "light": "preferred", "dark": "yes", "radius": {"sm": 10, "md": 16, "lg": 24}, "elevation": "raised", "motion": "expressive", "density": "spacious", "type_ratio": 1.25, "a11y_risk": "medium", "perf_cost": "medium", "pitfalls": ["animation that loops forever", "reward sounds with no off switch", "rainbow palettes with no hierarchy"], "pairing": "rounded-play"},
{"id": "technical-mono", "name": "Technical Mono", "summary": "Precise, code-adjacent: monospace accents, keyboard-first, information over ornament.", "signatures": ["monospace for code and IDs", "command palette", "keyboard hints", "subtle grid backgrounds"], "best_for": ["developer tools", "APIs and docs", "infrastructure", "security products"], "avoid_when": ["non-technical consumers", "emotional brands"], "light": "yes", "dark": "preferred", "radius": {"sm": 3, "md": 6, "lg": 8}, "elevation": "flat", "motion": "calm", "density": "compact", "type_ratio": 1.2, "a11y_risk": "low", "perf_cost": "low", "pitfalls": ["monospace body text for prose", "dim syntax colours below 4.5:1"], "pairing": "plex-system"},
{"id": "soft-depth", "name": "Soft Depth", "summary": "Layered surfaces with gentle elevation and translucency; modern consumer app feel.", "signatures": ["two or three surface levels", "soft shadows", "blurred overlays used sparingly", "medium-large radius"], "best_for": ["consumer mobile apps", "smart home", "media players", "personal dashboards"], "avoid_when": ["low-end devices dominate", "print or e-ink outputs"], "light": "yes", "dark": "yes", "radius": {"sm": 8, "md": 14, "lg": 22}, "elevation": "layered", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "high", "perf_cost": "high", "pitfalls": ["text on translucent layers losing contrast", "blur on every surface killing frame rate"], "pairing": "neutral-ui"},
{"id": "dark-immersive", "name": "Dark Immersive", "summary": "Content-forward dark canvas where imagery and video carry colour.", "signatures": ["near-black canvas", "artwork-led cards", "minimal chrome during playback", "vivid single accent"], "best_for": ["streaming", "gaming", "music", "photography", "events at night"], "avoid_when": ["form-heavy flows", "older audiences reading long text"], "light": "no", "dark": "preferred", "radius": {"sm": 4, "md": 8, "lg": 12}, "elevation": "layered", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "medium", "perf_cost": "high", "pitfalls": ["pure white on pure black halation", "grey metadata too dim", "autoplay with sound"], "pairing": "tech-marketing"},
{"id": "organic-natural", "name": "Organic Natural", "summary": "Earth tones, paper textures used lightly, soft geometry and honest photography.", "signatures": ["warm paper backgrounds", "leaf and clay colours", "rounded but irregular shapes", "real product photography"], "best_for": ["food and drink", "sustainability", "wellness", "farm and garden", "craft goods"], "avoid_when": ["fintech", "enterprise analytics"], "light": "preferred", "dark": "yes", "radius": {"sm": 6, "md": 12, "lg": 18}, "elevation": "soft", "motion": "calm", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "medium", "perf_cost": "medium", "pitfalls": ["olive text on beige", "texture images bloating page weight"], "pairing": "organic-reading"},
{"id": "clinical-clear", "name": "Clinical Clear", "summary": "Calm, legible and unambiguous; every state labelled, nothing decorative near critical data.", "signatures": ["high-legibility sans", "explicit units and ranges", "confirmations on irreversible actions", "plain language"], "best_for": ["patient apps", "clinical tools", "pharmacy", "lab results", "care coordination"], "avoid_when": ["entertainment", "fashion"], "light": "preferred", "dark": "yes", "radius": {"sm": 4, "md": 8, "lg": 12}, "elevation": "soft", "motion": "calm", "density": "comfortable", "type_ratio": 1.2, "a11y_risk": "low", "perf_cost": "low", "pitfalls": ["red and green as the only signal", "medical jargon in labels"], "pairing": "hyperlegible"},
{"id": "brutalist-raw", "name": "Brutalist Raw", "summary": "Exposed structure, system or mono type, hard borders and deliberate roughness.", "signatures": ["visible borders", "system fonts", "unstyled-looking links that are actually styled", "asymmetric layout"], "best_for": ["portfolios", "art and culture", "indie publications", "experimental launches"], "avoid_when": ["trust-sensitive transactions", "mass-market commerce"], "light": "preferred", "dark": "yes", "radius": {"sm": 0, "md": 0, "lg": 0}, "elevation": "flat", "motion": "calm", "density": "comfortable", "type_ratio": 1.5, "a11y_risk": "medium", "perf_cost": "low", "pitfalls": ["roughness that breaks keyboard focus", "low contrast passed off as style"], "pairing": "raw-mono"},
{"id": "retail-merchandising", "name": "Retail Merchandising", "summary": "The product photo is the hero; neutral chrome, clear price and one strong buy action.", "signatures": ["neutral background around imagery", "price and stock visible near the action", "filter rail", "sticky add-to-cart on mobile"], "best_for": ["e-commerce", "marketplaces", "catalogues", "food delivery"], "avoid_when": ["content without products", "B2B configuration-heavy sales"], "light": "preferred", "dark": "yes", "radius": {"sm": 4, "md": 8, "lg": 12}, "elevation": "soft", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "low", "perf_cost": "medium", "pitfalls": ["fake urgency timers", "sale red used for everything", "unoptimised images"], "pairing": "neutral-ui"},
{"id": "translucent-layered", "name": "Translucent Layered", "summary": "Frosted panels over a colourful backdrop; depth comes from blur and layering rather than shadow.", "signatures": ["blurred translucent panels", "vivid backdrop behind chrome", "thin light borders on panels", "few layers, each with a job"], "best_for": ["media overlays", "consumer device companions", "navigation chrome over imagery", "launch pages"], "avoid_when": ["text sits on the translucent layer for long reading", "the audience needs high contrast", "low-end devices are common"], "light": "yes", "dark": "preferred", "radius": {"sm": 8, "md": 14, "lg": 22}, "elevation": "layered", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "high", "perf_cost": "high", "pitfalls": ["text contrast that changes with whatever scrolls behind the panel", "backdrop blur on every surface, which stutters on mid-range phones", "no solid fallback when transparency is reduced in OS settings"], "pairing": "ai-modern"},
{"id": "bento-modular", "name": "Bento Modular", "summary": "A grid of unequal tiles, each holding one idea, sized by importance.", "signatures": ["tiles of two or three sizes on one grid", "one message per tile", "consistent gutters and radius", "a single hero tile"], "best_for": ["feature overviews", "product launch pages", "personal dashboards", "portfolio summaries"], "avoid_when": ["content is sequential and must be read in order", "the tile count would exceed about nine"], "light": "preferred", "dark": "yes", "radius": {"sm": 8, "md": 16, "lg": 24}, "elevation": "soft", "motion": "standard", "density": "comfortable", "type_ratio": 1.25, "a11y_risk": "medium", "perf_cost": "low", "pitfalls": ["reading order on mobile that no longer matches the importance of tiles", "every tile animated on scroll", "tiles of near-identical size that remove hierarchy"], "pairing": "tech-marketing"}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |