nw-outcome-kpi-framework SKILL.md skillA

nw-outcome-kpi-framework from nwave-ai/nwave is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nwave-ai/nwave/nw-outcome-kpi-framework@git:20260320.d98f3cb

Pins git:20260320.d98f3cb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nwave-ai/nwave
Path
nWave/skills/nw-outcome-kpi-framework/SKILL.md
Versions recorded
3
Latest version
git:20260320.d98f3cb, committed Mar 20, 2026
First version recorded
Mar 17, 2026
Size
10,013 bytes
Repository stars
633
License
MIT

Outcome KPI definition methodology - synthesizes Who Does What By How Much (Gothelf/Seiden), Running Lean (Maurya), and Measure What Matters (Doerr) into a practical framework for measurable outcome KPIs.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Outcome KPI Framework

"Doing stuff isn't the point. Achieving stuff is." -- Jeff Gothelf

Defines measurable outcome KPIs for user stories and features. Loaded during Phase 4 (Requirements Crafting) to produce `outcome-kpis.md`. Synthesizes three frameworks: customer-centric OKRs, lean metrics, and OKR methodology.

## The Outcome KPI Formula

Primary template from Gothelf/Seiden. Every KPI answers five questions:

| Component | Question | Example |
|-----------|----------|---------|
| **Who** | Which user segment? | Returning customers with 2+ orders |
| **Does What** | What observable behavior changes? | Complete checkout without contacting support |
| **By How Much** | What is the measurable target? | 40% reduction in support tickets |
| **Measured By** | How do we collect the data? | Support ticket system + checkout analytics |
| **Timeframe** | When do we measure? | 30 days post-release, then weekly |

Formula: **[Who] [Does what] [By how much]**

Apply as litmus test: if a KPI cannot answer all five components, it measures an output (feature delivery), not an outcome (behavior change).

### Good vs Bad KPIs

| Bad (Output) | Good (Outcome) |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nwave-ai/nwave/nw-outcome-kpi-framework@sha256:9e9bf77b0af58d50

The line at the top of this page pins the label git:20260320.d98f3cb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_24jlk4ztndzewmek.svg)](https://markdownregistry.com/a/art_24jlk4ztndzewmek)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Mar 17, 2026 and Mar 20, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20260320.d98f3cb latest2026-03-20 d98f3cb 10,013 BA view · diff
git:20260318.e6a0e192026-03-18 e6a0e19 9,991 BA view · diff
git:20260317.1d161472026-03-17 1d16147 9,982 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10013 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nwave-ai/nwave · 633 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_24jlk4ztndzewmek
GET https://markdownregistry.com/api/v1/resolve?ref=nwave-ai/nwave/nw-outcome-kpi-framework
GET https://markdownregistry.com/api/v1/blob/9e9bf77b0af58d50a18e9a6bba331e177837def041fbec80d794f2b25c42e34e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nwave-ai/nwave

nw-ab-agent-template SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-agent-template/SKILL.md · KNOWLEDGE — the canonical agent-spec template (frontmatter + body skeleton). Reference loaded by the create/migrate…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-anti-patterns SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-anti-patterns/SKILL.md · KNOWLEDGE — agent/skill/command anti-pattern catalog with fixes. Reference scanned by validate-spec; no sequence.
git:20261102.c67d57b · audit A · 633 stars
nw-ab-create-agent SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-create-agent/SKILL.md · PROCEDURE — create a NEW agent via the 5-phase workflow (ANALYZE→DESIGN→CREATE→VALIDATE→REFINE). Trigger: build a new…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-critique-dimensions SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-critique-dimensions/SKILL.md · Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation
git:20260320.d98f3cb · audit A · 633 stars
nw-ab-examples SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-examples/SKILL.md · KNOWLEDGE — canonical worked examples for agent creation, migration, and command optimization. Reference for the…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-house-style SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-house-style/SKILL.md · KNOWLEDGE — caveman-native authoring house style + by-construction guarantees (Reasoning Mandate injection…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-merge-agents SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-merge-agents/SKILL.md · PROCEDURE — merge agent B into agent A, relocating skills and cleaning up all references. Trigger: two agents must…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-migrate-monolith SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-migrate-monolith/SKILL.md · PROCEDURE — migrate one legacy monolithic agent to a lean core plus routed skills. Trigger: an existing agent has…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-command SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-command/SKILL.md · PROCEDURE — optimize a bloated command file to a lean declarative definition (forge.md pattern). Trigger: a command…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-optimize-skill SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-optimize-skill/SKILL.md · PROCEDURE — optimize one requested existing skill. Measures multi-trigger, duplication, and resident-context debt…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validate-spec SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validate-spec/SKILL.md · PROCEDURE — validate an EXISTING agent spec against the nw-ab-validation-checklist. Trigger: checking a spec for…
git:20261102.c67d57b · audit A · 633 stars
nw-ab-validation-checklist SKILL.md skill
nwave-ai/nwave · nWave/skills/nw-ab-validation-checklist/SKILL.md · KNOWLEDGE (data) — the agent-spec validation checklist. The item definitions the validate-spec procedure RUNS against…
git:20261102.c67d57b · audit A · 633 stars

Every file in nwave-ai/nwave

Browse by kind, by grade A, or by owner.