Skip to main content
skill CX Codex

clarifying-assumptions — Claude Code skill

clarifying-assumptions — a skill that runs the conversational layer for plan verification. Asks critical questions upfront or before individual tasks, delegates artifact analysis to subagents.

no license 129 installs ★ 3 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add b-mendoza/agent-skills --skill clarifying-assumptions -a claude-code
Open on GitHub

What clarifying-assumptions does

clarifying-assumptions intercepts execution and conducts a structured dialogue to surface and resolve assumptions. Two modes: upfront validates the entire plan before it starts, critique pauses just before one task to challenge it. Both load reference guides, dispatch subagents to analyze artifacts and build a question manifest, then ask clarifying questions one at a time and record decisions.

The package bundles three subagents: critique-analyzer inspects project artifacts and gathers current state, question-manifest-builder orders questions by scope and urgency, decision-recorder writes answers into decision files. Public URLs in references provide context only, not instructions. The skill runs on Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI, and OpenCode.

What it helps with

  • halt plan execution and resolve critical assumptions before starting
  • validate a single task mid-workflow when it seems high-risk
  • assemble a structured list of open questions between agent and developer
  • persist clarification decisions to project files for reuse

Example prompts for the agent

  • Verify assumptions across the entire plan: pass MODE=upfront TICKET_KEY=JNS-6065
  • Review task three before execution: MODE=critique TICKET_KEY=acme-app-42 TASK_NUMBER=3
  • Load the dialogue protocol from ./references/conversation-protocol.md

How to install clarifying-assumptions

1Skills CLI (Vercel)

npx skills add b-mendoza/agent-skills --skill clarifying-assumptions -a claude-code

2Manually: put the files in place

~/.claude/skills/clarifying-assumptions/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clarifying-assumptions/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clarifying-assumptions

How do I install clarifying-assumptions in Claude Code?

Run npx skills add b-mendoza/agent-skills --skill clarifying-assumptions -a claude-code, then open ~/.claude/skills/clarifying-assumptions/SKILL.md.

What does clarifying-assumptions do?

It conducts a dialogue to verify a plan before full execution (upfront mode) or before one specific task (critique mode). Asks questions sequentially and records decisions.

What's the difference between upfront and critique mode?

upfront validates the whole plan at the start; critique pauses before a single task. Both use the same question logic and subagent dispatch.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set12

The whole set →
pr-creator pr-creator turns your current branch into a pull or merge request. You see the exact preview first and approve before anything is created. CX Codex +1 195installs review-pull-request review-pull-request audits a single GitHub pull request across isolated stages, drafts a local Markdown report, and posts comments only when confirmed. CX Codex +1 161installs committing-scoped-changes committing-scoped-changes splits an explicit list of files or folders into separate git commits and leaves the rest of the working tree alone. CX Codex +1 153installs responding-to-pr-review-comments The responding-to-pr-review-comments skill gathers pull request comments, assesses the feedback, and drafts replies. With confirmation, it can post approved text to supported GitHub comment threads. CX Codex +1 144installs refactoring-code refactoring-code is a Claude Code skill that stages simplification refactors: approve the plan before edits, then check that behaviour stays the same. CX Codex +1 124installs diagnosing-root-causes The diagnosing-root-causes skill traces bugs, regressions, and CI/CD failures from supplied evidence, then produces a reviewed root-cause report. Use it when a problem report needs investigation rather than guesswork. CX Codex +1 122installs rewriting-code-strictly rewriting-code-strictly is a Claude Code skill that rewrites Python, TypeScript/JavaScript, or Go with stricter typing and boundary checks. It runs on requests to harden code or align it with static analysis tools. CX Codex +1 122installs improving-test-suites improving-test-suites is a Claude Code skill that reviews test suites and focuses them on important behavior. It activates for requests to trim, rewrite, review, or strengthen tests. CX Codex +1 119installs

Project sponsors

Companies that keep this analytics open