OKR Builder Skill
Write ambitious, measurable OKRs that connect product work to company strategy. Avoid vanity metrics, output-focused key results, and objectives that sound like task lists.
Reads from / Writes to the Brain
If a professional-brain (brain/) exists, ground in it instead of re-asking for what you already know:
- Read first:
context.md (metric definitions), knowledge/strategy.md (where the product is going), and any open hypotheses/. Run python3 ../professional-brain/scripts/brain_query.py ./brain "<objective theme>" and carry each fact's provenance tag through — don't set a key result off a [hunch] as if it were [data].
- 📥 Propose to the Brain: after producing, propose logging the chosen objectives + KR targets as a
decisions/ record (the period's bet) and any new metric definitions to knowledge/, each provenance-tagged. Show them, get a yes, then write with ../professional-brain/scripts/brain_write.py … --commit (append-only, dry-run by default).
Working from a brief
You will often get a short brief without every detail (no baselines, no exact numbers). Always deliver a complete, specific OKR set anyway — do not stop to ask questions and do not leave bracketed placeholders like [target]. Where a baseline or number is missing, infer a realistic value from the brief and the domain, and mark it (assumed — confirm). A clearly-labelled assumed baseline (e.g. "activation 40% (assumed) → 60%") is always better than a blank or an invented-as-fact figure.
Deeper Materials
references/bad-okr-gallery.md — six realistic bad OKRs with diagnosis and rewrite (disguised roadmap, unfalsifiable objective, sandbagging, uncontrollable KR, metric zoo, missing guardrail), ending in a 5-question diagnostic. Use it when reviewing existing OKRs — match against the gallery before writing feedback.
templates/okr-worksheet.md — a fill-in worksheet whose columns enforce the quality gates (baseline source, drift test, control test, guardrail) plus a pre-committed quarter-end scoring rubric. Offer it when a team wants to draft OKRs themselves.
OKR Fundamentals
Objective: Qualitative, inspiring, time-bound. Answers "where are we going?"
Key Result: Quantitative, specific, measurable. Answers "how will we know we've arrived?"
The Test for a Good KR
- Can it be scored 0.0–1.0 at the end of the period?
- Does it measure outcome, not output? ("Revenue from new customers increased by 30%" not "Launch 3 features")
- Is it ambitious but achievable? (Aim for 70% attainment as the gold standard)
- Is it within the team's control?
Common OKR Anti-Patterns to Flag and Fix
| Anti-Pattern |
Example |
Better Version |
| Task masquerading as KR |
"Launch onboarding redesign" |
"New user activation rate increases from 42% to 65%" |
| Vanity metric |
"Get 10,000 app downloads" |
"30-day retention for new users reaches 40%" |
| Binary KR |
"Ship API v2" |
"API v2 adopted by 80% of active integrations" |
| Too many KRs |
6+ per objective |
Max 3–4 KRs per objective |
| No baseline |
"Improve NPS" |
"NPS increases from 32 to 50" |
Always flag anti-patterns and offer a rewrite.
Output Format
[Quarter] OKRs — [Team/Product Area]
Objective 1: [Inspiring, qualitative statement]
Why this matters: [1–2 sentence strategic context]
| # |
Key Result |
Baseline |
Target |
Measurement Method |
| KR1 |
[Measurable outcome] |
[Current state] |
[Target] |
[How measured] |
| KR2 |
[Measurable outcome] |
[Current state] |
[Target] |
[How measured] |
| KR3 |
[Measurable outcome] |
[Current state] |
[Target] |
[How measured] |
Owner: [Name/Role]
Check-in cadence: Weekly
Repeat for each objective. Recommend 2–4 objectives per team per quarter.
Scoring Guide to Include
At quarter end, score each KR:
- 0.7–1.0 = Excellent (0.7 is the "sweet spot" — if all KRs score 1.0, they weren't ambitious enough)
- 0.4–0.6 = Made progress but missed
- 0.0–0.3 = Missed — needs retrospective discussion
Inputs (infer any not provided — label assumptions)
- Team or individual the OKRs are for
- Quarter and year
- Company or product North Star metric (OKRs should connect to this — if not given, infer a plausible one and label it (assumed))
- Top 3 priorities or goals for this quarter (rough notes are fine)
- Any existing OKRs to review or improve (optional)
Guidelines
- Connect OKRs to the company/product North Star; if it isn't given, infer a plausible one and label it (assumed) rather than asking
- Recommend no more than 3 objectives per team per quarter
- If user provides output-based goals, always reframe as outcomes
- Include a "health check" section flagging which KRs have no current baseline data
- Remind user: OKRs are not performance reviews — they should be ambitious enough that missing them is okay
Scoring Rubric (0–40)
Score any output of this skill before handing it over; 32+ is ship-quality.
| Dimension |
0 |
5 |
10 |
| Outcome orientation |
KRs are a shipped-feature task list ("launch X", "complete Y") |
Mostly outcomes, but one or more KRs are outputs or binary ship/no-ship |
Every KR is an outcome metric scorable 0.0–1.0 by degree of achievement |
| Baseline & measurability |
No baselines or measurement methods; KRs cannot be scored at quarter end |
Targets present but several baselines missing or unsourced, with no health-check flag |
Every KR has baseline, target, and measurement method; missing data is flagged in a health check with a plan to instrument |
| Ambition calibration |
Targets are last quarter's trendline (sandbagged) or pure fantasy with no path |
Some stretch, but nobody could say what a 0.7 score looks like |
Calibrated so 0.7 attainment is the expected good quarter; sandbagged proposals and moonshots are called out and corrected |
| Strategic focus & control |
No link to a North Star; 5+ objectives or KR zoo; KRs depend on other teams' work |
Ladders loosely to strategy but objectives are overloaded or one KR fails the control test |
≤3 objectives with ≤4 KRs each, every objective explicitly ladders to the North Star, and every KR is within the team's control |
Quality Checks
Anti-Patterns
Example Trigger Phrases
- "Write OKRs."
- "Set quarterly goals."
- "Define key results."
- "Review existing OKRs."
1---2name: okr-builder3description: "Create well-structured OKRs (Objectives and Key Results) for product teams, startups, and individuals. Use when asked to write OKRs, set quarterly goals, define key results, or review existing OKRs. Produces a complete OKR set with objectives, measurable key results, baselines, and a scoring guide."4disable-model-invocation: true # skill-optimizer5metadata:6 source: https://skillmd.com/skills/slipcast-dev/okr-builder7---89# OKR Builder Skill1011Write ambitious, measurable OKRs that connect product work to company strategy. Avoid vanity metrics, output-focused key results, and objectives that sound like task lists.1213## Reads from / Writes to the Brain1415If a [`professional-brain`](../professional-brain/SKILL.md) (`brain/`) exists, ground in it instead of re-asking for what you already know:1617- **Read first:** `context.md` (metric definitions), `knowledge/strategy.md` (where the product is going), and any open `hypotheses/`. Run `python3 ../professional-brain/scripts/brain_query.py ./brain "<objective theme>"` and carry each fact's provenance tag through — don't set a key result off a `[hunch]` as if it were `[data]`.18- **📥 Propose to the Brain:** after producing, propose logging the chosen objectives + KR targets as a `decisions/` record (the period's bet) and any new metric definitions to `knowledge/`, each provenance-tagged. Show them, get a yes, then write with `../professional-brain/scripts/brain_write.py … --commit` (append-only, dry-run by default).1920## Working from a brief2122You will often get a short brief without every detail (no baselines, no exact numbers). **Always deliver a complete, specific OKR set anyway** — do not stop to ask questions and do not leave bracketed placeholders like `[target]`. Where a baseline or number is missing, infer a realistic value from the brief and the domain, and mark it *(assumed — confirm)*. A clearly-labelled assumed baseline (e.g. "activation 40% *(assumed)* → 60%") is always better than a blank or an invented-as-fact figure.2324## Deeper Materials2526- **`references/bad-okr-gallery.md`** — six realistic bad OKRs with diagnosis and rewrite (disguised roadmap, unfalsifiable objective, sandbagging, uncontrollable KR, metric zoo, missing guardrail), ending in a 5-question diagnostic. Use it when *reviewing* existing OKRs — match against the gallery before writing feedback.27- **`templates/okr-worksheet.md`** — a fill-in worksheet whose columns enforce the quality gates (baseline source, drift test, control test, guardrail) plus a pre-committed quarter-end scoring rubric. Offer it when a team wants to draft OKRs themselves.2829## OKR Fundamentals3031**Objective:** Qualitative, inspiring, time-bound. Answers "where are we going?"32**Key Result:** Quantitative, specific, measurable. Answers "how will we know we've arrived?"3334### The Test for a Good KR35- Can it be scored 0.0–1.0 at the end of the period?36- Does it measure outcome, not output? ("Revenue from new customers increased by 30%" not "Launch 3 features")37- Is it ambitious but achievable? (Aim for 70% attainment as the gold standard)38- Is it within the team's control?3940## Common OKR Anti-Patterns to Flag and Fix4142| Anti-Pattern | Example | Better Version |43|---|---|---|44| Task masquerading as KR | "Launch onboarding redesign" | "New user activation rate increases from 42% to 65%" |45| Vanity metric | "Get 10,000 app downloads" | "30-day retention for new users reaches 40%" |46| Binary KR | "Ship API v2" | "API v2 adopted by 80% of active integrations" |47| Too many KRs | 6+ per objective | Max 3–4 KRs per objective |48| No baseline | "Improve NPS" | "NPS increases from 32 to 50" |4950Always flag anti-patterns and offer a rewrite.5152## Output Format5354### [Quarter] OKRs — [Team/Product Area]5556---5758**Objective 1: [Inspiring, qualitative statement]**5960*Why this matters:* [1–2 sentence strategic context]6162| # | Key Result | Baseline | Target | Measurement Method |63|---|---|---|---|---|64| KR1 | [Measurable outcome] | [Current state] | [Target] | [How measured] |65| KR2 | [Measurable outcome] | [Current state] | [Target] | [How measured] |66| KR3 | [Measurable outcome] | [Current state] | [Target] | [How measured] |6768*Owner:* [Name/Role]69*Check-in cadence:* Weekly7071---7273Repeat for each objective. Recommend 2–4 objectives per team per quarter.7475## Scoring Guide to Include7677At quarter end, score each KR:78- 0.7–1.0 = Excellent (0.7 is the "sweet spot" — if all KRs score 1.0, they weren't ambitious enough)79- 0.4–0.6 = Made progress but missed80- 0.0–0.3 = Missed — needs retrospective discussion8182## Inputs (infer any not provided — label assumptions)8384- **Team or individual** the OKRs are for85- **Quarter and year**86- **Company or product North Star metric** (OKRs should connect to this — if not given, infer a plausible one and label it *(assumed)*)87- **Top 3 priorities or goals for this quarter** (rough notes are fine)88- **Any existing OKRs to review or improve** (optional)8990## Guidelines9192- Connect OKRs to the company/product North Star; if it isn't given, infer a plausible one and label it *(assumed)* rather than asking93- Recommend no more than 3 objectives per team per quarter94- If user provides output-based goals, always reframe as outcomes95- Include a "health check" section flagging which KRs have no current baseline data96- Remind user: OKRs are not performance reviews — they should be ambitious enough that missing them is okay9798## Scoring Rubric (0–40)99100Score any output of this skill before handing it over; 32+ is ship-quality.101102| Dimension | 0 | 5 | 10 |103|---|---|---|---|104| Outcome orientation | KRs are a shipped-feature task list ("launch X", "complete Y") | Mostly outcomes, but one or more KRs are outputs or binary ship/no-ship | Every KR is an outcome metric scorable 0.0–1.0 by degree of achievement |105| Baseline & measurability | No baselines or measurement methods; KRs cannot be scored at quarter end | Targets present but several baselines missing or unsourced, with no health-check flag | Every KR has baseline, target, and measurement method; missing data is flagged in a health check with a plan to instrument |106| Ambition calibration | Targets are last quarter's trendline (sandbagged) or pure fantasy with no path | Some stretch, but nobody could say what a 0.7 score looks like | Calibrated so 0.7 attainment is the expected good quarter; sandbagged proposals and moonshots are called out and corrected |107| Strategic focus & control | No link to a North Star; 5+ objectives or KR zoo; KRs depend on other teams' work | Ladders loosely to strategy but objectives are overloaded or one KR fails the control test | ≤3 objectives with ≤4 KRs each, every objective explicitly ladders to the North Star, and every KR is within the team's control |108109## Quality Checks110111- [ ] Each KR is measurable with a baseline and target112- [ ] No output-based KRs (no "launch X" or "complete Y")113- [ ] Maximum 4 KRs per objective114- [ ] OKRs connect to the company or product North Star115- [ ] Ambitious enough that 0.7 attainment is the expected score116117## Anti-Patterns118119- [ ] Do not accept output-based key results — any KR phrased as "launch X" or "complete Y" must be rewritten as an outcome with a baseline and target120- [ ] Do not write OKRs without asking for the company or product North Star — OKRs disconnected from the strategic context are just a goal-setting exercise121- [ ] Do not write more than 4 KRs per objective — too many KRs dilute focus and make scoring ambiguous at quarter end122- [ ] Do not use binary KRs (ship/don't ship) — every KR must be scorable on a 0.0–1.0 scale based on degree of achievement123- [ ] Do not skip the health check section on baselines — OKRs without current baselines cannot be scored objectively at quarter end124125## Example Trigger Phrases126127- "Write OKRs."128- "Set quarterly goals."129- "Define key results."130- "Review existing OKRs."