code-tour

Generate CodeTour .tour JSON files anchored to real files and line ranges.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Maelwalser/claude-config --skill code-tour-maelwalser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/Maelwalser/claude-config/tree/main/skills/code-tour
Command: npx skills add https://github.com/Maelwalser/claude-config --skill code-tour-maelwalser

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create CodeTour walkthroughs anchored to real files and line ranges to facilitate guided codebase navigation for new contributors and reviewers.

Core Features & Use Cases

  • Create .tour JSON artifacts under .tours for targeted reader personas.
  • Anchor to exact file paths and line ranges to ensure precise navigation.
  • Use for onboarding, architecture walkthroughs, PR tours, RCA tours, and explain-how-this-works requests.

Quick Start

Generate a starter CodeTour anchored to the main entry file and a representative module to demonstrate navigation.

Frequently Asked Questions about code-tour

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

FAQPage Schema
How do I generate CodeTour walkthroughs anchored to real files and line numbers?

CodeTour walkthroughs are generated as .tour JSON artifacts placed under the .tours directory, requiring valid anchors to exact file paths and line ranges to ensure precise codebase navigation for onboarding and reviews.

Can I create codebase onboarding tours for a monorepo project?

Yes, you can create codebase onboarding tours for monorepo projects. The Skill generates CodeTour artifacts applicable across single-repo and monorepo environments to guide new contributors through targeted code navigation.

What is a .tour JSON file and when do I need it for architecture walkthroughs?

A .tour JSON file is a CodeTour artifact that anchors to specific file paths and line ranges. You need it for architecture walkthroughs, PR tours, and RCA investigations to provide guided codebase navigation for reviewers and new contributors.

Does this approach work for explaining how specific code features work?

Yes, this approach works for explain-how-this-works requests. The Skill generates CodeTour artifacts that anchor to exact files and line ranges, guiding readers directly to the relevant codebase implementation for clear explanations.

What are the limitations of using anchored .tour files for documentation?

The limitation of using anchored .tour files is that they require valid anchors to existing files and specific line ranges. If the referenced codebase files change or lines shift, the documentation anchors may become invalid and require regeneration.