Skip to main content
affpapa.org
RU EN
skill CX Codex

speckit-clarify — Claude Code skill: spec questions, install

Scans a feature spec for gaps, asks up to 5 targeted questions and writes the answers back into the spec file.

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

What speckit-clarify does

The skill loads the active feature spec and walks it category by category: user goals and success criteria, data model, interaction flows, non-functional requirements, external dependencies, edge cases, terminology. Each category gets a status — clear, partial or missing — and the gaps feed a question queue.

Five questions per session at most, and every one is cheap to answer: a pick from 2–5 options or a phrase of five words or less. They come one at a time. Answers are encoded back into the spec, so the file changes as the conversation goes.

It expects a spec-kit project layout with a .specify/ directory. Without it the prerequisite check aborts and the skill tells you to run /speckit-specify first. Run this before /speckit-plan; skipping the questions means reworking the plan later.

What it helps with

  • surface decisions the spec author never wrote down
  • fill gaps in acceptance criteria before planning starts
  • record edge-case answers inside the spec file itself
  • check the spec against project constitution rules
  • cap the review at five questions instead of an endless interview

Example prompts for the agent

  • run /speckit-clarify on the current spec
  • clarify the spec — I care about loading and error states
  • /speckit-clarify security and personal data handling

How to install speckit-clarify

1Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-code

2Manually: put the files in place

~/.claude/skills/speckit-clarify/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speckit-clarify/

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

Questions about speckit-clarify

How do I install speckit-clarify in Claude?

Run npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-code. The skill lands in ~/.claude/skills/speckit-clarify/SKILL.md.

What does speckit-clarify do?

It scans a feature spec for ambiguity and missing decisions, asks up to 5 short questions and writes the answers back into the same spec file.

What do I need for it to work?

A spec-kit project with a .specify/ directory. If the prerequisite check fails, the skill points you to /speckit-specify first.

Similar skills

All skills for Agent setup: memory, context, orchestration →
clarify aladicf Rewrites labels, error messages, empty states and CTAs so users know what happened and what to do next. CX Codex +1 533installs feature-forge https://github.com/Jeffallan A skill that runs a requirements interview and turns a feature idea into a spec: EARS requirements, acceptance criteria and an implementation checklist. CX Codex +1 4,200installs walden andrearaponi Keeps feature specs in .walden/specs/: EARS requirements, reviewed design, tasks and executable proofs. CX Codex +1 4,200installs ce-doc-review EveryInc This skill reviews requirements, plans, and specs through role-based reviewers. Use it to catch consequential issues in an existing document and apply fixes within the granted authority. CX Codex +1 3,600installs spec codewithmukesh Turns a rough feature idea into a written specification with acceptance criteria. Asks questions in rounds until every gap is closed. CX Codex +1 2,800installs elicit juxt Runs a structured discovery session and turns the conversation into an Allium specification. Useful when a system or feature is not written down yet. CX Codex +1 2,700installs

From the same set10

speckit-specify Turns a plain-language feature description into a spec folder: short name, number, spec.md from the template, and a path saved in .specify/feature.json. CX Codex +1 2,600installs speckit-constitution This skill writes and updates the project constitution in .specify/memory/constitution.md, turning your principles into a versioned governance doc. CX Codex +1 2,400installs speckit-implement Executes development tasks from tasks.md in spec-kit projects. It validates readiness checklists, triggers pre-implementation hooks, and configures ignore files. CX Codex +1 2,400installs speckit-tasks This skill turns plan.md and spec.md into a tasks.md ordered by dependencies and user stories. Useful when the feature is already described in spec-kit but the work queue is not. CX Codex +1 2,400installs speckit-taskstoissues Turns tasks from tasks.md into dependency-ordered GitHub issues. The skill is marked deprecated and points to a replacement extension. CX Codex +1 1,500installs speckit-baseline This skill reads your source files and turns them into a framework-agnostic feature spec with user stories and requirements. Useful when a codebase exists but written requirements do not. CX Codex +1 1,500installs speckit-checklist Generates a custom requirements-quality checklist for a feature specification. It helps reviewers catch ambiguous phrasing and missing edge cases before coding starts. CX Codex +1 1,500installs claude-command-converter Converts Claude Code slash commands into portable Agent Skills format. Useful when migrating workflows to Codex, Cursor, or Copilot. CX Codex +1 1,400installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor