clarification-phase

Resolve ambiguities in specification documents by asking structured questions.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/abner-magal/mcp-video-audio --skill clarification-phase-abner-magal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarification-phase
Source: https://github.com/abner-magal/mcp-video-audio/tree/main/.opencode/skills/planning/clarification-phase
Command: npx skills add https://github.com/abner-magal/mcp-video-audio --skill clarification-phase-abner-magal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill resolves ambiguities in project specifications by asking targeted questions, ensuring clarity before planning begins.

Core Features & Use Cases

  • Ambiguity Resolution: Identifies and clarifies unclear requirements marked in spec.md.
  • Structured Questioning: Uses the AskUserQuestion tool to present up to three prioritized questions with concrete options and impacts.
  • Use Case: Before starting development on a new feature, this Skill ensures all critical and high-priority questions about scope, user experience, or security are answered by stakeholders, preventing costly rework later.

Quick Start

Use the clarification-phase skill to resolve all [NEEDS CLARIFICATION] markers in the current spec.md file.

Frequently Asked Questions about clarification-phase

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

FAQPage Schema
How do I resolve ambiguities in project specifications before planning begins?

To resolve ambiguities in project specifications, you can execute a structured clarification phase to identify unclear requirements and ask stakeholders prioritized questions. This ensures all critical scope and security details are disambiguated before planning begins.

What is the best way to ask users for clarification on unclear requirements?

The best way to ask users for clarification is to formulate structured, prioritized questions with concrete options and impacts. Presenting up to three targeted questions at a time ensures high-priority requirements are effectively disambiguated without overwhelming the user.

How do I handle assumptions that need to be deferred during requirements clarification?

To handle deferred assumptions during requirements clarification, document them explicitly after asking the user questions. The clarification process integrates user responses back into the specification while logging any assumptions that cannot be immediately resolved.

Can I use this approach to disambiguate scope and security questions for new features?

Yes, you can use this clarification approach to disambiguate scope, user experience, and security questions for new features. It identifies critical and high-priority items in your specification document and ensures they are answered by stakeholders before development starts.

When do I need to run a clarification phase for my project management lifecycle?

You need to run a clarification phase after drafting a specification document but before starting the planning stage. It resolves any [NEEDS CLARIFICATION] markers in your spec file, preventing costly rework during development later in the project lifecycle.