speckit-clarify

Identify underspecified areas in a feature specification and generate up to five clarification questions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects ambiguity, missing decisions, and under-specified requirements in an active feature specification so teams can resolve uncertainty before planning or implementation begins.

Core Features & Use Cases

  • Targeted Question Generation: Produces up to five prioritized clarification questions that are answerable as short phrases or multiple-choice options to minimize downstream rework.
  • Spec-aware Integration: Loads the current FEATURE_SPEC, runs a repository prerequisite check, and incrementally encodes accepted clarifications back into the spec with atomic writes and validation.
  • Use Case: Use this when a feature spec lacks measurable acceptance criteria or has vague domain/data rules to ensure acceptance tests and architecture decisions align with stakeholder intent.

Quick Start

Run the speckit-clarify flow against the active feature spec to generate and record up to five high-impact clarification questions.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I identify underspecified areas in a feature specification?▼

To identify underspecified areas in a feature specification, load the active FEATURE_SPEC to detect ambiguity and missing decisions, then generate up to five targeted clarification questions for stakeholders to resolve uncertainty.

How do I generate clarification questions for vague feature spec requirements?▼

You generate clarification questions for vague requirements by running the spec-kit clarification flow, which analyzes the FEATURE_SPEC and produces up to five prioritized questions answerable as short phrases or multiple-choice options.

What is the best way to resolve missing acceptance criteria before implementation begins?▼

The best way to resolve missing acceptance criteria is to use a spec clarification process that generates targeted questions, ensuring architecture decisions align with stakeholder intent before downstream planning or implementation begins.

Do I need a .specify directory to run spec clarification workflows?▼

Yes, you need a .specify directory containing a FEATURE_SPEC file. The workflow requires running the check-prerequisites.ps1 script to validate the repository environment before generating clarification questions.

How does spec clarification encode accepted answers back into the feature spec?▼

Spec clarification encodes accepted answers back into the feature spec by performing atomic spec updates. This incrementally writes validated clarifications directly into the FEATURE_SPEC file to maintain consistency.