Create guided code walkthroughs
code-tourpluginsetup L2★17,464
alirezarezvani/claude-skills ↗What it does
Create persona-targeted CodeTour walkthroughs linked to real files and line numbers
Best for
When onboarding developers or explaining architecture requires guided walkthroughs tailored to reader expertise level rather than generic comments.
Inputs
- · codebase + repo structure
- · target persona: vibecoder, new joiner, architect, security reviewer, etc.
- · tour scope: feature, subsystem, or entire codebase
Outputs
- · .tour file (CodeTour format)
- · persona-specific narration + step-by-step file/line links
- · SMIG descriptions per step
Requires
- · CodeTour .tour file generator
- · 10 developer personas (vibecoder, new joiner, architect, security, perf, etc.)
- · SMIG description formula
- · stdlib Python tools
Preconditions
- · codebase in VS Code workspace
- · CodeTour extension installed
- · target persona identified
Failure modes
- · Tour outdates as code evolves (line numbers drift)
- · Persona narrative too generic, doesn't engage target reader
- · SMIG formula produces boilerplate descriptions
Trust signals
- · 10 developer personas (custom narration per type)
- · Supports all CodeTour step types
- · SMIG description formula (Signal, Meaning, Implication, Gotchas)
- · CodeTour integration (standard format, VS Code extension)