Code Tour
- 1.4k installs
- 238k repo stars
- Updated August 5, 2026
- affaan-m/ecc
This is a copy of code-tour by affaan-m - installs and ranking accrue to the original listing.
code-tour is an ECC skill that generates reusable, interactive CodeTour .tour files guiding developers through a codebase with direct file and line-range anchors.
About
code-tour is an Everything Claude Code skill that produces CodeTour-format walkthroughs instead of ad-hoc Markdown notes. The skill creates .tour JSON files under .tours/ with steps anchored to real files and line ranges, targeting specific reader personas for onboarding tours, architecture walkthroughs, PR reviews, and root-cause analysis paths. Developers reach for code-tour when a guided sequence serves better than a flat repository overview, such as ramping new engineers or explaining how a subsystem works with reusable artifacts. The skill only authors tour files and does not modify source code as part of the workflow.
- Generates official CodeTour .tour JSON files in the .tours/ directory
- Creates persona-targeted narrative walkthroughs with file and line anchors
- Supports onboarding tours, architecture tours, PR tours, and RCA tours
- Produces guided sequences instead of flat Markdown summaries
- Only outputs .tour files and never modifies source code
Code Tour by the numbers
- 1,408 all-time installs (skills.sh)
- +84 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/affaan-m/ecc --skill code-tourAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.4k |
|---|---|
| repo stars | ★ 238k |
| Last updated | August 5, 2026 |
| Repository | affaan-m/ecc ↗ |
How do you create interactive codebase walkthrough tours?
Generate reusable, interactive CodeTour files that guide someone through a codebase with direct file and line anchors.
Who is it for?
Teams onboarding engineers or reviewers who need reusable, IDE-anchored codebase walkthroughs instead of chat-only explanations.
Skip if: One-off explanations sufficient without a reusable guided tour artifact or projects not using the CodeTour VS Code extension.
When should I use this skill?
A developer asks for a code tour, onboarding walkthrough, architecture tour, PR tour, or explain-how-X-works guide with file anchors.
What you get
CodeTour .tour JSON files in .tours/ with persona-targeted steps linked to file and line ranges.
- CodeTour .tour files
- Onboarding walkthrough sequences
Files
コードツアー
コードベースウォークスルー用のCodeTour .tourファイルを作成し、実際のファイルとラインの範囲に直接開きます。ツアーは.tours/にあり、アドホックなMarkdownノートではなくCodeTour形式を対象としています。
良いツアーは特定の読者への物語：
- 彼らが何を見ているか
- なぜそれが重要か
- 次にどのパスを従うべきか
.tour JSONファイルのみを作成。このスキルの一部としてソースコードを変更しないでください。
使用時期
次の場合にこのスキルを使用：
- ユーザーがコードツアー、オンボーディングツアー、アーキテクチャウォークスルー、またはPRツアーを求める
- ユーザーが「Xがどのように機能するかを説明」と言い、再利用可能なガイド付きアーティファクトを望む
- 新しいエンジニアまたはレビュアーのためのランプアップパス
- タスクはフラット概要ではなくガイド付きシーケンスでより良くサービスされる
使用しないとき
| コードツアーの代わりに | 使用 |
|---|---|
| 一度限りの説明で十分 | 直接答える |
ユーザーがプロのドキュメント、.tourアーティファクトではなく | ドキュメント編集 |
| タスクは実装またはリファクタリング | 実装作業を行う |
| 広範なコードベースオンボーディング | codebase-onboarding |
ワークフロー
1. 発見
何か書く前にリポを探索：
- READMEとパッケージ/アプリエントリポイント
- フォルダ構造
- 関連するコンフィグファイル
- ツアーがPRフォーカスの場合は変更されたファイル
コードの形状を理解する前にステップを書き始めないでください。
2. 読者を推測
要求からペルソナと深さを決定。
| リクエストの形 | ペルソナ | 推奨される深さ |
|---|---|---|
| 「オンボーディング」「新しい参加者」 | new-joiner | 9-13ステップ |
ツアー形式
Code Tour .tourファイルはJSON形式で、各ステップはファイルパス、ライン番号、説明を含みます。
Related skills
Lark MarkdownInstantly turn any markdown file into clean, formatted Lark/Figma-compatible documents without manual reformatting.488k
Lark DocCreate, read, update, summarize, rewrite and manage Feishu/Lark cloud documents directly from agent workflows.401k16.1kLark WikiCreate, organize, query, and manage documents, spaces, and members inside Lark (Feishu) knowledge bases directly from AI agent workflows.397k16.1k
Domain ModelingBuild and sharpen a project's domain model: pin down domain terminology in a glossary and record architectural decisions as ADRs.318k202k
Opensource Guide CoachGet expert, attribution-safe guidance on launching and sustaining an open-source project.270k71Readme I18nMaintain consistent, updatable language selector blocks across every README variant in a multilingual repository.270k71How it compares
Pick code-tour over generic doc skills when the deliverable must be an interactive IDE-anchored .tour file, not static Markdown.
FAQ
What file format does code-tour produce?
code-tour produces CodeTour .tour JSON files stored in a .tours/ directory. Each step links to real repository files and line ranges that open directly in the CodeTour VS Code extension.
Does code-tour modify source code?
code-tour only creates .tour JSON walkthrough files and does not change application source code. Use separate skills when the task requires refactoring or feature implementation alongside documentation.