agentsclimarketplace

Plan usability test

Skill dineshrevunuru/SuperSkills/plan-usability-test

How I work, encoded as skills — 88 portable AI SKILL.md files (research, design, AI-product, motion, code, business). Fork it, make it yours. Inspired by @mattpocock + @emilkowalski, grounded in NN/g.

Install
npx -y skills add dineshrevunuru/SuperSkills --skill plan-usability-test

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 23 days oldThe repository was created 23 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Plans a usability test end-to-end the NN/g way: study goals → qual/quant fork → sample size (5-user rule and exactly when it fails) → moderated/unmoderated × remote/in-person mode choice → recruiting numbers → mandatory pilot with fix-then-freeze. Use when asked to 'plan a usability test', 'set up user testing', 'test this prototype/app/flow', 'how many users do I need', 'is 5 users enough', 'moderated or unmoderated?', 'remote or in-person?', or when a stakeholder wants metrics from a small study. Produces a complete test plan document.

SKILL.md

15.4 KB, as published. Nobody here has run it

Plan Usability Test

Turn a research question into a defensible usability test plan: right sample size, right mode, piloted before a single real participant sits down.

When to use / when NOT to use

Use when:

  • Someone needs to evaluate whether users can accomplish tasks in a design, prototype, or live product
  • Deciding sample size, study mode, or session logistics for any usability study
  • A stakeholder demands "statistically significant" results and you must size the study honestly
  • Defending a small-N study to skeptics

Do NOT use when — hand off instead:

  • Writing the actual task scenarios → write-task-scenarios (this skill decides how many tasks and what kind; that skill writes them)
  • Writing the screener survey or recruiting logistics detail → write-participant-screener
  • Running the live session (think-aloud, probing) → moderate-usability-session
  • Turning session notes into findings and severity ratings → analyze-usability-data
  • Choosing between usability testing and 19 other research methods → choose-research-method (come here only after usability testing is the chosen method)
  • Designing an A/B test or interpreting quant significance → use-quantitative-evidence
  • Picking long-haul product metrics (SUS/HEART/benchmark waves) → define-ux-success-metrics

The method (NN/g planning chain: goals → method → tasks → recruit → pilot)

Execute in order. Each step gates the next — do not pick a sample size before the qual/quant fork, do not recruit before the mode is fixed.

Step 1 — Define study goals

  • Write 2–4 research questions the study must answer. Answerable, specific, scoped to a part of the product: "Can first-time visitors book an appointment without help?" — not "Is the app usable?"
  • Name the scope explicitly (which flows, which platform, which fidelity). The 5-user math applies per scope tested — a study of one flow says nothing about the flows you didn't test.
  • Get stakeholder sign-off on the questions NOW. Scope added after recruiting starts breaks the plan.

Step 2 — The qual/quant fork (this decides everything downstream)

Ask: insights or numbers?

GoalStudy typeWhat you getWhat you must NOT claim
Find and fix problemsQualitative (formative)Observed failures, confusions, why they happenAny percentage. "3 of 5 users failed" is an observation, not a 60% failure rate
Measure performance against a target or baselineQuantitative (summative)Success rate, time-on-task, error rate with marginsAnything about why — pair with qual if you need causes

Hard rule: never report metrics from a qualitative-sized study. Numbers from n=5 have margins of error so wide they are noise (NN/g: "Why You Cannot Trust Numbers from Qualitative Usability Studies"). If the plan promises numbers, it must budget for the quant sample sizes in Step 3 — otherwise renegotiate the promise, don't fake the math.

Step 3 — Sample size decision tree

Is the goal qualitative problem-finding?
├── YES → Is the user population one roughly-homogeneous group
│         (same tasks, same context of use)?
│         ├── YES → 5 users. Done.
│         └── NO — genuinely divergent segments (different tasks or
│             wildly different domain knowledge, e.g. patients vs
│             clinicians) → 3–4 users PER segment.
│             Two similar personas ≠ divergent segments. Divergence
│             means they'd hit DIFFERENT problems, not just differ
│             demographically.
└── NO → What are you measuring?
    ├── Task metrics (success rate, time, errors) → ~40 participants
    ├── Eyetracking heatmaps → ~39 users per heatmap
    ├── Card sorting → ~15 participants
    └── Benchmark wave (trend over releases) → ~35+ per wave
        (then this is a program — see define-ux-success-metrics)

Why 5 works for qual: problems found ≈ N(1 − (1 − L)^n), with average per-user discovery rate L ≈ 31%. At n=5 that's ~85% of the problems in the tested scope. Users 6+ mostly re-show you what you've already seen.

The iteration corollary (spend the budget here): 3 rounds of 5 users with fixes between rounds beats 1 round of 15. Round 1 finds the big problems, the fix creates new questions, rounds 2–3 catch what the fixes broke. If the budget covers 15 participants, the default plan is 5 × 3 iterations — one 15-user study is the anti-pattern.

Defending small N to skeptics: the goal of a qual test is finding-and-fixing, not statistical proof. Show the discovery curve, show the per-problem evidence (clips, quotes), and offer a quant follow-up study for any claim that needs a number. Handle every claim in the readout per craft-critique's evidence-discipline protocol — observed problems are citable evidence; extrapolated percentages from n=5 are not.

Step 4 — Mode selection (moderated/unmoderated × remote/in-person)

ModeCost / speedData depthUse whenInvalid when
Moderated in-personHighest cost, slowestRichest — body language, environment, hands on hardwareHardware/physical products; assistive-tech users on their own devices; fragile prototypes needing a wizard; sensitive topicsBudget/geography can't support it and remote loses nothing
Moderated remoteMedium — no travel, wider recruit poolNear in-person depth: live probing, clarification, task repairDefault for most studies. Early prototypes, complex flows, exploratory "why" questionsParticipant can't run the tech; you need their physical context
Unmoderated remoteCheapest — ~20–40% cheaper, saves ~20 researcher-hours; runs in parallel, overnightThinnest — no probing, no clarification, no repairStable UI, simple well-defined tasks, larger N needed fast, natural-environment behaviorExploratory/why questions; fragile prototypes; tasks needing any mid-session judgment. Platform ceiling ≈ 20 min/session
Unmoderated in-personRare (kiosk / lab intercept)ThinWalk-up kiosk hardwareAlmost everything else — skip by default

Decision shortcuts:

  • Need to ask "why" or "what did you expect?" mid-task → moderated, no exception.
  • Prototype might break or dead-end → moderated (a moderator repairs; an unmoderated participant just quits and the data point is garbage).
  • Quant study at ~40 participants → unmoderated remote is usually the only affordable mode; accept the depth loss, it's a numbers study anyway.
  • Testing with screen-reader / assistive-tech users → in-person, their own equipment (see audit-accessibility for the full protocol).

Step 5 — Tasks

Decide count and type here; write them in write-task-scenarios.

  • Qualitative session: 4–8 tasks in ~60 min moderated; ≤5 short tasks in a 20-min unmoderated session.
  • Quantitative: every task needs one concrete, machine-checkable success state — no open-ended exploration.
  • Order: warm-up task first, highest-priority research questions next (fatigue kills the last task's data), independent tasks so one failure doesn't cascade.

Step 6 — Recruit

  • Define the participant profile by behavior and context, not demographics ("booked a service appointment online in the last 3 months", not "women 25–40").
  • Screener writing → write-participant-screener.
  • Over-recruit for no-shows: +1 floater per 5 moderated sessions; +15–20% for unmoderated.
  • Schedule moderated sessions with 30-min gaps for reset and debrief notes.

Step 7 — Logistics (fix before pilot)

  • Session length (60 min moderated typical; ≤20 min unmoderated), incentive, consent + recording permission, prototype links tested on the participant-facing device, note-taking template, observer ground rules.

Step 8 — Pilot: mandatory, with fix-then-freeze

No plan ships without a pilot session. Not optional at any budget.

  1. Schedule the pilot ≥2 days before the first real session — enough runway to fix what it finds.
  2. Run a full dress rehearsal with one participant (a colleague outside the project is acceptable; a real recruited user is better).
  3. Validate all five: task wording understood as intended · session fits the time slot · task order has no cascades · screener actually selected the right person · tech works end-to-end (links, recording, remote platform).
  4. Fix everything the pilot exposed.
  5. Freeze. After the first real session begins, the protocol is immutable — no reworded tasks, no reordered lists, no new questions. Mid-study edits make sessions incomparable and the findings unaggregatable.
  6. Pilot data is keepable as a real data point only if nothing changed. Changed one word of one task? The pilot is calibration, not data.

For unmoderated studies the pilot is doubly mandatory: there is no moderator to repair a broken task, so a flawed task silently ruins every parallel session at once. Pilot the exact platform flow a participant will see, including the intro screens.

Worked example — filled plan

Context: salon booking app in beta (Dinesh's shipped freelance work); question is whether new clients can book unaided before wide release.

# Usability Test Plan — Booking App Beta, First-Booking Flow
Date: 2026-07-14 · Owner: Dinesh · Status: pilot scheduled 2026-07-16

## 1. Research questions
RQ1 Can a first-time user book an appointment without assistance?
RQ2 Where do users hesitate or stall between service selection and confirmation?
RQ3 Do users understand what happens after booking (confirmation, reminders)?
Scope: booking flow only, iOS beta build. Excludes: rebooking, cancellation, admin app.

## 2. Study type
Qualitative / formative — find and fix before release. No metrics will be
reported from this study. (Quant benchmark deferred to post-launch, n≈40.)

## 3. Participants
Profile (behavioral): booked any personal-service appointment online in the
last 3 months; has NOT used this app; owns an iPhone.
N = 5 (single segment — new clients all attempt the same flow).
Recruit 6 (1 floater). Screener: see write-participant-screener output.

## 4. Mode
Moderated remote (video call + screen share of beta build).
Why: beta may dead-end (moderator repair needed) and RQ2 requires live probing.
In-person rejected: no hardware/context dependency justifies the cost.
Unmoderated rejected: fragile build + "why" questions = invalid mode.

## 5. Tasks (written in write-task-scenarios)
T1 warm-up: browse services · T2 book a specific service (RQ1, RQ2)
T3 locate confirmation details (RQ3) · T4 open exploration of anything unclear
Session: 45 min + 15 min buffer.

## 6. Logistics
Incentive: $50 gift card · Consent + recording form sent at scheduling
Observers: silent, questions routed to moderator via chat, debrief after each
session · Notes: one observation per note, observation ≠ interpretation.

## 7. Pilot — 2026-07-16 (2 days before session 1)
Validate: task wording, 45-min fit, task independence, screener accuracy,
screen-share of beta build on participant's own iPhone.
Fix-then-freeze: protocol locked after pilot fixes; pilot counts as data
only if zero changes result.

## 8. Limitations (stated up front, per craft-critique evidence protocol)
Findings are problem discoveries in the booking flow only; no population
percentages will be claimed. Untested flows carry no evidence either way.

Anti-patterns / red flags

Red flagWhy it failsFix
"We tested with 5 users: 80% success rate"Fake quant — n=5 margins are noiseReport observed problems; run n≈40 if a number is required
One 15-user study to "be thorough"Same problems found 3×, zero fixes validated3 iterations × 5 users, fix between rounds
5 users total across patients + cliniciansDivergent segments hit different problems3–4 per segment
Unmoderated study with "explore and tell us why" tasksNo probing exists in the mode; you get silence or fictionModerated, or rewrite as concrete tasks
Skipping the pilot to hit a deadlineFirst real session becomes the pilot — that data is burned anyway1 pilot ≥2 days out; it's cheaper than one wasted participant
Rewording a confusing task after session 2Sessions 1–2 and 3–5 are now different studiesFreeze after pilot; log the flaw, fix next round
Recruiting by demographics ("millennials")Demographics don't predict behavior with the productScreen on behavior + context
40-min unmoderated session planPlatforms cap ~20 min; participants rush or dropCut tasks or switch to moderated
Sample size chosen before the qual/quant forkThe fork determines N, not the other way aroundRun Step 2 first, always

Output format

Produce a single test-plan document with exactly these sections (as in the worked example): 1 Research questions + scope · 2 Study type (qual/quant + what will NOT be claimed) · 3 Participants (profile, N with justification, recruit count) · 4 Mode (chosen + rejected modes with reasons) · 5 Tasks (count, order, pointer to write-task-scenarios) · 6 Logistics · 7 Pilot date + fix-then-freeze note · 8 Limitations. A plan missing section 2's "will not claim" line or section 7's pilot date is incomplete — do not present it.

Sources

Boundaries

  • write-task-scenarios owns writing the tasks; this skill only sets count, type (concrete vs exploratory), and order.
  • write-participant-screener owns screener questions and recruiting logistics detail; this skill sets the profile and N.
  • moderate-usability-session owns everything inside the live session; analyze-usability-data owns everything after it.
  • use-quantitative-evidence owns A/B tests and statistical interpretation; this skill only routes quant goals to the right sample size.
  • define-ux-success-metrics owns metric/instrument selection (SUS, SEQ, HEART) and benchmark programs.
  • audit-accessibility owns testing protocol adaptations for assistive-tech participants.
  • craft-critique owns the evidence-discipline protocol — claims in plans and readouts are handled per that skill, never restated here.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.