# zoom-out

zoom-out draws a map of an unfamiliar part of a codebase before you change it: the modules involved, who calls whom, what depends on what.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 275 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/zoom-out/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-zoom-out

## What it does

The skill answers one question: where does this piece of code sit in the larger system? You get the modules around your area, the call direction between them, and the dependencies that matter. Its tools are Read, Grep and Glob, so it reads and reports — no edits.

Output has a fixed shape: a call graph, the seams where one concept hands off to another, and a short glossary of the terms used there. Names come from `CONTEXT.md`. Without that file the map uses internal implementation names instead of the project's own terms, and it reads flatter.

It runs as a directive rather than a background worker: the agent won't pick it up on its own, so ask for a zoom-out explicitly. For locating a symbol use `codebase-search`; for changing the architecture use `improve-codebase-architecture`. This one just draws the map.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill zoom-out -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/zoom-out/SKILL.md

## When to use it
- see how an unfamiliar module connects to the rest of the system
- estimate what a change will touch before committing
- draw a call and dependency map for a directory
- switch module names over to the project's own terms
- spot the seams where behaviour can be swapped

## Example prompts
- Zoom out and show me how `billing` fits into the system.
- Give me a module map around `orders`: who calls it and what it depends on.
- Start with a zoom-out on this directory, then we'll open the code.

## Similar
- [codebase-context](https://affpapa.org/en/nevibecode/skills/codebase-context.md) — skill · ★ 34 repo stars
- [repo-graph](https://affpapa.org/en/nevibecode/mcp/repo-graph.md) — MCP server · ★ 46 repo stars
- [explore-codebase](https://affpapa.org/en/nevibecode/skills/explore-codebase.md) — skill · 1200 installs
- [w-council](https://affpapa.org/en/nevibecode/skills/w-council.md) — skill · 647 installs
- [codebase-documenter](https://affpapa.org/en/nevibecode/skills/mhattingpete-codebase-documenter.md) — skill · 595 installs
- [explore](https://affpapa.org/en/nevibecode/skills/explore.md) — skill · 581 installs

## Other versions with the same name
- [zoom-out · haowjy](https://affpapa.org/en/nevibecode/skills/haowjy-zoom-out.md) — 443 installs
- [zoom-out · haowjy](https://affpapa.org/en/nevibecode/skills/zoom-out.md) — 443 installs

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
