Skip to content

feat: add code-tour skill — AI-generated CodeTour walkthroughs#1277

Open
vaddisrinivas wants to merge 2 commits intogithub:stagedfrom
vaddisrinivas:add-code-tour-skill
Open

feat: add code-tour skill — AI-generated CodeTour walkthroughs#1277
vaddisrinivas wants to merge 2 commits intogithub:stagedfrom
vaddisrinivas:add-code-tour-skill

Conversation

@vaddisrinivas
Copy link
Copy Markdown

Summary

Adds the code-tour skill — an AI-powered CodeTour generator that creates persona-targeted, step-by-step .tour files linking to real files and line numbers in any repository.

What it does

  • Creates CodeTour-compatible .tour JSON files for VS Code
  • Supports 20 developer personas (new joiner, bug fixer, architect, PR reviewer, vibecoder, security reviewer, performance optimizer, and more)
  • Covers all CodeTour step types: file/line, selection, pattern, uri, commands, directory, view
  • Supports tour-level fields: ref, isPrimary, nextTour for multi-tour series
  • Works with any repository in any language — includes entry-point maps for Node/TS, Python, Go, Rust, Java, Ruby, PHP, and more
  • Includes depth controls (quick/standard/deep) and repo-type-specific strategies (monorepo, API, CLI, library, frontend, data pipeline)

Links

Checklist

  • Skill folder created at skills/code-tour/SKILL.md
  • Frontmatter includes name and description
  • Branch created from staged
  • PR targets staged branch

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2026

🔍 Skill Validator Results

2 resource(s) checked | ✅ All checks passed

Full output
Found 1 skill(s)
[code-tour] 📊 code-tour: 5,620 BPE tokens [chars/4: 5,617] (comprehensive ✗), 28 sections, 5 code blocks
[code-tour]    ⚠  Skill is 5,620 BPE tokens (chars/4 estimate: 5,617) — "comprehensive" skills hurt performance by 2.9pp on average. Consider splitting into 2–3 focused skills.
�[32m✅ All checks passed (1 skill(s))�[0m

@vaddisrinivas
Copy link
Copy Markdown
Author

Closing — will resubmit as separate PRs per skill, following contribution guidelines.

Reduce persona table to top 10, condense verbose examples and notes,
trim redundant anti-patterns, compress step type docs and PR recipe.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vaddisrinivas vaddisrinivas reopened this Apr 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant