speckit-clarify

Detect ambiguities in feature specifications and integrate answers into the spec file.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/infantesromeroadrian/arca-agent --skill speckit-clarify-infantesromeroadrian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/infantesromeroadrian/arca-agent/tree/main/template/skills/speckit-clarify
Command: npx skills add https://github.com/infantesromeroadrian/arca-agent --skill speckit-clarify-infantesromeroadrian

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses ambiguity in feature specifications by asking targeted clarification questions, recording answers directly in the spec, and guiding the development process.

Core Features & Use Cases

  • Ambiguity Detection: Identifies underspecified areas in feature specifications.
  • Targeted Questions: Generates up to 5 questions to address specific ambiguities.
  • Spec Integration: Integrates clarifications directly into the feature specification file.
  • Use Case: For a new feature, use this Skill to ensure all requirements are clear and complete before proceeding to the planning phase.

Quick Start

To use the speckit-clarify skill, specify the areas of the spec to clarify. Example: clarify /my/project/skills/speckit-clarify.md --arg "User roles and permissions".

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I detect ambiguity in a feature specification?

To detect ambiguity in a feature specification, use this Skill to identify underspecified areas and automatically generate up to 5 targeted clarification questions for resolution.

How do I resolve feature spec ambiguities and integrate the answers back into the file?

To resolve feature spec ambiguities, provide the spec areas to clarify; the Skill asks targeted questions and integrates the recorded answers directly back into your specification file.

Do I need a Python environment and a .specify/ directory to run this specification management workflow?

Yes, running this specification management workflow requires a project containing a .specify/ directory and an active Python environment to execute the necessary bash pre-execution checks and hooks.

What is the best way to ensure feature requirements are clear before planning?

The best way to ensure feature requirements are clear before planning is to systematically resolve specification ambiguities by asking targeted questions and integrating the clarifications directly into the spec.

Does this specification clarification tool work with existing spec files?

Yes, the specification clarification tool works with existing spec files by accepting a path to the feature specification and an argument defining the specific areas to clarify.

Why are there up to 5 questions generated for my feature specification?

Up to 5 questions are generated to specifically address and resolve ambiguities detected within your feature specification, ensuring all requirements are clear and complete before development proceeds.