plugins/pm/skills/define-north-star/SKILL.md
Identify and validate your North Star Metric. Aligns product strategy with key business metric.
npx skillsauth add coalesce-labs/catalyst define-north-starInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
When to use: During strategy planning, when metrics feel scattered, or when teams are optimizing different things
Framework source: Aakash Gupta's "Do you really need a North Star Metric?"
thoughts/shared/pm/frameworks/ for your business model, growth stage, and existing metricsthoughts/shared/pm/metrics/north-star-[quarter].mdKey decision: Not every product needs a single North Star. Marketplaces, multi-product companies, and complex B2B may need a constellation of 2-4 metrics instead. I will help you decide which approach fits.
Automatic Context Checks: When this skill is invoked, immediately check:
| Source | Files/Folders | Search Terms | What to Extract |
| --------------- | ---------------------------------------------- | ---------------------------------------- | ------------------------------------- |
| Strategy Docs | thoughts/shared/pm/frameworks/*.md | objective, business goal, success metric | Current metric direction, if any |
| Business Model | thoughts/shared/pm/context/business-info-template.md | revenue model, growth focus, metrics | What drives the business |
| Metrics History | thoughts/shared/pm/metrics/*.md | baseline, trends, retention data | Current metric baselines and movement |
| Meetings | thoughts/shared/product/meeting-notes/*.md | "North Star", "KPI", "success metric" | Stakeholder expectations |
| PRDs | thoughts/shared/pm/prds/*.md | success metric, target | Feature-level success indicators |
Context Priority:
Cross-Skill Links:
/write-prod-strategy which uses North Star/feature-metrics which should ladder to North Star/retention-analysis to identify leading indicators/metrics-frameworkBefore defining your North Star, let me understand where you are...
Checking:
thoughts/shared/pm/context/business-info-template.md for your business modelthoughts/shared/pm/frameworks/ for strategic directionthoughts/shared/pm/metrics/ for baseline metrics and trendsthoughts/shared/product/meeting-notes/ for stakeholder prioritiesBased on what I find, I'll show you:
Business Model:
Existing Metrics:
Metric Gaps:
Definition: The single metric that best captures the core value your product delivers to customers.
✅ Product-led growth (PLG) companies
✅ Consumer products with network effects
✅ Early-stage companies (Seed to Series B)
❌ Marketplace/multi-sided platforms
❌ Complex B2B enterprise products
❌ Companies with multiple business models
A good North Star Metric has three components:
What is the one thing users do that indicates they're getting value?
Examples:
How often should this action happen to indicate real value?
Examples:
Who needs to do this action for it to count?
Examples:
Examples:
Slack:
Airbnb:
Spotify:
Answer these questions:
What problem does your product solve?
When do users say "aha, this is valuable"?
What action most correlates with retention?
Use this prompt:
Use /define-north-star and reference [[business-info-template]]
Help me identify our core value:
- Product: [describe your product]
- Customer problem: [what problem you solve]
- Retention data: [describe retained vs churned user behavior]
What action best captures when users get value?
Your North Star should be:
✅ Measurable
✅ Actionable
✅ Leading indicator
✅ Understandable
✅ Captures sustainable value
The real test: Does it help you make hard decisions?
Example decision scenarios:
Scenario 1: You can either:
Which moves your North Star more?
Scenario 2: Marketing wants to:
Which aligns with your North Star?
If your North Star doesn't help you choose, it's not working.
Problem: Revenue is an outcome, not a value metric
Exception: Marketplaces where GMV = value delivered
Problem: More features ≠ more value
Better: Usage of core feature
Problem: No correlation to actual value or retention
Better: Activation rate, active users
Once you have your North Star, break it down into input metrics:
Input Metrics (things that drive Nights Booked):
Supply side:
Demand side:
Trust & safety:
Each team owns input metrics that ladder up to North Star.
"Will this feature increase Nights Booked?"
"Will this campaign bring users who book nights?"
"Will improving performance increase Nights Booked?"
"Are our customers booking nights regularly?"
Your North Star should evolve as your company matures:
Early stage (0-100K users):
Growth stage (100K-1M users):
Scale stage (1M+ users):
Enterprise stage:
Slack's North Star Evolution:
2014-2015 (Early):
2016-2018 (Growth):
2019-2021 (Scale):
2022+ (Enterprise):
Key insight: North Star evolved with company stage
What problem do you solve? **___**
What do users do when they get value? **___**
What action correlates most with retention? **___**
How often should users do this action? **___**
Who needs to do this? (Individual, team, transaction) **___**
Formula: [Frequency] × [Core Action] × [Breadth]
Describe 2-3 hard decisions your North Star should help you make:
If a single North Star doesn't work for you, use a constellation:
Example: Amazon
Rule: No more than 4 metrics in your constellation
Every North Star needs 2-3 guardrail metrics to prevent destructive optimization.
Without guardrails, teams will find ways to game the North Star that hurt the business. The question to ask: "If we aggressively optimized [North Star], what could go wrong? That is your guardrail."
Common guardrail patterns:
Quality metric (e.g., NPS, CSAT, support ticket volume) -- Prevents growth at the expense of user satisfaction. Example: If North Star is "Weekly Active Users," a guardrail of "NPS stays above 40" prevents acquiring low-quality users who churn immediately.
Revenue/monetization metric (e.g., ARPU, conversion rate, LTV) -- Prevents engagement optimization that does not generate revenue. Example: If North Star is "time spent in app," a guardrail of "ARPU stays above $12/mo" prevents building addictive features that do not convert to paid.
Efficiency metric (e.g., CAC, cost per transaction, infrastructure cost per user) -- Prevents growth that is not sustainable. Example: If North Star is "completed transactions," a guardrail of "CAC stays below $50" prevents buying growth that does not pay back.
How to define guardrails:
Recommended North Star: [Metric Name] Formula: [How it is calculated] Current Value: [Baseline] Target: [Goal + timeline]
| Input Metric | Current | Target | Owner | Leading Indicator For | | ------------ | ------- | ------ | ------------- | --------------------- | | [Metric 1] | [Value] | [Goal] | [Team/Person] | [What it predicts] | | [Metric 2] | [Value] | [Goal] | [Team/Person] | [What it predicts] | | [Metric 3] | [Value] | [Goal] | [Team/Person] | [What it predicts] |
| Guardrail | Why | Threshold | Action if Breached | | ------------------- | ---------------------------- | --------------------- | --------------------------------- | | [Quality metric] | [Prevents what failure mode] | [Do not drop below X] | [Who investigates + what they do] | | [Revenue metric] | [Prevents what failure mode] | [Do not drop below X] | [Who investigates + what they do] | | [Efficiency metric] | [Prevents what failure mode] | [Do not drop below X] | [Who investigates + what they do] |
[2-3 sentences on whether to adopt/keep/change the North Star, with timeline for review. Example: "Adopt Weekly Active Teams as your North Star for the next 6 months. Review at the end of Q3 to determine if the metric still reflects core value delivery as you move into enterprise. Schedule a North Star review meeting for September."]
❌ Changing your North Star every quarter
❌ Having different North Stars by team
❌ Making it too complex
❌ Ignoring guardrails
North Star definition:
thoughts/shared/pm/metrics/north-star-[quarter].md (your working definition)After defining North Star:
/write-prod-strategyFeeds into:
/write-prod-strategy - North Star becomes the Objective component/metrics-framework - North Star is your lagging metric anchor/feature-metrics - Feature success metrics should ladder to North Star/catalyst-pm-ops:status-update - Progress toward North Star is tracked in updatesPulls from:
thoughts/shared/pm/metrics/ - Historical data validates metric choices/retention-analysis - Understand what drives long-term success/activation-analysis - Early indicators of North Star movement/activation-analysis - Find your activation metric/feature-metrics - Choose experiment metrics that ladder to North Star/metrics-framework - Understand leading vs lagging metrics/retention-analysis - Measure what drives retention and North Star/write-prod-strategy - Connect North Star to strategyBefore delivering the North Star analysis, verify:
Framework credit: Adapted from Aakash Gupta's North Star Metric framework. Read the full article: https://www.news.aakashg.com/p/do-you-really-need-a-north-star-metric
testing
Phase-agent that fixes a failing verify verdict so the pipeline self-heals instead of stalling to needs-human (CTL-653). Reads `${ORCH_DIR}/workers/<ticket>/verify.json`, fixes the `findings[]` (every severity:"high" plus the regression_risk drivers) directly via Edit/Write, commits the remediation, and emits `phase.remediate.complete.<ticket>`. The scheduler's router then re-dispatches `verify` to re-check (the verify⇄remediate cycle, cap 3). Dispatched as a `claude --bg` job by `phase-agent-dispatch`, which invokes it via slash command — hence `user-invocable: true`.
development
Phase agent for the verify step of the 9-phase orchestrator pipeline (CTL-450). NEW skill — has no canonical wrapper. Runs read-only adversarial verification against the implement-phase diff: tsc, tests, lint, security scan, reward-hacking scan, code review, test coverage, silent-failure hunt. Writes ${ORCH_DIR}/workers/<TICKET>/verify.json then emits phase.verify.complete.<ticket>. Reads phase-implement.json as its prior-phase artifact. NEVER writes application code — only test files allowed. Spawned via phase-agent-dispatch via slash command — hence `user-invocable: true`.
tools
--- name: phase-triage description: Phase agent that triages a Linear ticket — expands acronyms, classifies (feature/bug/docs/refactor/chore), identifies dependencies, estimates scope, writes triage.json, and posts a triage analysis comment to Linear. Triage completion is signaled by that comment plus the local triage.json — there is no `triaged` label. Emits phase.triage.complete.<TICKET> on success and phase.triage.failed.<TICKET> on error. Dispatched by the phase-agent orchestrator (CTL-452)
testing
Phase agent for the review step of the 9-phase orchestrator pipeline (CTL-450). Wraps the /review skill (gstack) — explicitly skips /ultrareview per user decision. Reads verify.json from the prior phase, runs /review against the diff, writes ${ORCH_DIR}/workers/<TICKET>/review.json, and creates a remediation commit for any HIGH-severity finding that has a deterministic fix. Emits phase.review.complete.<ticket>. Spawned via phase-agent-dispatch via slash command — hence `user-invocable: true`.