speckit-clarify

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

57|13|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/heidsoft/itsm --skill speckit-clarify-heidsoft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/heidsoft/itsm/tree/main/.claude/skills/speckit-clarify
Command: npx skills add https://github.com/heidsoft/itsm --skill speckit-clarify-heidsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Underspecified feature specifications slow teams and risk misalignment; this Skill prompts up to five precise clarification questions and encodes the answers back into the spec to reduce rework.

Core Features & Use Cases

  • Interactive clarification workflow that identifies gaps in a spec, proposes concrete questions, and records agreed answers.
  • Automatically updates the spec with a "Clarifications" section and a per-session log to ensure traceability.
  • Integrates with a .specify project structure and extension hooks to enable pre/post-clarification workflows.

Quick Start

Run speckit-clarify on your project and answer the questions as they appear.

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?

You can pinpoint underspecified areas in a feature specification by running an interactive clarification workflow that proposes up to five targeted questions and records the agreed answers directly into the document.

How do I add a clarifications section to my software product spec?

You add a clarifications section to your software product spec by running an interactive workflow that automatically enforces a dedicated section, creates per-session subheadings, and appends Q/A records for traceability.

Can I use clarification workflows for AI-enabled product specs?

Yes, the clarification workflow applies directly to AI-enabled product specs, prompting up to five targeted questions to resolve ambiguities and then encoding the answers directly into the specification document.

Does speckit-clarify support extension hooks for pre and post clarification?

Yes, speckit-clarify supports pre and post-clarification extension hooks, enabling you to trigger custom workflows before and after the interactive Q/A session within a .specify project structure.

What is the best way to reduce rework caused by underspecified requirements?

The best way to reduce rework from underspecified requirements is to run an interactive clarification workflow that prompts up to five precise questions and encodes the agreed answers directly into the specification document.

How do I maintain traceability for specification updates during clarification?

You maintain traceability for specification updates by enforcing a dedicated clarifications section with per-session subheadings, automatically appending Q/A records after each answer to create a permanent audit trail.