Skip to main content
affpapa.org
RU EN
skill

requirements-clarity — Claude Code skill: what it does & setup

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

Install into Claude Code · claude-code-templates All methods and platforms ↓ 
npx claude-code-templates@latest --skill productivity/requirements-clarity
Open on GitHub

What requirements-clarity 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.

What it helps with

  • 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 for the agent

  • 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

How to install requirements-clarity

1claude-code-templates

npx claude-code-templates@latest --skill productivity/requirements-clarity

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill requirements-clarity -a claude-code

3Manually: put the files in place

~/.claude/skills/requirements-clarity/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/requirements-clarity/

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

Questions about requirements-clarity

How do I install requirements-clarity in Claude Code?

Run npx claude-code-templates@latest --skill productivity/requirements-clarity or install it with npx skills add davila7/claude-code-templates --skill requirements-clarity -a claude-code.

What does requirements-clarity do?

It conducts an interactive inquiry using a 100-point grading system and generates a PRD file in ./docs/prds/ once clarity hits 90 points.

When does requirements-clarity skip clarification?

It stays inactive if you provide code snippets, direct file references like auth.go:45, existing functions, or reproducible bug reports.

Similar skills

All skills for Notes, tasks and projects →
find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. 862,247installs

From the same set804

The whole set →
ascii-ui-mockup-generator This subagent sketches UI concepts as ASCII mockups, giving you several layout, form and dashboard options before any code is written. 207installs blue-green-deployment A Claude slash command that sets up blue-green deployment: traffic switching, health validation and rollback. 206installs commit-smart This skill reads Git changes, suggests a commit type and scope, then drafts a message that explains the reason behind the work. Use it when a diff alone would leave the intent unclear. 205installs csharp-pro Get guidance on modern C# and .NET work, from async code to unit tests. Use it when building or checking an application. 205installs xlsx-official Sets up workflows for creating, editing, and recalculating XLSX, XLSM, CSV, and TSV files. It builds financial models using dynamic formulas instead of static values. 204installs langsmith-tracing Exports Claude Code conversation traces to LangSmith for session tracking and analysis. Runs in the background right after Claude finishes responding. 204installs voice-ai-development Plan voice agents and apps that handle speech input and audio replies. Use it when choosing an approach for calls, transcription, or speech synthesis. 203installs graph-query This skill queries a project’s code graph to trace component links and assess the reach of a change. Use it before editing a function or model. 202installs

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