speckit-clarify.agent

Identify underspecified areas in feature specs and encode answers back.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/franciscosanchezn/easyfactu-es --skill speckit-clarify-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify.agent
Source: https://github.com/franciscosanchezn/easyfactu-es/tree/main/.github/skills/speckit-clarify.agent
Command: npx skills add https://github.com/franciscosanchezn/easyfactu-es --skill speckit-clarify-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature specification by prompting up to five targeted clarification questions and encoding the answers back into the spec.

Core Features & Use Cases

  • Interactive clarification loop to surface ambiguities and missing decision points in active specs.
  • Automatically updates the feature spec with a new Clarifications section and session logs after each accepted answer.
  • Enables traceable decision records for downstream planning, testing, and implementation.

Quick Start

Prompt the user with a single clarifying question and update the spec after each answer.

Frequently Asked Questions about speckit-clarify.agent

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

FAQPage Schema
How do I clarify ambiguities in a feature specification?

To clarify ambiguities in a feature specification, you can use an interactive loop that prompts up to five targeted questions and encodes the answers directly back into the spec. This identifies missing decision points and updates the document automatically.

How do I track specification decisions during a Q&A session?

You can track specification decisions by automatically creating a Clarifications section with a Session YYYY-MM-DD subheading. It appends Q&A lines and persists changes after each accepted answer to maintain traceable decision records for downstream planning.

Does this specification clarification tool require a specific project structure?

Yes, this specification clarification tool applies to SPEC-KIT style projects. It requires a .specify directory to load the spec, append clarification logs, update relevant sections, and persist changes after each integration.

How many clarification questions can I prompt for an underspecified feature?

You can prompt up to five targeted clarification questions for an underspecified feature. The interactive loop updates the feature spec after each accepted answer to surface ambiguities and ensure functional requirements are met.

What is the best way to update underspecified areas in active specs?

The best way to update underspecified areas in active specs is through an interactive clarification loop that surfaces missing decision points. It automatically updates relevant spec sections and creates traceable records for implementation and testing.