speckit-clarify

Identify ambiguities in spec-kit feature specifications and generate clarification questions.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/fhlta/primecore --skill speckit-clarify-fhlta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/fhlta/primecore/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/fhlta/primecore --skill speckit-clarify-fhlta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Underspecified feature specifications lead to misaligned implementation, costly rework, and failed acceptance criteria. This Skill eliminates that risk by identifying gaps and ambiguities in your active feature spec before planning begins.

Core Features & Use Cases

  • Ambiguity Scanning: Automatically reviews feature specs across 10 core taxonomy categories (functional scope, data model, UX flow, non-functional requirements, etc.) to identify partial or missing information.
  • Targeted Clarification: Asks up to 5 high-impact, prioritized questions (multiple-choice or short-answer format) to resolve the most critical spec gaps, with recommended options based on industry best practices.
  • Automated Spec Integration: Records accepted answers directly into the spec file, updates relevant sections, and re-validates the spec quality checklist if one exists.
  • Use Case: A product manager drafting a spec for a new payment processing feature can use this Skill to catch missing details like supported payment methods or refund policies before the engineering team begins planning, avoiding costly rework later.

Quick Start

Use the /speckit-clarify command on your active feature spec to resolve critical ambiguities before moving to implementation planning.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I find ambiguities in feature specs before implementation planning?

Finding ambiguities in feature specs involves scanning across functional, data, UX, non-functional, and integration taxonomy categories to identify underspecified areas. This prevents misaligned implementation and downstream rework before planning begins.

What are common requirement gaps in product specifications that cause rework?

Common requirement gaps in product specifications include missing data models, incomplete UX flows, and undefined non-functional requirements. Scanning feature specs across taxonomy categories identifies these partial details to prevent costly rework.

How do I clarify product requirements during the pre-planning phase?

Clarifying product requirements during pre-planning involves generating up to 5 targeted questions to resolve high-impact spec gaps. Accepted answers integrate directly into the spec file and re-validate associated quality checklists.

Can I automatically update a feature spec file with clarified requirement answers?

You can automatically update a feature spec file by integrating accepted clarification answers directly into the document. The system then updates relevant sections and re-validates the spec quality checklist if one exists.

Does spec clarification work with structured spec-kit taxonomy categories?

Spec clarification works with spec-kit structured product feature specs by scanning across 10 core taxonomy categories including functional scope, data model, and UX flow. It dispatches configured pre and post execution extension hooks as required.

Why does undefined non-functional scope lead to failed acceptance criteria?

Undefined non-functional scope leads to failed acceptance criteria because underspecified feature specifications cause misaligned implementation. Identifying these requirement gaps before engineering begins prevents costly downstream rework.