github avatar

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-code

Installs 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

Recommended

More Security
1ruvnet avatarbrowser-loginruvnet/rufloDrive an authentication flow once, sanitize cookies through AIDefence, and vault a reusable cookie handle in browser-cookies for future sessions730skills.sh installs
2syncfusion avatarsyncfusion-react-speech-to-textsyncfusion/react-ui-components-skillsImplement the Syncfusion React SpeechToText component. Use this skill to convert speech to text, manage microphone input, control listening states, process spee730skills.sh installs
3cap-go avatarcapgo-organization-managementcap-go/capgo-skillsGuides the agent through Capgo account lookup and organization administration. Use when listing organizations, managing members, changing security settings, or 725skills.sh installs
4joellewis avatarfinancial-planning-integrationjoellewis/finance_skillsIntegrate financial planning engines with the advisor technology stack — data flows between planning tools, CRM, PMS, custodians, and aggregation platforms; cap723skills.sh installs
5joellewis avatartax-loss-harvestingjoellewis/finance_skillsExecute a complete tax-loss harvesting workflow from candidate identification through post-harvest monitoring. Use when the user asks about finding TLH candidat715skills.sh installs
6mindrally avatarfirebase-developmentmindrally/skillsFirebase development guidelines for Firestore, Authentication, Functions, and Storage with TypeScript and Angular.715skills.sh installs