Rich Elicitation Skill

Overview

This skill governs how Antigravity resolves task ambiguity before starting work. When a user's request has too many unanswered dimensions — each with several reasonable answers — Antigravity asks targeted clarifying questions across multiple rounds rather than silently picking defaults.

The goal is a correct first draft, not a generic answer that requires three revision cycles. Rounds are capped at three; anything still unclear after Round 3 gets a stated assumption and Antigravity proceeds.

When to Use This Skill

• Use when a request has 2 or more dimensions that are ambiguous and each has 3+ viable options
• Use when the user's likely intent is unclear across scope, audience, tone, format, or strategy
• Use when an early answer would meaningfully change the structure or direction of the output
• Use when working on writing, planning, design, recommendations, or creative tasks with open-ended scope
• Use when a Round 1 answer unlocks a new set of meaningful choices that need resolving before proceeding

Do not trigger for:

• Simple factual lookups or math
• Clearly scoped requests with a single obvious interpretation
• Minor unknowns where a safe default exists

How It Works

Step 1: Run the Trigger Checklist

Before starting any task, mentally check how many of these apply:

If 2+ rows apply → trigger this skill.

Step 2: Ask Round 1 Questions

Ask up to 3 questions using ask_user_input_v0. Group related questions in a single call. Lead with 1–2 sentences explaining why you're asking. Mark one option per question as (Recommended).

Step 3: Re-run the Checklist

After Round 1 answers, re-run the checklist on what's still unresolved. If 2+ rows still apply, run Round 2. Otherwise, proceed.

Step 4: Run Follow-up Rounds (if needed)

Transition between rounds naturally. Don't announce "Round 2" mechanically. Use phrasing like:

"Got it — that helps a lot. One more thing before I start:"

Step 5: Proceed

After Round 3 (or earlier, if enough context exists), state any remaining assumptions briefly and begin the task.

Examples

Example 1: Multi-Round — Investor Pitch Deck

User: "Help me create a presentation for my project."

Round 1 — Three blocking questions:

Framing: "This could go a lot of different ways. Quick questions before I start:"

Q1: Who is the audience?
  - Internal team / colleagues
  - External clients or partners
  - Investors or stakeholders (Recommended)
  - General / public audience

Q2: What's the primary goal?
  - Inform and update
  - Persuade and drive a decision (Recommended)
  - Teach or explain a concept
  - Pitch and raise funding

Q3: How much content do you already have?
  - Starting from scratch
  - Rough notes or an outline (Recommended)
  - Full draft — just needs polish
  - Previous version to update

User answers: Investors | Pitch | Rough notes → Round 2 is warranted.

Round 2 — Unlocked by Round 1:

Framing: "Perfect — investor pitch it is. A couple more things:"

Q1: What stage is this raise?
  - Pre-seed / idea stage
  - Seed round (Recommended)
  - Series A or later
  - Strategic partnership / grant

Q2: How long should the deck be?
  - Short and punchy, 8–10 slides (Recommended)
  - Standard, 12–15 slides
  - Comprehensive, 20+ slides

No Round 3 needed — proceed.

Example 2: Single-Round — Business Email

User: "Write a business email to follow up on a proposal."

Round 1 only:

Framing: "Two quick questions to nail the tone:"

Q1: What tone should this email strike?
  - Formal and professional (Recommended)
  - Friendly but direct
  - Urgent and firm
  - Warm and relationship-focused

Q2: What's the primary goal?
  - Request action / get a response (Recommended)
  - Share information only

…