code-tour

Create CodeTour .tour files with verified file paths and line anchors.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill code-tour-veloxia-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/code-tour/skills/code-tour
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill code-tour-veloxia-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps create structured CodeTour walkthroughs that explain a codebase through real files, verified line numbers, and a clear narrative tailored to the reader’s goal.

Core Features & Use Cases

  • Persona-targeted tours: Build walkthroughs for new joiners, PR reviewers, architecture readers, bug fixers, or security reviewers.
  • Verified anchors: Link every step to existing files, directories, or line-specific code so the tour stays accurate.
  • Tour-only output: Generate .tour files for the CodeTour extension without modifying source code.
  • Use case: A contributor wants to understand how authentication flows through the app, and this Skill creates a step-by-step tour that points to the exact files and lines involved.

Quick Start

Ask the code-tour skill to create a CodeTour for the current repository and specify the persona, focus, and depth you want.

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 code walkthrough for onboarding new developers to a repository?

To create a code walkthrough for onboarding, generate CodeTour .tour files that map persona-targeted steps to real source files and verified line numbers. This produces guided tours that help new developers navigate the codebase without modifying existing source code.

What is a CodeTour file and how does it help with repo navigation?

A CodeTour file is a structured JSON walkthrough stored in the .tours/ directory that links explanatory narrative to specific files and verified line anchors. It helps readers navigate repositories by providing persona-targeted, step-by-step context for onboarding or architecture reviews.

Can I generate architecture review tours that point to specific lines of code?

Yes, you can generate architecture review tours that point to specific lines of code. The tour output requires verified file paths and confirmed line anchors, ensuring every step references existing code rather than hallucinated or unverified locations.

How do I build a PR review tour for a specific codebase change?

Build a PR review tour by requesting a CodeTour focused on the PR reviewer persona. The output creates .tour files with steps linked to the exact source paths and verified line numbers involved in the change, providing a structured walkthrough for reviewers.

Does the CodeTour output modify my existing source code files?

No, the CodeTour output does not modify existing source code files. The tour generation process strictly produces .tour JSON files in the .tours/ directory, leaving all repository source paths untouched while linking to them via verified anchors.

What persona types are supported for targeted code walkthroughs?

Targeted code walkthroughs support persona types including new joiners, PR reviewers, architecture readers, bug fixers, and security reviewers. Tour steps are selected based on the specified persona to tailor the narrative and depth to the reader's specific goal.