Overview
epic-hypothesis is an open-source workflow skill for Claude Code and compatible agents, published by deanpeters. Its author describes it as: “Frame an epic as a testable hypothesis with target user, expected outcome, and validation method. Use when defining a major initiative before roadmap, discovery, or delivery planning.”. The project has 6.5k stars on GitHub and ships custom license terms, so review them before reuse. Add it to your setup with `/plugin marketplace add deanpeters/Product-Manager-Skills`.
What epic-hypothesis does
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.
What’s inside
The SKILL.md for epic-hypothesis is organised into these sections:
- Purpose
- Input
- Key Concepts
- The Epic Hypothesis Framework
- Why This Structure Works
- Anti-Patterns (What This Is NOT)
- When to Use This
- When NOT to Use This
- Application
- Step 1: Gather Context
- Step 2: Draft the If/Then Hypothesis
- Step 3: Design Tiny Acts of Discovery Experiments
Installation
Add epic-hypothesis to your agent with:
/plugin marketplace add deanpeters/Product-Manager-SkillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
License
deanpeters has not declared a standard open-source license for this repository (Other). Confirm the terms with the author before reusing it.
Strengths
- Ships in deanpeters/Product-Manager-Skills, an established project with 6,527 GitHub stars
- Works with Claude Code
- Actively maintained — repository updated in the last 90 days
Things to check
- No license declared — confirm terms with the author before reuse
Author
Topics
Frequently asked questions
- What does epic-hypothesis do?
- Frame an epic as a testable hypothesis with target user, expected outcome, and validation method. Use when defining a major initiative before roadmap, discovery, or delivery planning.
- How do I install epic-hypothesis?
- Run /plugin marketplace add deanpeters/Product-Manager-Skills in your agent, then reload your skills. Review the source at https://github.com/deanpeters/Product-Manager-Skills before installing.
- Is epic-hypothesis free to use?
- epic-hypothesis is publicly available on GitHub, but deanpeters has not declared a standard open-source license (Other). Confirm the terms with the author before reusing it.
- Which agents does epic-hypothesis work with?
- epic-hypothesis lists Claude Code — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does epic-hypothesis come from?
- epic-hypothesis ships inside deanpeters/Product-Manager-Skills, a repository that contains 41 catalogued skills in total. The repository's 6,527 GitHub stars apply to that whole collection, not to this skill on its own.
