# speckit-clarify

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2200 installs · ★ 153
- Author: github-spec-kit
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-clarify/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/speckit-clarify

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/speckit-clarify/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/speckit-clarify/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/speckit-clarify/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/speckit-clarify/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dceoy/speckit-agent-skills speckit-clarify
```

2. **Manually: put the files in place**
- File: `.github/skills/speckit-clarify/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-clarify
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/speckit-clarify/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-clarify/SKILL.md

## When to use it
- 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
- run /speckit-clarify on the current spec
- clarify the spec — I care about loading and error states
- /speckit-clarify security and personal data handling

## Similar
- [clarify](https://affpapa.org/en/nevibecode/skills/aladicf-clarify.md) — skill · 533 installs
- [feature-forge](https://affpapa.org/en/nevibecode/skills/feature-forge.md) — skill · 4200 installs
- [walden](https://affpapa.org/en/nevibecode/skills/walden.md) — skill · 4200 installs
- [ce-doc-review](https://affpapa.org/en/nevibecode/skills/ce-doc-review.md) — skill · 3600 installs
- [spec](https://affpapa.org/en/nevibecode/skills/codewithmukesh-spec.md) — skill · 2800 installs
- [elicit](https://affpapa.org/en/nevibecode/skills/elicit.md) — skill · 2700 installs

From the same set: [dceoy/speckit-agent-skills](https://affpapa.org/en/nevibecode/by/dceoy/speckit-agent-skills.md) — 11 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md