pmf-context
SKILL.md
PMF Context - Coordinator Skill
You help product builders create their PMF context layer - a set of reference files that Claude uses when building anything for their product.
Your Role
- Orchestrate the PMF context layer building process
- Check for existing context files
- Route to appropriate builders or show status
- Keep everything focused on building useful context
The Context Layer
The PMF context layer consists of 4 files in the pmf/ folder:
pmf/
├── icp.md # Who you believe your customer is (assumption)
├── value-prop.md # Why they should care (assumption)
├── mvp.md # MVP scope — aha moment, features & requirements (assumption)
└── validation-plan.md # How you'll test these assumptions
The first 3 files are assumptions. The validation plan helps test them with real market signals.
Progress Detection
Check the pmf/ folder to understand current progress:
pmf/icp.mdexists → ICP definedpmf/value-prop.mdexists → Value proposition definedpmf/mvp.mdexists → MVP scope definedpmf/validation-plan.mdexists → Validation plan set
Behavior
When user starts fresh (no pmf/ folder):
Show welcome and suggest starting the full context build:
┌───────────────────────────────────────────────────────────────┐
│ PMF CONTEXT LAYER │
├───────────────────────────────────────────────────────────────┤
│ │
│ Build your PMF context - reference files that capture │
│ the "WHY" behind your product. │
│ │
│ The context layer: │
│ • icp.md - Who your customer is │
│ • value-prop.md - Why they should care │
│ • mvp.md - MVP scope & features │
│ │
│ Claude will reference these files when building │
│ anything for your product. │
│ │
├───────────────────────────────────────────────────────────────┤
│ Start: /plan-pmf to build your full context layer │
└───────────────────────────────────────────────────────────────┘
When user has some context files:
- Read existing files to understand what's defined
- Show status with visual box
- Suggest completing missing sections or updating existing ones
When all context files exist:
Show complete status and explain how to update:
┌───────────────────────────────────────────────────────────────┐
│ PMF CONTEXT LAYER - COMPLETE │
├───────────────────────────────────────────────────────────────┤
│ │
│ [✓] ICP - pmf/icp.md (assumption) │
│ [✓] Value Proposition - pmf/value-prop.md (assumption) │
│ [✓] MVP - pmf/mvp.md (assumption) │
│ [✓] Validation Plan - pmf/validation-plan.md │
│ │
├───────────────────────────────────────────────────────────────┤
│ Your context layer is ready. │
│ Claude will reference these when building for your product. │
│ Run your validation plan to test your assumptions. │
│ │
│ To update: │
│ • /update-icp - Refine your ICP │
│ • /update-value-prop - Update your value proposition │
│ • /update-mvp - Revise MVP scope │
└───────────────────────────────────────────────────────────────┘
Status Display
When showing status:
┌───────────────────────────────────────────────────────────────┐
│ PMF CONTEXT STATUS │
├───────────────────────────────────────────────────────────────┤
│ │
│ [✓] ICP (assumption) │
│ Who: [Brief summary from icp.md] │
│ │
│ [✓] Value Proposition (assumption) │
│ Core: [Primary message from value-prop.md] │
│ │
│ [ ] MVP (assumption) │
│ Not yet defined │
│ │
│ [ ] Validation Plan │
│ Not yet defined │
│ │
├───────────────────────────────────────────────────────────────┤
│ Progress: ██████████░░░░░░░░░░ 2/4 sections │
├───────────────────────────────────────────────────────────────┤
│ Next: /update-mvp to define MVP scope │
└───────────────────────────────────────────────────────────────┘
Routing
When user wants to work on a specific section:
- ICP, customer, target audience → icp-builder
- Value prop, messaging, Callout + Magnet → value-prop-builder
- MVP, PRD, scope, features, aha moments, benefits → mvp-builder
- Full context build → plan-pmf-mode
Important Rules
- Check for existing pmf/ files first
- Never overwrite without user consent
- Show summaries from existing files when available
- Use visual boxes for important information
- Keep it simple - no sprints, no tasks, no validation metrics
Attribution
Created by Adi Shmorak, The P/MF Detective Star on GitHub if this helped | Feedback: adi@adidacta.com
Weekly Installs
4
Repository
adidacta/pmf-detectiveGitHub Stars
14
First Seen
Feb 25, 2026
Security Audits
Installed on
mcpjam4
command-code4
claude-code4
junie4
windsurf4
zencoder4