A skill your agent uses when the user asks to create a CodeTour .tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers.

MITAuto-check passedDevelopment

Install Code Tour

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill code-tour -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills code-tour --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/code-tour/skills/code-tour .claude/skills/code-tour && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-tour
GitHub stars
28k
Token cost
~1.6k tokens
SKILL.md length
692 words
Files
1
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to create a CodeTour .tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers.

  • Works in 5 steps: Discover the repo → Infer the intent → Read actual files → …
  • The user asks to create a CodeTour .tour file — persona-targeted
  • SKILL.md covers Overview, When to Use This Skill, Core Workflow and Personas, plus 3 more sections
  • Reaches aka.ms

What it does

Code Tour is an agent skill from alirezarezvani/claude-skills. Use when the user asks to create a CodeTour .tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for: create a tour, onboarding tour, architecture tour, PR review tour, explain how X works, vibe check, RCA tour, contributor guide, or any structured code walkthrough request.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Codebase onboarding and Pull requests. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • The user asks to create a CodeTour .tour file — persona-targeted
  • Step-by-step walkthroughs that link to real files and line numbers
  • : create a tour
  • Onboarding tour

Example prompts

  • “/code-tour”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Discover the repo
  2. Infer the intent
  3. Read actual files
  4. Write the tour
  5. Validate

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • aka.ms

    Also links to:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Tour loads about 1.6k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 692 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 692 words, ~1,573 tokens.

Download SKILL.mdSave it as .claude/skills/code-tour/SKILL.md (or your agent's skills folder).
name
code-tour
description
Use when the user asks to create a CodeTour .tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for: create a tour, onboarding tour, architecture tour, PR review tour, explain how X works, vibe check, RCA tour, contributor guide, or any structured code walkthrough request.

Code Tour

Create CodeTour files — persona-targeted, step-by-step walkthroughs of a codebase that link directly to files and line numbers. CodeTour files live in .tours/ and work with the VS Code CodeTour extension.

Overview

A great tour is a narrative — a story told to a specific person about what matters, why it matters, and what to do next. Only create .tour JSON files. Never modify source code.

When to Use This Skill

  • User asks to create a code tour, onboarding tour, or architecture walkthrough
  • User says "tour for this PR", "explain how X works", "vibe check", "RCA tour"
  • User wants a contributor guide, security review, or bug investigation walkthrough
  • Any request for a structured walkthrough with file/line anchors

Core Workflow

1. Discover the repo

Before asking anything, explore the codebase:

In parallel: list root directory, read README, check config files. Then: identify language(s), framework(s), project purpose. Map folder structure 1-2 levels deep. Find entry points — every path in the tour must be real.

If the repo has fewer than 5 source files, create a quick-depth tour regardless of persona — there's not enough to warrant a deep one.

2. Infer the intent

One message should be enough. Infer persona, depth, and focus silently.

User saysPersonaDepth
"tour for this PR"pr-reviewerstandard
"why did X break" / "RCA"rca-investigatorstandard
"onboarding" / "new joiner"new-joinerstandard
"quick tour" / "vibe check"vibecoderquick
"architecture"architectdeep
"security" / "auth review"security-reviewerstandard
(no qualifier)new-joinerstandard

When intent is ambiguous, default to new-joiner persona at standard depth — it's the most generally useful.

3. Read actual files

Every file path and line number must be verified. A tour pointing to the wrong line is worse than no tour.

4. Write the tour

Save to .tours/<persona>-<focus>.tour.

json
{
  "$schema": "https://aka.ms/codetour-schema",
  "title": "Descriptive Title — Persona / Goal",
  "description": "Who this is for and what they'll understand after.",
  "ref": "<current-branch-or-commit>",
  "steps": []
}
Step types
TypeWhen to useExample
ContentIntro/closing only (max 2){ "title": "Welcome", "description": "..." }
DirectoryOrient to a module{ "directory": "src/services", "title": "..." }
File + lineThe workhorse{ "file": "src/auth.ts", "line": 42, "title": "..." }
SelectionHighlight a code block{ "file": "...", "selection": {...}, "title": "..." }
PatternRegex match (volatile files){ "file": "...", "pattern": "class App", "title": "..." }
URILink to PR, issue, doc{ "uri": "https://...", "title": "..." }
Step count
DepthStepsUse for
Quick5-8Vibecoder, fast exploration
Standard9-13Most personas
Deep14-18Architect, RCA
Writing descriptions — SMIG formula
  • S — Situation: What is the reader looking at?
  • M — Mechanism: How does this code work?
  • I — Implication: Why does this matter for this persona?
  • G — Gotcha: What would a smart person get wrong?
Show full SKILL.md (288 more words)Show less
5. Validate
  • Every file path relative to repo root (no leading / or ./)
  • Every file confirmed to exist
  • Every line verified by reading the file
  • First step has file or directory anchor
  • At most 2 content-only steps
  • nextTour matches another tour's title exactly if set

Personas

PersonaGoalMust cover
VibecoderGet the vibe fastEntry point, main modules. Max 8 steps.
New joinerStructured ramp-upDirectories, setup, business context
Bug fixerRoot cause fastTrigger -> fault points -> tests
RCA investigatorWhy did it failCausality chain, observability anchors
Feature explainerEnd-to-endUI -> API -> backend -> storage
PR reviewerReview correctlyChange story, invariants, risky areas
ArchitectShape and rationaleBoundaries, tradeoffs, extension points
Security reviewerTrust boundariesAuth flow, validation, secret handling
RefactorerSafe restructuringSeams, hidden deps, extraction order
External contributorContribute safelySafe areas, conventions, landmines

Narrative Arc

  1. Orientation — file or directory step (never content-only first step — blank in VS Code)
  2. High-level map — 1-3 directory steps showing major modules
  3. Core path — file/line steps, the heart of the tour
  4. Closing — what the reader can now do, suggested follow-ups

Anti-Patterns

Anti-patternFix
File listing — "this file contains the models"Tell a story. Each step depends on the previous.
Generic descriptionsName the specific pattern unique to this codebase.
Line number guessingNever write a line you didn't verify by reading.
Too many steps for quick depthActually cut steps.
Hallucinated filesIf it doesn't exist, skip the step.
Recap closing — "we covered X, Y, Z"Tell the reader what they can now do.
Content-only first stepAnchor step 1 to a file or directory.

Cross-References

  • Related: engineering/codebase-onboarding — for broader onboarding beyond tours
  • Related: engineering/pr-review-expert — for automated PR review workflows
  • CodeTour extension: microsoft/codetour
  • Real-world tours: coder/code-server

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in engineering/code-tour/skills/code-tour of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Code Tour next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Tour compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Tour this skillalirezarezvani/claude-skills28k—~1.6kAutomated safety check: PassMIT
Adopt PR Branch Contextpydantic/pydantic-ai-harness946—~1.8kAutomated safety check: PassMIT
Compasscrabbuild/compass168—~5kAutomated safety check: PassCustom licence
Slm Graphqualixar/superlocalmemory227—~2.7kAutomated safety check: NotesAGPL-3.0
Onboard Team Area in Databricks CLIdatabricks/cli404—~851Automated safety check: NotesCustom licence
CodeScope Codebase Graph AnalysisQwenLM/qwen-code28k1 repos~9.3kAutomated safety check: PassApache-2.0

Similar skills

  • Adopt PR Branch Context

    pydantic/pydantic-ai-harness

    Official

    Fills in issue-brief.md and pr-decisions.md for an existing pull request, so you can pick up a PR mid-flight with its linked issue and past review decisions summarized.

    946 GitHub stars~1.8k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Compass

    crabbuild/compass

    A skill your agent uses for graph-first AI coding sessions and repository analysis: session initialization, architecture maps, dependency or call-graph tracing, symbol and repository search…

    168 GitHub stars~5k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Slm Graph

    qualixar/superlocalmemory

    Index and query a codebase as a structural graph — build the code graph, trace blast radius of a change, find callers/callees/inheritors, semantic code search by meaning, assemble PR review context…

    227 GitHub stars~2.7k tokensUpdated today
    DevelopmentAuto-check: notes
  • Official

    Walks through reserving a directory for a team in the Databricks CLI repo and wiring GitHub CODEOWNERS so that team's approvals are required for its area.

    404 GitHub stars~851 tokensUpdated today
    DevelopmentAuto-check: notes
  • Answers questions about code structure, history, bugs and PR risk using a CodeScope knowledge graph and semantic index built from the repository.

    28k GitHub starsUsed in 1 repo~9.3k tokens
    DevelopmentAuto-check passed
  • Kc Scope PR

    imran31415/kube-coder

    Scope a kube-coder change before you open or update a PR — what the diff actually touches, which tests reach it, what the change made worse, and what is left untested.

    388 GitHub stars~1.2k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Categories

Questions about Code Tour

What does Code Tour do?

A skill your agent uses when the user asks to create a CodeTour .tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Code Tour is an agent skill from alirezarezvani/claude-skills.tour file — persona-targeted, step-by-step walkthroughs that link to real files and line numbers.

When should I use Code Tour?

Code Tour fits situations like: the user asks to create a CodeTour .tour file — persona-targeted; step-by-step walkthroughs that link to real files and line numbers; : create a tour; onboarding tour.

How do I install Code Tour in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill code-tour -a claude-code`. Or copy the skill folder (engineering/code-tour/skills/code-tour in alirezarezvani/claude-skills) into .claude/skills/code-tour in your project. Claude Code loads it when a task matches its description.

How do I install Code Tour in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill code-tour -a codex`. Or copy the skill folder (engineering/code-tour/skills/code-tour in alirezarezvani/claude-skills) into .agents/skills/code-tour in your project. Codex loads it when a task matches its description.

Can I use Code Tour in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill code-tour -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-tour, .gemini/skills/code-tour, .github/skills/code-tour and .opencode/skills/code-tour in your project.

What does Code Tour need to run?

SKILL.md names no scripts, command-line tools or credentials: Code Tour is instructions for the agent only.

Does Code Tour access the network?

SKILL.md names 2 domains. In commands or code: aka.ms; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Code Tour safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Code Tour use?

Code Tour is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Code Tour use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Tour?

Skills that share tags, products or a category with Code Tour: Adopt PR Branch Context (pydantic/pydantic-ai-harness, 946 stars), Compass (crabbuild/compass, 168 stars), Slm Graph (qualixar/superlocalmemory, 227 stars) and Onboard Team Area in Databricks CLI (databricks/cli, 404 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Tour?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,788 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.