frame-the-hypothesis
Skill1 starsChanged 5 months agoApache-2.0View on GitHub
Use when a founder has a vague AI idea and needs to sharpen it into one falsifiable bet before building - when they say "is this worth building", "how do I validate this", "I have an idea for an AI product", "the demo works, what now", "everyone I talk to says they love it", "how do I know if this is real", or are about to build on a hunch. Triggers when the model keeps flattering the idea, or the founder is testing the build instead of the demand. Produces a problem statement, the riskiest assumption scored, a falsifiable hypothesis with a pass/fail bar, and a five-reason devil's-advocate critique. Run after start-here, before map-the-terrain or architect-before-code.
In this repository27 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .cursor/rules/ai-native-os.mdcCursor rule
- agentic-build-loopSkill
- ai-assisted-salesSkill
- apply-ai-native-modelsSkill
- architect-before-codeSkill
- capture-learningSkill
- cognitive-architecture-reviewSkill
- compliance-readinessSkill
- customer-discovery-that-doesnt-lieSkill
- design-a-loopSkill
- design-the-mvaSkill
- eval-and-safety-harnessSkill
- gateway-agent-opsSkill
- geo-contentSkill
- hypothesis-miningSkill
- map-the-terrainSkill
- measure-ai-native-pmfSkill
- moat-strategySkill
- pay-down-agentic-debtSkill
- red-team-the-agentSkill
- secure-the-connectorsSkill
- self-healing-fallbacksSkill
- share-of-model-auditSkill
- start-hereSkill
- write-the-claude-mdSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 37
Instead, make it refute you: "Give five specific reasons this fails, and the cheapest test that would expose each." Dispatch the …
- Distinctive: line 50
Don't invent market numbers.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Frame the Hypothesis
AI makes prototyping so cheap it hides the question that actually matters: is the problem real? A working demo proves nothing about demand. This skill turns "I have an AI idea" into "here is the one assumption that decides whether this is real, and the cheapest experiment that could prove me wrong", and it forces the model to attack the idea instead of flattering it.
The method
Sharpen the problem, score the riskiest assumption, write the falsifiable bet, then make the model
attack it. Full anatomy, the uncertainty x fatality rubric, the devil's-advocate protocol, and a worked
example: references/hypothesis-craft.md.
Step 1: Sharpen the problem, not the solution
Reframe in the customer's words: who exactly ([ICP]) fails to get what painful job done ([PROBLEM]),
how do they cope today, and how often does it hurt? Output a one-paragraph problem statement.
Step 2: Name the riskiest assumption
List the beliefs the idea rests on, then flag the one that is both most uncertain and most fatal
if wrong ([RISKIEST_ASSUMPTION]). Usually problem or demand risk, not technical risk.
Step 3: Write the falsifiable hypothesis
State it as: "We believe [X]; we'll know we're wrong if [bar]." Commit to the pass/fail bar
before running anything. If no result could fail it, it's theatre.
Step 4: Run the structured devil's advocate
The model will confirm your idea if you let it (sycophancy).
Instead, make it refute you: "Give five specific reasons this fails, and the cheapest test that would
expose each." Dispatch the devils-advocate agent for a harder pass.
Output
- Problem statement (customer's words) + the assumption stack, riskiest one flagged.
- One falsifiable hypothesis with an explicit pass/fail bar and decision rule.
- The five strongest refutations, and which to test first. Next skill:
map-the-terrainorarchitect-before-code.
Constraints
- Adversarial by default: if the model only justifies the idea, the prompt failed. Make it attack.
- Validate problem and demand before solution. Building is not validating.
- Don't invent market numbers; label any figure an assumption to confirm.
- Stay theme-agnostic; the founder supplies the domain.
Dictionary
sycophancy · the 40% rule · the Remove-the-AI test
Copy-paste version
For non-coders: paste into any chatbot (Claude.ai, ChatGPT, Gemini).
Act as a sharp, skeptical AI-native validation coach. My idea: [ONE_LINER]. For: [ICP]. Problem I
think they have: [PROBLEM]. Domain: [DOMAIN].
1. Rewrite the problem in the customer's words: who exactly, what painful job, how they cope now, how often it hurts.
2. List my assumptions, then pick the ONE most uncertain AND most fatal if wrong.
3. Write it as a falsifiable hypothesis: "We believe X; we'll know we're wrong if [bar]." Set the number before I test.
4. Now turn on me: give five specific reasons this idea fails, and the cheapest experiment that would expose each.
Do not flatter the idea. Make me test the problem before the solution, and don't invent market numbers.Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

