vc-intent-clarify

Scores request ambiguity and generates structured multi-choice clarification questions before agent routing.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/HyuseCS/project-c --skill vc-intent-clarify-hyusecs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-intent-clarify
Source: https://github.com/HyuseCS/project-c/tree/main/.claude/skills/vc-intent-clarify
Command: npx skills add https://github.com/HyuseCS/project-c --skill vc-intent-clarify-hyusecs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Vague user requests cause AI agents to route to the wrong workflow or build the wrong thing, wasting entire execution phases. This Skill scores request ambiguity across four signals and produces structured, option-rich clarifying questions so routing decisions are grounded in confirmed intent. ## Core Features & Use Cases - 4-Signal Ambiguity Scoring: Scores scope ambiguity, missing paths, multiple intents, and session context to classify requests into Tier 0 (auto-route), Tier 1 (routing summary), or Tier 2 (full clarification suite). - Two Operating Modes: SIMPLE mode uses a light 3-5 file research pass; DEEP mode spawns a research subagent to populate question options with real file paths and concrete values. - Structured Question Generation: Produces multi-choice questions across 8 standard dimensions (scope, success criteria, risk, priority, autonomy, constraints, and more) with recommended defaults, rendered via the AskUserQuestion tool. - Use Case: A user says "make the app faster" — the Skill scores this 4/4 ambiguous, triggers Tier 2, and generates concrete questions about which performance dimension, target metrics, and acceptable tradeoffs before any agent is routed. ## Quick Start Ask the orchestrator to clarify intent for a request like "refactor the billing flow to add credit top-up support" before routing it to an execution agent.

Frequently Asked Questions about vc-intent-clarify

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

FAQPage Schema
How do I clarify ambiguous user requests before routing to an AI agent?

Score the request across four signals: ambiguous scope, missing file path, multiple possible intents, and first interaction. Scores of 0-1 auto-route silently, 2 shows a routing summary, and 3+ triggers a full structured clarification suite with multi-choice questions.

What is the difference between SIMPLE and DEEP clarification modes?

SIMPLE mode runs in the main thread with a 3-5 file light research pass to fill question options. DEEP mode spawns a research subagent first, returning concrete file paths and risk findings so questions contain real values instead of generic placeholders.

When should intent clarification be skipped entirely?

Auto-skip applies for continuation phrases like "go" or "proceed", mid-phase-program execution, trivial single-file fixes under 15 lines, explicit mode commands, resumed active plans, and pure information questions with one obvious routing target.

How many clarification rounds are allowed before routing anyway?

Clarification is capped at two rounds maximum. If the user answers Tier 2 questions but routing remains unclear, state what is unresolved, ask one final direct question, then default to the research agent with the narrowest reasonable scope.

Does the skill validate its own clarification output?

Yes, the bundled validation script fails any output artifact missing a restatement line, an ambiguity score from 0-7, or an exactly-one mode choice of simple or deep followed by a reason or because justification.