speckit-clarify

Scan feature specifications against a taxonomy and resolve ambiguities interactively.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill eliminates project uncertainty by identifying missing decision points in feature specifications and systematically gathering the necessary clarifications to ensure development readiness.

Core Features & Use Cases

  • Ambiguity Detection: Scans feature specifications against a comprehensive taxonomy to flag missing functional, technical, or edge-case requirements.
  • Structured Clarification: Conducts a guided, interactive questioning loop to resolve ambiguities and record decisions directly into the spec file.
  • Use Case: Use this skill when a new feature spec feels incomplete or vague to ensure all team members and stakeholders are aligned before the implementation planning phase begins.

Quick Start

Invoke the speckit-clarify skill to analyze the current feature specification and resolve any outstanding ambiguities.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I resolve ambiguity in feature specifications before implementation?

To resolve ambiguity in feature specifications, you can use an interactive clarification loop that scans project specs against a taxonomy to identify missing functional, technical, or edge-case requirements and records decisions directly into the file.

Why does underspecified requirements documentation cause project uncertainty?

Underspecified requirements cause project uncertainty by leaving missing decision points undefined, which creates downstream implementation risks when team members and stakeholders attempt to build features without explicit functional and non-functional constraints.

What is the best way to ensure development readiness for incomplete feature specs?

The best way to ensure development readiness is to conduct structured clarification that systematically gathers necessary decisions to fill gaps in incomplete feature specs, ensuring high-fidelity, spec-driven development workflows before planning begins.

How do I identify missing functional and edge-case requirements in a spec file?

You identify missing functional and edge-case requirements by scanning feature specifications against a comprehensive multi-category taxonomy that flags underspecified constraints within your project documentation.

Does this clarification process work without external dependencies?

Yes, the clarification process works without external dependencies, operating as a standalone script component to analyze feature specifications and execute the interactive questioning loop directly.

When should I not use automated spec clarification for feature documentation?

You should not use automated spec clarification when a feature specification is already explicitly defined with all functional and non-functional constraints, as the interactive loop is designed to resolve vagueness and incomplete requirements.