# deep-dive

deep-dive — a two-stage skill: three parallel lanes trace why something broke, then a requirements interview starts from those findings. Built for bugs and changes in code you don't know yet.

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

## What it does

Deep Dive runs two stages back to back. The first digs into why something happens, splitting the work into three investigation lanes: a cause in the code, one in config or environment, and a mismatch between what is measured and what is assumed. The second stage converts what turned up into a spec through an interview.

Findings cross over at three injection points. The interview opens from a richer starting point, receives system context, and begins with the questions the trace could not settle on its own. State sits in the directory of whichever adapter is active (`.omc/`, `.omx/`, `.agents/`), and artifact paths are stored, so a run picks up again after the context gets compacted.

The skill does not execute anything itself; it hands the spec to the runtime's planner or executor. The handoff counts as ready once the saved files pass `scripts/validate_deep_dive_artifacts.py`. You confirm the lane hypotheses once at the start, and the trace then runs without interruption. Already know the root cause? Run `/deep-interview` on its own.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-dive -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-dive -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-dive -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/deep-dive/SKILL.md
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-dive -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/deep-dive
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-dive -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/akillness/jeo-skills/tree/HEAD/.agent-skills/deep-dive/SKILL.md

## When to use it
- trace a bug whose cause you can't pin down
- map how an existing subsystem behaves before changing it
- carry investigation findings into a spec instead of restarting the interview
- split a vague problem into three checkable hypotheses
- hand a finished spec to the runtime's planner

## Example prompts
- Deep dive on the flaky password reset emails: find the cause first, then write up what we should change.
- Run deep-dive on the queue worker crash, then turn the findings into requirements.
- I want to know why the report export got slow before we plan any changes.

## Similar
- [nansen-wallet-deep-dive](https://affpapa.org/en/nevibecode/skills/nansen-wallet-deep-dive.md) — skill · 393 installs
- [user-deep-dive](https://affpapa.org/en/nevibecode/skills/user-deep-dive.md) — skill · 212 installs
- [anthropic-technical-deep-dive](https://affpapa.org/en/nevibecode/skills/anthropic-technical-deep-dive.md) — skill · 141 installs
- [keyword-deep-dive](https://affpapa.org/en/nevibecode/skills/keyword-deep-dive.md) — skill · ★ 416 repo stars
- [Animation Principles - Deep Dive](https://affpapa.org/en/nevibecode/skills/animation-principles-deep-dive.md) — skill · 560 installs
- [Redfin Property MCP — Single-Address Deep Dive](https://affpapa.org/en/nevibecode/mcp/redfin-property-mcp-single-address-deep-dive.md) — MCP server · 5877 installs

## Other versions with the same name
- [deep-dive · rohitg00](https://affpapa.org/en/nevibecode/skills/rohitg00-deep-dive.md) — ★ 2858 repo stars
- [deep-dive · zaxbyhub](https://affpapa.org/en/nevibecode/skills/deep-dive.md) — ★ 539 repo stars

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