skills.rest
Rohithdgrr
RohithdgrrCOMMUNITY
Explore all skills by this author →
GitHub

code-tour

Generates CodeTour .tour files with persona-targeted walkthroughs linked to verified files and line numbers.

Updated Aug 14, 2026
Search Tags:#vscode#documentation#onboarding#codebase#code walkthrough#codetour#tour file
One-click install
npx skills add https://github.com/Rohithdgrr/REEK-uninstaller --skill code-tour-rohithdgrr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/Rohithdgrr/REEK-uninstaller/tree/main/.opencode/skills/code-tour
Command: npx skills add https://github.com/Rohithdgrr/REEK-uninstaller --skill code-tour-rohithdgrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing structured codebase walkthroughs by hand is slow and error-prone, and tours with wrong file paths or line numbers mislead readers. This Skill automates the creation of CodeTour .tour files that anchor every step to verified locations in the repository. ## Core Features & Use Cases - Persona-targeted tours: Infers the right audience (new joiner, PR reviewer, architect, security reviewer, RCA investigator, and more) and adjusts depth from quick (5-8 steps) to deep (14-18 steps). - Verified anchors: Reads actual source files so every file path and line number in the tour is confirmed to exist before writing. - Narrative structure: Applies the SMIG formula (Situation, Mechanism, Implication, Gotcha) and a defined narrative arc so tours read as stories, not file listings. - Use Case: A maintainer asks for an onboarding tour for new contributors; the Skill explores the repo, maps the architecture, and writes a .tours/new-joiner-onboarding.tour file that opens directly in the VS Code CodeTour extension. ## Quick Start Ask the assistant to create an onboarding code tour of this repository for a new joiner.

Frequently Asked Questions about code-tour

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a CodeTour file for my repository?▼

Ask for a tour with an optional persona and focus, such as an onboarding or architecture tour. The Skill explores the repo, verifies file paths and line numbers, and writes a .tour JSON file into the .tours/ directory.

What is a CodeTour .tour file used for?▼

A .tour file is a JSON walkthrough format consumed by the VS Code CodeTour extension. It defines ordered steps that link descriptions to specific files, directories, line numbers, or code selections inside a codebase.

Does the CodeTour extension work outside VS Code?▼

The .tour format is designed for the VS Code CodeTour extension from Microsoft. The files are plain JSON stored in .tours/, so they remain readable as documentation even without the extension installed.

How are line numbers in a tour kept accurate?▼

The Skill reads each referenced source file before writing the step, so every line number is verified against the actual code. For volatile files, it can use regex pattern steps instead of fixed line numbers.

When should I not use a guided code tour?▼

Tours are a poor fit for repositories with fewer than five source files, where a quick-depth tour is created instead. They also do not replace full documentation, since they only reference existing code rather than modify it.

Related Skills

Explore More Software Engineering Skills→
mnazaalmnazaal

dev-scout

Maps repository architecture, entry points, interfaces, and risks through read-only exploration.

Community
Intermediate
hbvg234hbvg234
1

code-tour

Create JSON CodeTour walkthroughs anchored to specific files and lines.

Community
Intermediate
DVNghiemDVNghiem
20

code-tour

Generate structured Markdown code tours with validated file paths.

Community
Advanced
alirezarezvanialirezarezvani
25.3k

code-tour

Creates persona-targeted CodeTour .tour files with verified file and line anchors.

Community
Intermediate