rampstackco/claude-skills / skills/design-standards
design-standards
VerifiedApply production-grade design standards when building or reviewing pages, components, or UI. Use this skill whenever the user asks to build a page, design a component, lay out a section, review the UI, fix the layout, or check design quality. Triggers on build a page, create a component, design a section, hero, card, CTA, layout, review the UI, fix the design, design system, design tokens, spacing, typography scale, button standards, mobile design. Also triggers for any production design decision where contrast, accessibility, spacing, or visual hierarchy matters.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 357 B |
| SKILL.md | skill md | 9.4 KB |
| references/design-tokens-template.md | markdown | 7.2 KB |
| references/preship-checklist.md | markdown | 5.7 KB |
| references/tailwind-patterns.md | markdown | 8.7 KB |
references/preship-checklist.md
View on GitHub# Pre-Ship Design Checklist
Run before declaring any page or component complete. Most production design defects come from skipping these.
---
## Tokens and consistency
- [ ] All colors come from the token set (no hardcoded hex values)
- [ ] All spacing comes from the spacing scale (no arbitrary px values)
- [ ] All typography uses defined type tokens
- [ ] All radii use the defined radius tokens
- [ ] Shadows use defined shadow tokens
- [ ] No more than one variant per component type (e.g., one primary button style across the page)
---
## Contrast (WCAG AA)
- [ ] All body text passes 4.5:1 against its background
- [ ] All large text passes 3:1
- [ ] All UI elements (icons, borders, focus rings) pass 3:1
- [ ] Brand colors used for text use the darker text variant if the signature color fails
- [ ] No light gray text under #6B7280 on white backgrounds
- [ ] Dark mode (if implemented) tested against dark surfaces, not just light
Use a contrast checker for every pairing. Visual judgment is unreliable.
---
## Visual hierarchy
- [ ] One clear primary action per page (one primary CTA)
- [ ] Secondary actions visually subordinate to primary
- [ ] Headline larger and heavier than body text by enough to be unambiguous
- [ ] Section breaks visible without effort (spacing or background change)
- [ ] Images do not visually compete with primary content
---
## Typography
- [ ] Exactly one H1 per page
- [ ] No skipped header levels (H2 followed by H4)
- [ ] Body text minimum 14px (16px preferred)
- [ ] Line length controlled (45 to 75 characters per line for body text)
- [ ] Line height appropriate (1.4 to 1.6 for body, 1.0 to 1.2 for display)
- [ ] No fake italics or fake bold (use real font weights)
---
## Spacing and rhythm
- [ ] Consistent padding inside same-type containers (all cards, all sections)
- [ ] Section breathing room: 64px+ desktop, 48px+ mobile
- [ ] Form fields spaced minimum 16px apart vertically
- [ ] Related elements visually grouped (proximity principle)
- [ ] No cramped sections that bleed into each other
---
## Buttons and CTAs
- [ ] Primary button uses brand primary color
- [ ] Hover state visible and distinct
- [ ] Focus state visible (focus ring or equivalent)
- [ ] Disabled state visible and accessible
- [ ] Touch target minimum 44 by 44 pixels
- [ ] Button text descriptive (not "click here" or "submit")
---
## Forms
- [ ] Every input has a visible label (placeholder is not a label)
- [ ] Required fields marked clearly
- [ ] Error states have text descriptions, not just color
- [ ] Help text positioned below or beside the field, not as placeholder
- [ ] Input height accommodates touch (minimum 44px)
- [ ] Form inputs use 16px+ text on iOS to prevent zoom
---
## Images and media
- [ ] All meaningful images have descriptive alt text
- [ ] Decorative images have empty alt (`alt=""`)
- [ ] Images have explicit width and height to prevent layout shift
- [ ] Modern formats used where supported (WebP, AVIF)
- [ ] Lazy loading on below-the-fold images
- [ ] No images stretched or pixelated due to wrong sizing
---
## Interactive elements
- [ ] All interactive elements have hover states (where pointer is supported)
- [ ] Focus rings visible (do not use `outline: none` without a replacement)
- [ ] Tap targets minimum 44 by 44 pixels
- [ ] Tap targets at least 8 pixels of spacing on all sides from other tap targets
- [ ] Cursor styles correct (`pointer` for clickable, `text` for inputs, etc.)
---
## Mobile (375 to 390 pixel viewport)
- [ ] Tested on real device or device-mode in browser
- [ ] No horizontal scroll
- [ ] No fixed-width elements breaking layout
- [ ] Sticky bottom bars do not overlap content (page wrapper has bottom padding)
- [ ] Sticky top bars do not eat critical content
- [ ] Mobile menu works on touch
- [ ] All text remains readable (no truncated headlines)
- [ ] Tap targets remain 44px minimum
---
## Tablet (768 to 1024 pixel viewport)
- [ ] Layout transitions cleanly between mobile and desktop breakpoints
- [ ] No awkward in-between sizing
- [ ] Multi-column layouts adapt sensibly
---
## Desktop (1280+ pixel viewport)
- [ ] Page max-width prevents content from stretching too wide
- [ ] Typography does not break (line lengths still controlled)
- [ ] Whitespace remains balanced
---
## Performance signals (visual)
- [ ] No visible layout shift after initial render
- [ ] Images load progressively (no blank-then-pop)
- [ ] No flash of unstyled text (FOUT) for primary fonts
- [ ] No render-blocking elements above the fold
(For deep performance audits, use `performance-optimization`.)
---
## Brand and consistency
- [ ] Logo placed correctly (per brand-style-guide rules)
- [ ] Brand colors used per brand-style-guide rules
- [ ] Imagery direction matches brand-style-guide
- [ ] Voice (in any UI text) matches brand-voice
- [ ] No off-brand stock photography or generic illustrations
---
## Accessibility (basic checks; for deeper audits use `accessibility-audit`)
- [ ] Page operable by keyboard alone
- [ ] Logical tab order
- [ ] Form fields have associated labels (`for`/`id` or `aria-labelledby`)
- [ ] Buttons and links use semantic elements (not `<div onClick>`)
- [ ] Skip links present for long pages
- [ ] Page language declared (`<html lang="...">`)
---
## Pre-launch sanity
- [ ] No placeholder text remaining ("Lorem ipsum," "TODO," "[Replace this]")
- [ ] No broken images
- [ ] No broken links (test 5 random links)
- [ ] No console errors in browser dev tools
- [ ] No accessibility errors in browser audit tools
---
## Sign-off
When all boxes check, the design is ready to ship. If any box fails, document the failure, decide whether it is a launch blocker, and either fix or file a known-issue ticket before shipping.
The checklist is the floor, not the ceiling. Great design exceeds it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |