Proactive Explorer
Overview
Use this skill to reduce avoidable user questions.
Core principle: search local context before asking the user to restate information the system can gather on its own.
Rules
- Start with local exploration when the request is ambiguous but likely answerable from the workspace.
- Prefer fast local tools first:
rg, targeted file reads, and focused shell commands.
- Ask the user only for true product decisions, missing credentials, private preferences, or unresolved contradictions.
- Stop exploring once you have enough evidence to act. Do not turn simple tasks into a ceremony.
- Before asking a question, summarize what you already checked and what gap remains.
When to Use
Use when any of the following are true:
- a missing implementation detail may be recoverable from code, config, docs, tests, or logs
- you can likely resolve an ambiguous file, function, dependency, or workflow reference locally
- a bug report or execution choice should be narrowed with workspace evidence before you ask
- the user message is compressed, but the missing structure is probably already in local context
Do not use when:
- the answer depends on a decision only the user can make
- the missing fact is external, time-sensitive, or account-specific
- the task is already explicit enough to act without more search
Exploration Order
- Read local rules and nearby docs such as
AGENTS.md, project docs, and relevant config.
- Search filenames, code, tests, and logs with
rg and targeted reads.
- Inspect runtime state with shell commands when needed.
- Use web search only when the missing fact is outside the workspace.
- Ask the user only for the remaining gap.
Output Pattern
Before asking a clarifying question, be able to state:
- what you searched
- what you found
- what remains unknown
- why that unknown blocks the next step
Common Mistakes
- asking for information that local search would reveal in seconds
- exploring indefinitely after the uncertainty is already low
- using web search before exhausting local evidence
- asking broad questions instead of one concrete unresolved decision
Quick Reference
- Need implementation context: search code and tests first.
- Need runtime state: inspect logs, processes, ports, and environment.
- Need design intent: read local rules, docs, and nearby examples.
- Need outside facts: search the web after local evidence is exhausted.
1---2name: proactive-explorer3description: Use when missing context may be recoverable from local code, files, logs, or environment evidence before asking the user or making assumptions.4---56# Proactive Explorer78## Overview910Use this skill to reduce avoidable user questions.1112Core principle: search local context before asking the user to restate information the system can gather on its own.1314## Rules1516- Start with local exploration when the request is ambiguous but likely answerable from the workspace.17- Prefer fast local tools first: `rg`, targeted file reads, and focused shell commands.18- Ask the user only for true product decisions, missing credentials, private preferences, or unresolved contradictions.19- Stop exploring once you have enough evidence to act. Do not turn simple tasks into a ceremony.20- Before asking a question, summarize what you already checked and what gap remains.2122## When to Use2324Use when any of the following are true:2526- a missing implementation detail may be recoverable from code, config, docs, tests, or logs27- you can likely resolve an ambiguous file, function, dependency, or workflow reference locally28- a bug report or execution choice should be narrowed with workspace evidence before you ask29- the user message is compressed, but the missing structure is probably already in local context3031Do not use when:3233- the answer depends on a decision only the user can make34- the missing fact is external, time-sensitive, or account-specific35- the task is already explicit enough to act without more search3637## Exploration Order38391. Read local rules and nearby docs such as `AGENTS.md`, project docs, and relevant config.402. Search filenames, code, tests, and logs with `rg` and targeted reads.413. Inspect runtime state with shell commands when needed.424. Use web search only when the missing fact is outside the workspace.435. Ask the user only for the remaining gap.4445## Output Pattern4647Before asking a clarifying question, be able to state:4849- what you searched50- what you found51- what remains unknown52- why that unknown blocks the next step5354## Common Mistakes5556- asking for information that local search would reveal in seconds57- exploring indefinitely after the uncertainty is already low58- using web search before exhausting local evidence59- asking broad questions instead of one concrete unresolved decision6061## Quick Reference6263- Need implementation context: search code and tests first.64- Need runtime state: inspect logs, processes, ports, and environment.65- Need design intent: read local rules, docs, and nearby examples.66- Need outside facts: search the web after local evidence is exhausted.
cnfjlhj