Code Tour
Creates CodeTour .tour files — persona-targeted, step-by-step codebase walkthroughs that link to real files and line numbers. It guides the user through discovering the repo, inferring intent, writing narrative descriptions, and validating the tour.
✨ What it does
- Infers persona and depth from user request (e.g., new-joiner, architect, PR reviewer)
- Verifies every file path and line number by reading actual files
- Supports multiple step types: content, directory, file+line, selection, pattern, URI
- Enforces step count guidelines per depth (quick, standard, deep)
- Uses SMIG formula for writing descriptions (Situation, Mechanism, Implication, Gotcha)
- Validates tour structure and anti-patterns
🎯 When to use it
- User asks to create a code tour, onboarding tour, or architecture walkthrough
- User says 'tour for this PR', 'explain how X works', 'vibe check', or 'RCA tour'
- User wants a contributor guide, security review, or bug investigation walkthrough
- Any request for a structured walkthrough with file/line anchors
🚀 How to use
Trigger by asking for a code tour, e.g., 'Create a tour for this PR' or 'Explain how X works'. The skill will explore the repo, infer persona and depth, then generate a .tour file in .tours/. Provide the repo context and any specific focus. Example prompts:
Create an onboarding tour for this repo.
Tour for this PR: explain the changes.
📄 Output: A .tour JSON file saved to .tours/<persona>-<focus>.tour.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/code-tour/skills/code-tour .claude/skills/code-tourSkill source: engineering/code-tour/skills/code-tour/SKILL.md
⚠️ Good to know
Requires access to the repository files to verify paths and line numbers; only creates .tour files and never modifies source code.
❓ FAQ
What if the user doesn't specify a persona?
The skill defaults to the new-joiner persona at standard depth, as it's the most generally useful.
Can the first step be content-only?
No, the first step must have a file or directory anchor to avoid a blank step in VS Code.
How many steps should a standard tour have?
Standard depth tours should have 9-13 steps.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.