code-tour

Create CodeTour JSON walkthrough files with verified file anchors.

Updated Jun 24, 2026

Search Tags:#architecture #debugging #onboarding #pull request #review #code walkthrough #codetour

Ready to run

npx skills add https://github.com/mostafa-ismail-2004/codex-plugin --skill code-tour-mostafa-ismail-2004

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/mostafa-ismail-2004/codex-plugin/tree/main/skills/code-tour
Command: npx skills add https://github.com/mostafa-ismail-2004/codex-plugin --skill code-tour-mostafa-ismail-2004

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns a codebase or pull request into a structured, anchor-based CodeTour walkthrough so readers can understand how a system works without wading through a flat summary.

Core Features & Use Cases

Onboarding tours: Build step-by-step routes for new maintainers to learn a repository's structure and execution flow.
Architecture walkthroughs: Trace core modules, entry points, and dependencies in a narrative sequence that explains why the design matters.
PR and RCA tours: Create reviewer-friendly or incident-focused tours anchored to real files, lines, selections, or patterns.
Safety and precision: Requires verified file anchors and line ranges, and it writes only .tour artifacts rather than changing application code.

Quick Start

Ask the skill to create a CodeTour for the repository, PR, or feature you want explained and have it produce a .tour file with verified anchors.

Frequently Asked Questions about code-tour

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create a guided code walkthrough for onboarding new developers?▼

Create a guided code walkthrough by generating CodeTour JSON artifacts with anchored navigation through real source files. This Skill builds step-by-step tour files that map repository structure and execution flow for new maintainers without altering application code.

Can I generate CodeTour files for reviewing pull requests?▼

Yes, you can generate CodeTour files for pull request reviews. The Skill creates reviewer-friendly tours anchored to verified files, line ranges, and selections, tracing feature explanations and debugging paths directly within the source code.

What is the best way to document code architecture using anchored file references?▼

Document code architecture by creating CodeTour walkthroughs that trace core modules, entry points, and dependencies in a narrative sequence. The Skill requires validated file and directory references to ensure the tour accurately reflects the design structure.

Does generating CodeTour artifacts modify my existing source files?▼

Generating CodeTour artifacts does not modify existing source files. The Skill writes only `.tour` JSON files containing anchored navigation metadata, ensuring your application code remains completely untouched during onboarding or architecture review tour creation.

How do I trace incident investigation paths through a codebase?▼

Trace incident investigation paths by creating RCA tours anchored to real source files and line selections. The Skill builds structured walkthroughs that guide reviewers through debugging paths and root cause analysis using verified file references.

Do I need specific dependencies installed to create CodeTour walkthrough files?▼

You do not need specific dependencies installed to create CodeTour walkthrough files. The Skill operates independently without external requirements, outputting only `.tour` JSON artifacts that contain validated file anchors and line ranges for navigation.