Metrics Definition
Define 3–5 UX KPIs with HEART framing so design bets tie to conversion, retention, and task success you can actually measure.
Overview
metrics-definition is an agent skill most often used in Validate (also Grow, Launch) that defines UX KPIs and HEART-aligned metrics tying design work to measurable outcomes.
Install
npx skills add https://github.com/owl-listener/designer-skills --skill metrics-definitionWhat is this skill?
- Behavioral, attitudinal, business, and engagement metric categories with clear definitions
- HEART framework: Happiness, Engagement, Adoption, Retention, Task success
- Metric template: name, definition, method, source, target, frequency, owner
- Best practice to choose 3–5 primary metrics with baselines before measuring change
- Pairs quantitative targets with qualitative insights for design review
- HEART framework with five dimensions
Adoption & trust: 562 installs on skills.sh; 1.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You ship UI changes but cannot point to a small set of agreed metrics that prove whether design improved task success or business results.
Who is it for?
Founders and designers scoping MVPs, redesigns, or onboarding flows who need a shared metric language before implementation.
Skip if: Teams wanting automated instrumentation code, warehouse SQL, or full analytics platform setup without doing metric strategy first.
When should I use this skill?
Defining UX KPIs, connecting design decisions to measurable outcomes, or applying HEART and metric templates before or after UI changes.
What do I get? / Deliverables
You exit planning with 3–5 owned KPIs, baselines, and measurement methods that guide Build priorities and post-launch reporting.
- Metric spec sheet per template with targets and owners
- Primary KPI set balanced across behavioral and business outcomes
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Metrics definition belongs on Validate scope first because you lock what success means before heavy Build investment. Scope is where hypotheses, primary metrics, baselines, and owners are agreed alongside feature and UX priorities.
Where it fits
Pick three primary metrics and baselines before committing to an onboarding redesign scope.
Refresh adoption and retention targets after a feature ships and wire them into weekly review.
Define conversion and task-success KPIs for a landing experiment tied to a design hypothesis.
How it compares
UX measurement playbook—not a product analytics MCP integration or dashboard builder.
Common Questions / FAQ
Who is metrics-definition for?
Solo builders and design-led teams who need credible UX KPIs linked to business outcomes before and after shipping interface work.
When should I use metrics-definition?
In Validate when scoping an MVP or redesign; in Grow when refining lifecycle and retention metrics; at Launch when defining success criteria for distribution experiments.
Is metrics-definition safe to install?
It contains editorial methodology only; review the Security Audits panel on this page for the skill package source and integrity.
SKILL.md
READMESKILL.md - Metrics Definition
# Metrics Definition You are an expert in defining meaningful UX metrics that demonstrate design impact. ## What You Do You help teams define metrics connecting design work to measurable outcomes. ## Metric Categories - **Behavioral**: Task completion, time on task, error rate, feature adoption - **Attitudinal**: SUS, NPS, CSAT, perceived ease of use - **Business**: Conversion, retention, support volume, onboarding completion - **Engagement**: DAU/MAU, session duration, feature discovery, return visits ## HEART Framework - Happiness: satisfaction, ease ratings - Engagement: frequency, depth - Adoption: activation, feature uptake - Retention: return rate, churn - Task success: completion, time, errors ## Metric Template Name, definition, method, data source, target, frequency, owner. ## Best Practices - Choose 3-5 primary metrics - Balance behavioral and attitudinal - Set baselines before measuring change - Connect metrics to design hypotheses - Report alongside qualitative insights