Structure epics as testable hypotheses with explicit assumptions, lightweight experiments, and measurable success criteria.
Works with
Uses an if/then format to articulate the action, target persona, expected outcome, and validation method, making product assumptions explicit before committing to full build-out
Emphasizes \"tiny acts of discovery\" experiments (prototypes, concierge tests, landing pages) that validate hypotheses in days or weeks, not months
Defines falsifiable success criteria
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versionepic-hypothesisExecute the skills CLI command in your project's root directory to begin installation:
Fetches epic-hypothesis from deanpeters/product-manager-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate epic-hypothesis. Access via /epic-hypothesis in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Create detailed user stories, acceptance criteria, and feature specs
Example
Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios
Reduce spec writing time by 50%, ensure comprehensive coverage
Research competitors, compare features, identify gaps
Example
Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities
Complete competitive research in 2 hours instead of 2 days
Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs
Example
Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale
0
total installs
0
this week
3.1K
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
3.1K
stars
Frame epics as testable hypotheses using an if/then structure that articulates the action or solution, the target beneficiary, the expected outcome, and how you'll validate success. Use this to manage uncertainty in product development by making assumptions explicit, defining lightweight experiments ("tiny acts of discovery"), and establishing measurable success criteria before committing to full build-out.
This is not a requirements spec—it's a hypothesis you're testing, not a feature you're committed to shipping.
Inspired by Tim Herbig's Lean UX hypothesis format, the structure is:
If/Then Hypothesis:
Tiny Acts of Discovery Experiments:
Validation Measures:
Use template.md for the full fill-in structure.
Before drafting an epic hypothesis, ensure you have:
skills/problem-statement/SKILL.md)skills/proto-persona/SKILL.md)skills/jobs-to-be-done/SKILL.md)If missing context: Run discovery interviews or problem validation work first.
Fill in the template:
### If/Then Hypothesis
**If we** [action or solution on behalf of the target persona]
**for** [target persona]
**Then we will** [attain or achieve a desirable outcome or job-to-be-done for the persona]
Quality checks:
skills/proto-persona/SKILL.md)Examples:
Before building the full epic, define lightweight experiments to test the hypothesis:
### Tiny Acts of Discovery Experiments
**We will test our assumption by:**
- [Experiment 1: low-cost, fast test]
- [Experiment 2: another low-cost, fast test]
- [Add more as necessary]
Experiment types:
Quality checks:
Examples:
Specify what success looks like and the timeframe for evaluation:
### Validation Measures
**We know our hypothesis is valid if within** [timeframe in days or weeks]
**we observe:**
- [Desirable quantitative, measurable outcome]
- [Desirable qualitative, measurable outcome]
- [Add more as necessary]
Quality checks:
Examples:
Once the hypothesis is validated, break the epic into user stories:
### Epic: [Epic Name]
**Stories:**
1. [User Story 1 - reference `skills/user-story/SKILL.md`]
2. [User Story 2]
3. [User Story 3]
See examples/sample.md for full epic hypothesis examples.
Mini example excerpt:
**If we** provide one-click Google Calendar integration
**for** trial users managing multiple meetings
**Then we will** increase activation rate from 40% to 50%
Symptom: "If we build a dashboard, then we will have a dashboard"
Consequence: You're describing output, not outcome. This doesn't test anything.
Fix: Focus on the user outcome: "If we build a dashboard showing real-time task status, then PMs will spend 50% less time asking for status updates."
Symptom: "We'll test our assumption by building the full feature"
Consequence: You've committed to building before validating. Not a hypothesis—it's a feature commitment.
Fix: Design lightweight experiments (prototypes, concierge tests, landing pages) that take days/weeks, not months.
Symptom: "We know it's valid if users are happy"
Consequence: Success criteria are subjective and unmeasurable.
Fix: Define specific, falsifiable metrics: "80% of surveyed users rate the feature 4+ out of 5" or "Response time drops by 50%."
Symptom: "We know it's valid if within 6 months revenue increases"
Consequence: Too slow to inform decisions. By then, you've already built it.
Fix: Aim for 2-4 week validation cycles. If you can't measure in that timeframe, choose a leading indicator (e.g., activation rate, not annual revenue).
Symptom: "We already told the CEO we're shipping this, so we have to validate it"
Consequence: Experiments are theater—you're going to build it regardless of results.
Fix: Frame epics as hypotheses before making commitments. If stakeholders need certainty, explain the risk of building unvalidated features.
skills/problem-statement/SKILL.md — Hypothesis should address a validated problemskills/proto-persona/SKILL.md — Defines the "for [persona]" sectionskills/jobs-to-be-done/SKILL.md — Informs the "then we will" outcomeskills/user-story/SKILL.md — Validated epics decompose into user storiesskills/user-story-splitting/SKILL.md — How to break validated epics into storiesprompts/backlog-epic-hypothesis.md in the https://github.com/deanpeters/product-manager-prompts repo.Skill type: Component
Suggested filename: epic-hypothesis.md
Suggested placement: /skills/components/
Dependencies: References skills/problem-statement/SKILL.md, skills/proto-persona/SKILL.md, skills/jobs-to-be-done/SKILL.md
Used by: skills/user-story/SKILL.md, skills/user-story-splitting/SKILL.md
Make data-driven prioritization decisions faster
Draft PRDs, status updates, and stakeholder presentations
Example
Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement
Save 3-5 hours/week on communication overhead
Prerequisites
Time Estimate
30-60 minutes to see productivity improvements
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.
✗ Avoid when
Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.
mattpocock/skills
parcadei/continuous-claude-v3
cursor/plugins
ailabs-393/ai-labs-claude-skills
pproenca/dot-skills
mattpocock/skills
Solid pick for teams standardizing on skills: epic-hypothesis is focused, and the summary matches what you get after install.
Useful defaults in epic-hypothesis — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
epic-hypothesis is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
epic-hypothesis has been reliable in day-to-day use. Documentation quality is above average for community skills.
We added epic-hypothesis from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
epic-hypothesis reduced setup friction for our internal harness; good balance of opinion and flexibility.
Useful defaults in epic-hypothesis — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
I recommend epic-hypothesis for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
Keeps context tight: epic-hypothesis is the kind of skill you can hand to a new teammate without a long onboarding doc.
epic-hypothesis reduced setup friction for our internal harness; good balance of opinion and flexibility.
showing 1-10 of 73