code-tour

Generate CodeTour .tour files with file and line anchors for specific personas.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/PAISHU-AI/PAI-zong-NB --skill code-tour-paishu-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/PAISHU-AI/PAI-zong-NB/tree/main/skills/code-tour
Command: npx skills add https://github.com/PAISHU-AI/PAI-zong-NB --skill code-tour-paishu-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the need for creating CodeTour .tour files, which are persona-targeted, step-by-step walkthroughs with real file and line anchors for codebases.

Core Features & Use Cases

  • CodeTour File Creation: Generates .tour files for codebase tours, architecture walkthroughs, PR tours, RCA tours, and explainers.
  • Persona Targeting: Tours are designed for specific reader personas such as new joiners, architects, PR reviewers, and RCA investigators.
  • Real File and Line Anchors: Tours link directly to specific files and lines in the code, providing a guided tour experience.
  • Use Case: When onboarding a new maintainer or conducting a security review, this Skill can be used to create a structured tour that walks the user through the necessary code and logic.

Quick Start

Create a CodeTour for a specific persona by providing the tour name and focus, then use the skill to generate the .tour file with the appropriate steps and descriptions.

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 step-by-step codebase walkthrough for onboarding new developers?

To create a codebase walkthrough for onboarding, you can generate CodeTour .tour files that link directly to specific code files and lines, providing a guided, step-by-step tour experience. You simply provide the tour name and focus to produce the structured file.

What is a CodeTour .tour file and when do I need one for my repository?

A CodeTour .tour file is a format for persona-targeted, step-by-step codebase walkthroughs with real file and line anchors. You need this format for onboarding new joiners, conducting architecture walkthroughs, PR tours, or RCA investigations.

Can I generate a code tour tailored for a specific reviewer or investigator persona?

Yes, you can generate code tours tailored for specific reader personas such as new joiners, architects, PR reviewers, and RCA investigators. The tour provides targeted steps and descriptions based on the persona's specific needs and focus.

How do I build a root cause analysis tour that points to specific code lines?

You can build an RCA tour by providing the tour focus, which generates a .tour file linking directly to specific files and lines in the code. This guides RCA investigators through the necessary code and logic step by step.

What do I need to prepare before generating a CodeTour for my project?

Before generating a CodeTour, you need a clear understanding of your codebase structure and the specific needs of the reader persona. You then provide the tour name and focus to output the appropriate .tour file with steps and descriptions.

Are there limitations when using .tour files for PR reviews?

When using .tour files for PR reviews, the main constraint is the requirement for a clear understanding of the codebase structure and the persona's needs to generate an effective step-by-step walkthrough with accurate file and line anchors.