Agent skill

Assumption Mapper

by mohitagw15856 in mohitagw15856/pm-claude-skills

Extract and risk-rate hidden assumptions in a product brief or PRD.

MITAuto-check passedProduct & Project Management

Install Assumption Mapper

skills CLI
$ npx skills add mohitagw15856/pm-claude-skills --skill assumption-mapper -a claude-code

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

GitHub CLI
$ gh skill install mohitagw15856/pm-claude-skills assumption-mapper --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/mohitagw15856/pm-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/assumption-mapper .claude/skills/assumption-mapper && 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-mapper
GitHub stars
1.4k
Token cost
~2k tokens
SKILL.md length
1,004 words
Files
4 (incl. references)
Skills in repo
1,348
Repo updated
First seen
Licence
MIT

At a glance

Extract and risk-rate hidden assumptions in a product brief or PRD.

  • Works in 4 steps: Surface across all four lenses. Extract… → Rate on the two axes only. For each:… → Find and pressure the riskiest. The… → …
  • Asked to review a product brief for assumptions
  • SKILL.md covers Required Inputs, Where this sits — the spine's…, The loop and Output Structure, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Assumption Mapper is an agent skill from mohitagw15856/pm-claude-skills. Extract and risk-rate hidden assumptions in a product brief or PRD. Use when asked to review a product brief for assumptions, audit a PRD for risks, find hidden assumptions, validate product plans, or run an assumption analysis. Produces a prioritised assumption map with confidence and impact scores, recommended validation methods, and critical assumption flags.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/cheap-tests.md`, `references/worked-example.md` and `templates/assumption-board.md`).

It sits in Product & Project Management, covering PRD writing. The repository describes itself as: 1255 professional Agent Skills for Claude, ChatGPT, Gemini, Cursor & Codex — PRDs, postmortems, leases, medical bills, layoffs, go-bags, new countries. Plain markdown, MIT, in… The licence is MIT.

When your agent uses it

  • Asked to review a product brief for assumptions
  • Audit a PRD for risks
  • Find hidden assumptions
  • Validate product plans

Example prompts

  • “/assumption-mapper”

Workflow steps

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

  1. Surface across all four lenses. Extract assumptions in Desirability (do users
  2. Rate on the two axes only. For each: load-bearing (1–5, does the plan collapse
  3. Find and pressure the riskiest. The top-priority assumption (high-load-bearing ×
  4. Hand off. Output the ranked map, and state explicitly which assumption

What it can do on your machine

Read from SKILL.md and the folder at commit 1cbf1f0. 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 Mapper loads about 2k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 1,004 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

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 mohitagw15856/pm-claude-skills at commit 1cbf1f0, republished under its MIT licence (© mohitagw15856). 1,004 words, ~1,999 tokens.

Download SKILL.mdSave it as .claude/skills/assumption-mapper/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
assumption-mapper
description
Extract and risk-rate hidden assumptions in a product brief or PRD. Use when asked to review a product brief for assumptions, audit a PRD for risks, find hidden assumptions, validate product plans, or run an assumption analysis. Produces a prioritised assumption map with confidence and impact scores, recommended validation methods, and critical assumption flags.

Assumption Mapper Skill

Surface and prioritize the untested assumptions embedded in any product plan before development begins.

Required Inputs

Ask the user for these if not provided:

  • Product brief, PRD, or concept description (even rough notes work)
  • Stage (concept / discovery / pre-build / post-launch — affects which assumptions matter most)

Where this sits — the spine's entry point

This is the front of the product-decision spine: assumption-mapper → /prd-template → /rice-prioritisation → /roadmap-narrative. It takes a raw idea or brief and hands the next skill one thing: the riskiest assumption, and whether it survived a cheap test. Shared terms (assumption, load-bearing, confidence, provenance) are defined once in docs/craft/product-decisions.md — consult it rather than re-deriving them. Writing a PRD on top of an untested load-bearing assumption is the failure this skill exists to prevent, so run it before /prd-template, not after.

The loop

Four phases. Phase 3 is the skill; the rest feed it. Each ends on a completion criterion — don't advance until it's met.

  1. Surface across all four lenses. Extract assumptions in Desirability (do users want it?), Feasibility (can we build it?), Viability (will the business sustain it?), Usability (can users actually use it?). The dangerous assumptions are the ones so obvious no one wrote them down. Done when: at least one assumption per lens, and re-reading the brief for the emptiest lens surfaces nothing new.
  2. Rate on the two axes only. For each: load-bearing (1–5, does the plan collapse if it's false?) and confidence (1–5, how sure are we it's true?). Priority = load-bearing − confidence. Tag each fact's provenance ([data]/[hunch]). Done when: every assumption has both scores and a provenance tag, and the highest-priority one is genuinely the scariest — not the easiest to test.
  3. Find and pressure the riskiest. The top-priority assumption (high-load-bearing × low-confidence) is the one that can sink the whole plan. Name the cheapest test that could disprove it before a line of code is written (see the disclosed cheap-tests reference for the menu). Done when: the single riskiest assumption is named, with a test that could run this week and a clear "what a fail looks like."
  4. Hand off. Output the ranked map, and state explicitly which assumption /prd-template must treat as validated-or-open. An unresolved riskiest assumption becomes an Open Question in the PRD, not a silent bet. Done when: the downstream skill could start from this output without re-asking what the risky bet is.

Output Structure

Assumption Map: [Feature/Product Name]
AssumptionCategoryConfidenceImpactPriorityValidation Method
[assumption][type][1-5][1-5][score][method]
Critical Assumptions (Impact 4+ and Confidence 2 or below)

[Flagged items with detailed validation recommendations]

Top 3 Assumptions to Validate First

[Detailed recommendations including specific research method, estimated effort, and what the result would change]

Example (Partial)

Input: "We're building a self-serve onboarding flow to reduce time-to-value for SMB customers."

AssumptionCategoryConfidenceImpactPriorityValidation Method
SMB users can complete onboarding without human helpUsability253Unmoderated usability test (n=8)
Faster onboarding correlates with higher retentionViability341Cohort analysis of current onboarding times vs. 90-day retention
The current onboarding is the primary reason for slow time-to-valueDesirability242User interviews with recent churned SMB accounts

Anti-Patterns

  • Do not only surface desirability assumptions — feasibility and viability assumptions are equally likely to kill a product and are often overlooked
  • Do not assign high confidence to an assumption just because it hasn't been challenged yet — absence of evidence is not evidence
  • Do not recommend "user interviews" as the validation method for every assumption — some assumptions require quantitative data, competitive analysis, or technical spikes
  • Do not list assumptions that cannot be tested — every assumption in the map must have a plausible validation method, or it should be flagged as unknowable and treated as a risk
Show full SKILL.md (382 more words)Show less

Deeper Materials

This skill ships with support files — use them when they are available:

  • references/cheap-tests.md — The Cheap-Test Catalog: Right-Sizing Validation. Apply it while producing the output; it carries the calibration and judgment calls the method summary above compresses.
  • templates/assumption-board.md — a fill-in version of the deliverable with the quality gates inline. Offer it when the user wants to work the document themselves rather than have it generated.

Scoring Rubric (0–40)

Score any output of this skill before handing it over; 32+ is ship-quality.

Dimension0510
Category coverageDesirability-only — the feasibility and viability assumptions most likely to kill the plan are absentThree categories populated, but the empty one wasn't re-mined from the brief; coverage is token (one throwaway row)All four categories populated with substantive rows, with visible digging into whichever category the brief itself neglected
Scoring disciplineConfidence/impact numbers arbitrary or missing; priority arithmetic inconsistent; no critical flagsScores present and Priority = Impact − Confidence holds, but confidence is inflated for unchallenged assumptions and critical flags applied selectivelyScores defensible (unchallenged ≠ high confidence), arithmetic consistent including negative priorities left visible, and the CRITICAL flag applied mechanically at Impact 4+ / Confidence ≤2 — even to assumptions the team likes
Validation method fit"User interviews" (or "do research") pasted into every rowMethods vary but several are mismatched to the assumption type, missing sample sizes, or unpricedEach method matched to the assumption (data audit, backtest, fake door, desk check, spike…) with sample size and effort; untestable assumptions flagged unknowable and converted to owned risks, not given fake tests
Decision leverageTop-3 list missing, or tests whose outcome would change nothingTop 3 named with effort, but "what the result changes" is vague or the tests validate comfortable assumptions over dangerous onesTop 3 are the highest-priority testable assumptions, each with effort, a pre-committed threshold where relevant, and a concrete decision the result would change

Quality Checks

  • At least one assumption per category (Desirability, Feasibility, Viability, Usability)
  • All Impact 4+ / Confidence 2− assumptions flagged as CRITICAL
  • Each validation method is specific (not just "do research" — name the method and sample size)
  • Priority scores are consistent (Impact − Confidence, higher = more urgent)

Example Trigger Phrases

  • "Review a product brief for assumptions."
  • "Audit a PRD for risks."
  • "Find hidden assumptions."
  • "Validate product plans."
  • "Run an assumption analysis."

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

Files

SKILL.md and 3 other files (references) in skills/assumption-mapper of mohitagw15856/pm-claude-skills.

  • SKILL.md
  • references/cheap-tests.md
  • references/worked-example.md
  • templates/assumption-board.md

Open the folder on GitHubat commit 1cbf1f0

Compare with similar skills

Assumption Mapper 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 Mapper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Assumption Mapper this skillmohitagw15856/pm-claude-skills1.4k—~2kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Prd Generator

    jamesrochabrun/skills

    Generate comprehensive Product Requirements Documents (PRDs) for product managers.

    216 GitHub starsUsed in 2 repos~3.8k tokens
    Product & Project ManagementAuto-check passed

More from mohitagw15856/pm-claude-skills

All 1,348 skills in this repo
  • Car Tco

    mohitagw15856/pm-claude-skills

    Compare the total cost of car ownership across buy-new, buy-used, lease, and keep-your-current-car — depreciation, insurance, maintenance ramp, and fuel over a real horizon, not just the monthly…

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Exit Waterfall

    mohitagw15856/pm-claude-skills

    Compute who gets what at each exit price from a cap table — liquidation preferences, conversion points, and where the founders' share collapses.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Feature Prioritisation

    mohitagw15856/pm-claude-skills

    Apply prioritisation frameworks (RICE, MoSCoW, Kano, ICE, Opportunity Scoring) to rank features and backlog items.

    1.4k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Fire Number

    mohitagw15856/pm-claude-skills

    Compute a financial-independence (FIRE) target and years-to-reach with every assumption labeled as an assumption — plus a sensitivity table instead of a single false-precision answer.

    1.4k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Freelance Rate

    mohitagw15856/pm-claude-skills

    Derive a freelance day/hourly rate backwards from target income, honest billable utilization, overhead, and the self-employment tax premium — the arithmetic that proves a rate is not salary÷2000.

    1.4k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Assumption Mapper

What does Assumption Mapper do?

Extract and risk-rate hidden assumptions in a product brief or PRD. Assumption Mapper is an agent skill from mohitagw15856/pm-claude-skills. Extract and risk-rate hidden assumptions in a product brief or PRD.

When should I use Assumption Mapper?

Assumption Mapper fits situations like: asked to review a product brief for assumptions; audit a PRD for risks; find hidden assumptions; validate product plans.

How do I install Assumption Mapper in Claude Code?

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

How do I install Assumption Mapper in Codex?

Run `npx skills add mohitagw15856/pm-claude-skills --skill assumption-mapper -a codex`. Or copy the skill folder (skills/assumption-mapper in mohitagw15856/pm-claude-skills) into .agents/skills/assumption-mapper in your project. Codex loads it when a task matches its description.

Can I use Assumption Mapper 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 mohitagw15856/pm-claude-skills --skill assumption-mapper -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-mapper, .gemini/skills/assumption-mapper, .github/skills/assumption-mapper and .opencode/skills/assumption-mapper in your project.

What does Assumption Mapper need to run?

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

Does Assumption Mapper 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 Mapper 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 Mapper use?

Assumption Mapper 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 Mapper use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.3k tokens, read only when the agent opens those files.

What are the alternatives to Assumption Mapper?

Skills that share tags, products or a category with Assumption Mapper: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Assumption Mapper?

mohitagw15856 (a GitHub user) maintains it in mohitagw15856/pm-claude-skills, which has 1,434 GitHub stars. The repository holds 1,348 skills in this directory. The repository was last updated on October 9, 2026.

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