Skip to content
Skills Library
Management & product · Planning

create-metrics-framework

/create-metrics-framework

Define a North Star metric, input metrics, and guardrail metrics when the user asks to create a metrics framework, define KPIs, or set up measurement

Licence
MIT
Last repository change
10.05.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.05.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Define a North Star metric, input metrics, and guardrail metrics when the user asks to create a metrics framework, define KPIs, or set up measurement

Arguments

/create-metrics-framework [product area or business goal to build metrics around]
Original author description

Define a North Star metric, input metrics, and guardrail metrics when the user asks to create a metrics framework, define KPIs, or set up measurement

How it works

  1. Overview
  2. Workflow
  3. Output
  4. Anti-patterns
Original SKILL.md headings · 41 lines, 483 words
SKILL.md preview
---
name: create-metrics-framework
description: Define a North Star metric, input metrics, and guardrail metrics when the user asks to create a metrics framework, define KPIs, or set up measurement
author: chalk
version: "1.0.0"
metadata-version: "3"
allowed-tools: Read, Glob, Grep, Write
argument-hint: "[product area or business goal to build metrics around]"
read-only: false
destructive: false
idempotent: false
open-world: false
user-invocable: true
tags: metrics, measurement, kpi
---

# Create Metrics Framework

## Overview

Build a metrics framework combining the North Star Framework (Amplitude), AARRR Pirate Metrics, and HEART Framework (Google). Defines one North Star metric, the input metrics that drive it, and guardrail metrics that prevent gaming. Gives the team a shared definition of success.

## Workflow

1. **Read product context** -- Scan `.chalk/docs/product/` for the product profile, PRDs with success metrics, JTBD docs, and any existing metrics definitions. Understand what the product does and who it serves before defining metrics.

2. **Parse scope** -- Extract from `$ARGUMENTS` the product area or business goal. If unspecified, build a company-level metrics framework using the product profile.

3. **Determine the next file number** -- Read filenames in `.chalk/docs/product/` to find the highest numbered file. The next number is `highest + 1`.

4. **Define the North Star metric** -- Identify the single metric that best captures the core value the product delivers to users. It must be: measurable, actionable by the team, a leading indicator of revenue, and reflective of user value (not just business extraction).

5. **Map input metrics** -- Identify 3-5 input metrics that drive the North Star. Use the AARRR framework as a lens: Acquisition (how users find you), Activation (first value moment), Retention (users come back), Revenue (users pay), Referral (users bring others). Not all stages need a metric -- pick the ones that matter most.

6. **Apply the HEART framework** -- For key user journeys, consider: Happiness (satisfaction), Engagement (usage depth), Adoption (new feature uptake), Retention (continued use), Task success (completion rate). Use this to fill gaps the AARRR lens missed.

7. **Set guardrail metrics** -- Define 2-3 metrics that must NOT degrade while optimizing the North Star. These prevent gaming (e.g., optimizing signups by removing friction could degrade activation quality).

8. **Write the file** -- Save to `.chalk/docs/product/<n>_metrics_framework.md`.

9. **Confirm** -- Share the file path and highlight which metrics likely need instrumentation work before they can be measured.

## Output

- **File**: `.chalk/docs/product/<n>_metrics_framework.md`
- **Format**: Plain markdown with North Star definition, input metrics table, and guardrail metrics
- **First line**: `# Metrics Framework: <Product Area>`

## Anti-patterns

- **Vanity metrics as North Star** -- Page views, total signups, or app downloads do not reflect user value. The North Star must measure value delivered, not volume collected.
- **Too many metrics** -- If everything is a key metric, nothing is. One North Star, 3-5 inputs, 2-3 guardrails. That is the budget.
- **No guardrails** -- Without guardrails, teams will optimize the North Star at the expense of something important. Always define what must not break.
- **Unmeasurable metrics** -- Every metric must be instrumentable with current or near-term tooling. If you cannot measure it, it is not a metric -- it is a wish.
- **Lagging-only indicators** -- Revenue and churn are important but slow to move. Include leading indicators (activation rate, feature adoption) that predict future outcomes.

Versions

The database has no other skills named create-metrics-framework.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version a9d94a1b4df7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100product-metrics
    Define a complete product metrics framework: North Star metric selection, input metrics, dashboard design, alert thresholds, and — for AI products — a four-layer AI metrics stack (model quality, operational, product-level, business). Use when setting up metrics for a new…
  • 100north-star-metric
    Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation. Classify the business game (Attention, Transaction, Productivity) and validate against 7 criteria for an effective North Star. Use when choosing a North Star Metric, setting up a…
  • 95north-star-metric
    Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation. Classify the business game (Attention, Transaction, Productivity) and validate against 7 criteria for an effective North Star. Use when choosing a North Star Metric, setting up a…
  • 100lumen-metrics
    Metrics architecture — produce a complete metrics plan given a product description. North Star, input metrics tree, instrumentation spec, action triggers, and counter-metrics. Use when asked to "design a metrics framework", "what should we measure", "build a metrics system",…
  • 100north-star-metric-advisor
    Define a single north star metric with input metrics, guardrails, and measurement plan that reflects core user value and ladders to business outcomes. Use when working on product discovery, PRDs, user stories, OKRs, or backlog planning.
  • 100north-star
    Defines a North Star Metric that captures delivered customer value and decomposes it into 3-4 movable input metrics. Use when you need to "pick a North Star metric," "we're optimizing for revenue and it's hurting us," "build an input metric tree," "what should the team actually…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.