MCPInstall

product-designer

Product design across UI/UX, design systems, prototyping, and user research. Use when creating user journey maps, building wireframes, defining design tokens and component systems, planning usability tests, or establishing design principles.

Installs
4.9K
Last 24h
—
Trending rank
—
Security
Pass

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/borghei/claude-skills --skill product-designer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads product-designer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·This skill provides a set of tools and workflows for product designers, including UI/UX critique, user journey mapping, and usability test scoring. The included Python scripts use only the standard library and perform no network or dangerous system operations.
Socket PassNo alerts
Snyk PassLOW ·Risk: LOW · No issues
Runlayer PassNONE ·1 file scanned · No issues
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed

SKILL.md

The instructions your agent reads when the skill is triggered.

Product Designer

The agent operates as a senior product designer, delivering user-centered design solutions spanning UX research, UI design, design systems, prototyping, and usability testing.

Clarify First

Before generating the design deliverable, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

  • Target user and the problem: who hurts and the job-to-be-done (drives Discover and the journey map's problem statement).
  • Which deliverable: journey map, wireframe, usability test plan, or design critique (sets which workflow and template applies).
  • Fidelity and stage: exploration vs dev-handoff (drives prototype fidelity and what "done" means).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

Workflow

  1. Discover - Research user needs through interviews, analytics, and competitive analysis. Create user journey maps and identify pain points. Checkpoint: problem statement is validated by at least 3 user data points.
  2. Define - Synthesize findings into a clear problem statement and design requirements. Build information architecture (card sorting, site maps). Checkpoint: IA has been validated via card sort or tree test.
  3. Develop - Ideate solutions through sketching and wireframing. Build prototypes at appropriate fidelity. Checkpoint: prototype covers the complete happy path plus one error state.
  4. Test - Run usability tests with 5-8 participants. Measure task completion rate, time on task, error rate, and SUS score. Checkpoint: all critical usability issues are documented with severity ratings.
  5. Deliver - Refine designs based on test findings. Prepare dev handoff with design tokens, component specs, and interaction documentation. Checkpoint: engineering has confirmed feasibility of all interactions.

Design Sprint (5-Day Format)

DayActivityOutput
MondayMap problem, interview expertsChallenge map, target area
TuesdaySketch solutions, Crazy 8sSolution sketches
WednesdayDecide, storyboardTestable hypothesis
ThursdayBuild prototypeRealistic clickable prototype
FridayTest with 5 usersValidated/invalidated hypothesis

User Journey Map Template

PERSONA: Sarah, Product Manager, goal: find analytics insights fast

STAGE:      AWARENESS    CONSIDER     PURCHASE     ONBOARD      RETAIN
Actions:    Searches     Compares     Signs up     Configures   Uses daily
Touchpoint: Google       Website      Checkout     Setup wizard App
Emotion:    Frustrated   Curious      Anxious      Hopeful      Satisfied
Pain point: Too many     Hard to      Complex      Slow setup   Missing
            options      compare      pricing                   features
Opportunity: SEO content  Comparison   Simplify     Quick-start  Feature
                         tool         flow         template     education

Information Architecture

Card Sorting Methods:

  • Open sort: users create their own categories
  • Closed sort: users place items into predefined categories
  • Hybrid: combination approach

Example Site Map:

Home
+-- Products
|   +-- Category A
|   |   +-- Product 1
|   |   +-- Product 2
|   +-- Category B
+-- About
|   +-- Team
|   +-- Careers
+-- Resources
|   +-- Blog
|   +-- Help Center
+-- Account
    +-- Profile
    +-- Settings

UI Design Foundations

Design Principles

  1. Hierarchy - Visual weight guides attention via size, color, and contrast
  2. Consistency - Reuse patterns and components; maintain predictable interactions
  3. Feedback - Acknowledge every user action; show system status and loading states
  4. Accessibility - 4.5:1 color contrast minimum, focus indicators, screen reader support

Design Token System

/* Color tokens */
--color-primary-500: #3b82f6;
--color-primary-600: #2563eb;
--color-gray-50: #f9fafb;
--color-gray-900: #111827;
--color-success: #10b981;
--color-warning: #f59e0b;
--color-error: #ef4444;

/* Typography scale */
--text-sm: 0.875rem;   /* 14px */
--text-base: 1rem;     /* 16px */
--text-lg: 1.125rem;   /* 18px */
--text-xl: 1.25rem;    /* 20px */
--text-2xl: 1.5rem;    /* 24px */

/* Spacing (4px base unit) */
--space-1: 0.25rem;    /* 4px */
--space-2: 0.5rem;     /* 8px */
--space-4: 1rem;       /* 16px */
--space-6: 1.5rem;     /* 24px */
--space-8: 2rem;       /* 32px */

Component Structure

Button/
+-- Variants: Primary, Secondary, Tertiary, Destructive
+-- Sizes: Small (32px), Medium (40px), Large (48px)
+-- States: Default, Hover, Active, Focus, Disabled, Loading
+-- Anatomy: [Leading Icon] Label [Trailing Icon]

Component Design Tokens (JSON)

{
  "color": {
    "primary": {"50": {"value": "#eff6ff"}, "500": {"value": "#3b82f6"}},
    "semantic": {"success": {"value": "{color.green.500}"}, "error": {"value": "{color.red.500}"}}
  },
  "spacing": {"xs": {"value": "4px"}, "sm": {"value": "8px"}, "md": {"value": "16px"}},
  "borderRadius": {"sm": {"value": "4px"}, "md": {"value": "8px"}, "full": {"value": "9999px"}}
}

Example: Usability Test Plan

# Usability Test: New Checkout Flow

## Objectives
- Validate that users can complete purchase in < 3 minutes
- Identify friction points in address and payment steps

## Participants
- 6 users (3 new, 3 returning)
- Mix of desktop and mobile

## Tasks
1. "Find a laptop under $1,000 and add it to your cart" (browse + add)
2. "Complete the purchase using a credit card" (checkout flow)
3. "Change the shipping address on your order" (post-purchase edit)

## Success Criteria
| Task | Completion Target | Time Target |
|------|-------------------|-------------|
| Browse + Add | 100% | < 60s |
| Checkout | 90%+ | < 180s |
| Edit address | 80%+ | < 90s |

## Metrics
- Task completion rate
- Time on task
- Error count per task
- System Usability Scale (SUS) score (target: 68+)

Prototype Fidelity Guide

FidelityPurposeToolsTimeline
PaperQuick explorationPaper, penMinutes
Low-fiFlow validationFigma, SketchHours
Mid-fiUsability testingFigmaDays
High-fiDev handoff, final testingFigmaDays-Weeks

Tool Reference

design_critique.py

Evaluates a UI design against Nielsen's 10 Usability Heuristics and accessibility standards. Generates a structured critique report with severity ratings, compliance scores, and prioritized improvement recommendations.

FlagTypeDefaultDescription
--checklistflag-Generate empty checklist for evaluation
--answersstring-Path to completed checklist JSON file
--jsonflagFalseOutput as JSON
python scripts/design_critique.py --checklist
python scripts/design_critique.py --checklist --json > checklist.json
python scripts/design_critique.py --answers completed_checklist.json
python scripts/design_critique.py --answers completed_checklist.json --json

journey_mapper.py

Creates structured user journey maps with emotion curves, pain point identification, and opportunity analysis. Includes pre-built templates for SaaS, e-commerce, and mobile app journeys.

FlagTypeDefaultDescription
--template, -tchoice-Pre-built template: saas, ecommerce, mobile_app
--stages, -sstring-Path to custom stages JSON file
--jsonflagFalseOutput as JSON
python scripts/journey_mapper.py --template saas
python scripts/journey_mapper.py --template ecommerce --json
python scripts/journey_mapper.py --stages custom_journey.json

usability_scorer.py

Calculates System Usability Scale (SUS) scores and task performance metrics from usability test data. Provides individual and aggregate analysis with grade interpretation and benchmarking.

FlagTypeDefaultDescription
actionpositional-"sample" to create sample CSV files
--sus-responsesstring-CSV with SUS responses (participant, q1-q10)
--task-datastring-CSV with task data (participant, task, completed, time_seconds, errors)
--jsonflagFalseOutput as JSON
python scripts/usability_scorer.py sample
python scripts/usability_scorer.py --sus-responses responses.csv
python scripts/usability_scorer.py --task-data tasks.csv
python scripts/usability_scorer.py --sus-responses responses.csv --task-data tasks.csv --json

Troubleshooting

ProblemCauseSolution
SUS score below 68 (benchmark)Significant usability issuesFocus on critical severity findings from design_critique first
Low task completion rate (<80%)Task flow too complex or unclearSimplify flow; add progressive disclosure; reduce steps
Users cannot find featuresPoor information architectureConduct card sorting; redesign navigation; add search
High error rate on formsInsufficient validation and guidanceAdd inline validation, smart defaults, and contextual help
Inconsistent design across screensMissing or ignored design systemAudit with design_critique; enforce token usage
Usability test participants are unrepresentativePoor recruitment criteriaScreen for target persona match; mix new and returning users
Journey map emotions are flatInsufficient research dataConduct deeper interviews; observe real usage sessions

Success Criteria

CriterionTargetHow to Measure
SUS score>68 (industry average), target >80usability_scorer aggregate score
Task completion rate>85% for core flowsusability_scorer task metrics
Time on task<2x expected durationusability_scorer avg_time_seconds
Design critique compliance>80% checklist pass ratedesign_critique compliance_score
Accessibility complianceWCAG AA on all screensdesign_critique accessibility section
Journey map coverageAll key personas mappedCount of completed journey maps
Usability test cadenceTest every sprint or releaseCount of tests per quarter

Scope & Limitations

In scope:

  • Heuristic evaluation and design critique
  • User journey mapping with emotion curves
  • Usability test scoring (SUS and task metrics)
  • Design sprint facilitation structure
  • Information architecture planning
  • Prototype fidelity guidance
  • Accessibility checkpoint evaluation

Out of scope:

  • Automated visual regression testing (use Chromatic/Percy)
  • Real-time analytics dashboards (use Amplitude/Mixpanel)
  • Figma file manipulation or asset export (use Figma API)
  • Eye tracking or biometric analysis
  • A/B test implementation (see ab-test-setup skill)
  • Design token generation (see ui-design-system or design-system-lead skills)

Integration Points

Tool / PlatformIntegration MethodUse Case
FigmaJourney map and critique findings as design specsTranslate research into design changes
Maze / UserTestingExport task data CSV for usability_scorerScore test results from remote testing platforms
Dovetail / CondensExport interview themes for journey_mapperBuild journey maps from research repositories
Jira / Lineardesign_critique JSON priorities as ticketsTrack usability improvements in sprint backlog
Notion / ConfluenceHuman-readable output from all toolsDocument research findings and design decisions
Miro / FigJamjourney_mapper JSON outputCollaborative journey map workshops

FAQ

What does the product-designer skill do?

Product design across UI/UX, design systems, prototyping, and user research. Use when creating user journey maps, building wireframes, defining design tokens and component systems, planning usability tests, or establishing design principles.

How do I install product-designer?

Run npx skills add https://github.com/borghei/claude-skills --skill product-designer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/product-designer/ (personal) or .claude/skills/product-designer/ (project).

Which AI agents can use product-designer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is product-designer safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed; Runlayer passed; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains product-designer?

It is published by borghei in borghei/claude-skills. It has 4,859 recorded installs.

More from borghei/claude-skills

View all →

business-intelligence

borghei/claude-skills

Business intelligence across dashboard design, visualization, and reporting automation. Use when designing dashboards, building KPI frameworks, automating reports, creating data stories, or optimizing BI tool performance.

Business & Finance1.5K installs

brand-strategist

borghei/claude-skills

Brand strategy covering positioning, identity, brand architecture, messaging frameworks, and governance. Use when developing brand positioning, creating messaging frameworks, auditing brand health, or building brand architecture.

Marketing & SEO776 installs

data-analyst

borghei/claude-skills

Data analysis across SQL, visualization, statistics, and reporting. Use when writing SQL queries, building dashboards, performing cohort or funnel analysis, running hypothesis tests, or presenting data-driven recommendations.

Data & Databases606 installs

cfo-advisor

borghei/claude-skills

Open the skill to read its SKILL.md instructions.

454 installs

data-scientist

borghei/claude-skills

Open the skill to read its SKILL.md instructions.

440 installs

growth-marketer

borghei/claude-skills

Open the skill to read its SKILL.md instructions.

Marketing & SEO428 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance 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.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs