.agents/skills/assumption-mapping/SKILL.md
Surface every assumption embedded in a plan, strategy, or document, assess how critical and how validated each one is, and identify which ones to test first. Load when the user asks to map assumptions, surface hidden beliefs, find what must be true for this to work, run an assumption audit, or when deep-thinking diagnoses an assumption frame. Also triggers on "what are we assuming", "what must be true for this to work", or "find the untested beliefs". Based on David Bland and Alex Osterwalder's assumption mapping method from Testing Business Ideas.
npx skillsauth add dvy1987/agent-loom assumption-mappingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an assumption auditor. You make implicit beliefs explicit, assess their risk, and produce a prioritised list of what to test — so the team runs experiments on what matters, not what is easy.
State assumptions as falsifiable claims. "Users want this" is not an assumption. "Users will pay $20/month for this feature" is — it can be tested and proven false.
Assumptions are not risks. A risk is an event that might happen. An assumption is a belief that must be true for the plan to work. Keep them separate.
The most dangerous assumptions are the most confident ones. Teams rarely test what they're sure of. That's where surprises come from.
Skip this if: Skip if: the plan has only 1–2 assumptions and they are obvious. Skip if: the user just needs to start and can course-correct. Use only when many unvalidated beliefs are embedded in a plan.
Two axes:
LOW EVIDENCE HIGH EVIDENCE
HIGH IMPORTANCE [CRITICAL] [VALIDATED]
LOW IMPORTANCE [MONITOR] [DEPRIORITISE]
Critical = test these first, they can kill everything Validated = these are solid, build on them Monitor = worth watching, not urgent Deprioritise = don't spend energy here
Extract all embedded assumptions. Look in:
Convert implicit beliefs to explicit, testable statements:
Ask for each assumption:
For every assumption in the Critical quadrant (high importance, low evidence):
Assumption Map: [plan/document]
CRITICAL — test these first
┌─────────────────────────────────────────────────┐
│ [Assumption stated as falsifiable claim] │
│ Evidence we have: [what exists, if anything] │
│ Minimum test: [cheapest way to validate] │
│ False condition: [what would disprove it] │
└─────────────────────────────────────────────────┘
VALIDATED — solid foundations
- [Assumption]: [evidence that supports it]
MONITOR — watch but don't test yet
- [Assumption]: [why it's lower priority]
TOTAL: N assumptions | Critical: N | Validated: N
CRITICAL — test first ┌───────────────────────────────────────────── │ "Users want to connect with each other, not just the product" │ Evidence: 0 — no user research conducted on peer connection desire │ Minimum test: Interview 10 active users. Ask: "When was the last time you wanted to talk to another user of this product?" If fewer than 5 have a real story, assumption is likely false. │ False condition: <30% of users can name a specific thing they'd ask another user └───────────────────────────────────────────── ┌───────────────────────────────────────────── │ "Founding members will sustain posting for 90+ days without incentive" │ Evidence: None — no precedent in this user base │ Minimum test: Ask 5 prospective founding members to commit to 2 posts/week for 4 weeks before launch. See who follows through. │ False condition: Fewer than 3 of 5 complete the 4-week pilot └─────────────────────────────────────────────
VALIDATED
MONITOR
TOTAL: 8 assumptions found | Critical: 2 | Validated: 1 | Monitor: 5 </output> </example> </examples>
Assumption map: [plan/document]
Total assumptions surfaced: N
Critical (high importance, low evidence): N
Validated: N | Monitor: N | Deprioritised: N
Minimum experiments defined: N
development
Run a fast, read-only health check across all skills in the library and produce a structured quality report — without modifying anything. Load when the user asks to validate skills, check skill health, audit the library, run a skill quality check, or when improve-skills needs a pre-flight before starting its cycle. Also triggers on "what's wrong with my skills", "check all skills", "skill health report", "are my skills ok", or "pre-flight check". Called automatically by improve-skills before any improvement work begins, and by universal-skill-creator after every new skill is created. Never modifies any file — only reads and reports.
tools
Design, build, validate, and ship production-grade agent skills that work across OpenAI Codex, Ampcode, Factory.ai Droids, Google Gemini, Warp, Bolt.new, Replit, GitHub Copilot, Claude Code, VS Code, Cursor, and any agentskills.io compliant platform. Load when the user asks to create a skill, build a custom skill, write a SKILL.md, package instructions as a reusable agent capability, convert a workflow into a skill, improve or audit an existing SKILL.md, generate a meta-skill, make a cross-platform skill, turn a repeated task into automation, or design agent skills that target multiple AI coding tools simultaneously. Also load for skill stacking, skill scoping, skill discovery, parameterized skills, skill publishing to GitHub or skills.sh, or when the user says skill creator, skill architect, or skill engineer.
tools
Identify the right tool for a process step. Load when a user or skill needs to check tool availability, confirm CLI compatibility, or determine if an MCP server is needed. Triggers on "what tool", "do I need an MCP", "is [tool] available", "which tool handles", "tool lookup", "check tool availability", "find a tool for". Called by process-decomposer and agent-builder when assigning tools to steps.
development
Apply the Red-Green-Refactor cycle to software development. Load when the user asks to write code using TDD, create unit tests, implement a feature with test coverage, refactor code, or ensure software quality through automated testing. Also triggers on "test-driven development", "write tests first", "TDD this feature", "Red-Green-Refactor", "ensure 100% test coverage", or any request to build software with a test-first approach. Supports unit, integration, and end-to-end testing strategies.