Agent skill

Assumption Test

by Neeeophytee in Neeeophytee/finding-unknowns-skills

Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach.

MITAuto-check passed

Install Assumption Test

skills CLI
$ npx skills add Neeeophytee/finding-unknowns-skills --skill assumption-test -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Neeeophytee/finding-unknowns-skills assumption-test --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Neeeophytee/finding-unknowns-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/assumption-test .claude/skills/assumption-test && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
assumption-test
GitHub stars
343
Token cost
~631 tokens
SKILL.md length
317 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach.

  • Works in 5 steps: Read the request, relevant code, and… → State the assumption as an observable… → Design the smallest discriminating… → …
  • A plan depends on uncertain runtime
  • SKILL.md covers Steps and Guardrails
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Assumption Test is an agent skill from Neeeophytee/finding-unknowns-skills. Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Use when a plan depends on uncertain runtime, integration, or data behavior that inspection alone cannot establish. Not for preference interviews or routine implementation.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 14 installable skills for Claude Code, OpenAI Codex, and Hermes: find unknowns, clarify requirements, manage context, test assumptions, and verify bug fixes with regression… The licence is MIT.

When your agent uses it

  • A plan depends on uncertain runtime
  • Data behavior that inspection alone cannot establish

Example prompts

  • “/assumption-test”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read the request, relevant code, and existing evidence. If inspection already settles the question, cite that evidence and stop; do not…
  2. State the assumption as an observable prediction. Define what would refute it, what would support it within the tested scope, and what…
  3. Design the smallest discriminating experiment. Use an isolated fixture or test environment, the real component under question where…
  4. Run the experiment within the user's authorized scope. Preserve the command, relevant inputs, actual output, and environment details…
  5. Close with the assumption, method, observation, verdict (supported within scope, refuted, or inconclusive), and the planning decision this…

What it can do on your machine

Read from SKILL.md and the folder at commit ca5696a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Assumption Test loads about 631 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 317 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~631

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Neeeophytee/finding-unknowns-skills at commit ca5696a, republished under its MIT licence (© Neeeophytee). 317 words, ~631 tokens.

Download SKILL.mdSave it as .claude/skills/assumption-test/SKILL.md (or your agent's skills folder).
name
assumption-test
description
Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Use when a plan depends on uncertain runtime, integration, or data behavior that inspection alone cannot establish. Not for preference interviews or routine implementation.

Assumption test

A plausible assumption can survive every planning conversation and still fail on contact with the system. Turn the consequential uncertainty into a question an experiment can answer.

Steps

  1. Read the request, relevant code, and existing evidence. If inspection already settles the question, cite that evidence and stop; do not manufacture an experiment. If several assumptions remain, select the one whose failure would most change the approach.
  2. State the assumption as an observable prediction. Define what would refute it, what would support it within the tested scope, and what would leave it inconclusive. Set those criteria before observing the result.
  3. Design the smallest discriminating experiment. Use an isolated fixture or test environment, the real component under question where available, and a bounded number of operations. Name what the setup cannot represent; a mock's behavior is not evidence about its provider.
  4. Run the experiment within the user's authorized scope. Preserve the command, relevant inputs, actual output, and environment details needed to reproduce it. If a tool or dependency is unavailable, report the experiment as unrun or inconclusive, with the missing prerequisite.
  5. Close with the assumption, method, observation, verdict (supported within scope, refuted, or inconclusive), and the planning decision this evidence changes. Recommend the next discriminating check only if it could change that decision. Keep temporary code separate from the production implementation.

Guardrails

  • One successful trial does not establish a universal claim. State the tested conditions and remaining uncertainty, particularly for concurrency and performance.
  • Do not use production writes, real payments, destructive operations, or newly incurred costs without authorization. An experiment does not grant additional permissions.
  • Distinguish the component failing from the experiment failing to run. Never turn missing access or a broken fixture into a verdict about the system.
  • Do not fix the implementation or broaden into a build unless the user requested it. The deliverable is evidence that informs a decision.

© Neeeophytee, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/assumption-test of Neeeophytee/finding-unknowns-skills.

Open the folder on GitHubat commit ca5696a

Compare with similar skills

Assumption Test next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Assumption Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Assumption Test this skillNeeeophytee/finding-unknowns-skills343—~631Automated safety check: PassMIT
Falsifysickn33/agentic-awesome-skills47k1 repos~7.7kAutomated safety check: PassMIT
Finding ExperimentsPostHog/posthog40k—~783Automated safety check: PassCustom licence
ExperimentsArize-ai/phoenix12k—~1.8kAutomated safety check: PassCustom licence
Prioritize Assumptionsphuryn/pm-skills27k—~571Automated safety check: PassMIT
Scroll Experiencesickn33/agentic-awesome-skills47k2 repos~534Automated safety check: PassMIT

Similar skills

  • Falsify

    sickn33/agentic-awesome-skills

    The scientific thinking protocol for AI agents. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 1 repo~7.7k tokens
    Auto-check passed
  • Finding Experiments

    PostHog/posthog

    Official

    Resolves a PostHog experiment reference from natural language to a concrete experiment ID by browsing experiment-list (not feature-flag tools), with disambiguation when multiple experiments match.

    40k GitHub stars~783 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Experiments

    Arize-ai/phoenix

    Run, read, and compare dataset-backed experiments to find evidence that a prompt or pipeline is improving.

    12k GitHub stars~1.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Prioritize Assumptions

    phuryn/pm-skills

    Prioritize assumptions using an Impact × Risk matrix and suggest experiments for each.

    27k GitHub stars~571 tokensUpdated 24 days ago
    Product & Project ManagementAuto-check passed
  • Scroll Experience

    sickn33/agentic-awesome-skills

    Expert in building immersive scroll-driven experiences - parallax storytelling, scroll animations, interactive narratives, and cinematic web experiences.

    47k GitHub starsUsed in 2 repos~534 tokens
    Writing & ContentAuto-check passed
  • Webgl Experience

    nexu-io/open-design

    A full-screen, real-time WebGL/WebGL2 experience — animated shaders, 3D scenes, generative visuals, particle fields — rendered live on the GPU with a typographic overlay.

    100k GitHub stars~903 tokensUpdated today
    Game DevelopmentAuto-check passed

More from Neeeophytee/finding-unknowns-skills

All 14 skills in this repo
  • Agent Interface Design

    Neeeophytee/finding-unknowns-skills

    Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and examples.

    343 GitHub stars~650 tokensUpdated 10 days ago
    Auto-check passed
  • Blindspot Pass

    Neeeophytee/finding-unknowns-skills

    Surface the user's unknown unknowns before work starts. An agent skill from Neeeophytee/finding-unknowns-skills.

    343 GitHub stars~482 tokensUpdated 10 days ago
    Auto-check passed
  • Brainstorm Prototypes

    Neeeophytee/finding-unknowns-skills

    Generate several genuinely different throwaway variations (designs, approaches, drafts) for the user to react to.

    343 GitHub stars~492 tokensUpdated 10 days ago
    Auto-check passed
  • Change Quiz

    Neeeophytee/finding-unknowns-skills

    After a working session, produce a report on what changed plus a quiz the user must pass before merging.

    343 GitHub stars~532 tokensUpdated 10 days ago
    Auto-check passed
  • Context Audit

    Neeeophytee/finding-unknowns-skills

    Audit the instructions an agent already carries — CLAUDE.md, AGENTS.md, skills, tool descriptions — for contradictions, over-constraint, and duplication, then propose a cut list.

    343 GitHub stars~779 tokensUpdated 10 days ago
    Auto-check passed
  • Implementation Notes

    Neeeophytee/finding-unknowns-skills

    Keep a running implementation-notes.md during a build, logging every deviation from the plan and every discovered edge case.

    343 GitHub stars~474 tokensUpdated 10 days ago
    Auto-check passed

Questions about Assumption Test

What does Assumption Test do?

Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Assumption Test is an agent skill from Neeeophytee/finding-unknowns-skills. Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach.

When should I use Assumption Test?

Assumption Test fits situations like: A plan depends on uncertain runtime; data behavior that inspection alone cannot establish.

How do I install Assumption Test in Claude Code?

Run `npx skills add Neeeophytee/finding-unknowns-skills --skill assumption-test -a claude-code`. Or copy the skill folder (skills/assumption-test in Neeeophytee/finding-unknowns-skills) into .claude/skills/assumption-test in your project. Claude Code loads it when a task matches its description.

How do I install Assumption Test in Codex?

Run `npx skills add Neeeophytee/finding-unknowns-skills --skill assumption-test -a codex`. Or copy the skill folder (skills/assumption-test in Neeeophytee/finding-unknowns-skills) into .agents/skills/assumption-test in your project. Codex loads it when a task matches its description.

Can I use Assumption Test in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Neeeophytee/finding-unknowns-skills --skill assumption-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/assumption-test, .gemini/skills/assumption-test, .github/skills/assumption-test and .opencode/skills/assumption-test in your project.

What does Assumption Test need to run?

SKILL.md names no scripts, command-line tools or credentials: Assumption Test is instructions for the agent only.

Does Assumption Test access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Assumption Test safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Assumption Test use?

Assumption Test is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Assumption Test use?

About 631 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Assumption Test?

Skills that share tags, products or a category with Assumption Test: Falsify (sickn33/agentic-awesome-skills, 47k stars), Finding Experiments (PostHog/posthog, 40k stars), Experiments (Arize-ai/phoenix, 12k stars) and Prioritize Assumptions (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Assumption Test?

Neeeophytee (a GitHub user) maintains it in Neeeophytee/finding-unknowns-skills, which has 343 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 28, 2026.

Source: Neeeophytee/finding-unknowns-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.