speckit-clarify

Resolve underspecified feature specs by asking up to five targeted questions and recording answers.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/alienstro/mediapipe-scroll --skill speckit-clarify-alienstro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/alienstro/mediapipe-scroll/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/alienstro/mediapipe-scroll --skill speckit-clarify-alienstro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The speckit-clarify Skill reduces ambiguity in a feature specification by identifying underspecified areas and guiding you to resolve them before planning.

Core Features & Use Cases

  • Pre-plan clarification workflow: Performs a structured scan of the active spec for missing or partial decisions and prompts you for answers until clarified.
  • Configurable extension hooks: Supports optional and mandatory pre-clarification hooks from .specify/extensions.yml, when present.
  • Spec self-updating: Records accepted answers into the appropriate sections of the spec and saves after each integration to minimize rework risk.
  • Limited, high-impact questioning: Asks up to 5 highly targeted clarification questions using constrained answer formats.

Quick Start

Run /speckit-clarify to detect missing requirements in your current feature spec and update the spec with your answers.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I clarify ambiguous feature requirements before planning?▼

To reduce specification ambiguity before planning, this Skill scans your active spec for missing decisions across functional, non-functional, UX, and data categories, then interactively prompts you for targeted answers to resolve underspecified areas.

How do I update a spec-kit feature specification incrementally?▼

You can update a spec-kit feature specification incrementally by answering the interactive clarification prompts; the Skill records your accepted answers into the appropriate spec sections and saves after each integration to minimize rework risk.

Does spec clarification work with extension hooks?▼

Yes, spec clarification supports optional and mandatory pre-clarification hooks configured via .specify/extensions.yml, allowing you to execute custom extension logic before the ambiguity scanning process begins.

What is the maximum number of clarification questions asked for a feature spec?▼

The maximum number of clarification questions asked for a feature spec is five. The Skill limits questioning to high-impact areas using constrained answer formats to efficiently resolve underspecified requirements.

Do I need prerequisite path checks before resolving spec ambiguity?▼

Yes, you need prerequisite path checks via check-prerequisites.ps1 before resolving spec ambiguity. The Skill validates your environment paths to ensure the active spec-kit project is correctly configured before clarification.

When should I not use automated spec clarification?▼

You should not use automated spec clarification if your feature specification is already implementation-ready or if your project lacks the required spec-kit structure and prerequisite path configurations needed for validation.