PM-Skills Quick Start¶

What's Included¶

31 shipped PM skills in skills/ (25 phase skills across 6 phases, 1 foundation skill, 5 utility skills)
38 slash-command docs in commands/ (31 skill commands plus 7 workflow commands)
9 Workflows for multi-skill processes (Triple Diamond, Lean Startup, Feature Kickoff, and 6 more)
MCP sync guardrail via GitHub Actions (validate-mcp-sync, observe-first rollout)

Installation¶

Claude.ai / Claude Desktop¶

Go to Settings > Capabilities (Desktop) or Project Settings > Add Files (Claude.ai)
Upload the latest release ZIP (pm-skills-vX.X.X.zip) from Releases
Skills are now available in your conversations

Claude Code¶

Clone or copy to your project:

git clone https://github.com/product-on-purpose/pm-skills.git

Or download and extract the latest ZIP from Releases to your project root.

Other AI Agents¶

Point your agent to AGENTS.md for skill discovery. Each skill is self-contained in skills/{skill-name}/SKILL.md (e.g., skills/deliver-prd/SKILL.md).

More detail: see docs/getting-started.md for the long-form guide.

Usage¶

Slash Commands¶

/prd "Feature description"
/hypothesis "Assumption to test"
/acceptance-criteria "Story or feature slice"
/user-stories "PRD or feature context"
/competitive-analysis "Market or product area"

See AGENTS.md for the complete command list.

Workflows¶

Run multi-skill workflows:

/workflow-feature-kickoff "Feature name"  # Problem → Hypothesis → PRD → Stories

Workflow definitions are in _workflows/.

Skill Lifecycle Tools¶

Three utility skills manage the skill library itself:

flowchart LR
    Create["/pm-skill-builder\nCreate"] --> Validate["/pm-skill-validate\nValidate"]
    Validate -- "PASS" --> Ship["Ship"]
    Validate -- "Findings" --> Iterate["/pm-skill-iterate\nIterate"]
    Iterate --> Validate

See docs/pm-skill-lifecycle.md for detailed workflow patterns.

File Structure¶

skills/            # All 31 skill definitions (25 phase + 1 foundation + 5 utility, flat)
commands/          # 38 command markdown files (+ .gitkeep)
_workflows/        # Multi-skill workflows
scripts/           # sync, validation, and release helpers
.claude/pm-skills-for-claude.md  # instructions for Claude Code users
AGENTS.md          # Agent discovery index

For Claude Code discovery, run ./scripts/sync-claude.sh (or .ps1) to populate .claude/skills and .claude/commands from the flat source.

Learn More¶

Full documentation: https://github.com/product-on-purpose/pm-skills
Skill specification: https://agentskills.io/specification

Built by Product on Purpose for PMs who ship.