speckit-clarify

Identify underspecified areas in feature specs and encode clarification answers.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/burningddol/epigram --skill speckit-clarify-burningddol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/burningddol/epigram/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/burningddol/epigram --skill speckit-clarify-burningddol

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies underspecified areas in a feature specification and immediately prompts for focused clarifications to reduce downstream rework.

Core Features & Use Cases

  • Clarification planning and gap analysis across functional scope, data model, UX flows, non-functional requirements, and integration points.
  • Session-based updates: accepted answers are embedded into a Clarifications section and applied to the spec after each step.
  • Collaboration-ready for product managers and engineers to drive consistent specs and testable acceptance criteria.

Quick Start

Run the speckit-clarify workflow against the active feature spec to begin the clarification session.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I find underspecified areas in a feature specification?

You can identify spec gaps by running a targeted clarification workflow that analyzes functional scope, data models, and UX flows, then asks up to 5 highly specific questions to extract missing details and encode answers directly back into the spec.

What is the best way to reduce downstream rework in product management workflows?

The best way to reduce downstream rework in product management workflows is to enforce structured spec clarification sessions, embedding accepted answers immediately into the active specification to ensure testable acceptance criteria before implementation begins.

How do I clarify non-functional requirements and integration points in a spec?

You clarify non-functional requirements and integration points by applying a structured clarification workflow to your active feature spec, which generates targeted questions covering these specific attributes to guide planable implementation.

Do I need a .specify directory structure to automate specification clarification?

Yes, you need a .specify directory structure because the clarification workflow applies its gap analysis and atomic updates to project specs located within that specific folder hierarchy.

Can I apply atomic updates to a feature spec during a clarification session?

Yes, you can apply atomic updates to a feature spec during a clarification session, as the workflow embeds accepted answers into a Clarifications section and updates the FEATURE_SPEC incrementally after each step.

What are the limitations of automated gap analysis for requirements?

Automated gap analysis for requirements is limited to asking up to 5 highly targeted clarification questions per session, requiring manual user input to resolve ambiguities and encode the exact answers back into the specification.