Project Structure¶

Table of Contents¶

Directory Overview
/skills/ — Skills
/commands/ — Slash Commands
/workflows/ — Workflows
/docs/ — Documentation
/templates/ — Skill Templates
/AGENTS/ — AI Agent Context
/.github/ — GitHub Configuration
Root Files
File Naming Conventions
Related Documentation

This document provides a comprehensive overview of the PM-Skills repository structure. For a quick overview, see the README.md.

Directory Overview¶

pm-skills/
├── skills/                     # Core PM skills (31 total, flat)
├── commands/                   # Slash command markdown files (38 total + .gitkeep)
├── _workflows/                 # Workflows
├── docs/                       # Documentation (incl. templates)
│   └── templates/              # Skill creation templates
├── AGENTS/                     # AI agent session context
├── .github/                    # GitHub configuration
└── [root files]                # README, LICENSE, etc.

`/skills/` — The 31 PM Skills (flat)¶

Skills are the core of PM-Skills. Each skill teaches AI assistants how to produce a specific PM artifact with professional quality.

Organization¶

Flat directories named {phase}-{skill} for domain skills, plus classification-driven names such as foundation-persona and utility-pm-skill-builder for non-phase skills.

Examples: discover-competitive-analysis, define-hypothesis, deliver-prd, foundation-persona, utility-pm-skill-builder.

Skill Structure¶

Each skill follows the Agent Skills Specification:

skills/{skill-name}/
├── SKILL.md              # Instructions for AI (required)
└── references/
    ├── TEMPLATE.md       # Output structure (required)
    └── EXAMPLE.md        # Real-world example (required)

File	Purpose
`SKILL.md`	Primary instruction file. Contains frontmatter metadata and step-by-step guidance for the AI.
`references/TEMPLATE.md`	The structure the AI should follow when generating output.
`references/EXAMPLE.md`	A complete, high-quality example showing expected output.

Skills by Phase¶

Discover Phase (3 skills)¶

Skill	Purpose
`discover-interview-synthesis`	Turn user research into actionable insights
`discover-competitive-analysis`	Map market landscape and find opportunities
`discover-stakeholder-summary`	Understand stakeholder needs and concerns

Define Phase (4 skills)¶

Skill	Purpose
`define-problem-statement`	Crystal-clear problem framing
`define-hypothesis`	Testable assumptions with success metrics
`define-opportunity-tree`	Teresa Torres-style outcome mapping
`define-jtbd-canvas`	Jobs to be Done framework

Develop Phase (4 skills)¶

Skill	Purpose
`develop-solution-brief`	One-page solution pitch
`develop-spike-summary`	Document technical explorations
`develop-adr`	Architecture Decision Records (Nygard format)
`develop-design-rationale`	Capture design choice reasoning

Deliver Phase (6 skills)¶

Skill	Purpose
`deliver-acceptance-criteria`	Given/When/Then acceptance criteria for a story or feature slice
`deliver-prd`	Comprehensive product requirements document
`deliver-user-stories`	INVEST-compliant stories with acceptance criteria
`deliver-edge-cases`	Error states, boundaries, recovery paths
`deliver-launch-checklist`	Pre-launch verification checklist
`deliver-release-notes`	User-facing release communication

Foundation (1 skill)¶

Skill	Purpose
`foundation-persona`	Evidence-calibrated product or marketing persona generation

Utility (5 skills)¶

Skill	Purpose
`utility-mermaid-diagrams`	Generate Mermaid diagrams for PM artifacts
`utility-pm-skill-builder`	Guided creation of new pm-skills-compatible skills
`utility-pm-skill-iterate`	Targeted improvements to existing skills based on feedback
`utility-pm-skill-validate`	Audit skills against structural conventions and quality criteria
`utility-slideshow-creator`	Generate professional presentations from JSON deck specs

Measure Phase (4 skills)¶

Skill	Purpose
`measure-experiment-design`	Rigorous A/B test planning
`measure-instrumentation-spec`	Event tracking requirements
`measure-dashboard-requirements`	Analytics dashboard specifications
`measure-experiment-results`	Document learnings from experiments

Iterate Phase (4 skills)¶

Skill	Purpose
`iterate-retrospective`	Team retrospectives that drive action
`iterate-lessons-log`	Build organizational memory
`iterate-refinement-notes`	Capture backlog refinement outcomes
`iterate-pivot-decision`	Evidence-based pivot/persevere framework

`/commands/` — Slash Commands¶

Contains Claude Code slash command definitions. Each .md maps a /command to its skill (or workflow).

Commands (38 total: 31 skill commands + 7 workflow commands) | Command | Target skill/workflow | | --- | --- | | /competitive-analysis | discover-competitive-analysis | | /interview-synthesis | discover-interview-synthesis | | /stakeholder-summary | discover-stakeholder-summary | | /problem-statement | define-problem-statement | | /hypothesis | define-hypothesis | | /opportunity-tree | define-opportunity-tree | | /jtbd-canvas | define-jtbd-canvas | | /adr | develop-adr | | /design-rationale | develop-design-rationale | | /solution-brief | develop-solution-brief | | /spike-summary | develop-spike-summary | | /acceptance-criteria | deliver-acceptance-criteria | | /prd | deliver-prd | | /user-stories | deliver-user-stories | | /edge-cases | deliver-edge-cases | | /launch-checklist | deliver-launch-checklist | | /release-notes | deliver-release-notes | | /dashboard-requirements | measure-dashboard-requirements | | /experiment-design | measure-experiment-design | | /experiment-results | measure-experiment-results | | /instrumentation-spec | measure-instrumentation-spec | | /lessons-log | iterate-lessons-log | | /pivot-decision | iterate-pivot-decision | | /refinement-notes | iterate-refinement-notes | | /retrospective | iterate-retrospective | | /persona | foundation-persona | | /pm-skill-iterate | utility-pm-skill-iterate | | /pm-skill-validate | utility-pm-skill-validate | | /mermaid-diagrams | utility-mermaid-diagrams | | /pm-skill-builder | utility-pm-skill-builder | | /slideshow-creator | utility-slideshow-creator | | /workflow-feature-kickoff | feature-kickoff workflow | | /workflow-customer-discovery | customer-discovery workflow | | /workflow-sprint-planning | sprint-planning workflow | | /workflow-product-strategy | product-strategy workflow | | /workflow-post-launch-learning | post-launch-learning workflow | | /workflow-stakeholder-alignment | stakeholder-alignment workflow | | /workflow-technical-discovery | technical-discovery workflow |

`/_workflows/` — Workflows¶

Workflows chain multiple skills together into guided, end-to-end sequences.

Workflow	Purpose	Skills Included
`feature-kickoff.md`	New feature development	problem-statement → hypothesis → prd → user-stories → launch-checklist
`lean-startup.md`	Rapid validation cycle	hypothesis → experiment-design → experiment-results → pivot-decision
`triple-diamond.md`	Complete product development	All 25 phase skills across 6 phases
`customer-discovery.md`	Transform raw research into a validated problem	interview-synthesis → stakeholder-summary → problem-statement → hypothesis
`sprint-planning.md`	Prepare sprint-ready stories from a backlog	user-stories → acceptance-criteria → edge-cases
`product-strategy.md`	Frame a major strategic initiative	competitive-analysis → opportunity-tree → problem-statement → solution-brief
`post-launch-learning.md`	Measure results and capture learnings after launch	experiment-results → dashboard-requirements → lessons-log → retrospective
`stakeholder-alignment.md`	Build a case for leadership buy-in	stakeholder-summary → problem-statement → solution-brief → design-rationale
`technical-discovery.md`	Evaluate technical feasibility and architecture	spike-summary → adr → solution-brief

`/docs/` — Documentation¶

docs/
├── getting-started.md        # Quick setup guide
├── guides/
│   ├── using-skills.md       # How to use skills effectively
│   └── authoring-pm-skills.md # How to create new skills
├── reference/
│   ├── categories.md         # Skill categorization system
│   ├── frontmatter-schema.yaml # Metadata specification
│   └── project-structure.md  # This file
└── frameworks/
    └── triple-diamond-delivery-process.md

Document	Audience	Purpose
`getting-started.md`	New users	Installation and first steps
`guides/using-skills.md`	All users	Beginner to advanced usage
`guides/creating-skills.md`	Contributors	Skill creation guide
`reference/categories.md`	Contributors	Category taxonomy
`reference/frontmatter-schema.yaml`	Contributors	Metadata validation rules

`/docs/templates/` — Skill Templates¶

Starter templates for creating new skills.

docs/templates/
└── skill-template/
    ├── SKILL.md              # Template with placeholders
    ├── TEMPLATE.md           # Output structure template
    └── EXAMPLE.md            # Example template

Use these templates when contributing a new skill. See authoring-pm-skills.md for the full process.

`/AGENTS/` — AI Agent Context¶

Session continuity for AI coding assistants. Contains context, decisions, and session logs.

AGENTS/
├── DECISIONS.md              # Shared cross-agent decisions
├── claude/
│   ├── CONTEXT.md            # Claude continuity state
│   ├── DECISIONS.md          # Claude-local rationale
│   ├── TODO.md               # Task tracking
│   ├── SESSION-LOG/          # Session summaries
│   └── PLANNING/             # Working collaboration artifacts
└── codex/
    ├── CONTEXT.md            # Codex continuity state
    ├── DECISIONS.md          # Codex-local rationale
    ├── SESSION-LOG/          # Session summaries
    └── PLANNING/             # Working collaboration artifacts

This directory helps AI assistants maintain context across sessions. Not required for using PM-Skills.

`/.github/` — GitHub Configuration¶

.github/
├── workflows/
│   ├── release.yml           # Package and publish releases
│   ├── sync-agents-md.yml    # Auto-sync AGENTS.md on changes
│   └── codeql.yml            # Code scanning
├── ISSUE_TEMPLATE/
│   ├── bug_report.yml        # Bug report template
│   ├── feature_request.yml   # Feature request template
│   └── config.yml            # Template configuration
├── PULL_REQUEST_TEMPLATE.md  # PR checklist
└── dependabot.yml            # Dependency updates

Root Files¶

File	Purpose
`README.md`	Project overview, installation, usage
`AGENTS.md`	Universal agent discovery (auto-detected by Copilot, Cursor, Windsurf)
`CHANGELOG.md`	Version history (Keep a Changelog format)
`CONTRIBUTING.md`	Contribution guidelines
`CODE_OF_CONDUCT.md`	Community standards
`SECURITY.md`	Vulnerability reporting
`LICENSE`	Apache 2.0 license
`CLAUDE.md`	Project-specific instructions for Claude Code

File Naming Conventions¶

Pattern	Meaning
`UPPERCASE.md`	Root-level documentation (README, CHANGELOG, etc.)
`lowercase-with-dashes/`	Skill directories and feature folders
`SKILL.md`	Skill instruction file (always uppercase)
`TEMPLATE.md`	Output template (always uppercase)
`EXAMPLE.md`	Example output (always uppercase)
`_prefix/`	Underscore prefix for meta directories (e.g., `_workflows/`)