speckit.clarify

Identify and resolve ambiguities in feature specifications by asking targeted questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires speckit.specify, and includes scripts (resource) components.

What problem does it solve?

This Skill identifies underspecified areas in feature specifications by asking targeted clarification questions, reducing ambiguity and improving spec quality.

Core Features & Use Cases

  • Targeted Clarification: Asks up to 5 highly targeted questions to resolve ambiguities in feature specifications.
  • Spec Update: Encodes answers back into the spec file, enhancing clarity.
  • Integration with speckit.specify: Dependent on speckit.specify for spec generation, ensuring a seamless workflow.
  • Use Case: When reviewing a feature spec, this Skill can be used to ensure all requirements are clear and complete before proceeding to planning.

Quick Start

Run the clarify skill on your feature spec to automatically identify and resolve ambiguities.

Frequently Asked Questions about speckit.clarify

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

FAQPage Schema
How do I resolve ambiguities in a feature specification?

To resolve ambiguities in a feature specification, this Skill asks up to five targeted clarification questions based on impact and uncertainty, then encodes your answers directly back into the spec file to improve overall spec quality.

What is the best way to identify underspecified areas in software requirements?

Identifying underspecified areas in software requirements is handled through structured ambiguity detection, which automatically finds gaps in your feature spec and prioritizes questions to resolve the highest impact uncertainties first.

Do I need a spec file generated before running specification clarification?

Yes, specification clarification requires a spec file generated by the speckit.specify dependency, as it operates within the scope of feature specification reviews and uses that output to identify ambiguities.

Can I update my existing feature spec with clarification answers automatically?

Yes, you can update your existing feature spec automatically because the Skill encodes your answers from the targeted clarification questions directly back into the original spec file.

How many clarification questions will I be asked when reviewing a feature spec?

You will be asked up to five highly targeted clarification questions when reviewing a feature spec, specifically prioritized by their impact and uncertainty to resolve ambiguities efficiently without overwhelming the review process.

When should I use targeted questions for specification management?

You should use targeted questions for specification management when reviewing a feature spec to ensure all requirements are clear and complete, specifically before proceeding to the planning phase of your software design workflow.