# requirements-clarity

Clarifies fuzzy feature descriptions through targeted questions before coding starts. It scores requirements on a 100-point scale and writes a finished PRD file.

- skill · `type=skill` · Claude Code · 204 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/productivity/requirements-clarity
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/requirements-clarity

## What it does

The skill catches abstract prompts like "build dashboard" or "add payments". Rather than letting the model draft arbitrary code, it grades the task across four areas: functional scope (up to 30 points), technical constraints (25), edge cases with error paths (25), and business context (20).

Interviews proceed in short cycles of two or three focused questions per turn. The assistant updates the clarity score after each reply. Once the total reaches 90 points, it writes the specification directly to `./docs/prds/{feature_name}-v{version}-prd.md` with acceptance criteria, architecture choices, and boundaries.

Targeted tasks will not trigger this flow: prompts referencing specific file paths like `auth.go:45`, inline code samples, or explicit bug reproduction steps bypass clarification entirely.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill productivity/requirements-clarity
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill requirements-clarity -a claude-code
```

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates requirements-clarity
```

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

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/requirements-clarity
```

### Windsurf (Devin Desktop)

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

### 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/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/productivity/requirements-clarity

## When to use it
- turn vague task prompts into a structured PRD document
- uncover edge cases and validation rules before writing code
- establish measurable acceptance criteria and architecture boundaries
- filter out unnecessary work using YAGNI and KISS principles

## Example prompts
- I want to add user authentication to the project, help me write the PRD
- We need a dashboard for analytics, ask the necessary questions to clarify scope
- Help me specify requirements and technical constraints for payment integration

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 804 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