OKR Mastery
File Map
skills/okr-mastery/
├── SKILL.md ← You are here (router & directives)
├── references/ ← All knowledge and reference files
│ ├── skill-model.md ← Core OKR methodology and principles
│ ├── prompt-library.md ← Step-by-step workflow instructions
│ ├── quick-reference.md ← Working checklist for quality checks
│ └── review-rubric.md ← 10-criterion quality scoring tool
├── company/ ← Company customization layer
│ ├── setup-instructions.md ← How to fill in the company layer
│ └── context.md ← Company-specific OKR context
└── assets/ ← Templates and output format files
└── okr-template.md ← OKR drafting template
When This Skill Activates
This skill handles all OKR-related work: drafting, reviewing, refining, decomposing, coaching, red-teaming, and scoring objectives and key results.
Trigger on any of these signals:
- User asks to write, draft, create, or set OKRs
- User asks to review, critique, or improve existing OKRs
- User pastes or uploads draft OKRs for feedback
- User asks to decompose company goals into team-level OKRs
- User asks to generate key results for a given objective
- User mentions quarterly goals, objectives and key results, or OKR planning
- User asks to score or reflect on a completed OKR cycle
Before Starting Any Task
Follow these steps every time this skill activates:
Check company/context.md first.
If it contains filled-in company data (not [Fill in: ...] placeholders), incorporate the company's org structure, strategic priorities, terminology, planning cadence, cultural norms, and tooling conventions into all output.
If it still contains only placeholders, work from the universal methodology only.
Read references/skill-model.md for the full methodology — philosophy, key distinctions, the six-phase process, quality criteria, and anti-patterns.
Keep references/quick-reference.md as your working checklist.
Run the quality checklist from this file before presenting any OKRs to the user.
Ask for strategic context before drafting.
Never start writing OKRs without understanding: company/team priorities, the team's mission, current challenges, and the time horizon.
If the user hasn't provided this, ask for it.
Core Workflows
Workflow 1: Draft OKRs from Scratch
When the user wants to create new OKRs:
Gather context. Ask the user for:
- Who these OKRs are for (company, team, individual)
- The time period (quarter, annual)
- Strategic priorities, team mission, current challenges
- Any parent OKRs these must align to
- Whether company context is available in
company/context.md
Read references/skill-model.md — pay attention to the philosophy, key distinctions (especially outcomes vs outputs, committed vs aspirational), and the templates section.
Draft the OKRs following these rules:
- 3-5 objectives maximum
- 3-5 key results per objective
- Objectives: qualitative, inspirational, concise (one line), action-oriented
- Key results: measurable, time-bound, outcome-focused, unambiguous
- Pair every significant quantity KR with a quality safeguard KR
- Classify each OKR as COMMITTED or ASPIRATIONAL
- Make cross-functional dependencies explicit
- Use the formula: "I will [objective] as measured by [key results]"
If company context is available, adapt the output:
- Use the company's terminology and metric names
- Align to stated strategic priorities and initiatives
- Follow the company's format conventions (e.g., NCT-style narratives if applicable)
- Respect the planning cadence and scope expectations
- Use the OKR template from
assets/okr-template.md as a starting structure
Run the quality checklist from references/quick-reference.md on every OKR before presenting.
Report which checks pass and which need attention.
Self-score against references/review-rubric.md.
Flag any criterion scoring below 4.
Workflow 2: Review and Critique Existing OKRs
When the user provides draft OKRs for feedback:
Read references/review-rubric.md — apply every criterion.
Score each criterion on a 1-5 scale using the rubric's anchors.
Present scores in a summary table.
For any criterion below 4, explain what's wrong with specific examples from the user's OKRs, and suggest concrete fixes.
Check for anti-patterns from references/skill-model.md:
- Task list disguised as OKRs
- One-dimensional metrics without quality pairing
- Fuzzy or unmeasurable KRs
- Team-internal jargon
- Too many OKRs
- Sandbagging
- Missing committed/aspirational classification
- Missing dependencies
If company context is available, also check:
- Alignment to strategic priorities
- Use of approved terminology and metrics
- Appropriate scope for the team level
- Compliance with tooling format conventions
Produce a revised set that addresses all issues.
Mark what changed and why.
Workflow 3: Decompose Company OKRs into Team OKRs
When the user has high-level objectives to break into team-level OKRs:
Get the parent OKR (company or division-level objective and its key results).
Get the list of teams that need to contribute.
Read references/skill-model.md — focus on the cascading process, top-down vs bottom-up, and alignment sections.
For each team, draft 1-2 objectives that support the parent OKR:
- Each team's objectives should contribute to one or more parent key results
- Write 3-5 measurable key results per team objective
- Explicitly note cross-functional dependencies between teams
- Include at least one bottom-up OKR per team
- Classify each as committed or aspirational
Validate the decomposition:
- No duplication — teams don't overlap on the same KR
- Full coverage — every parent KR has at least one team contributing
- Team KRs are within each team's control and influence
- Dependencies are explicit and bidirectional
Score the full set against the review rubric.
Workflow 4: Refine and Iterate
When the user has feedback on draft OKRs and wants them improved:
Understand the feedback. Ask clarifying questions if the user's direction is ambiguous.
Apply the changes while preserving what was already strong.
Re-run the quality checklist and the review rubric after changes.
Show a before/after comparison highlighting what improved and any scores that changed.
Flag any remaining issues — don't let weaknesses slide just because they weren't in the feedback.
Workflow 5: OKR Coaching / Red Team
When the user wants OKRs stress-tested:
Read references/prompt-library.md — use the Red Team Exercise structure.
Challenge every OKR on these dimensions:
- Perverse incentives: What could go wrong if pursued aggressively?
- Gaming risk: How could someone hit the number without delivering real value?
- Missing coverage: What important work is not represented?
- Dependency blindness: What cross-team dependencies are hidden?
- Ambition calibration: Are committed goals achievable? Are aspirational goals genuinely stretchy?
- Measurability: Can every KR be objectively scored?
- Alignment: Does every OKR connect to a strategic priority?
- The "so what" test: If all OKRs are achieved, will it actually matter?
Rank the top 5 issues by risk severity.
Provide specific fixes for each issue.
Be constructive but rigorous. Flag mediocre OKRs clearly. Don't hedge.
Workflow 6: End-of-Cycle Scoring and Reflection
When the user wants to score a completed OKR cycle:
Read references/prompt-library.md — use the Scoring and Reflection structure.
Score each KR on a 0.0-1.0 scale using the traffic-light system:
- Green (0.7-1.0): Delivered
- Yellow (0.4-0.6): Progress made, needs attention
- Red (0.0-0.3): Failed to make real progress
Assess each objective overall with a weighted score.
Reflect: What worked? What didn't? Were KRs well-chosen?
Recommend for next cycle: What carries forward? What's new? What drops?
Produce a cycle summary suitable for sharing with leadership.
Output Format
Always output OKRs in clean Markdown using this structure:
**Objective:** [statement]
Type: [COMMITTED / ASPIRATIONAL]
- **KR1:** [measurable result with target and date]
- **KR2:** [measurable result with target and date]
- **KR3:** [measurable result with target and date]
If company context specifies a richer format (e.g., NCT-style with narratives and commitments), use that format instead.
Refer to assets/okr-template.md for the full template structure.
After drafting, always append the quality checklist results.
Quality Standards
Reference references/review-rubric.md for the full 10-criterion rubric.
At minimum, every OKR must pass these checks before presenting to the user:
- Objective is outcome-oriented, not a task
- Objective fits on one line and is inspirational
- Key results are measurable with specific numbers and dates
- Key results describe outcomes, not outputs
- Key results are within the team's influence
- Metrics are unambiguous (define what counts)
- At least one quantity-quality KR pair exists
- Each OKR is classified as committed or aspirational
- No vanity metrics
- Timebound and scoped appropriately
- Connects clearly to a parent objective or strategic priority
Important Behaviors
- Always ask for strategic context before drafting — never guess at priorities
- Never present OKRs without running the quality checklist first
- When reviewing, score each rubric criterion explicitly with the 1-5 scale
- If company context is available, validate alignment to strategic priorities
- Prefer fewer, higher-quality OKRs over many weak ones
- Be opinionated — flag mediocre OKRs clearly, don't hedge or soften criticism
- When in doubt about ambition level, push toward stretch goals
- Always make dependencies explicit
- If the user provides OKRs in a company-specific format, preserve that format in your output
1---2name: okr-mastery3description: Guides the creation, review, and refinement of high-quality OKRs using a structured methodology. Use when user asks to "write OKRs", "draft objectives", "review my OKRs", "create key results", "plan quarterly goals", "set OKRs for my team", "critique these OKRs", "help with OKR planning", or mentions "objectives and key results". Also use when user uploads or pastes draft OKRs for feedback, or asks to decompose company goals into team-level OKRs. Supports both drafting from scratch and iterative refinement.4---56# OKR Mastery78## File Map9```text10skills/okr-mastery/11├── SKILL.md ← You are here (router & directives)12├── references/ ← All knowledge and reference files13│ ├── skill-model.md ← Core OKR methodology and principles14│ ├── prompt-library.md ← Step-by-step workflow instructions15│ ├── quick-reference.md ← Working checklist for quality checks16│ └── review-rubric.md ← 10-criterion quality scoring tool17├── company/ ← Company customization layer18│ ├── setup-instructions.md ← How to fill in the company layer19│ └── context.md ← Company-specific OKR context20└── assets/ ← Templates and output format files21 └── okr-template.md ← OKR drafting template22```2324## When This Skill Activates2526This skill handles all OKR-related work: drafting, reviewing, refining, decomposing, coaching, red-teaming, and scoring objectives and key results.2728Trigger on any of these signals:29- User asks to write, draft, create, or set OKRs30- User asks to review, critique, or improve existing OKRs31- User pastes or uploads draft OKRs for feedback32- User asks to decompose company goals into team-level OKRs33- User asks to generate key results for a given objective34- User mentions quarterly goals, objectives and key results, or OKR planning35- User asks to score or reflect on a completed OKR cycle3637## Before Starting Any Task3839Follow these steps every time this skill activates:40411. **Check `company/context.md` first.**42 If it contains filled-in company data (not `[Fill in: ...]` placeholders), incorporate the company's org structure, strategic priorities, terminology, planning cadence, cultural norms, and tooling conventions into all output.43 If it still contains only placeholders, work from the universal methodology only.44452. **Read `references/skill-model.md`** for the full methodology — philosophy, key distinctions, the six-phase process, quality criteria, and anti-patterns.46473. **Keep `references/quick-reference.md`** as your working checklist.48 Run the quality checklist from this file before presenting any OKRs to the user.49504. **Ask for strategic context before drafting.**51 Never start writing OKRs without understanding: company/team priorities, the team's mission, current challenges, and the time horizon.52 If the user hasn't provided this, ask for it.5354## Core Workflows5556### Workflow 1: Draft OKRs from Scratch5758When the user wants to create new OKRs:59601. **Gather context.** Ask the user for:61 - Who these OKRs are for (company, team, individual)62 - The time period (quarter, annual)63 - Strategic priorities, team mission, current challenges64 - Any parent OKRs these must align to65 - Whether company context is available in `company/context.md`66672. **Read `references/skill-model.md`** — pay attention to the philosophy, key distinctions (especially outcomes vs outputs, committed vs aspirational), and the templates section.68693. **Draft the OKRs** following these rules:70 - 3-5 objectives maximum71 - 3-5 key results per objective72 - Objectives: qualitative, inspirational, concise (one line), action-oriented73 - Key results: measurable, time-bound, outcome-focused, unambiguous74 - Pair every significant quantity KR with a quality safeguard KR75 - Classify each OKR as COMMITTED or ASPIRATIONAL76 - Make cross-functional dependencies explicit77 - Use the formula: "I will [objective] as measured by [key results]"78794. **If company context is available**, adapt the output:80 - Use the company's terminology and metric names81 - Align to stated strategic priorities and initiatives82 - Follow the company's format conventions (e.g., NCT-style narratives if applicable)83 - Respect the planning cadence and scope expectations84 - Use the OKR template from `assets/okr-template.md` as a starting structure85865. **Run the quality checklist** from `references/quick-reference.md` on every OKR before presenting.87 Report which checks pass and which need attention.88896. **Self-score** against `references/review-rubric.md`.90 Flag any criterion scoring below 4.9192### Workflow 2: Review and Critique Existing OKRs9394When the user provides draft OKRs for feedback:95961. **Read `references/review-rubric.md`** — apply every criterion.97982. **Score each criterion** on a 1-5 scale using the rubric's anchors.99 Present scores in a summary table.1001013. **For any criterion below 4**, explain what's wrong with specific examples from the user's OKRs, and suggest concrete fixes.1021034. **Check for anti-patterns** from `references/skill-model.md`:104 - Task list disguised as OKRs105 - One-dimensional metrics without quality pairing106 - Fuzzy or unmeasurable KRs107 - Team-internal jargon108 - Too many OKRs109 - Sandbagging110 - Missing committed/aspirational classification111 - Missing dependencies1121135. **If company context is available**, also check:114 - Alignment to strategic priorities115 - Use of approved terminology and metrics116 - Appropriate scope for the team level117 - Compliance with tooling format conventions1181196. **Produce a revised set** that addresses all issues.120 Mark what changed and why.121122### Workflow 3: Decompose Company OKRs into Team OKRs123124When the user has high-level objectives to break into team-level OKRs:1251261. **Get the parent OKR** (company or division-level objective and its key results).1271282. **Get the list of teams** that need to contribute.1291303. **Read `references/skill-model.md`** — focus on the cascading process, top-down vs bottom-up, and alignment sections.1311324. **For each team**, draft 1-2 objectives that support the parent OKR:133 - Each team's objectives should contribute to one or more parent key results134 - Write 3-5 measurable key results per team objective135 - Explicitly note cross-functional dependencies between teams136 - Include at least one bottom-up OKR per team137 - Classify each as committed or aspirational1381395. **Validate the decomposition:**140 - No duplication — teams don't overlap on the same KR141 - Full coverage — every parent KR has at least one team contributing142 - Team KRs are within each team's control and influence143 - Dependencies are explicit and bidirectional1441456. **Score the full set** against the review rubric.146147### Workflow 4: Refine and Iterate148149When the user has feedback on draft OKRs and wants them improved:1501511. **Understand the feedback.** Ask clarifying questions if the user's direction is ambiguous.1521532. **Apply the changes** while preserving what was already strong.1541553. **Re-run the quality checklist** and the review rubric after changes.1561574. **Show a before/after comparison** highlighting what improved and any scores that changed.1581595. **Flag any remaining issues** — don't let weaknesses slide just because they weren't in the feedback.160161### Workflow 5: OKR Coaching / Red Team162163When the user wants OKRs stress-tested:1641651. **Read `references/prompt-library.md`** — use the Red Team Exercise structure.1661672. **Challenge every OKR** on these dimensions:168 - **Perverse incentives**: What could go wrong if pursued aggressively?169 - **Gaming risk**: How could someone hit the number without delivering real value?170 - **Missing coverage**: What important work is not represented?171 - **Dependency blindness**: What cross-team dependencies are hidden?172 - **Ambition calibration**: Are committed goals achievable? Are aspirational goals genuinely stretchy?173 - **Measurability**: Can every KR be objectively scored?174 - **Alignment**: Does every OKR connect to a strategic priority?175 - **The "so what" test**: If all OKRs are achieved, will it actually matter?1761773. **Rank the top 5 issues** by risk severity.1781794. **Provide specific fixes** for each issue.1801815. **Be constructive but rigorous.** Flag mediocre OKRs clearly. Don't hedge.182183### Workflow 6: End-of-Cycle Scoring and Reflection184185When the user wants to score a completed OKR cycle:1861871. **Read `references/prompt-library.md`** — use the Scoring and Reflection structure.1881892. **Score each KR** on a 0.0-1.0 scale using the traffic-light system:190 - Green (0.7-1.0): Delivered191 - Yellow (0.4-0.6): Progress made, needs attention192 - Red (0.0-0.3): Failed to make real progress1931943. **Assess each objective overall** with a weighted score.1951964. **Reflect**: What worked? What didn't? Were KRs well-chosen?1971985. **Recommend for next cycle**: What carries forward? What's new? What drops?1992006. **Produce a cycle summary** suitable for sharing with leadership.201202## Output Format203204Always output OKRs in clean Markdown using this structure:205206```207**Objective:** [statement]208Type: [COMMITTED / ASPIRATIONAL]209210- **KR1:** [measurable result with target and date]211- **KR2:** [measurable result with target and date]212- **KR3:** [measurable result with target and date]213```214215If company context specifies a richer format (e.g., NCT-style with narratives and commitments), use that format instead.216Refer to `assets/okr-template.md` for the full template structure.217218After drafting, always append the quality checklist results.219220## Quality Standards221222Reference `references/review-rubric.md` for the full 10-criterion rubric.223At minimum, every OKR must pass these checks before presenting to the user:224225- Objective is outcome-oriented, not a task226- Objective fits on one line and is inspirational227- Key results are measurable with specific numbers and dates228- Key results describe outcomes, not outputs229- Key results are within the team's influence230- Metrics are unambiguous (define what counts)231- At least one quantity-quality KR pair exists232- Each OKR is classified as committed or aspirational233- No vanity metrics234- Timebound and scoped appropriately235- Connects clearly to a parent objective or strategic priority236237## Important Behaviors238239- Always ask for strategic context before drafting — never guess at priorities240- Never present OKRs without running the quality checklist first241- When reviewing, score each rubric criterion explicitly with the 1-5 scale242- If company context is available, validate alignment to strategic priorities243- Prefer fewer, higher-quality OKRs over many weak ones244- Be opinionated — flag mediocre OKRs clearly, don't hedge or soften criticism245- When in doubt about ambition level, push toward stretch goals246- Always make dependencies explicit247- If the user provides OKRs in a company-specific format, preserve that format in your output