skills/by-role/pm/okr-writer/SKILL.md
Write OKRs (Objectives and Key Results). Use when the user says "write OKRs", "help me set goals", "create objectives and key results", "quarterly goals", "team OKRs", "I need to define success for this quarter", "Doerr method", or wants to translate a strategic direction into measurable targets - even if they don't explicitly say "OKRs".
npx skillsauth add qa-aman/claude-skills okr-writerInstall 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.
Based on "Measure What Matters" by John Doerr, who brought OKRs from Intel to Google. Doerr's core distinction: Objectives are the "what" (inspirational, qualitative), Key Results are the "how we know" (measurable, binary at quarter end). CFRs - Conversations, Feedback, Recognition - are what make OKRs work in practice.
Two types of OKRs (Doerr):
Ask: is this a committed OKR (must hit) or aspirational (stretch)? This changes how you write the Key Results.
Doerr's test: "Does this objective make you uncomfortable in a good way?" If it's easy, it's not aspirational enough.
Each KR must:
Format: [Metric] from [baseline] to [target]
For each OKR set, identify:
OKRs without CFRs become forgotten spreadsheets.
Doerr's "cascading" principle: team OKRs should visibly connect to company OKRs. Flag any team OKR that doesn't trace to a company-level objective.
"You'll need a baseline for this KR. Who owns this metric and can pull the current number?"
1. Output-based Key Results Bad: "Launch new onboarding flow by March 31" Good: "Increase onboarding completion rate from 45% to 70%" Shipping is activity. Outcomes are results.
2. Treating aspirational OKRs as committed Bad: Team marks 70% attainment as failure because "we didn't hit it." Good: For aspirational OKRs, 70% = success. Recalibrate at quarter end, don't punish stretch.
3. Too many Objectives Bad: 5-7 Objectives per team. Good: 1-3 Objectives max. Doerr: "A few well-chosen OKRs send a clear message about what we say no to."
4. No baseline Bad: "Improve conversion rate to 10%" Good: "Improve conversion rate from 6% to 10%"
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.