skills.rest
alfredoperez
alfredoperezCOMMUNITY
Explore all skills by this author →
GitHub

speckit-clarify

Identify ambiguities in AI feature specs and ask targeted clarification questions.

80|21|Updated Dec 2, 2025
Search Tags:#code quality#feature specification#spec-kit#spec clarification#AI specification
One-click install
npx skills add https://github.com/alfredoperez/speckit-companion --skill speckit-clarify-alfredoperez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-clarify
Source: https://github.com/alfredoperez/speckit-companion/tree/main/.cursor/skills/speckit-clarify
Command: npx skills add https://github.com/alfredoperez/speckit-companion --skill speckit-clarify-alfredoperez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies underspecified areas in feature specs by asking targeted clarification questions, reducing ambiguity and improving spec quality.

Core Features & Use Cases

  • Targeted Clarification: Ask up to 5 highly targeted questions to clarify underspecified areas in a feature spec.
  • Spec Update: Encode answers back into the spec, enhancing its comprehensiveness and correctness.
  • Compatibility: Requires spec-kit project structure with a .specify/ directory for optimal use.
  • Use Case: Use this Skill to refine a new feature spec, ensuring all critical aspects are addressed before implementation begins.

Quick Start

Run the 'speckit-clarify' command to start the clarification process.

Frequently Asked Questions about speckit-clarify

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

FAQPage Schema
How do I clarify ambiguities in an AI feature specification?▼

To clarify ambiguities in an AI feature specification, you can use a targeted clarification process that asks up to 5 questions to resolve underspecified areas and encodes the answers directly back into the spec.

What is the best way to improve feature spec quality before implementation?▼

Improving feature spec quality involves identifying underspecified areas and asking targeted clarification questions to enhance comprehensiveness and correctness before implementation begins.

Do I need a specific project structure to update feature specifications?▼

Yes, updating feature specifications using this targeted clarification process requires a spec-kit project structure with a `.specify/` directory for optimal compatibility.

How does spec clarification resolve underspecified areas in a feature spec?▼

Spec clarification resolves underspecified areas by asking up to 5 highly targeted questions, requiring user input to specify answers, and outputting a revised spec with integrated clarifications.

Can I automatically encode clarification answers back into my feature spec?▼

Yes, you can encode clarification answers back into your feature spec, which automatically outputs a revised spec with the integrated clarifications to enhance correctness.

Related Skills

Explore More Software Engineering Skills→
opencueopencue
3

speckit-checklist

Generate feature requirement checklists for spec-kit projects.

Official
Intermediate
cslsoftwarescslsoftwares

governance-spec-reviewer

Audit SPEC and PRD for security, database edge cases, and rollback gaps.

Community
Advanced
ztwosoneztwosone

speckit-clarify

Identify missing decisions in feature specifications and record clarification outcomes.

Community
Advanced
reason-healthcarereason-healthcare
12

speckit-clarify

Identify underspecified areas in feature specifications and log clarifications.

Official
Advanced