proactive-explorer — Claude Code skill: what it does, how to install
The proactive-explorer skill tells Claude Code to look for missing context in the project before asking the user. Use it when code, configuration, or logs may resolve an ambiguity.
no license ★ 475 updated 2026-10-13
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a claude-codeWhat proactive-explorer does
For an unclear task, the skill directs Claude Code to inspect the workspace first: check local guidance and docs, locate relevant files, then examine logs or runtime state if needed. It recommends focused searches with rg, selected file reads, and shell commands. Stop once the evidence is enough to proceed.
Ask the user about choices that depend on their preferences, credentials, or unresolved contradictions. Before asking, summarize what has already been checked and what still blocks the next step. Local evidence comes before web search; skip extra exploration when the request is already clear.
This is a workflow rule, not a way to recover account-specific or outside facts from the repository.
What it helps with
- find implementation details in code and tests
- resolve an ambiguous reference to a file or dependency
- narrow down a bug using logs and runtime state
- identify which missing details require a user decision
Example prompts for the agent
- Check the project code, config, and docs for the details missing from my request before asking me.
- Use the local tests and logs to trace this failure, then tell me what still needs clarification.
- Find which file and dependency I mean by inspecting the project instructions and nearby examples first.
How to install proactive-explorer
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a claude-code2Manually: put the files in place
~/.claude/skills/proactive-explorer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/proactive-explorer/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a codex2Manually: put the files in place
.agents/skills/proactive-explorer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a cursor2Manually: put the files in place
.cursor/skills/proactive-explorer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cnfjlhj/ai-collab-playbook skills/full/proactive-explorer2Manually: put the files in place
.github/skills/proactive-explorer/SKILL.md1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a gemini-cli2Platform CLI
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/proactive-explorerManually: put the files in place
.devin/skills/proactive-explorer/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about proactive-explorer
How do I install proactive-explorer in Claude Code?
Run npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a claude-code.
What does proactive-explorer do?
It guides Claude Code to look through project instructions, files, and logs before requesting more context. The user is asked about decisions or facts the workspace cannot resolve.
When should the agent ask the user a question?
When progress depends on the user's choice, credentials, or resolving a contradiction. Before asking, the agent should state what it checked and what is still blocking the task.