assumption-inventory

assumption-inventory is a skill for Claude Code from adamlinscott/claude-skills. It costs 152 tokens per session (1,544 once invoked), scanned A, original, MIT.

A preflight review that lists the facts and guesses a development task depends on before substantial work begins.

In plain words
What is it for?
Use it before long, expensive, hard-to-reverse, or multi-step work to confirm the target, project location, editable files, restrictions, definition of done, and open questions.
Why use it?
It helps catch wrong goals, unclear boundaries, missing success criteria, and other costly misunderstandings early.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; names the AskUserQuestion tool.

Part of the claude-skills plugin — 18 skills shipped together

Good fit Use it before long, expensive, hard-to-reverse, or multi-step work to confirm the target, project location, editable files, restrictions, definition of done, and open questions.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/adamlinscott/claude-skills/assumption-inventory
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add adamlinscott/claude-skills --skill assumption-inventory
Clone the repo
git clone --depth 1 https://github.com/adamlinscott/claude-skills

Made for: Claude Code.

Or install claude-skills, the plugin that ships this one along with the rest of its 18 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for assumption-inventory

README.md
[![agentmods](https://agentmods.dev/badge/skills/adamlinscott/claude-skills/assumption-inventory/github.svg)](https://agentmods.dev/skills/adamlinscott/claude-skills/assumption-inventory)
Your own site
<a href="https://agentmods.dev/skills/adamlinscott/claude-skills/assumption-inventory"><img src="https://agentmods.dev/badge/skills/adamlinscott/claude-skills/assumption-inventory/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for assumption-inventory

Your own site · 80×15
<a href="https://agentmods.dev/skills/adamlinscott/claude-skills/assumption-inventory"><img src="https://agentmods.dev/badge/skills/adamlinscott/claude-skills/assumption-inventory.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 152 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,544 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00152 $0.01544
Opus 5 $0.00076 $0.00772
Sonnet 5 $0.00030 $0.00309
Haiku 4.5 $0.00015 $0.00154

Measured 10d ago against content hash e4d4523dd44e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

assumption-inventory scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/assumption-inventory/SKILL.md · 105 lines

How it starts

The opening of the file, as written. The whole thing — 105 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Assumption Inventory

Before a long run, the cheapest bug to fix is a wrong premise. This skill is a preflight: surface the assumptions the next stretch of work rests on, separate what you can cite from what you are guessing, and confirm the load-bearing guesses before the work starts — not after the diff lands.

The mechanism is one distinction held strictly: a fact is something on disk or stated by the user (it gets a citation); an assumption is everything else (it does not). The danger is an uncited assumption quietly becoming load-bearing — the work builds on it, and the divergence only surfaces hours later. This skill drags those assumptions into the open and gates the load-bearing ones on evidence or confirmation.

This is the front end of the triad: assumption-inventory (before), reground (mid-drift), fresh-eyes (after). Run it in order; do not skip to step 4.

1. Decide whether to run

Run this when the work ahead is long, expensive, hard to reverse, or multi-step and the target is not already crisply pinned. Skip it for a one-line change with an explicit target — the ceremony is not free. When in doubt on a big task, run it.

2. Draft the inventory

Fill every slot. For each, tag the basis: [cited: file:line / user said X] for a fact, [assumption] for a guess. Do not leave a slot blank — "unknown" is a valid, important answer.

  • Goal — what outcome am I trying to produce, in one sentence? Why now?
  • Root / scope — which repo, directory, or workspace is this rooted in? Is it workspace-wide or one repo? What platform(s) must it run on?
  • May edit — which files / areas am I allowed to change?
  • Must not touch — what is off-limits (generated files, other repos, prod config, contracts other code depends on)?
  • Done means — what concrete, checkable state counts as complete? How will I know?
  • Open questions — what do I not know yet that could change the above?

3. Stress the assumptions

For each [assumption], ask: what is the cheapest evidence that would settle this, and have I looked? Then look. Read the file, run pwd / git remote -v, check for a CLAUDE.md or ADR, grep for the symbol. Cheap checks turn guesses into citations now, before they cost anything. See REFERENCE.md for the catalog of assumptions that are silently wrong most often (platform, scope, auth, volatile contracts) — check those by default even when they feel obvious.

Read the full file on GitHub · 105 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 105 lines · 152 tokens per session scan A e4d4523dd44e

Subscribe to this mod's changes

assumption-inventory is a skill published in the GitHub repository adamlinscott/claude-skills (3 stars, last pushed 10d ago), licensed MIT. It adds 152 tokens to every session and 1,544 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

implement

Use in the Implement phase whenever writing or editing production Java code, or fixing a bug, in a Spring/Spring Boot project. Enforces test-first (red-green-refactor), executes the approved plan step by step, and honors the project's path-scoped tech-stack rules and the task's enforcement set. Preloaded into…

taipt1504/claudehut · 73 tokens

review

Use in the Review phase before claiming any Java/Spring task is complete, fixed, or passing. Spawns the auditor subagents that check the implementation against every applicable skill, rule, and memory item, runs the test suite for fresh evidence, and re-spawns for at most two fix rounds before reporting what survives.…

taipt1504/claudehut · 81 tokens

claudehut-workflow

Use at the start of every session and whenever beginning a coding task in a Java/Spring backend - establishes the ClaudeHut 7-phase agentic workflow, the complexity-tier routing that lets small tasks skip deliberation phases, and the laws that govern which skills and rules must fire. Injected at session start; also…

taipt1504/claudehut · 86 tokens

discover

Use as the FIRST phase of EVERY coding task, before brainstorming - grounds the work in the existing codebase (entry points, key types, structure) and proves whether something reusable already exists. Produces the reuse-scan artifact the write gate requires and the reuse DECISION (adopt / extend / new). Runs inline on…

taipt1504/claudehut · 95 tokens

write-plan

Use in the Plan phase after the spec is approved - dispatches the planner agent to draft the executable plan from the standard template (decision summary, T-xxx task breakdown with test-first + verify per task), gets the user's approval, records the plan (opening the write gate), and mirrors the breakdown into Claude…

taipt1504/claudehut · 93 tokens

brainstorm

Use to generate and weigh solution approaches for a problem, after discovery has grounded the context. Produces two or more genuinely distinct options scored on trade-offs, recommends one, and (for code tasks) assembles the enforcement set the rest of the workflow audits against. General-purpose ideation — works for…

taipt1504/claudehut · 74 tokens