speckit-clarify

Scan feature specifications for gaps and generate prioritized clarification questions.

8|1|Updated Sep 19, 2008
One-click install
npx skills add https://github.com/juvenal/openrender --skill speckit-clarify-juvenal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/juvenal/openrender/tree/main/.qwen/skills/speckit-clarify
Command: npx skills add https://github.com/juvenal/openrender --skill speckit-clarify-juvenal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Underspecified or ambiguous feature specifications lead to misalignment between stakeholders, wasted engineering effort, and deliverables that fail to meet acceptance criteria. This Skill eliminates that risk by systematically identifying gaps in your feature spec before planning begins.

Core Features & Use Cases

  • Structured Ambiguity Scanning: Evaluates your feature spec across 10+ taxonomy categories (functional scope, data model, UX flows, non-functional requirements, integrations, edge cases, and more) to flag partial or missing information.
  • Prioritized Clarification Workflow: Generates up to 5 high-impact, answerable questions per session, targeting gaps that most affect architecture, task decomposition, and test design to maximize rework reduction.
  • Automatic Spec Integration: Records accepted answers directly into your feature spec file, updates relevant sections to resolve ambiguities, and validates the final document for consistency, no contradictory text, and complete coverage.
  • Use Case: A product manager building a new user notification feature can use this Skill to identify missing details like notification delivery retry rules or accessibility requirements, record stakeholder answers in the spec, and ensure engineering has a clear, unambiguous blueprint for planning.

Quick Start

Invoke the speckit-clarify skill to identify and resolve all critical ambiguities in your active feature specification before proceeding 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 resolve ambiguities in a feature specification before development starts?

To resolve ambiguities in a feature specification, scan the document across functional scope, data model, and UX categories to identify coverage gaps, then generate prioritized clarification questions for stakeholders. This prevents misalignment and costly downstream rework.

What is requirement validation for feature specs and when do I need it?

Requirement validation for feature specs is the process of checking a document for missing decision points across integration, non-functional, and edge case categories. You need it during pre-planning to ensure engineering receives a complete, unambiguous blueprint.

How do I identify missing decision points in an underspecified feature requirement?

Identify missing decision points in an underspecified feature requirement by applying structured ambiguity scanning across 10+ taxonomy categories. This flags partial information affecting architecture, task decomposition, and test design to maximize rework reduction.

Can I automatically integrate stakeholder answers directly into my feature spec file?

Yes, you can automatically integrate accepted stakeholder answers directly into your feature spec file. The system updates relevant sections to resolve ambiguities and validates the final document for consistency, ensuring no contradictory text and complete coverage.

What is the best way to prevent rework caused by ambiguous software requirements?

The best way to prevent rework caused by ambiguous software requirements is generating up to five high-impact, answerable clarification questions per session. Targeting gaps that affect architecture and test design delivers a clear blueprint for implementation planning.

Does spec clarification work for complex non-functional and integration requirements?

Yes, spec clarification works for non-functional and integration requirements by evaluating your feature spec across comprehensive taxonomy categories. It flags missing details like delivery retry rules or accessibility requirements to ensure complete functional scope coverage.