# agent-exploration

agent-exploration — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that splits a broad research question into independent slices and dispatches each to a separate explorer.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 259 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/agent-exploration/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/agent-exploration

## What it does

When a question spans too many independent areas for a single agent, it identifies those areas, dispatches one explorer per slice, and keeps each worker scoped to its own `analysis/NN_analysis_<slug>.md` file — no commits, no edits outside that path.

The `--agents <num>` flag sets an upper bound, not a quota. The skill picks as many slices as the scope justifies, up to 8. Output defaults to `.audits/exploration/<timestamp>/`; use `--path <dir>` to redirect. If one slice fails, the rest finish normally. The failed slice is noted in the summary rather than triggering a full restart.

Without `--prompt <text>` the skill reads the active request from context. `--model <model>` overrides the environment default. No external runtime is started, and no agent registry is created — only the native explorer mechanisms of the chosen platform are used.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill agent-exploration -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill agent-exploration -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill agent-exploration -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/agent-exploration
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill agent-exploration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/agent-exploration
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill agent-exploration -a opencode
```

### 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/pedronauck/skills/tree/HEAD/skills/mine/agent-exploration/SKILL.md

## When to use it
- split a broad research task into independent parallel workstreams
- produce an evidence-backed summary with source links and remaining gaps
- keep each agent's output isolated so workers cannot overwrite each other
- recover from a failed slice without restarting the entire investigation
- redirect output path or override the model for a specific run

## Example prompts
- Run agent-exploration --prompt "How is our monorepo architecture structured" --agents 4
- Analyse the dependency graph with agent-exploration --path .reports/deps --model o3
- Start a multi-area security review: agent-exploration --agents 6 --path .audits/security

## Similar
- [council](https://affpapa.org/en/nevibecode/skills/zaxbyhub-council.md) — skill · ★ 539 repo stars
- [deep-research](https://affpapa.org/en/nevibecode/skills/199-biotechnologies-deep-research.md) — skill · 10500 installs
- [recursive-synthesis](https://affpapa.org/en/nevibecode/skills/recursive-synthesis.md) — skill · 138 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 359600 installs
- [arena](https://affpapa.org/en/nevibecode/skills/arena.md) — skill · 10800 installs
- [delegate-setup](https://affpapa.org/en/nevibecode/skills/delegate-setup.md) — skill · 6500 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 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
