agentsclimarketplace

Define ux success metrics

Skill dineshrevunuru/SuperSkills/define-ux-success-metrics

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 define-ux-success-metrics

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

Defines how a design's success will be measured: HEART goals→signals→metrics, SUS/SEQ/NPS instrument selection, UX benchmarking waves, and analytics measurement plans with macro/micro conversions. Use when asked 'how do we measure success', 'what metrics should we track', 'define KPIs for this feature', 'set up HEART', 'should we use NPS', 'benchmark our UX', 'write a measurement plan', or before any launch that will later be judged. NOT for analyzing usability findings (analyze-usability-data), designing A/B tests (use-quantitative-evidence), or measuring AI output quality (write-ai-evals).

SKILL.md

15.9 KB, as published. Nobody here has run it

Define UX Success Metrics

Turn a fuzzy goal ("make the flow better") into a small set of metrics someone will actually act on — before the work ships, never retrofitted after.

When to use / when NOT to use

Use when:

  • A feature, redesign, or launch needs a definition of success before build starts
  • A stakeholder asks "how will we know this worked?"
  • Someone proposes NPS, "engagement," or a dashboard and you need to pressure-test it
  • Setting up a benchmarking program or a per-launch measurement plan

Do NOT use when:

  • Analyzing session recordings or rating issue severity → analyze-usability-data
  • Designing an A/B test or judging whether a difference is real → use-quantitative-evidence
  • Planning a usability study's sample size or mode → plan-usability-test
  • Measuring AI model output quality (golden sets, rubrics) → write-ai-evals
  • Writing custom survey questions → write-survey (SUS/SEQ are standardized — administer verbatim, never rewrite items)

The method: goals → signals → metrics

Run these steps in order. Do not skip Step 0.

Step 0 — Name the decision the metric feeds. Ask: "If this number moves, who does what differently?" If no one changes behavior, the metric is decoration — cut it. Every metric in the plan must have an owner and a decision attached.

Step 1 — Pick the framework.

Is the product used by choice (consumer/self-serve)?
├── YES → HEART (Google's framework: Happiness, Engagement,
│         Adoption, Retention, Task success)
└── NO — mandated workplace/B2E tool (users can't leave)?
    └── YES → CASTLE (NN/g's B2E complement — Engagement, Adoption,
              and Retention are weak signals when use is mandatory;
              measure Cognitive load, Advanced-feature usage,
              Satisfaction, Task efficiency, Learnability, Errors)

Step 2 — Choose 2–4 categories. Never all five. Tracking everything means acting on nothing. Pick the categories where this specific launch is supposed to move the needle. A new-user onboarding flow cares about Adoption + Task success; a retention feature cares about Retention + Happiness.

Step 3 — Derive Goal → Signal → Metric for each category.

LayerWhat it isTest
GoalSuccess stated in words, no numbersWould the team agree this is what "working" means?
SignalA user behavior or attitude that indicates the goalCan you observe it? (logged action, survey response)
MetricThe countable expression of the signalCan you compute it from real instrumentation, today?

Write goals FIRST. Teams that start at metrics pick whatever the analytics tool already shows — that is the tool defining success, not the design.

Step 4 — Assign an instrument per metric (decision tree below). Mix behavioral (what users do) with at least one attitudinal (what users feel) — behavior alone can't distinguish "efficient" from "gave up fast."

Step 5 — Set baseline, target, and comparison standard. Every metric needs: current baseline (or "capture in Wave 1"), a target, and WHAT you compare against — past self (most common), a competitor, or an industry benchmark. A number with no comparison is noise.

Step 6 — Write the measurement plan (Output format below) and get the metric owners to sign it before build starts.

HEART quick reference

CategoryGoal exampleSignal exampleMetric example
HappinessUsers find the flow effortlessPost-task ease ratingsSEQ average per task; SUS per wave
EngagementUsers return to the feature voluntarilyRepeat visits to featureWeekly actions per active user
AdoptionNew users start using the new flowFirst-time completions% of new users completing flow in first week
RetentionUsers keep coming backReturn visits over time% of Wave-1 users active in month 3
Task successUsers complete the core task unaidedCompletions, errors, abandonsTask success rate; error rate; time-on-task

Caveat on time-on-task: decide up front whether time means efficiency (shorter = better; transactional tasks) or engagement (longer = better; content consumption). The same number reads opposite ways — a plan that doesn't declare the framing invites cherry-picking later.

Instrument selection decision tree

What do you need to measure?
├── Perceived usability of the WHOLE product/flow
│   └── SUS — 10 items, administered post-test/post-wave.
│       5-point agreement scale, alternating positive/negative items.
│       Score = 0–100 (odd items: score−1; even items: 5−score; sum ×2.5).
│       Compare against your own prior waves; ~68 is the published
│       cross-industry average. One SUS number with no comparison
│       point means nothing.
├── Difficulty of ONE task, right after the user did it
│   └── SEQ — single question: "Overall, how difficult or easy was
│       this task?" 1 = Very difficult … 7 = Very easy.
│       Ask immediately after each task, before the next one.
├── Workload on a mission-critical / high-stress task
│   └── NASA-TLX — 6 workload subscales; heavier instrument,
│       use only when overload itself is the risk.
├── Behavioral outcome (did they succeed / convert / return?)
│   └── Analytics events + success rate. Success rate is the
│       simplest usability metric — define pass/fail (and any
│       partial-credit rule) BEFORE running sessions.
└── Stakeholder demands NPS
    └── Administer it, but never alone — see NPS caveats.

NPS caveats (say these out loud when NPS comes up)

NPS ("How likely are you to recommend…?", 0–10; NPS = %promoters[9–10] − %detractors[0–6]):

  1. The bins destroy information. Collapsing an 11-point scale into 3 buckets throws away most of the signal — a 7→8 shift is invisible, a 6→7 shift isn't, arbitrarily.
  2. It's gameable — teams learn to beg for 9s at the survey moment.
  3. It's too coarse for design decisions. NPS can't tell you WHAT to fix; it measures a vague future intention, not experience.

If the org requires NPS: report it, but pair every NPS number with task success + a perceived-usability score (SUS/SEQ) so design decisions run on the diagnostic metrics, not the vanity one.

The small-N prohibition

Never report metrics from a 5-user qualitative study. With n=5, the margin of error swamps the measurement — "3 of 5 succeeded" is an insight prompt, not a 60% success rate. Quantitative UX metrics need ~40 participants; trendable benchmark waves need ~35+. If someone puts a percentage from a qual study in a deck, flag it (enforced jointly with analyze-usability-data).

Benchmarking waves (long-term program)

Benchmarking ≠ per-launch success metrics. Success metrics answer "did THIS launch work?"; benchmarking tracks 2–4 long-haul metrics across releases to answer "is the product getting better?" Run both; don't confuse them.

The 7-step flow (NN/g):

  1. Choose metrics tied to critical tasks — 2–4 metrics covering different UX aspects (one behavioral, one attitudinal minimum)
  2. Pick the collection method — quant usability testing, analytics, or surveys
  3. Establish the baseline wave (~35+ participants for trendable numbers)
  4. Freeze the protocol (checklist below)
  5. Re-measure on a fixed cadence (per major release, or quarterly)
  6. Compare against the chosen standard: past self / competitor / industry
  7. Document every wave in a research repository so wave 6 is still comparable to wave 1

Frozen-protocol checklist — identical across every wave:

  • Task wording — verbatim, character-for-character
  • Instrument and its exact items (SUS/SEQ administered unmodified)
  • Recruiting criteria and screener
  • Device/platform/environment
  • Metric definitions (what counts as success, how timing starts/stops)
  • Documented in the repository with date, N, and any deviations

If the product change breaks a task (the feature moved, the flow no longer exists): version the task, mark the trend line broken at that wave, and start a new baseline for that task. Never quietly reword and keep comparing — a trend across changed protocols is fiction.

Analytics measurement plan (macro/micro conversions)

Translate UX goals into instrumentation BEFORE launch, so day-1 data is usable.

  • Macro conversion — the one primary outcome the product exists for (confirmed booking, completed purchase, published project). One per product surface. This is the number leadership sees.
  • Micro conversions — the smaller steps that indicate progress toward the macro (viewed services, selected time slot, entered contact details). These are the diagnostic layer: when the macro stalls, micros show WHERE the funnel leaks.

Rules:

  1. Every micro must sit on the causal path to the macro. "Time on site" is not a micro conversion; "reached the payment step" is.
  2. Name events in the analytics tool exactly as they appear in the plan — drift between plan names and event names kills the plan within a month.
  3. Report business outcomes, not UX activity. "Ran 3 studies, fixed 14 issues" is activity. "Unaided booking completion up since redesign; support-assisted bookings down" is an outcome. Executives fund outcomes.
  4. Any claim comparing your numbers to market/industry figures goes through craft-critique's evidence protocol — cite the benchmark source or flag it under-evidenced.

Worked example — a salon booking app (beta)

Context: a salon's native booking app in beta. The launch question: "does the app let clients book unaided?"

Framework: HEART (consumer, used by choice). Categories chosen: Adoption, Task success, Happiness (Engagement cut — booking is transactional, more visits ≠ better; Retention deferred to a later wave — beta window too short to read it).

CategoryGoalSignalMetricInstrument
AdoptionExisting clients switch from phone booking to the appFirst-time bookings made in-app% of active clients completing ≥1 in-app booking in first monthAnalytics event booking_confirmed (first per user)
Task successA client completes a booking with zero staff helpBookings completed without a support call/walk-in assistUnaided completion rate; abandonment stepFunnel events + support log cross-check
HappinessBooking feels easyPost-booking ease ratingSEQ (1–7) shown once after first completed booking; SUS emailed each benchmark waveIn-app SEQ prompt; SUS survey

Conversion structure:

  • Macro: booking_confirmed
  • Micros (in funnel order): service_selectedstylist_selectedtimeslot_viewedtimeslot_selectedcontact_completedbooking_confirmed

Plan decisions: baselines captured in Wave 1 of beta (no targets before a baseline exists — a target invented pre-baseline is theater). Comparison standard: past self, wave over wave. Owner per metric named in the plan. Review cadence: end of each beta wave. Time-on-task explicitly framed as efficiency (shorter is better — this is a transactional flow).

Decision each metric feeds: Adoption low → marketing/onboarding problem, not UI; Task success low → funnel micros locate the leaking step for redesign; SEQ low with high completion → it works but feels hard — friction pass next sprint.

Anti-patterns / red flags

Red flagWhy it failsDo instead
Tracking all 5 HEART categoriesDiffuse attention, no action2–4 categories tied to THIS launch's intent
Starting from what the analytics tool showsTool defines success, not designGoals first, metrics last
NPS as the only UX metricCoarse, gameable, non-diagnosticPair with task success + SUS/SEQ
Percentages from n=5 studiesMargin of error swamps signalInsights from small N; metrics from ~40+
Rewording tasks between benchmark wavesTrend becomes fictionFrozen protocol; version + re-baseline on breaks
Metrics defined after launchBaseline lost foreverPlan signed before build starts
"Engagement up" on a transactional flowLonger time may mean users are lostDeclare efficiency-vs-engagement framing up front
Reporting UX activity (studies run, issues fixed)Reads as cost, not valueReport outcome deltas on the agreed metrics
Metric with no owner or decision attachedDashboard decorationStep 0: cut it
Rewriting SUS/SEQ items to "fit the product"Breaks comparability with all benchmarksAdminister standardized instruments verbatim

Output format

# Measurement Plan — [feature/launch name]
Framework: HEART | CASTLE — [why]
Categories: [2–4, with one-line reason each]

## Goals → Signals → Metrics
| Category | Goal | Signal | Metric | Instrument | Baseline | Target | Owner |
|---|---|---|---|---|---|---|---|

## Conversions
Macro: [event name]
Micros (funnel order): [event] → [event] → … → [macro]

## Decisions these metrics feed
- [metric] moves down → [who] does [what]

## Comparison standard: past self / competitor / industry [cite source]
## Review cadence: [when, by whom]
## Benchmarking: [in program? which 2–4 long-haul metrics; wave cadence; protocol doc link]

Sources

Boundaries

  • plan-usability-test owns study planning and sample-size routing; this skill owns WHICH instruments and metrics the study collects.
  • analyze-usability-data owns qualitative findings and severity; instrument scores from this skill enter its analysis as context, not as findings. The small-N prohibition is enforced in both.
  • use-quantitative-evidence owns A/B test design and statistical-vs-practical significance; any "is this metric difference real?" question hands off there.
  • write-ai-evals owns measuring AI output quality (golden sets, rubrics, LLM-as-judge); this skill measures the surrounding product UX.
  • write-survey owns custom survey construction; SUS/SEQ/NPS are standardized instruments administered verbatim, so they live here.
  • Claims comparing metrics to market or industry benchmarks are handled per craft-critique's evidence protocol.

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.