skills.rest
misadecastro
misadecastroCOMMUNITY
Explore all skills by this author →
GitHub

speckit-clarify

Identify underspecified requirements in feature specs and update the document with clarifications.

Updated Apr 4, 2026
Search Tags:#workflow#planning#specification#requirements#ambiguity#clarify
One-click install
npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-clarify-misadecastro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/misadecastro/imperial-soccer/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-clarify-misadecastro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.

Core Features & Use Cases

  • Surface gaps and ambiguities in the active feature specification.
  • Generate a prioritized queue of up to 5 clarification questions.
  • Update the spec with accepted answers under a Clarifications section after each interaction.

Quick Start

Provide the current feature spec and run the clarifications workflow to generate targeted questions and update the spec.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify ambiguities in a feature specification?▼

To resolve underspecified requirements, provide the feature spec to generate up to 5 targeted clarification questions. Accepted answers are recorded inline and updated with measurable acceptance criteria.

How do I update a specification document with clarifications?▼

You update a specification document with clarifications by encoding accepted answers back into the spec under a Clarifications section after each interaction, ensuring traceability with measurable acceptance criteria.

What is the best way to resolve underspecified requirements in feature work items?▼

The best way to resolve underspecified requirements is prompting focused clarifications and updating the specification document directly, ensuring gaps in data models and UX are resolved with measurable criteria for acceptance.

Does spec clarification work with a .specify directory structure?▼

Yes, spec clarification applies specifically to feature work items structured with a .specify directory, analyzing the contained specification files to surface gaps and generate targeted questions.

What areas of a feature spec are prioritized for ambiguity resolution?▼

Ambiguity resolution prioritizes high-impact areas across functional scope, data models, UX, and non-functional requirements to surface critical gaps and generate focused clarification questions.

Related Skills

Explore More Product & Management Skills→
estaciolimaestaciolima

speckit-clarify

Identify and resolve underspecified areas in feature specification files.

Community
Advanced
Foo-xFoo-x
2

testcase-generator

Generate acceptance and rejection test cases from specifications using CSP failure models.

Community
Advanced
shaman007shaman007
25

speckit-clarify

Identify and resolve ambiguities in feature specifications through structured questioning.

Community
Advanced
estaciolimaestaciolima

speckit-checklist

Generate structured checklists to validate technical requirements from project documentation.

Community
Intermediate