assumption-validation
Test whether assumptions are true before making commitments. Use when assumptions have low certainty and high risk.
Best use case
assumption-validation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Test whether assumptions are true before making commitments. Use when assumptions have low certainty and high risk.
Teams using assumption-validation should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/assumption-validation/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How assumption-validation Compares
| Feature / Agent | assumption-validation | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Test whether assumptions are true before making commitments. Use when assumptions have low certainty and high risk.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Assumption Validation ## Overview Test whether an assumption is true or false before making commitments based on it. ## When to Use - When an assumption has low certainty and high risk - Before major resource commitments - When stakeholders challenge your reasoning - During Empathize and Define phases ## How to Apply ### 1. State the Assumption Clearly Make it testable. Transform vague beliefs into specific claims: - ❌ "Users want better tools" - ✅ "Users spend >2 hours/week on manual data entry and would use an automated solution" ### 2. Define What Would Validate or Invalidate Be explicit about criteria: - **Validates**: 8+ out of 10 users report >2 hrs/week on manual entry - **Invalidates**: <5 out of 10 users report this, or they prefer manual control - **Inconclusive**: Mixed results, need different approach ### 3. Choose Validation Method Match method to assumption type: **User behavior/needs**: Interviews, observation, surveys **Technical feasibility**: Spikes, prototypes, vendor demos **Market conditions**: Market research, competitor analysis **Business viability**: Financial modeling, expert consultation ### 4. Execute Validation Conduct research with focus on disproving, not confirming: - Ask open-ended questions - Observe actual behavior, not just stated preferences - Look for contradictory evidence - Talk to diverse user types ### 5. Update Status Record findings in currentstate.json: - **Validated**: Evidence supports the assumption - **Invalidated**: Evidence contradicts it - **Partially validated**: More complex than assumed - **Needs more research**: Inconclusive ### 6. Act on Findings **If validated**: Proceed with confidence, but stay alert for new evidence **If invalidated**: - Update problem framing - Revise approach - Generate new assumptions - May need to pivot **If partially validated**: - Refine the assumption - Identify what's true and what's not - Adjust plans accordingly ## Example **Assumption**: "Field technicians need offline access" **Validation Plan**: - Interview 8 field technicians - Ask about connectivity at work locations - Observe their current workarounds - Ask what happens when connection drops **Findings**: - 7/8 work in areas with spotty connectivity - All have experienced data loss from connection drops - All use workarounds (paper notes, photos) when offline - Strong preference for offline-first design **Result**: VALIDATED — Offline access is a critical requirement **Action**: Prioritize offline functionality in ideation phase ## Tips - Seek to disprove, not confirm - Sample diverse users, not just friendly ones - Observe behavior, don't just ask - Document exact evidence, not interpretations - Update currentstate.json immediately - One assumption may spawn new assumptions
Related Skills
type-inference-validation
Static type inference and validation for navigation paths
bio-alignment-validation
Validate alignment quality with insert size distribution, proper pairing rates, GC bias, strand balance, and other post-alignment metrics. Use when verifying alignment data quality before variant calling or quantification.
date-validation
Use when editing Planning Hubs, timelines, calendars, or any file with day-name + date combinations (Wed Nov 12), relative dates (tomorrow), or countdowns (18 days until) - validates day-of-week accuracy, relative date calculations, and countdown math with two-source ground truth verification before allowing edits
spring-validation
Bean Validation (Jakarta Validation) with Spring Boot. Custom validators, validation groups, cross-field validation, and internationalized error messages.
fullstack-validation
Comprehensive validation methodology for multi-component applications including backend, frontend, database, and infrastructure
assumption-grading
Assess assumptions on certainty and risk to prioritize validation efforts. Use at project start or before phase transitions.
assumption-buster
Flip, remove, or exaggerate assumptions to unlock new solution angles.
api-validation
Apply when validating API request inputs: body, query params, path params, and headers. This skill covers Zod v4 patterns.
api-request-validation
A skill for implementing robust API request validation in Python web frameworks like FastAPI using Pydantic. Covers Pydantic models, custom validators (email, password), field-level and cross-field validation, query/file validation, and structured error responses. Use when you need to validate incoming API requests.
api-contracts-and-zod-validation
Generate Zod schemas and TypeScript types for forms, API routes, and Server Actions with runtime validation. Use this skill when creating API contracts, validating request/response payloads, generating form schemas, adding input validation to Server Actions or route handlers, or ensuring type safety across client-server boundaries. Trigger terms include zod, schema, validation, API contract, form validation, type inference, runtime validation, parse, safeParse, input validation, request validation, Server Action validation.
api-contracts-and-validation
Define and validate API contracts using Zod
api-contract-validation
Detect breaking changes in API contracts (OpenAPI/Swagger specs)