speckit-clarify

Identify underspecified areas in feature specifications and encode answers back into the spec.

1|1|Updated May 31, 2026
One-click install
npx skills add https://github.com/WayneSHC/polaris-desk --skill speckit-clarify-wayneshc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/WayneSHC/polaris-desk/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/WayneSHC/polaris-desk --skill speckit-clarify-wayneshc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies underspecified areas in feature specifications by asking up to 5 targeted clarification questions and encoding answers back into the spec.

Core Features & Use Cases

  • Targeted Clarification: Asks up to 5 highly targeted questions to reduce ambiguity in feature specs.
  • Spec Integration: Encodes answers directly into the spec file for traceability.
  • Compatibility: Requires spec-kit project structure with a .specify/ directory.
  • Use Case: Use this Skill to ensure your feature specifications are clear and complete before proceeding to planning or implementation.

Quick Start

Run the 'speckit-clarify' command with optional areas to clarify in 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 clarify feature specifications before implementation?

To clarify feature specifications, this Skill asks up to 5 targeted questions to identify underspecified areas and encodes the answers directly back into the spec file for traceability. It requires a spec-kit project structure to function.

What is the best way to reduce ambiguity in feature specs?

The best way to reduce ambiguity in feature specs is using targeted clarification questions. This Skill analyzes your specification, asks up to 5 highly targeted questions, and encodes your answers directly into the Markdown spec file.

Do I need a spec-kit project structure to use spec clarification tools?

Yes, you need a spec-kit project structure with a .specify/ directory to use this spec clarification tool. It relies on this specific environment to process specifications and output encoded Markdown files.

How does questioning work for encoding answers back into a specification?

Questioning for encoding answers works by identifying underspecified areas in your feature spec, asking up to 5 targeted questions, and writing the responses directly back into the specification file to ensure clarity before planning.

Can I use Python to automate feature specification clarification?

Yes, you can use Python to automate feature specification clarification. This Skill uses Python for processing and Markdown for output, asking targeted questions to fill gaps in your feature specs within a spec-kit project.

Why does my feature specification clarification stop after 5 questions?

Your feature specification clarification stops after 5 questions because this Skill is designed to ask a maximum of 5 highly targeted questions to reduce ambiguity. This limit ensures the clarification process remains focused and efficient.