Agent skill · affaan-m
code-tour
Create CodeTour `.tour` files — persona-targeted, step-by-step walkthroughs with real file and line anchors. Use for onboarding tours, architecture walkthroughs, PR tours, RCA tours, and structured "explain how this works" requests. Use when the user asks for a code tour, onboarding walkthrough, PR tour, or an explanation of how a subsystem works.
What it needs
About 5k tokens when loaded.
What this skill does
Code Tour Create CodeTour .tour files for codebase walkthroughs that open directly to real files and line ranges. Tours live in .tours/ and are meant for the CodeTour format, not ad hoc Markdown notes. A good tour is a narrative for a specific reader: what they are looking at why it matters what path they should follow next Only create .tour JSON files. Do not modify source code as part of this skill. When to Use Use this skill when: the user asks for a code tour, onboarding tour, architecture walkthrough, or PR tour the user says "explain how X works" and wants a reusable guided artifact the user wants a ramp-up path for a new engineer or reviewer the task is better served by a guided sequence than a flat summary Examples: onboarding a new maintainer architecture tour for one service or package PR-review walk-through anchored to changed files RCA tour showing the failure path security review tour of trust boundaries and key checks When NOT to Use Instead of code-tour Use --- --- A one-off explanation in chat is enough answer directly The user wants prose docs, not a .tour artifact documentation-lookup or repo docs editing The task is implementation or refactoring do the implementation work The task is broad codebase onboarding without a tour artifact codebase-onboarding Workflow 1. Discover Explore the repo before writing anything: README and package/app entry points folder structure relevant config files the changed files if the tour is PR-focused Do not start writing steps before you understand the shape of the code. 2. Infer the reader Decide the persona and depth from the request. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/code-tour--0e04cf