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.