pm-okr

Display, replace, or propose OKRs in .claude/pm-config.md using gh CLI queries.

3|1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/auerbachb/claude-code-config --skill pm-okr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pm-okr
Source: https://github.com/auerbachb/claude-code-config/tree/main/.claude/skills/pm-okr
Command: npx skills add https://github.com/auerbachb/claude-code-config --skill pm-okr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of keeping Objectives and Key Results up to date by surfacing current OKRs, aligning them with recent work, and proposing measurable updates so prioritization reflects real progress.

Core Features & Use Cases

  • Show current OKRs: Reads the ## OKRs section from .claude/pm-config.md and displays objectives with any progress indicators.
  • Set OKRs safely: Replaces only the OKRs section in .claude/pm-config.md while preserving all other content.
  • Suggest updates from activity: Analyzes merged PRs, closed issues, and open backlog to estimate progress, cite evidence, and propose new or revised OKRs for planning.
  • Use case: During sprint planning, run a review to identify which key results have evidence in recent merges and which objectives need new work or updated targets.

Quick Start

Ask the assistant to show current objectives and aligned issues by running: /pm-okr show

Frequently Asked Questions about pm-okr

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

FAQPage Schema
How do I keep project OKRs updated based on recent GitHub activity?

To keep project OKRs updated, this automation analyzes recent merged PRs and closed issues via the gh CLI to estimate progress and propose measurable OKR revisions for sprint planning.

How do I manage OKRs stored in a markdown config file without breaking other content?

Managing OKRs in a markdown config file is done by targeting only the specific OKRs section, replacing or updating objectives while preserving all other file content safely.

Can I use GitHub CLI to track issue and PR progress against my objectives?

Yes, you can use GitHub CLI to query issues and PRs, cite evidence from recent activity, and align that progress directly against your configured objectives and key results.

What's the best way to automate OKR prioritization for sprint planning?

Automating OKR prioritization involves generating AI-suggested updates from your open backlog and closed tickets, identifying which key results have evidence and which need new work.

Do I need a specific PM config file to track objectives and key results?

Yes, you need a .claude/pm-config.md file containing an OKRs section; the tool reads and writes exclusively to this section to display, replace, or propose new objectives.

What happens if GitHub CLI queries return truncated results when checking OKRs?

When gh CLI queries list issues and PRs for OKR alignment, the system actively warns on truncated results to ensure progress estimates are not based on incomplete activity data.