speckit-clarify

Identify underspecified areas in feature specifications and generate targeted questions.

Updated Jul 2, 2026
One-click install
npx skills add https://github.com/niisara/social-media-content --skill speckit-clarify-niisara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/niisara/social-media-content/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/niisara/social-media-content --skill speckit-clarify-niisara

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires spec-kit, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps identify underspecified areas in feature specifications by asking up to 5 targeted clarification questions, reducing ambiguity and improving spec quality.

Core Features & Use Cases

  • Targeted Clarification: Asks up to 5 highly targeted questions to address underspecified areas.
  • Spec Integration: Encodes answers back into the feature specification.
  • Compatibility: Requires spec-kit project structure with a .specify/ directory.
  • Use Case: When developing a new feature, use this Skill to ensure all aspects are clearly defined before proceeding to planning.

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 resolve ambiguity in feature specifications before development?

To resolve ambiguity in feature specifications, you can use a clarification tool that scans your spec and asks up to 5 targeted questions to identify and fill underspecified areas. This ensures all aspects are clearly defined before planning.

What is the best way to clarify underspecified areas in a software feature spec?

The best way to clarify underspecified areas is through structured ambiguity scanning that generates targeted questions. Answers are then encoded directly back into the feature specification file, improving overall spec quality.

How do I integrate clarification answers back into my spec-kit specification?

To integrate clarification answers into your spec-kit specification, the Skill automatically encodes your responses directly back into the spec file. This updates the document within your existing project structure.

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

Yes, you need a spec-kit project structure with a .specify/ directory to use this specification clarification tool. The Skill relies on this specific environment to scan and update feature specifications.

When should I run specification clarification during feature development?

You should run specification clarification during feature development when you have an initial spec draft. Use it to ensure all aspects are clearly defined and ambiguity is resolved before proceeding to the planning phase.

Can I target specific areas to clarify in my feature specification?

Yes, you can target specific areas to clarify in your feature specification. The command accepts optional parameters to focus the ambiguity resolution and coverage scanning on particular sections of your spec.