speckit-clarify

Scan feature specs for ambiguity and write up to five clarifications into the FEATURE_SPEC file.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you find unclear, missing, or underspecified parts of a feature spec so implementation and validation don’t stall later.

Core Features & Use Cases

  • Ambiguity & coverage scanning: Reviews the active feature spec across functional, data, UX, quality, integration, edge cases, constraints, terminology, and acceptance signals.
  • Up to 5 high-impact clarifications: Asks one question at a time with tightly constrained answer formats to minimize back-and-forth.
  • Spec self-updating: Records accepted answers into the spec file under a session-specific Clarifications section and saves after each answer to prevent context loss.

Quick Start

Tell the AI to clarify your current spec by running the speckit-clarify skill for the feature you’re specifying, for example: “Clarify the current feature spec so I can proceed confidently.”

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I reduce ambiguity in a feature spec before planning?

To reduce ambiguity in a feature spec, you can run a clarifying process that scans for underspecified functional, data, and UX requirements. It asks up to five targeted questions one at a time and writes the accepted answers directly back into the spec file to ensure planning readiness.

How do I resolve underspecified acceptance criteria in my spec?

To resolve underspecified acceptance criteria, the workflow scans the active feature spec using a defined ambiguity taxonomy. It enforces a one-question-at-a-time interaction with constrained response formats to incrementally capture and save missing testable signals into your file.

Can I use spec-kit to clarify missing UX requirements?

Yes, you can use a spec-kit compatible workflow to clarify missing UX requirements. The process reviews your active feature spec across functional, data, and UX dimensions, then prompts you for specific clarifications to update the document and reduce implementation risk.

What is the best way to update a feature spec with clarifications?

The best way to update a feature spec with clarifications is to use an incremental saving approach. The process records accepted answers into a session-specific Clarifications section within the FEATURE_SPEC file, saving after each response to prevent context loss during the specifying workflow.

Does the spec clarification process require any specific repository setup?

Yes, the spec clarification process requires running repository prerequisite checks before scanning. This ensures the environment is properly configured to locate the active FEATURE_SPEC file and apply the defined ambiguity taxonomy for identifying underspecified areas.