
Code Tour
This is what happens when someone finally treats code walkthroughs as a first-class artifact instead of a Slack message that gets lost in three days. It writes CodeTour files that link directly to real files and line numbers, validated against your actual repo structure. The persona system is the clever part: same codebase, different tour for the new hire versus the on-call engineer doing an RCA versus the architect evaluating a refactor. It bundles validation scripts to catch broken line references and a doc-to-skeleton generator for bootstrapping from your README. Works with the VS Code CodeTour extension and includes references to real production tours on GitHub so you're not guessing at schema details.
- skills.sh installs
- 739
- GitHub stars
- 41K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add github/awesome-copilot --skill code-tour --agent claude-codeInstalls into .claude/skills of the current project.
Files
Code Tour Skill
You are creating a CodeTour — a persona-targeted, step-by-step walkthrough of a codebase
that links directly to files and line numbers. CodeTour files live in .tours/ and work with
the VS Code CodeTour extension.
Two scripts are bundled in scripts/:
scripts/validate_tour.py— run after writing any tour. Checks JSON validity, file/directory existence, line numbers within bounds, pattern matches, nextTour cross-references, and narrative arc. Run it:python ~/.agents/skills/code-tour/scripts/validate_tour.py .tours/<name>.tour --repo-root .scripts/generate_from_docs.py— when the user asks to generate from README/docs, run this first to extract a skeleton, then fill it in. Run it:python ~/.agents/skills/code-tour/scripts/generate_from_docs.py --persona new-joiner --output .tours/skeleton.tour
Two reference files are bundled:
Sponsors
Details
- Repository
- github.com/github/awesome-copilot
- Categories
- Security, Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building, Debugging
- First seen
- Jun 3, 2026
More from github/awesome-copilot
All 318- Linkedin Post Formatter361
- Ui Screenshots212
- Data Breach Blast Radius110
- Sql Server Table Reconciliation104
- Aws Cloudwatch Investigation
- Aws Cost Optimize
- Aws Resource Health Diagnose
- Aws Well Architected Review
- Azure Well Architected Review
- Bug Reproduction Brief
- Incident Postmortem
- Mcp Implementation Security Review
- Pester Migration
- Tm7 Threat Model
- Git Commit48.4K
- Excalidraw Diagram Generator34.4K
- Multi Stage Dockerfile31.5K
- Documentation Writer28.4K
- Prd24.4K
- Refactor22.6K
- Java Springboot21.8K
- Gh Cli21.2K
- Create Readme19.5K
- Playwright Generate Test18.2K