clarify

Resolve ambiguous user requests into a concise Context Brief via Q&A and codebase exploration.

36|3|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/2lab-ai/oh-my-claude --skill clarify-2lab-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clarify
Source: https://github.com/2lab-ai/oh-my-claude/tree/main/plugins/stv/skills/clarify
Command: npx skills add https://github.com/2lab-ai/oh-my-claude --skill clarify-2lab-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts ambiguous or underspecified user requests into a clear, verifiable Context Brief so teams can proceed with implementation without repeated clarification cycles.

Core Features & Use Cases

  • Two-track clarification: Conducts one-question-at-a-time user Q&A while simultaneously launching codebase exploration subagents to gather technical context.
  • Synthesis into a brief: Produces a Context Brief containing goal, in/out-of-scope, technical context, constraints, success criteria, open questions, and a complexity assessment for routing.
  • Use case: Ideal when a feature request or ticket lacks acceptance criteria and technical assumptions; the skill uncovers ambiguities, surface technical risks, and yields a single source of truth for next steps.

Quick Start

Ask the assistant to run stv:clarify on your vague task description to interview for missing details and explore the codebase, then present a Context Brief.

Frequently Asked Questions about clarify

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

FAQPage Schema
How do I turn a vague feature request into an actionable development brief?

You can resolve ambiguous requests by running an iterative one-question Q&A alongside automated codebase exploration to produce a concise Context Brief covering goals, scope, constraints, and success criteria.

What is the best way to gather technical context for a ticket lacking acceptance criteria?

Gathering technical context for unclear tickets involves launching codebase exploration subagents to report related files, patterns, and constraints while simultaneously interviewing the user to surface technical risks and assumptions.

How does automated codebase exploration work during early project scoping?

Automated codebase exploration during early scoping works by integrating subagents that scan the codebase to report related files, patterns, and technical constraints, feeding the results directly into a comprehensive Context Brief.

Can I assess implementation complexity while resolving ambiguities in a user request?

Yes, you can assess implementation complexity while resolving ambiguities by synthesizing user answers and codebase context into a Context Brief that includes a dedicated complexity assessment for routing.

What should be included in a context brief for software engineering tasks?

A context brief for software engineering tasks should include the goal, in and out-of-scope items, technical context, constraints, success criteria, open questions, and a complexity assessment to serve as a single source of truth for implementation.

When should I use a clarification process for software requirements?

Use a clarification process for software requirements during early scoping, when handling unclear tickets, or receiving feature requests that lack technical assumptions and acceptance criteria to prevent repeated clarification cycles.