foundation-okr-writer

Drafts, reviews, and rewrites outcome-based OKR sets with quality audits and guardrail metrics.

640|81|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/product-on-purpose/pm-skills --skill foundation-okr-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundation-okr-writer
Source: https://github.com/product-on-purpose/pm-skills/tree/main/skills/foundation-okr-writer
Command: npx skills add https://github.com/product-on-purpose/pm-skills --skill foundation-okr-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams routinely write OKRs that are really feature lists, task counts, or roadmap wrappers, producing false precision and roadmap theater instead of measurable outcomes. This Skill coaches the drafting, review, and rewriting of OKR sets so every key result measures a real behavior or business change with an explicit baseline, target, and evidence source.

Core Features & Use Cases

  • Five entry modes: Guided (default), One-Shot via --oneshot, Sustained Coach, Audit Only for reviewing existing drafts, and Rewrite for converting roadmaps or feature lists into outcome OKRs.
  • Quality audit and anti-pattern detection: Scores every OKR set against an 11-criterion rubric and reframes feature-delivery KRs, vanity metrics, and missing baselines; refuses to fabricate data or couple OKRs to compensation.
  • Guardrails and alignment: Requires guardrail KRs for optimization targets, maps initiatives as bets tied to specific KRs, and surfaces cross-team dependencies and conflicts.
  • Use Case: A growth PM needs Q3 OKRs for a team after a successful launch. The Skill runs a short diagnostic, drafts one objective with measurable KRs including baselines and guardrails, audits the set, and flags open questions before the planning review.

Quick Start

Ask the assistant to help you write outcome-based OKRs for your team and cycle, for example by saying: help me write Q3 OKRs for the growth team based on our retention strategy.

Frequently Asked Questions about foundation-okr-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write outcome-based OKRs for my team?

Provide your team scope, cycle, and strategic context, and the Skill drafts an objective with key results that each include a metric definition, baseline, target, deadline, evidence source, and confidence level. It defaults to a Guided mode that diagnoses your context before drafting.

How to convert a roadmap or feature list into OKRs?

Use Rewrite mode by asking to fix or convert the list. The Skill moves features and tasks into an Initiatives as Bets section and reframes each key result as a measurable outcome or behavior change rather than a delivery milestone.

Can it review or critique an existing OKR draft?

Yes, Audit Only mode scores a pasted OKR set against an 11-criterion rubric covering strategic fit, measurement quality, focus, guardrails, and integrity. It flags anti-patterns like vanity metrics and missing baselines without drafting new OKRs unless asked.

What is the difference between this and an OKR grading tool?

This Skill handles drafting, reviewing, and rewriting OKRs before and during a cycle. End-of-cycle scoring with evidence and learning synthesis belongs to the companion measure-okr-grader skill, which grades completed OKR sets.

When should I not use OKRs for planning?

Avoid OKRs when you only need a dashboard spec, event tracking plan, experiment design, or hypothesis, since dedicated skills cover those. OKRs are also the wrong artifact for purely business-as-usual teams that need steady-state KPIs rather than stretch outcomes.

Does it work for feature teams with pre-committed roadmaps?

Yes. The empowered-team diagnostic detects feature-team contexts and adds a Disclosure section framing pre-committed work as outcome bets, rather than refusing to proceed. It adjusts framing so learnings inform next-cycle planning.