AugmentClaude

Design Workflows

Review designs, write UI copy, build systems, and check accessibility.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/design-notque/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Design workflows — UX copy, design systems, design critique, accessibility review, design handoff, user research synthesis. Use when writing UI copy, reviewing designs, building component systems, checking accessibility, or preparing developer handoffs.

What this skill does

Design

Umbrella skill for design workflows: UX copy, design systems, critique, accessibility review, developer handoff, and user research synthesis. Each mode loads its own reference files on demand.


Mode Detection

Classify into one mode before proceeding.

ModeSignal PhrasesReference
UX-COPYwrite copy, button text, error message, empty state, onboarding copy, tooltip text, confirmation dialog, notification copyreferences/ux-copy.md
DESIGN-SYSTEMdesign tokens, component library, naming conventions, audit components, document component, extend system, theme architecturereferences/design-systems.md
CRITIQUEreview design, critique mockup, design feedback, evaluate screen, visual hierarchy, usability reviewreferences/design-critique.md
ACCESSIBILITYWCAG, accessibility audit, color contrast, keyboard navigation, screen reader, a11y, focus management, ARIAreferences/accessibility-review.md
HANDOFFdeveloper handoff, spec sheet, handoff doc, implementation spec, design-to-dev, responsive specreferences/design-handoff.md
RESEARCHsynthesize research, interview analysis, usability findings, survey results, user segments, research themes(inline — see workflow)

If the request spans modes, pick the primary mode and note the secondary.


Workflow by Mode

UX-COPY Mode

Load: references/ux-copy.md, references/llm-design-failure-modes.md

  1. Gather context — Ask conversationally:

    • Component type (button, error, empty state, tooltip, confirmation, notification, onboarding)
    • User state and emotional context (frustrated, exploring, completing a task)
    • Brand voice (formal, friendly, playful, reassuring)
    • Constraints (character limits, platform guidelines, localization needs)
    • Existing copy patterns (what terminology the product already uses)
  2. Generate copy using component-specific patterns from reference:

    • Primary recommendation with rationale
    • 2-3 alternatives with tone/context guidance
    • Localization notes (character expansion, idiom risks, cultural context)
  3. Validate — Check against these gates:

    • Copy uses product's existing terminology consistently
    • Action labels match outcomes (button says what it does)
    • Error messages follow What happened + Why + How to fix
    • Character limits respected for target platform
    • No jargon without explanation

Gate: Copy exists for all requested components. Each piece has rationale tied to user context. Alternatives provided with differentiated use cases.

DESIGN-SYSTEM Mode

Load: references/design-systems.md, references/llm-design-failure-modes.md

  1. Determine operation:
OperationInputsKey Actions
AuditComponent library or codebaseCheck naming consistency, token coverage, hardcoded values, state completeness, documentation gaps
DocumentComponent name + contextGenerate props/variants/states/accessibility/usage spec
ExtendGap description + existing systemPropose new component using existing tokens and patterns, show relationship to existing components
  1. Execute using design token architecture from reference:

    • Tokens: color (brand, semantic, neutral), typography (scale, weights, line heights), spacing (scale, component padding), borders (radius, width), shadows (elevation), motion (duration, easing)
    • Components: variants, states (default, hover, active, disabled, loading, error), sizes, accessibility, composition patterns
    • Patterns: form patterns, navigation patterns, data display, feedback
  2. Validate:

CheckCriteria
NamingConsistent convention across all components
TokensNo hardcoded values — everything references a token
StatesAll interactive states defined (default, hover, active, disabled, loading, error)
A11yARIA roles, keyboard behavior, screen reader announcements documented
CompositionComponent works standalone and composed with others

Gate: Output uses consistent naming. All values reference tokens. Interactive states complete. Accessibility documented.

CRITIQUE Mode

Load: references/design-critique.md, references/llm-design-failure-modes.md

  1. Gather context:

    • Design stage (exploration, refinement, final polish)
    • Target users and their goals
    • Focus area (optional — "just the navigation" vs full review)
    • Platform (web desktop, web mobile, native iOS, native Android)
  2. Apply structured critique — Four-step method:

    • Describe: What is present? Elements, layout, visual relationships. No judgment yet.
    • Analyze: How are design principles applied? Hierarchy, contrast, alignment, proximity, repetition.
    • Interpret: What does the design communicate? Emotional tone, brand alignment, user expectations.
    • Evaluate: What works, what could improve, and specific recommendations.
  3. Evaluate against heuristics — Apply Nielsen's 10 to the specific design:

HeuristicKey Question
Visibility of system statusDoes the user know what's happening?
Match with real worldDoes it use the user's language and mental models?
User control and freedomCan the user undo, go back, escape?
Consistency and standardsDoes it follow platform conventions and its own patterns?
Error preventionDoes the design prevent errors before they happen?
Recognition over recallAre options visible, not memorized?
Flexibility and efficiencyDoes it serve both novices and experts?
Aesthetic and minimalist designDoes every element earn its space?
Error recoveryAre errors explained with clear recovery paths?
Help and documentationIs contextual help available where needed?
  1. Match feedback to stage:
StageFocusAvoid
ExplorationConcept direction, user flow logic, information architecturePixel-level visual polish
RefinementVisual hierarchy, interaction patterns, consistency, edge casesQuestioning the fundamental approach
FinalColor contrast, spacing precision, copy accuracy, accessibilityStructural redesign suggestions

Gate: Critique covers usability, visual hierarchy, consistency, and accessibility. Feedback is specific (element + issue + recommendation). Positive observations included. Stage-appropriate depth.

ACCESSIBILITY Mode

Load: references/accessibility-review.md, references/llm-design-failure-modes.md

  1. Determine scope: Full WCAG 2.1 AA audit vs targeted check (contrast, keyboard, screen reader).

  2. Audit by WCAG principle:

PrincipleKey Criteria
PerceivableAlt text (1.1.1), semantic structure (1.3.1), text contrast 4.5:1 (1.4.3), UI contrast 3:1 (1.4.11)
OperableKeyboard access (2.1.1), focus order (2.4.3), visible focus (2.4.7), touch targets 44x44px (2.5.5)
UnderstandablePredictable behavior (3.2.1), error identification (3.3.1), input labels (3.3.2)
RobustName/role/value for all UI components (4.1.2)
  1. Check component-specific patterns from reference (buttons, forms, modals, navigation, data tables, carousels).

  2. Generate audit report with:

    • Issue count by severity (Critical, Major, Minor)
    • Each finding: WCAG criterion, location, issue, severity, remediation
    • Color contrast check table (foreground, background, ratio, required, pass/fail)
    • Keyboard navigation map
    • Screen reader announcement check
    • Priority fixes ranked by user impact

Gate: Audit covers all four WCAG principles. Each finding cites a specific WCAG criterion. Remediation provided for every issue. Severity reflects real user impact.

HANDOFF Mode

Load: references/design-handoff.md, references/llm-design-failure-modes.md

  1. Gather inputs:

    • Design (Figma URL, screenshot, description)
    • Tech stack (framework, CSS approach, component library)
    • Design system tokens (if available)
    • Target breakpoints
  2. Generate spec covering all artifact categories:

CategoryContents
LayoutGrid system, breakpoints, responsive behavior rules
Design tokensColor, typography, spacing, elevation — token names mapped to values
ComponentsName, variant, props, special behavior notes
StatesEvery interactive element: default, hover, active, disabled, loading, error
InteractionsClick/tap, hover, transitions (duration + easing), gestures
ContentCharacter limits, truncation rules, empty states, loading states
Edge casesMin/max content, i18n text expansion, slow connections, missing data
AccessibilityFocus order, ARIA labels/roles, keyboard interactions, screen reader announcements
AnimationElement, trigger, description, duration (ms), easing function
  1. Validate completeness:
    • Every interactive element has all states specified
    • Token references used (not raw values)
    • Edge cases documented (empty, loading, error, overflow, missing data)
    • Responsive behavior explicit at each breakpoint
    • Accessibility requirements stated

Gate: Spec covers all categories in the table. Uses token references. All states documented. Edge cases present. A developer can build from this spec without guessing.

RESEARCH Mode

Load: references/llm-design-failure-modes.md

  1. Accept inputs — Interview transcripts, survey data, usability test notes, support tickets, app reviews, NPS responses.

  2. Process each source:

    • Extract observations (what happened), verbatim quotes, behaviors (vs stated preferences), pain points, positive signals, context
    • Behavioral data outweighs stated preferences. What users do > what users say.
  3. Synthesize:

    • Affinity mapping: one observation per note, let clusters emerge, split large clusters
    • Theme development: initial codes -> theme candidates -> review against evidence -> refined themes
    • Triangulation: findings supported by multiple sources are stronger. Flag single-source findings.
  4. Priority matrix:

High ImpactLow Impact
High FrequencyTop priorityQuality-of-life
Low FrequencySegment-specificNote and deprioritize
  1. Generate synthesis:
    • Executive summary (3-4 sentences)
    • Key themes: name, prevalence (X of Y participants), summary, supporting evidence with quotes, implication
    • Insights-to-opportunities table: insight, opportunity, impact, effort
    • User segments identified: name, characteristics, needs, rough size
    • Prioritized recommendations with evidence basis
    • Questions for further research
    • Methodology notes and limitations

Gate: Themes supported by evidence with quotes. Behaviors distinguished from stated preferences. Quote attribution uses participant type ("Enterprise admin, 200-person team"), not names. Recommendations tied to specific findings.


LLM Failure Modes in Design Work

Load references/llm-design-failure-modes.md for all modes. These are specific ways LLMs fail at design tasks:

Failure ModeWhat HappensDefense
Generic copyCopy sounds professional but lacks product personality and contextGround every piece in the product's existing voice, user's emotional state, and specific feature context
Inaccessible suggestionsRecommends color combinations or patterns that fail WCAGCheck every color pairing against 4.5:1 (text) and 3:1 (UI) ratios. Verify keyboard paths.
Platform-blind critiqueApplies desktop heuristics to mobile or iOS patterns to AndroidIdentify target platform first. Apply platform-specific conventions.
Missing edge casesSpecs cover happy path but omit empty, loading, error, overflow, i18n statesUse the edge case checklist from handoff reference for every spec.
Surface-level critique"Looks clean" or "good hierarchy" without specificityEvery critique finding names the element, the issue, and a concrete recommendation.
Fabricated researchInvents plausible user quotes, statistics, or persona detailsEvery finding cites user-provided source material. Flag confidence levels. Mark assumptions explicitly.
Token-value confusionSpecs use raw px/hex values instead of design tokensReference token names. Flag any raw value as "needs token mapping."
Framework dumpingLists heuristics or WCAG criteria as a checklist without applying to the specific designApply each criterion to the actual design. Skip criteria that do not apply. Explain how each applies.

Output Conventions

  • Markdown with clear headers. Scannable by busy designers and developers.
  • Tables for comparisons, audit findings, component specs, token mappings.
  • Severity labels: Critical (blocks users), Major (degrades experience), Minor (polish).
  • Every recommendation is specific enough to act on. "Improve contrast" is not actionable. "Change body text from #999 to #595959 on #fff background to meet 4.5:1 ratio" is.
  • Include what works well alongside what needs improvement.

Reference Loading Table

ModePrimary ReferenceSecondary Reference
UX-COPYreferences/ux-copy.mdreferences/llm-design-failure-modes.md
DESIGN-SYSTEMreferences/design-systems.mdreferences/llm-design-failure-modes.md
CRITIQUEreferences/design-critique.mdreferences/llm-design-failure-modes.md
ACCESSIBILITYreferences/accessibility-review.mdreferences/llm-design-failure-modes.md
HANDOFFreferences/design-handoff.mdreferences/llm-design-failure-modes.md
RESEARCH(inline)references/llm-design-failure-modes.md

Related skills