create-metrics-framework

Define a metrics framework with North Star, input, and guardrail metrics.

6|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-metrics-framework
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-metrics-framework
Source: https://github.com/GeneralJerel/chalk-skills/tree/main/skills/create-metrics-framework
Command: npx skills add https://github.com/GeneralJerel/chalk-skills --skill create-metrics-framework

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Metrics Framework standardizes how teams define success by specifying a single North Star metric, the supporting input metrics, and guardrail metrics to prevent gaming. It ensures alignment across product context and measurement readiness.

Core Features & Use Cases

  • Define one measurable North Star metric that reflects user value and business impact.
  • Map 3-5 input metrics across the AARRR (Acquisition, Activation, Retention, Revenue, Referral) and HEART (Happiness, Engagement, Adoption, Retention, Task success) lenses.
  • Establish 2-3 guardrail metrics to prevent unintended optimization and ensure guardrails stay intact as the North Star improves.
  • Generate a final metrics framework document at .chalk/docs/product/<n>_metrics_framework.md that teams can instrument and monitor.

Quick Start

Provide the product area or business goal as the argument to generate a complete metrics framework at the specified path.

Frequently Asked Questions about create-metrics-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define a North Star metric with guardrails for my product?▼

To define a North Star metric with guardrails, specify a single primary metric reflecting user value, supported by 3-5 input metrics and 2-3 guardrail metrics. This framework prevents unintended optimization and aligns product context with measurement readiness.

What is the best way to structure KPIs using AARRR and HEART frameworks?▼

Structuring KPIs with AARRR and HEART frameworks involves mapping 3-5 input metrics across acquisition, activation, retention, revenue, and referral alongside happiness, engagement, adoption, and task success. This approach supports your North Star metric with measurable, actionable indicators.

How do I create a metrics framework document for product management?▼

Creating a metrics framework document involves analyzing your product context to generate a structured markdown file. This file defines your North Star, input, and guardrail metrics, providing a standardized reference for teams to instrument and monitor product success.

Why do I need guardrail metrics when optimizing a North Star metric?▼

You need guardrail metrics when optimizing a North Star metric to prevent gaming and unintended optimization. Establishing 2-3 guardrails ensures boundaries stay intact, protecting critical business areas while the primary metric improves.

Can I generate a metrics framework for a specific product area or business goal?▼

Yes, you can generate a metrics framework for a specific product area or business goal by providing it as the argument. The system analyzes the specific context and outputs a defined metrics document tailored to that area.

How many input metrics should I include in a product measurement framework?▼

You should include 3 to 5 input metrics in a product measurement framework. These measurable inputs support the North Star metric and are mapped across AARRR and HEART lenses to ensure comprehensive coverage of product performance.