skills.rest
llmh333
llmh333COMMUNITY
Explore all skills by this author →
GitHub

code-tour

Generate CodeTour-compatible .tour JSON walkthroughs under .tours/ with validated file paths and line ranges.

Updated Sep 13, 2025
Search Tags:#onboarding#pr review#security review#architecture review#rca#code walkthrough#codetour
One-click install
npx skills add https://github.com/llmh333/employee_management_spring --skill code-tour-llmh333
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-tour
Source: https://github.com/llmh333/employee_management_spring/tree/main/.gemini/skills/code-tour
Command: npx skills add https://github.com/llmh333/employee_management_spring --skill code-tour-llmh333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CodeTour turns confusing repositories into guided, clickable walkthroughs by creating reusable tour artifacts that open directly to the correct files and line ranges.

Core Features & Use Cases

  • Persona-targeted step-by-step walkthroughs: Guides readers like new joiners, architects, PR reviewers, RCA investigators, and security reviewers through the same codebase with the right depth.
  • Real file and line anchored tours: Ensures every referenced path and line anchor exists so the walkthrough is reliable instead of a guessy summary.
  • Structured tour output for onboarding and review: Produces only CodeTour-compatible .tour JSON artifacts placed deterministically under .tours/.

Quick Start

Use the code-tour skill to create a PR-review walkthrough anchored to the changed files in .gemini/skills/code-tour by requesting: “Create a CodeTour for reviewing this PR, targeted to a pr-reviewer persona, and open directly to the exact files and line ranges involved.”

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 to a large codebase?▼

To create a guided code walkthrough for onboarding, generate CodeTour artifacts that anchor readers directly to validated file paths and line ranges. This produces deterministic `.tour` JSON outputs under `.tours/` for clickable, step-by-step explanations.

Can I generate anchored code tours for PR review and security review tours?▼

Yes, you can generate anchored code tours for PR review and security review tours. The walkthroughs target specific personas like pr-reviewers and security reviewers, guiding them through exact changed files and line ranges involved in the investigation.

What is the best way to explain feature architecture across scattered files without losing readers?▼

The best way to explain feature architecture across scattered files is generating CodeTour walkthrough artifacts. These artifacts validate real paths and line ranges, creating a guided, clickable tour that keeps readers oriented instead of lost in the repository.

Do I need specific dependencies or extensions to use `.tour` JSON outputs under `.tours/`?▼

You do not need specific dependencies to generate `.tour` JSON outputs under `.tours/`. The skill requires no external dependencies, preserving YAML frontmatter metadata fields for discovery and writing deterministic tour files directly.

How does a CodeTour walkthrough artifact handle RCA investigations in complex repositories?▼

A CodeTour walkthrough artifact handles RCA investigations by anchoring root cause analysis steps to real file paths and exact line ranges. It generates persona-targeted tours for RCA investigators, ensuring reliable navigation through the relevant codebase sections.

Are there limitations when generating deterministic `.tour` JSON outputs for codebase onboarding?▼

A limitation when generating deterministic `.tour` JSON outputs is that the skill only produces CodeTour-compatible files placed under `.tours/`. It validates real paths and line ranges but does not generate other documentation formats or summaries.

Related Skills

Explore More Software Engineering Skills→
Veloxia-agencyVeloxia-agency

code-tour

Create CodeTour .tour files with verified file paths and line anchors.

Community
Advanced
JamkrisJamkris
86

code-tour

Create .tour JSON artifacts anchored to files and line ranges for codebase walkthroughs.

Community
Advanced
MODAC-AgentMODAC-Agent

gosu-review-v1

Generate Korean Markdown code-review reports from changed Go files.

Official
Advanced
DVNghiemDVNghiem
20

code-tour

Generate structured Markdown code tours with validated file paths.

Community
Advanced