speckit-clarify

Identify underspecified areas in feature specs and encode answers into a Clarifications section.

9|4|Updated May 13, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-mcp --skill speckit-clarify-opsmill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/opsmill/infrahub-mcp/tree/main/.agents/skills/speckit-clarify
Command: npx skills add https://github.com/opsmill/infrahub-mcp --skill speckit-clarify-opsmill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in the current feature specification and encode answers back into the spec.

Core Features & Use Cases

  • Structured ambiguity scanning across functional scope, data model, UX flows, non-functional attributes, and integration considerations.
  • Generates up to five targeted clarification questions and records answers into a new Clarifications section in the spec for traceability.
  • Provides a session-based workflow that updates the spec file and preserves canonical terminology for downstream planning.

Quick Start

Run a clarification pass on your feature spec and record up to five targeted questions with answers in the Clarifications section.

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, run a structured ambiguity scan across functional scope, data models, user interactions, non-functional requirements, and edge cases to pinpoint missing details.

How do I add clarifications to a spec file for traceability?

Add clarifications to a spec file by appending a dedicated Clarifications section with a daily session subsection, mapping each targeted question to its answer as a bullet point for downstream traceability.

What is the best way to generate targeted questions for engineering requirements?

The best way to generate targeted questions for engineering requirements is using a session-based workflow that analyzes the spec and outputs up to five relevant clarification questions per session.

Can I record answers directly into my existing feature specs?

Yes, you can record answers directly into existing feature specs. The workflow updates the spec file by encoding answers back into the document while preserving canonical terminology for planning.

What are the limitations of automated spec clarification workflows?

A limitation of automated spec clarification workflows is the generation cap of five targeted clarification questions per session, requiring multiple sessions to fully address complex feature specifications.