code-tour

Generate CodeTour JSON files with verified file paths and line numbers.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/devCharuzu/philfida-taskmanage --skill code-tour-devcharuzu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/devCharuzu/philfida-taskmanage/tree/main/.windsurf/skills/code-tour
Command: npx skills add https://github.com/devCharuzu/philfida-taskmanage --skill code-tour-devcharuzu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CodeTour creation enables structured, narrative walkthroughs that anchor to real files and line numbers, helping teams share precise code context without modifying source.

Core Features & Use Cases

  • Generate CodeTour JSON files that link to specific files and line ranges in a codebase.
  • Support onboarding, architecture walkthroughs, PR reviews, and explain-how-to requests with persona-targeted narratives.

Quick Start

Create a CodeTour for the onboarding of new team members by anchoring steps to real files and line numbers.

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 anchored to specific files and line numbers?

To create a code walkthrough, generate CodeTour JSON files that link narrative steps to specific files and line ranges in your codebase. The tool verifies all file paths and line numbers against the repository before outputting tours to the .tours directory.

What is the best way to onboard new developers with architecture walkthroughs?

The best way to onboard developers with architecture walkthroughs is to generate persona-targeted narratives anchored to real files and line numbers. This provides precise code context without modifying the source files.

Can I use code tours for PR reviews and explaining how code works?

Yes, you can use code tours for PR reviews and explain-how-to requests. The tool applies persona-targeted narratives to specific file paths and line ranges, verifying anchors against the repository to ensure accuracy.

Does the CodeTour generator verify file paths and line numbers against the repository?

Yes, the CodeTour generator verifies all file paths and line numbers against the repository. This ensures that the narrative steps in the JSON files accurately point to existing code before saving to the .tours directory.

Do I need to modify my source files to add narrative code navigation steps?

No, you do not need to modify source files to add narrative code navigation steps. The tool creates standalone CodeTour JSON files that anchor to the codebase, sharing precise context without altering the original source.

Where are the generated CodeTour JSON files stored?

Generated CodeTour JSON files are stored in the .tours directory. The tool outputs the verified file and line anchored walkthroughs there, keeping narrative context separate from the source code.