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.