← ClaudeAtlas

code-tourlisted

Use when asked to create a code walkthrough, onboarding tour, architecture tour, PR review tour, or any structured explanation of how a codebase works. Triggers on "create a code tour", "onboarding tour", "how does X work", "explain the codebase", "architecture walkthrough", "PR tour", or "contributor guide". Outputs a CodeTour `.tour` JSON file for the VS Code CodeTour extension, with a plain-markdown fallback for environments without it.
tmj-90/gaffer · ★ 0 · AI & Automation · score 69
Install: claude install-skill tmj-90/gaffer
# Create persona-targeted, file-anchored code tours A great tour is a narrative — a story told to a specific person about what matters, why it matters, and what to do next. Every file path and line number must be real and verified. ## Persona selection Infer silently from the request: | User says | Persona | Depth | |-----------|---------|-------| | "tour for this PR" | pr-reviewer | standard | | "why did X break" / "RCA" | rca-investigator | standard | | "onboarding" / "new joiner" | new-joiner | standard | | "quick tour" / "vibe check" | vibecoder | quick | | "architecture" | architect | deep | | "security" / "auth review" | security-reviewer | standard | | (no qualifier) | new-joiner | standard | **Depth guidelines:** - Quick: 5–8 steps, high-level, 1–2 sentences per step. - Standard: 10–20 steps, full narrative, 3–5 sentences per step. - Deep: 20–40 steps, links between steps, covers edge cases and design rationale. ## Tour file format ```json { "$schema": "https://aka.ms/codetour-schema", "title": "Tour title — persona", "description": "One sentence: what this tour covers and who it's for.", "steps": [ { "file": "src/index.ts", "line": 1, "title": "Entry point", "description": "The application starts here. The `main()` function wires together the three primary subsystems..." } ] } ``` Tours live in `.tours/<name>.tour` in the repo root. **Markdown fallback.** The `.tour` JSON is the primary output. When the CodeTour exte