# proactive-explorer

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 475 repo stars
- Author: cnfjlhj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/proactive-explorer/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/proactive-explorer

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/proactive-explorer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/proactive-explorer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/proactive-explorer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/proactive-explorer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cnfjlhj/ai-collab-playbook skills/full/proactive-explorer
```

2. **Manually: put the files in place**
- File: `.github/skills/proactive-explorer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill proactive-explorer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/proactive-explorer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/proactive-explorer/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/proactive-explorer/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [proactive-agent](https://affpapa.org/en/nevibecode/skills/proactive-agent.md) — skill · 15400 installs
- [proactive-agent-lite](https://affpapa.org/en/nevibecode/skills/proactive-agent-lite.md) — skill · 105 installs
- [tax-calendar-proactive](https://affpapa.org/en/nevibecode/skills/tax-calendar-proactive.md) — skill · ★ 38 repo stars
- [proactive-delegation](https://affpapa.org/en/nevibecode/rules/proactive-delegation.md) — rule · ★ 3951 repo stars
- [delivery-contract.proactive](https://affpapa.org/en/nevibecode/prompts/delivery-contractproactive.md) — prompt · ★ 189 repo stars
- [proactive-mcp](https://affpapa.org/en/nevibecode/mcp/proactive-mcp.md) — MCP server · ★ 12 repo stars

From the same set: [cnfjlhj/ai-collab-playbook](https://affpapa.org/en/nevibecode/by/cnfjlhj/ai-collab-playbook.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
