speckit-clarify

Detect ambiguous feature specifications and generate targeted clarification questions.

Updated May 22, 2026
One-click install
npx skills add https://github.com/yareliCamacho/AppCalendario --skill speckit-clarify-yarelicamacho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/yareliCamacho/AppCalendario/tree/main/.cursor/skills/speckit-clarify
Command: npx skills add https://github.com/yareliCamacho/AppCalendario --skill speckit-clarify-yarelicamacho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps turn vague feature ideas into clear, actionable specifications by finding the missing decisions that would otherwise cause rework, misaligned implementation, or weak acceptance tests.

Core Features & Use Cases

  • Ambiguity Detection: Scans a feature spec for unclear scope, data model gaps, UX edge cases, and unresolved dependencies.
  • Targeted Clarification: Asks a small number of high-impact questions that can be answered quickly and directly.
  • Spec Updates: Records each accepted answer back into the spec so the document stays current and implementation-ready.
  • Use Case: A team is about to plan a new feature, but the requirements leave open questions about roles, states, integrations, or success criteria, so this skill tightens the spec before work starts.

Quick Start

Ask this skill to review the current feature spec and surface the most important clarification questions before planning begins.

Frequently Asked Questions about speckit-clarify

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

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

To identify ambiguity in a feature specification, scan the document for unclear scope, data model gaps, UX edge cases, and unresolved dependencies to prevent misaligned implementation and rework.

What is spec clarification and why do I need it for software engineering projects?

Spec clarification is the process of finding missing decisions in product specs. It is needed to turn vague feature ideas into actionable requirements, ensuring implementation work starts with clear acceptance criteria.

How do I turn vague product specs into targeted clarification questions?

Turn vague product specs into targeted clarification questions by prioritizing high-impact ambiguities, asking a small number of direct questions about roles, states, and integrations, and recording concise answers back into the document.

Does spec ambiguity detection work for incomplete UX flows and data models?

Yes, spec ambiguity detection works for incomplete UX flows and data models by applying to product and software teams preparing specs where requirements, data models, or integrations are currently incomplete.

What's the best way to resolve unresolved dependencies in software requirements?

The best way to resolve unresolved dependencies in software requirements is to surface the most important clarification questions before planning begins, tightening the spec so the document stays implementation-ready.

How do I keep a feature spec current when clarification answers are provided?

Keep a feature spec current by recording each accepted clarification answer directly back into the specification document, ensuring the updated spec remains ready for downstream feature planning and implementation.