spec-kitty-clarify

Identify underspecified areas in feature specifications and propose targeted clarifications.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill spec-kitty-clarify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-kitty-clarify
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/spec-kitty-plugin/skills/spec-kitty-clarify
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill spec-kitty-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Underspecified feature specifications can derail planning and implementation. This skill guides a structured clarifications workflow to surface ambiguities, identify risks, and capture concrete decisions directly in the spec.

Core Features & Use Cases

  • Taxonomy-driven ambiguity checks across functional scope, data model, interactions, non-functional attributes, and edge cases.
  • Interactive, single-question-at-a-time clarifications that generate a prioritized queue of questions (max 5) and record answers in a dedicated Clarifications section.
  • Live spec integration: updates the FEATURE_SPEC with each accepted answer, preserving formatting and traceability, and exports a validation-ready clarification trail for planning.
  • Plan readiness guidance: surfaces unresolved gaps and provides recommendations on whether to proceed to planning or defer clarifications.

Quick Start

Initiate a clarification session by running /spec-kitty.clarify in the active feature-spec repository.

Frequently Asked Questions about spec-kitty-clarify

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

FAQPage Schema
How do I identify ambiguities in a feature specification before planning?

Ambiguities in a feature specification are identified through taxonomy-driven checks across functional scope, data models, interactions, non-functional quality attributes, and edge cases, generating targeted clarifications to reduce risk.

What is the best way to clarify underspecified requirements with stakeholders?

The best way to clarify underspecified requirements with stakeholders is an interactive workflow that surfaces gaps, asks single questions at a time from a prioritized queue, and records traceable decisions directly in the specification.

How do I know if my feature spec is ready to proceed to planning or if I should defer?

Plan readiness is determined by surfacing unresolved gaps from the clarification trail and providing explicit recommendations on whether to proceed to planning or defer until remaining specification ambiguities are answered.

Can I update a feature spec with clarification answers without losing existing formatting?

Yes, you can update a feature spec with clarification answers because the workflow integrates live with the FEATURE_SPEC, preserving original formatting and traceability while exporting a validation-ready clarification trail.

Does this specification clarification approach limit the number of questions asked at once?

Yes, this specification clarification approach limits questions by generating a prioritized queue of a maximum of five targeted questions, asking them one at a time to maintain focus and capture concrete decisions.

What limitations exist when checking edge cases in feature requirements?

A limitation when checking edge cases in feature requirements is that the taxonomy-driven gap analysis relies entirely on the existing specification content, meaning entirely unstated out-of-scope behaviors may remain unresolved without active stakeholder input.