speckit-clarify

Identify underspecified areas in feature specifications and record clarification answers.

2|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/NUMU-IO/NUMU-api --skill speckit-clarify-numu-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/NUMU-IO/NUMU-api/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/NUMU-IO/NUMU-api --skill speckit-clarify-numu-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speeds up feature-spec refinement by exposing missing decisions early, before planning and implementation create rework.

Core Features & Use Cases

  • Asks up to five highly targeted clarification questions for ambiguous requirements.
  • Captures answers directly back into the spec so the document stays aligned.
  • Useful when scope, roles, data models, edge cases, integrations, or non-functional needs are incomplete.

Quick Start

Ask this skill to review your feature spec and surface the most important ambiguities before planning.

Frequently Asked Questions about speckit-clarify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify missing requirements in a feature spec?

To identify missing requirements in a feature spec, you need targeted clarification questioning on ambiguous scope, roles, data models, and edge cases. This exposes underspecified areas early, capturing answers directly back into the spec to prevent downstream rework during planning and implementation.

What questions should I ask to clarify ambiguous feature requirements?

To clarify ambiguous feature requirements, ask up to five highly targeted questions covering scope, roles, data models, edge cases, integrations, and non-functional quality constraints. Prioritizing these clarification questions helps surface critical missing decisions before implementation begins.

How do I update a feature spec incrementally without breaking consistency?

You update a feature spec incrementally without breaking consistency by capturing concise answers directly into the document as they are resolved. This preserves spec alignment and reduces downstream rework by ensuring all scope and data model updates are recorded immediately.

When do I need spec clarification before planning a feature?

You need spec clarification before planning a feature when scope, roles, data models, edge cases, integrations, or non-functional quality constraints are still incomplete. Early questioning of these ambiguous areas speeds up refinement and prevents implementation rework.

What is the best way to reduce ambiguity in software feature specifications?

The best way to reduce ambiguity in software feature specifications is applying prioritized, targeted questioning to expose incomplete decisions. Capturing these answers directly into the spec ensures the document stays aligned and minimizes downstream rework during the build phase.