Agent skill

North Star Metric

by borghei in borghei/Claude-Skills

Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics.

MITAuto-check passedProduct & Project Management

Install North Star Metric

skills CLI
$ npx skills add borghei/Claude-Skills --skill north-star-metric -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills north-star-metric --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/execution/north-star-metric .claude/skills/north-star-metric && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
north-star-metric
GitHub stars
891
Token cost
~1.9k tokens
SKILL.md length
859 words
Files
7 (incl. scripts, references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics.

  • Tasks that involve Product metrics
  • SKILL.md covers Overview, Core Capabilities, When to Use and Clarify First, plus 4 more sections
  • Runs Python scripts from its folder; calls python

What it does

North Star Metric is an agent skill from borghei/Claude-Skills. Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics. Includes a Python tool that renders the metric tree as a Mermaid diagram.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts, reference files and assets (for example `assets/nsm_spec_template.md`, `examples/acme-analytics-nsm.md` and `references/nsm-framework-guide.md`).

It sits in Product & Project Management, covering Product metrics. It works with Python and Mermaid. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Tasks that involve Product metrics

Example prompts

  • “/north-star-metric”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

North Star Metric loads about 1.9k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 859 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 859 words, ~1,854 tokens.

Download SKILL.mdSave it as .claude/skills/north-star-metric/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
north-star-metric
description
Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics. Includes a Python tool that renders the metric tree as a Mermaid diagram.
license
MIT + Commons Clause
metadata.version
1.0.1
metadata.author
borghei
metadata.category
project-management
metadata.domain
pm-execution
metadata.updated
2026-06-15
metadata.python-tools
metric_tree_builder.py
metadata.tech-stack
north-star, input-metrics, leading-indicators, counter-metrics, omtm

North Star Metric (NSM) Expert

Overview

A North Star Metric (NSM) is the single number that best represents the value your product delivers to its customers. Sean Ellis popularized the framing; Amplitude codified the playbook; Lean Analytics calls a related concept the "One Metric That Matters" (OMTM). The NSM is one number, not a dashboard. Its job is to align the entire team -- engineering, marketing, sales, support -- on a shared definition of "we won this quarter."

This skill produces a complete NSM specification: the NSM itself, 3-5 input metrics the team can directly influence, the leading indicators that move days or weeks before the inputs, the anti-metrics (things that must NOT move in the wrong direction), and counter-metrics that guard against gaming. The Python tool (metric_tree_builder.py) emits the spec as JSON, Markdown, or a Mermaid tree diagram for a README or Confluence page.

This is the first artifact a team should produce after defining strategy and before writing OKRs. Once the NSM is set, OKRs map directly to moving the input metrics, and roadmaps justify themselves by which input metric they target.

Core Capabilities

  • NSM selection — score candidates against the five tests (customer value, strategic alignment, leading, single number, movable) and the five Amplitude archetypes.
  • Metric-tree decomposition — break the NSM into 3-5 input metrics with an explicit formula (multiplicative / additive / funnel / ratio).
  • Leading indicators — assign 2-3 per input that move before the input does (the daily/weekly dashboard).
  • Guardrails — anti-metrics (protect the customer) and counter-metrics (protect the business), each with explicit thresholds.
  • Rendering — Mermaid tree, JSON dashboard config, or Markdown via the Python tool.

When to Use

  • New product or strategic direction -- before OKRs and roadmap, define the NSM and inputs.
  • Strategic re-alignment -- the dashboard has 47 metrics and no one knows which to optimize.
  • Cross-functional friction -- marketing, product, and growth disagree on what "success" means.
  • Investor / board reporting -- the NSM becomes the headline metric.
  • A/B experimentation guardrails -- every test reports NSM impact plus counter-metric impact.

When NOT to use: very early-stage discovery (use discovery/ first — you don't yet know what value you deliver); pure infrastructure work with an indirect user-value chain; before the org has aligned on strategy (the NSM exposes disagreement but does not resolve it).

Clarify First

Before defining the NSM, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Core customer value the product delivers — drives NSM candidate selection; the NSM must be a proxy for this, not a revenue lagging metric
  • Business archetype — attention / transaction / productivity / marketplace / engagement sets the Amplitude archetype and the input-metric formula (multiplicative/additive/funnel/ratio)
  • Input metrics the team can directly influence — the 3-5 nodes of the tree; if the team can't move them, the tree is decoration
  • Anti-/counter-metrics to guard — the thresholds that protect customer and business against a gamed NSM

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

bash
python scripts/metric_tree_builder.py --input nsm_spec.json --format mermaid   # render the metric tree
python scripts/metric_tree_builder.py --demo --format markdown                 # worked SaaS productivity NSM
Show full SKILL.md (366 more words)Show less

References

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/nsm-playbook.md — the five quality tests, Amplitude archetypes + real company examples, the metric-tree structure and input math, leading indicators, anti-/counter-metrics with thresholds, the step-by-step workflow, the metric_tree_builder.py reference (flags, input JSON, Mermaid sample), troubleshooting, and success criteria. Read when selecting an NSM or building the tree.
  • references/nsm-framework-guide.md — deep dive on three overlapping frameworks (Sean Ellis NSM, Amplitude NSM, Lean Analytics OMTM), input-metric math, and worked examples across five business archetypes. Read when comparing frameworks or working a specific archetype.
  • references/red-flags.md — concrete examples of how NSM specs go wrong, why they're bad, and how to fix them. Read when reviewing an NSM or diagnosing a gamed/lagging metric.
  • assets/nsm_spec_template.md — fill-in template for an NSM specification matching the tool's JSON shape. Use when drafting a spec.

Scope & Limitations

In Scope: NSM selection across 5 archetypes; input-metric tree decomposition with explicit math; leading-indicator selection per input; anti-/counter-metric definition with thresholds; the Python rendering tool; handoff to OKR drafting and roadmap prioritization.

Out of Scope: building actual analytics dashboards (BI tools — this produces the spec); statistical experiment design (discovery/brainstorm-experiments/); financial/revenue forecasting (finance/); OKR drafting (brainstorm-okrs/); data quality validation (data-analytics/).

Caveats: an NSM exposes strategic disagreement but does not resolve it — escalate the strategy decision, not the metric debate. Pure financial outputs (revenue, ARR) are usually too lagging; pick a customer-value proxy that revenue follows from. The NSM aligns; teams still need component metrics for diagnostics. A team without instrumentation cannot operate against an NSM — spend on telemetry first.

Integration Points

IntegrationDirectionDescription
discovery/brainstorm-ideas/Receives fromOpportunity discovery defines what value to deliver; NSM measures it
discovery/identify-assumptions/Receives fromNSM candidates surface assumptions about what customers value
execution/brainstorm-okrs/Feeds intoNSM becomes the quarterly Objective; inputs become Key Results
execution/outcome-roadmap/Feeds intoRoadmap items justify themselves by which input metric they target
execution/prioritization-frameworks/Pairs withNSM impact is one of the scoring criteria (e.g., RICE Impact, Weighted)
execution/status-update-generator/Feeds intoNSM and input movements feature in Highlights of weekly updates
data-analytics/ (domain)Pairs withNSM spec becomes the schema for dashboards and event taxonomies
executive-reporting/ (senior-pm)Feeds intoMonthly board packets lead with NSM trend

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references, assets) in project-management/execution/north-star-metric of borghei/Claude-Skills.

  • SKILL.md
  • assets/nsm_spec_template.md
  • examples/acme-analytics-nsm.md
  • references/nsm-framework-guide.md
  • references/nsm-playbook.md
  • references/red-flags.md
  • scripts/metric_tree_builder.py

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

North Star Metric next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

North Star Metric compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
North Star Metric this skillborghei/Claude-Skills891—~1.9kAutomated safety check: PassMIT
Physicalai Train Benchmarking A Policyopen-edge-platform/physical-ai-studio133—~1.2kAutomated safety check: PassApache-2.0
Threads Keyword Searchbrowser-act/skills6.1k—~1.7kAutomated safety check: PassMIT
Threads User Postsbrowser-act/skills6.1k—~2.3kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
X Article Publisherwshuyi/x-article-publisher-skill8722 repos~3.6kAutomated safety check: PassMIT

Similar skills

  • Physicalai Train Benchmarking A Policy

    open-edge-platform/physical-ai-studio

    Benchmarks a trained Physical AI Studio policy in a simulation gym and reports success metrics.

    133 GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Threads Keyword Search

    browser-act/skills

    Searches Threads posts by keyword or hashtag and returns matching posts with engagement metrics, extracted from SSR-embedded JSON.

    6.1k GitHub stars~1.7k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • Threads User Posts

    browser-act/skills

    Fetches public posts from a Threads user's profile page, extracting post text, engagement metrics, and media info from SSR-embedded JSON.

    6.1k GitHub stars~2.3k tokensUpdated 1 mo ago
    Data & AnalyticsAuto-check passed
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • X Article Publisher

    wshuyi/x-article-publisher-skill

    Publish Markdown articles to X (Twitter) Articles editor with proper formatting.

    872 GitHub starsUsed in 2 repos~3.6k tokens
    Documents & OfficeAuto-check passed
  • Final Release Review

    openai/openai-agents-python

    Official

    Assess a Python SDK release candidate or release plan against the previous release and recommend ship or block.

    30k GitHub stars~5.4k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    891 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    891 GitHub stars~4.2k tokensUpdated 4 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    891 GitHub stars~3.4k tokensUpdated 4 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    891 GitHub stars~3.6k tokensUpdated 4 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    891 GitHub stars~3.4k tokensUpdated 4 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    891 GitHub stars~2.2k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about North Star Metric

What does North Star Metric do?

Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics. North Star Metric is an agent skill from borghei/Claude-Skills. Define a North Star Metric (NSM) and its input metric tree, with leading indicators, anti-metrics, and counter-metrics.

When should I use North Star Metric?

North Star Metric fits situations like: tasks that involve Product metrics.

How do I install North Star Metric in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill north-star-metric -a claude-code`. Or copy the skill folder (project-management/execution/north-star-metric in borghei/Claude-Skills) into .claude/skills/north-star-metric in your project. Claude Code loads it when a task matches its description.

How do I install North Star Metric in Codex?

Run `npx skills add borghei/Claude-Skills --skill north-star-metric -a codex`. Or copy the skill folder (project-management/execution/north-star-metric in borghei/Claude-Skills) into .agents/skills/north-star-metric in your project. Codex loads it when a task matches its description.

Can I use North Star Metric in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill north-star-metric -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/north-star-metric, .gemini/skills/north-star-metric, .github/skills/north-star-metric and .opencode/skills/north-star-metric in your project.

What does North Star Metric need to run?

Going by SKILL.md and its folder, North Star Metric needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does North Star Metric access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is North Star Metric safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does North Star Metric use?

North Star Metric is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does North Star Metric use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.7k tokens, read only when the agent opens those files.

What are the alternatives to North Star Metric?

Skills that share tags, products or a category with North Star Metric: Physicalai Train Benchmarking A Policy (open-edge-platform/physical-ai-studio, 133 stars), Threads Keyword Search (browser-act/skills, 6.1k stars), Threads User Posts (browser-act/skills, 6.1k stars) and GitHub Deep Research (bytedance/deer-flow, 84k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains North Star Metric?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 891 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.