Agent skill

Lean UX

by wondelai in wondelai/skills

Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables.

MITAuto-check passedFrontend & Design

Install Lean UX

skills CLI
$ npx skills add wondelai/skills --skill lean-ux -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wondelai/skills lean-ux --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wondelai/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/lean-ux .claude/skills/lean-ux && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lean-ux
GitHub stars
2.4k
Token cost
~4k tokens
SKILL.md length
1,924 words
Files
7 (incl. references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables.

  • Works in 6 steps: Declaring Assumptions → Hypothesis Statements → MVPs and Experiments → …
  • The user mentions Lean UX
  • SKILL.md covers Core Principle, Scoring, Framework and Common Mistakes, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Lean UX is an agent skill from wondelai/skills. Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables. Use when the user mentions "Lean UX", "design hypothesis", "outcome over output", "design studio method", "assumption mapping", "lightweight research", "too much design documentation", or "get the team designing together". Also trigger when reducing design-documentation overhead, getting cross-functional teams to co-design, or running fast usability experiments. Covers hypothesis…

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/agile-integration.md`, `references/case-studies.md` and `references/collaborative-design.md`).

It sits in Frontend & Design, covering UX design. The repository describes itself as: Wondel.ai Agent Skills — Business, Marketing, UX & Coding Frameworks from Bestselling Books. 50 skills + 12 guided journeys for Claude Code, Codex, Cursor & other agentskills.io… The licence is MIT.

When your agent uses it

  • The user mentions Lean UX
  • Design hypothesis
  • Outcome over output
  • Design studio method

Example prompts

  • “Lean UX”
  • “design hypothesis”
  • “outcome over output”
  • “/lean-ux”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Declaring Assumptions
  2. Hypothesis Statements
  3. MVPs and Experiments
  4. Collaborative Design
  5. Feedback and Research
  6. Integration with Agile

What it can do on your machine

Read from SKILL.md and the folder at commit c172996. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • amazon.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lean UX loads about 4k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 167 tokens; SKILL.md has 1,924 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~167
When it runs · the whole SKILL.md, loaded when a task matches
~4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~24k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wondelai/skills at commit c172996, republished under its MIT licence (© wondelai). 1,924 words, ~4,010 tokens.

Download SKILL.mdSave it as .claude/skills/lean-ux/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
lean-ux
description
Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables. Use when the user mentions "Lean UX", "design hypothesis", "outcome over output", "design studio method", "assumption mapping", "lightweight research", "too much design documentation", or "get the team designing together". Also trigger when reducing design-documentation overhead, getting cross-functional teams to co-design, or running fast usability experiments. Covers hypothesis statements, MVPs for UX, and cross-functional collaboration. For Build-Measure-Learn, see lean-startup. For usability audits, see ux-heuristics.
license
MIT
metadata.author
wondelai
metadata.version
1.4.0

Lean UX Framework

A practice-driven approach to UX that replaces heavy deliverables with rapid experimentation, cross-functional collaboration, and continuous learning. Lean UX shifts the question from "What should we design?" to "What do we need to learn?"

Core Principle

Outcomes over outputs. The value of a design is measured not by the fidelity of the deliverable but by the change in user behavior it produces.

The foundation: Traditional UX waterfalls requirements into wireframes, mockups, specs, and code—losing context and hiding untested assumptions at every handoff. Lean UX compresses the distance between idea and evidence: declare assumptions, form hypotheses, run the smallest possible experiment, and let real user behavior settle the argument. Shared understanding replaces documentation; learning velocity replaces pixel perfection.

Scoring

Goal: 10/10. Score a UX process, design plan, or team workflow by the eight-row Quick Diagnostic below: award ~1.25 points per row answered "yes" (8 yeses = 10). Bands:

  • 9-10 — assumptions declared, hypotheses with pre-committed success criteria, lowest-fidelity experiments, whole-team design, weekly research, outcome (not output) metrics, dual-track agile, and a recently invalidated hypothesis on the books.
  • 5-6 — hypotheses exist but criteria are vague or fidelity is over-invested; design and research still partly siloed.
  • <=3 — heavy deliverables, untested assumptions, output-counting, no experiment log.

Always state the current score, the diagnostic rows that failed, and the specific fix for each.

Framework

1. Declaring Assumptions

Core concept: Every design starts with assumptions. Lean UX makes them explicit so they can be prioritized and tested, rather than baked invisibly into specifications.

Why it works: Unspoken assumptions mean teams build on shaky ground and discover problems only after launch; surfacing them early focuses energy on the riskiest ones and reduces the cost of being wrong.

Key insights:

  • Business assumptions define what must be true for the business (revenue model, market size, willingness to pay); user assumptions define who users are and how they behave
  • Prioritize on two axes: risk (how damaging if wrong) and uncertainty (how little we know)
  • Test high-risk, high-uncertainty assumptions first
  • Write assumptions collaboratively as a team, not in isolation

Product applications:

ContextApplicationExample
New feature kick-offAssumption mapping workshop"We assume users want to share reports with teammates"
Roadmap planningRank features by assumption riskPrioritize features whose success depends on untested beliefs
Stakeholder alignmentExpose hidden assumptions across rolesPM assumes pricing works; engineer assumes scale; designer assumes flow

Ethical boundary: Assumptions must be honest assessments, not post-hoc justifications—if leadership has already committed to a direction, acknowledge the constraint rather than pretending it's open to falsification.

See references/hypothesis-canvas.md when running an assumption workshop or writing a hypothesis — the risk/uncertainty prioritization matrix, business-vs-user assumption split, and fillable hypothesis and sub-hypothesis templates.

2. Hypothesis Statements

Core concept: A hypothesis translates an assumption into a testable prediction, linking a proposed change to a measurable outcome for a specific user segment.

Why it works: Hypotheses force precision—instead of "make onboarding better," the team commits to a prediction that can be proven or disproven, which prevents scope creep and makes the learn step unambiguous.

Key insights:

  • Standard format: "We believe [outcome] will happen if [persona] achieves [action] with [feature]"
  • Every hypothesis specifies persona, action, outcome, and measurable signal
  • Sub-hypotheses break a large bet into independently testable parts
  • Agree on what "validated" and "invalidated" look like before running the experiment

Product applications:

ContextApplicationExample
Feature designWrite hypothesis before wireframing"We believe trial-to-paid conversion will rise 10% if new users complete a guided setup wizard"
A/B testsFormalize test rationale"We believe click-through will rise 15% if we move the CTA above the fold"
Sprint planningAttach hypothesis to each storyStory: "filter by date." Hypothesis: "task completion time drops 30%"

Ethical boundary: Never cherry-pick metrics after the fact to declare a hypothesis validated—pre-commit to success criteria.

See references/outcome-metrics.md when picking the measurable signal for a hypothesis or defining team success — outcomes-vs-outputs, leading-vs-lagging indicator pairs, UX OKRs, and the vanity metrics to avoid.

3. MVPs and Experiments

Core concept: An MVP in Lean UX is the smallest design artifact that can test a hypothesis with real users—a learning tool, not a product launch.

Why it works: A paper prototype tested with five users in a hallway can invalidate a hypothesis that would otherwise consume a full engineering sprint; matching experiment fidelity to assumption risk maximizes learning per unit of effort.

Key insights:

  • Experiments range from low fidelity (paper prototypes, concierge tests) to high fidelity (coded A/B tests, Wizard of Oz)
  • Choose the lowest-fidelity experiment that can answer the question
  • A good experiment has a clear hypothesis, defined audience, measurable signal, and time box
  • Proto-personas can stand in for full research when speed matters, but must be validated later

Product applications:

ContextApplicationExample
Early concept validationPaper prototype or clickable mockupSketch 3 concepts, test with 5 users same day
Demand validationLanding page smoke test"Sign up for early access" measures real interest
Usability validationClickable prototype testFigma prototype tested with 5-8 users
Pricing validationPainted door testShow pricing page, measure click-through before building billing

Ethical boundary: Smoke tests and fake doors must not mislead users into believing a product exists—disclose test status and offer an opt-out.

See references/experiment-patterns.md when choosing or designing an experiment — the full catalog of experiment types with when/when-NOT-to-run notes, the experiment selection matrix and fidelity ladder, and a design template.

4. Collaborative Design

Core concept: Design is a team sport. Lean UX replaces the solitary designer-then-handoff model with cross-functional sessions where developers, PMs, and designers sketch solutions together.

Why it works: Developers who helped sketch the solution don't need a 40-page spec to build it—shared understanding replaces documentation, diverse perspectives generate more creative solutions, and handoff waste drops dramatically.

Key insights:

  • Design Studio method: diverge (individual sketching), present, critique, converge (refined sketch), iterate
  • The goal is informed commitment, not consensus: the team agrees on what to test, not what is "right"
  • Cross-functional means engineers, QA, data analysts, and stakeholders sketch too
  • Style guides and pattern libraries are living documents; reduce deliverables to the minimum needed for shared understanding (often a whiteboard photo)

Product applications:

ContextApplicationExample
Sprint kick-offDesign Studio session (90 minutes)Whole team sketches solutions to the sprint's hypothesis
Feature explorationCollaborative sketching workshop6-up sketches: each person draws 6 ideas in 5 minutes
Remote teamsVirtual whiteboard sessionsFigJam or Miro board with timed sketch rounds

Ethical boundary: Collaboration must not become design by committee—a designated designer synthesizes input; the team does not vote on pixels.

See references/collaborative-design.md when facilitating a Design Studio — the step-by-step workshop protocol (timings, materials, remote variants) and how to keep style guides as living documents.

Show full SKILL.md (825 more words)Show less
5. Feedback and Research

Core concept: Continuous, lightweight research replaces big-bang usability studies—small research activities embedded in every sprint instead of quarterly reports.

Why it works: Findings only change a decision while it is still cheap to reverse, so research value decays with every sprint between learning and the decision it informs; small weekly studies keep that gap near zero, which a quarterly report never can.

Key insights:

  • Research types: usability tests, customer interviews, A/B tests, analytics review, surveys, diary studies
  • Five users uncover approximately 85% of usability problems (Nielsen)
  • Continuous cadence: recruit weekly, test weekly, synthesize weekly
  • The whole team should observe at least some sessions to build empathy
  • Proto-personas are refined and eventually replaced by evidence-based personas

Product applications:

ContextApplicationExample
Weekly usability testingTest prototype with 3-5 users every Thursday"Testing Thursday" ritual with rotating facilitators
Post-launch learningMonitor analytics + 3 follow-up interviewsFind drop-off points, interview churned users
Persona validationCompare proto-persona assumptions to interview data"We assumed power users are marketers; data shows ops managers"

Ethical boundary: Conduct research with informed consent—participants should understand how their data is used and be free to withdraw.

6. Integration with Agile

Core concept: Lean UX works inside Agile via dual-track development: discovery (learning what to build) and delivery (building it) run in parallel.

Why it works: Design work doesn't fit neatly into a delivery sprint; running discovery one sprint ahead means validated designs are ready when the delivery sprint begins, instead of design forever catching up.

Key insights:

  • The discovery track (research + design) feeds the delivery track (engineering + QA), staggered one sprint ahead
  • User stories gain a hypothesis and success metric alongside acceptance criteria
  • "Definition of Done" for UX includes validated learning, not just shipped pixels
  • Backlog items from invalidated hypotheses are removed, not deferred

Product applications:

ContextApplicationExample
Sprint planningInclude hypothesis validation in sprint goals"Sprint goal: validate that inline editing cuts task time 20%"
Backlog refinementAttach experiment results to storiesStory moves to delivery only after hypothesis is validated
RetrospectivesReview learning velocity alongside delivery velocity"We validated 4 hypotheses and invalidated 2 this sprint"

Ethical boundary: Never use Lean UX as an excuse to skip accessibility, security, or compliance—these are non-negotiable quality standards, not assumptions to test.

See references/agile-integration.md when fitting discovery into a delivery cadence — the staggered dual-track sprint mechanics, how stories carry a hypothesis, and a UX Definition of Done.

See references/case-studies.md when you want a worked end-to-end example to model an engagement on — four composite scenarios (enterprise, startup, agency, internal tools) showing assumptions, experiments, and before/after outcome metrics.

Common Mistakes

MistakeWhy It FailsFix
Treating MVPs as launchesOver-building by conflating MVP with first releaseReframe: MVP = learning tool, not product launch
Skipping assumption declarationHidden assumptions become expensive surprisesRun a 30-minute assumption mapping session at kick-off
Hypothesis without success criteriaCan't tell if the experiment passedPre-commit to metric, threshold, and sample size
Designer-only designHandoff waste, misalignment, slow iterationRun Design Studio sessions with the full team
Research as a phaseFeedback arrives too late to matterEmbed lightweight research in every sprint
Ignoring invalidated hypothesesBuilding features that failed testingRemove invalidated items from the backlog; pivot or drop
Documenting instead of collaborating40-page specs nobody readsReplace specs with shared understanding from co-design
Measuring outputs not outcomesShipping features that don't change behaviorDefine success as behavior change, not delivery

Quick Diagnostic

Audit any UX process or design plan:

QuestionIf NoAction
Are assumptions explicitly declared?Hidden assumptions drive decisionsRun an assumption mapping workshop
Is there a testable hypothesis?Building on opinionWrite hypothesis in standard format before designing
Is the experiment the lowest fidelity that answers the question?Over-investing before learningDowngrade to paper prototype or smoke test
Does the whole team participate in design?Handoff waste and misalignmentSchedule a Design Studio session
Is research happening every sprint?Feedback loop too slowEstablish a weekly testing cadence
Are you tracking outcomes, not just outputs?Shipping without learningDefine behavior-change metrics per feature
Does UX work feed into Agile smoothly?Design bottleneck or sprint-zero trapImplement dual-track agile with staggered sprints
Can you point to a recently invalidated hypothesis?Not learning; confirmation biasReview the experiment log and celebrate a pivot

Further Reading

For the complete methodology, research, and case studies:

About the Authors

Jeff Gothelf is an organizational designer, coach, and author who spent over 15 years leading UX teams at companies including TheLadders and Neo Innovation; watching teams waste months on unvalidated deliverables led him to create Lean UX. Josh Seiden is a designer and product strategist with 25+ years of experience who co-founded the interaction design practice at Cooper and was Managing Director at Neo Innovation. Together they co-authored Lean UX and Sense and Respond.

© wondelai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in lean-ux of wondelai/skills.

  • SKILL.md
  • references/agile-integration.md
  • references/case-studies.md
  • references/collaborative-design.md
  • references/experiment-patterns.md
  • references/hypothesis-canvas.md
  • references/outcome-metrics.md

Open the folder on GitHubat commit c172996

Compare with similar skills

Lean UX next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lean UX compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lean UX this skillwondelai/skills2.4k—~4kAutomated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k26 repos~2.6kAutomated safety check: PassMIT
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Animategrowupanand/ConvoForm1026 repos~1.9kAutomated safety check: PassApache-2.0
Migrate Content Iadocker/docs4.7k—~5.1kAutomated safety check: PassApache-2.0
UX WalkthroughXiaoMi/hiui879—~1.3kAutomated safety check: PassMIT

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 26 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed
  • Animate

    growupanand/ConvoForm

    Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

    102 GitHub starsUsed in 6 repos~1.9k tokens
    Frontend & DesignAuto-check passed
  • Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • UX Walkthrough

    XiaoMi/hiui

    体验走查 skill。适用于代码库、URL、截图三种输入,输出结构化体验问题报告,并同步生成本地 docx 报告。触发词:体验走查、UX review、交互走查、界面审查、体验问题。

    879 GitHub stars~1.3k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    743 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed

More from wondelai/skills

All 62 skills in this repo
  • Crossing The Chasm

    wondelai/skills

    Navigate the technology adoption lifecycle from early adopters to mainstream market.

    2.4k GitHub stars~3.6k tokensUpdated 29 days ago
    Auto-check passed
  • Design Everyday Things

    wondelai/skills

    Apply foundational design principles: affordances, signifiers, constraints, feedback, and conceptual models.

    2.4k GitHub stars~4k tokensUpdated 29 days ago
    Auto-check passed
  • Design Sprint

    wondelai/skills

    Run a structured 5-day process to prototype, test, and validate product ideas with real users.

    2.4k GitHub stars~3.8k tokensUpdated 29 days ago
    Auto-check passed
  • Hooked UX

    wondelai/skills

    Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment).

    2.4k GitHub stars~3.5k tokensUpdated 29 days ago
    Auto-check passed
  • Improve Retention

    wondelai/skills

    Diagnose and fix retention problems using behavior design (B=MAP).

    2.4k GitHub stars~3.8k tokensUpdated 29 days ago
    Auto-check passed
  • Monetizing Innovation

    wondelai/skills

    Design products and pricing around validated willingness to pay, from Ramanujam & Tacke's "Monetizing Innovation".

    2.4k GitHub stars~5.2k tokensUpdated 29 days ago
    Auto-check passed

Questions about Lean UX

What does Lean UX do?

Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables. Lean UX is an agent skill from wondelai/skills. Apply lean thinking to UX: hypothesis-driven design, collaborative sketching, and rapid experiments instead of heavy deliverables.

When should I use Lean UX?

Lean UX fits situations like: the user mentions Lean UX; design hypothesis; outcome over output; design studio method.

How do I install Lean UX in Claude Code?

Run `npx skills add wondelai/skills --skill lean-ux -a claude-code`. Or copy the skill folder (lean-ux in wondelai/skills) into .claude/skills/lean-ux in your project. Claude Code loads it when a task matches its description.

How do I install Lean UX in Codex?

Run `npx skills add wondelai/skills --skill lean-ux -a codex`. Or copy the skill folder (lean-ux in wondelai/skills) into .agents/skills/lean-ux in your project. Codex loads it when a task matches its description.

Can I use Lean UX in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wondelai/skills --skill lean-ux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lean-ux, .gemini/skills/lean-ux, .github/skills/lean-ux and .opencode/skills/lean-ux in your project.

What does Lean UX need to run?

SKILL.md names no scripts, command-line tools or credentials: Lean UX is instructions for the agent only.

Does Lean UX access the network?

SKILL.md names 1 domain. As links in the text: amazon.com. This is read from the text; nothing was executed.

Is Lean UX safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lean UX use?

Lean UX is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lean UX use?

About 4k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 20k tokens, read only when the agent opens those files.

What are the alternatives to Lean UX?

Skills that share tags, products or a category with Lean UX: Impeccable (bestofjs/bestofjs, 3.1k stars), Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Animate (growupanand/ConvoForm, 102 stars) and Migrate Content Ia (docker/docs, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lean UX?

wondelai (a GitHub organization) maintains it in wondelai/skills, which has 2,371 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 10, 2026.

Source: wondelai/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.