code-tour

The `code-tour` skill creates structured CodeTour `.tour` files that guide readers through a codebase using real file paths and verified line anchors. Instead of producing informal Markdown explanations or one-off chat summaries, this skill generates reusable walkthrough artifacts designed for the CodeTour format. It helps teams document architecture, onboarding flows, pull request changes, debugging paths, and system behavior in a step-by-step narrative that developers can follow directly inside supported editors. The skill focuses on creating coherent guided experiences that explain not only what a reader is viewing, but also why each component matters and what they should inspect next.

The skill supports multiple walkthrough styles tailored to different audiences, including onboarding tours for new engineers, architecture deep dives, PR review tours, root-cause analysis investigations, security reviews, and feature explanations. It follows a structured workflow that includes repository discovery, reader persona inference, validation of file paths and line ranges, and deterministic `.tour` file generation inside the `.tours/` directory. Supported step types include directory-level orientation steps, file-and-line anchors, code selections for focused analysis, and limited content-only narrative steps. The workflow emphasizes verification and accuracy by requiring all referenced files and anchors to exist before the tour is finalized.

This skill is intended for engineering teams, maintainers, reviewers, and technical leads who need reusable codebase walkthroughs rather than transient explanations. It is especially useful for onboarding new contributors, reviewing large pull requests, documenting complex execution paths, explaining service architecture, and guiding investigations into failures or security-sensitive flows. The skill is best suited for scenarios where a guided sequence of exploration provides more value than flat documentation or conversational summaries.