code-tour
github/awesome-copilotOfficial collectionProduct & project management
code-tour is a skill in github/awesome-copilot, last changed 12 Apr 2026. It can run shell commands, reach the network, name web addresses and bundle scripts — read the findings before installing.
Use this skill to create CodeTour .tour files — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for: "create a tour", "make a code tour", "generate a tour", "onboarding tour", "tour for this PR", "tour for this bug", "RCA tour", "architecture tour", "explain how X works", "vibe check", "PR review tour", "contributor guide", "help someone ramp up", or any request for a structured walkthrough through code. Supports 20 developer personas (new joiner, bug fixer, architect, PR reviewer, vibecoder, security reviewer, and more), all CodeTour step types (file/line, selection, pattern, uri, commands, view), and tour-level fields (ref, isPrimary, nextTour). Works with any repository in any language.
At a glance
What it can touch
How much a skill can do, not whether it is risky.
Pattern check
Nothing flagged
That isn't proof the skill is harmless.
Commit 8178d19 · 3 Nov 2026
How the check worksPattern check: nothing flagged
That isn't proof the skill is harmless.
Install
Each tab says whether it installs commit 8178d19, the one we checked, or the latest version.
OpenCode also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Goose also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Windsurf (Devin Desktop) also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Zed also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Roo Code also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Factory Droid also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Junie also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
Amp also looks in .agents/skills/ and ~/.agents/skills/, so use the Any agent steps.
No install command here reaches Kiro. Copy the skill's folder into .kiro/skills/ in your project, or ~/.kiro/skills/ for all your projects. github/awesome-copilot/skills/code-tour (opens in a new tab)
Antigravity also looks in .agents/skills/, so the Any agent steps reach it with This project. For All projects, see where Antigravity looks.
Cline also looks in .claude/skills/, so the Claude Code steps reach it with This project. For All projects, see where Cline looks.
Claude Code
Pinned to commit 8178d19, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .claude/skills &&mkdir .claude/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .claude/skills/code-tour/ &&rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Claude apps
Pinned to commit 8178d19, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make code-tour.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&out="$(mktemp -d)" &&cp -R "$tmp"/skills/code-tour "$out"/code-tour &&(cd "$out" && zip -qr - code-tour) > code-tour.zip &&rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose code-tour.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Codex
Pinned to commit 8178d19, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .agents/skills &&mkdir .agents/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .agents/skills/code-tour/ &&rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Cursor
Pinned to commit 8178d19, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .cursor/skills &&mkdir .cursor/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .cursor/skills/code-tour/ &&rm -rf "$tmp"Copilot & VS Code
Pinned to commit 8178d19, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .github/skills &&mkdir .github/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .github/skills/code-tour/ &&rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install github/awesome-copilot skills/code-tour/SKILL.md@8178d1939a203f691067073dcab2a3f1e14072d3 --agent github-copilot --scope projectGemini CLI
Pinned to commit 8178d19, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .gemini/skills &&mkdir .gemini/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .gemini/skills/code-tour/ &&rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/github/awesome-copilot.git --path skills/code-tour --scope workspaceAny agent
Pinned to commit 8178d19, the one we checked.
OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity read .agents/skills in a project.
From your project's root folder:
tmp="$(mktemp -d)" &&git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/github/awesome-copilot.git "$tmp" &&git -C "$tmp" fetch -q --depth 1 origin 8178d1939a203f691067073dcab2a3f1e14072d3 &&git -C "$tmp" sparse-checkout set -- skills/code-tour &&git -C "$tmp" checkout -q 8178d1939a203f691067073dcab2a3f1e14072d3 &&mkdir -p .agents/skills &&mkdir .agents/skills/code-tour &&cp -R "$tmp"/skills/code-tour/. .agents/skills/code-tour/ &&rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add github/awesome-copilot --skill code-tourWhat it can touch
From the files and frontmatter at commit 8178d19. This is how much a skill can do, not whether it is risky.
Pattern check
Pattern check: nothing flagged · commit 8178d19 · 3 Nov 2026
We checked every text file in this skill, at commit 8178d19 on 3 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
How the check worksReport an incorrect finding
Outside links we did not follow
- https://github.com/microsoft/codetour
- https://github.com/search?q=path%3A**%2F*.tour+&type=code
- https://github.com/coder/code-server/blob/main/.tours/contributing.tour
- https://github.com/a11yproject/a11yproject.com/blob/main/.tours/code-tour.tour
- https://github.com/lostintangent/rock-paper-scissors/blob/master/main.tour
- https://github.com/lucasjellema/cloudnative-on-oci-2021/blob/main/.tours/introduction.tour
- https://github.com/nickvdyck/webbundlr/blob/main/.tours/getting-started.tour
- https://github.com/nickvdyck/webbundlr/blob/main/.tours/architecture.tour
- https://aka.ms/codetour-schema
- https://vscode.dev/github.com/
Show 14 more
- http://json-schema.org/draft-04/schema#
- https://github.com/microsoft/codetour/blob/main/.tours/intro.tour
- https://raw.githubusercontent.com/.../overview.svg
- https://github.com/github/codespaces-codeql/blob/main/.tours/codeql-tutorial.tour
- https://github.com/github/codespaces-learn-with-me/blob/main/.tours/main.tour
- https://github.com/blackgirlbytes/copilot-todo-list/blob/main/.tours/main.tour
- https://github.com/lucasjellema/cloudnative-on-oci-2021/blob/main/.tours/function-tweet-retriever.tour
- https://github.com/lucasjellema/cloudnative-on-oci-2021/blob/main/.tours/oci-and-infrastructure-as-code.tour
- https://github.com/lucasjellema/cloudnative-on-oci-2021/blob/main/.tours/build-and-deployment-pipeline-function-tweet-retriever.tour
- https://dev.to/tobiastimm/onboard-your-codebase-with-codetour-2jc8
- https://coder.com/blog/onboard-to-new-projects-faster-with-codetour
- https://techcommunity.microsoft.com/blog/educatordeveloperblog/codetour-vscode-extension-allows-you-to-produce-interactive-guides-assessments-a/1274297
- https://technology.amis.nl/software-development/visual-studio-code-the-code-tours-extension-for-in-context-and-interactive-readme/
- https://github.com/topics/codetour
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specPasses with warnings
The open format from agentskills.io, held to the strictest version of each rule among the agents we check.
- Warning
The body is about 5,417 tokens (approx.); the spec suggests under 5,000. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
There is no license field, so readers can't tell whether they may reuse the skill. O2
Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.
- Note
Reference files over 100 lines with no table of contents at the top: references/examples.md (196 lines). B5
Fix: Add a short list of the sections at the top of each.
- Warning
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
The body is about 5,417 tokens (approx.); the spec suggests under 5,000. After compaction Claude Code keeps only the first 5,000 tokens of a skill. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
Reference files over 100 lines with no table of contents at the top: references/examples.md (196 lines). B5
Fix: Add a short list of the sections at the top of each.
- Note
Claude apps & API uploadPasses
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Note
The description is 744 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4
Fix: If the claude.ai upload refuses it, trim the description to 200 characters.
- Note
The body is about 5,417 tokens (approx.); the spec suggests under 5,000. Anthropic's guidance says the same. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
Reference files over 100 lines with no table of contents at the top: references/examples.md (196 lines). B5
Fix: Add a short list of the sections at the top of each.
- Note
- OpenAI (Codex & API)Passes
- VS Code & CopilotPasses
SKILL.md
Files
More from github/awesome-copilot
Other Product & project management skills
Same category, most repo stars first.