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.