speckit-clarify

Analyze technical specs and ask targeted questions to clarify ambiguities.

22|8|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/JoshMock/the-agency --skill speckit-clarify-joshmock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/JoshMock/the-agency/tree/main/packages/spec-kit/skills/speckit-clarify
Command: npx skills add https://github.com/JoshMock/the-agency --skill speckit-clarify-joshmock

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps identify and resolve ambiguities in feature specifications by asking precise, prioritized questions, ensuring clearer requirements and reducing rework.

Core Features & Use Cases

  • Ambiguity Detection: Scans technical specs to find incomplete or unclear sections.
  • Interactive Clarification: Asks up to five targeted questions to stakeholders for clarification.
  • Specification Improvement: Updates the spec document with clarified details, improving accuracy and implementation readiness.
  • Use Case: A team managing a project uses this Skill to systematically clarify functional and non-functional requirements before development begins.

Quick Start

Initiate a clarification session, and the Skill will analyze your spec, then ask focused questions to clarify uncertainties.

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 my software feature specifications?

Specification ambiguity detection scans technical specs to find incomplete or unclear sections. It facilitates precise identification of uncertainties by analyzing structured spec documents for missing functional and non-functional details.

What's the best way to clarify project requirements before development begins?

Clarifying project requirements before development is best achieved through interactive clarification sessions. The process asks up to five targeted questions to stakeholders, resolving uncertainties and updating the spec document with actionable details.

How do interactive clarification sessions work for requirement analysis?

Interactive clarification sessions for requirement analysis work by analyzing a spec and asking focused questions. After you initiate a session, it systematically asks up to five prioritized questions to stakeholders to resolve specification ambiguities.

Can I use automated specification analysis for project planning and design reviews?

Automated specification analysis is applicable for project planning, design reviews, and development readiness assessments. It systematically clarifies functional and non-functional requirements to ensure features are well-defined and actionable.

How many targeted questions does a specification clarification session ask?

A specification clarification session asks up to five targeted questions. It prioritizes these questions to efficiently resolve ambiguities and update the spec document with clarified details, improving implementation readiness.