assumption-validation

Test whether assumptions are true before making commitments. Use when assumptions have low certainty and high risk.

16 stars

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

$curl -o ~/.claude/skills/assumption-validation/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/design/assumption-validation/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/assumption-validation/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How assumption-validation Compares

Feature / Agentassumption-validationStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/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

16
from diegosouzapw/awesome-omni-skill

Static type inference and validation for navigation paths

bio-alignment-validation

16
from diegosouzapw/awesome-omni-skill

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

16
from diegosouzapw/awesome-omni-skill

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

16
from diegosouzapw/awesome-omni-skill

Bean Validation (Jakarta Validation) with Spring Boot. Custom validators, validation groups, cross-field validation, and internationalized error messages.

fullstack-validation

16
from diegosouzapw/awesome-omni-skill

Comprehensive validation methodology for multi-component applications including backend, frontend, database, and infrastructure

assumption-grading

16
from diegosouzapw/awesome-omni-skill

Assess assumptions on certainty and risk to prioritize validation efforts. Use at project start or before phase transitions.

assumption-buster

16
from diegosouzapw/awesome-omni-skill

Flip, remove, or exaggerate assumptions to unlock new solution angles.

api-validation

16
from diegosouzapw/awesome-omni-skill

Apply when validating API request inputs: body, query params, path params, and headers. This skill covers Zod v4 patterns.

api-request-validation

16
from diegosouzapw/awesome-omni-skill

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

16
from diegosouzapw/awesome-omni-skill

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

16
from diegosouzapw/awesome-omni-skill

Define and validate API contracts using Zod

api-contract-validation

16
from diegosouzapw/awesome-omni-skill

Detect breaking changes in API contracts (OpenAPI/Swagger specs)