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.