Claude MarketplacesSubmit
affaan-m avatar

Code Tour

affaan-m/ecc

Generates CodeTour JSON files that anchor walkthroughs to real line numbers and file paths in your repo. You'd use this when "explain how this works" needs to be repeatable for the next person, like onboarding tours, PR review paths, or RCA walkthroughs. The SMIG framework (Situation, Mechanism, Implication, Gotcha) keeps descriptions tight and grounded. One honest gotcha: the ref field matters more than it looks. Point a PR tour at the base branch and every new file fails to open, even though the tour itself renders fine. Worth it when you need a reusable narrative instead of one-off Slack paragraphs.

skills.sh installs
5.5K
GitHub stars
300.3K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add affaan-m/ecc --skill code-tour --agent claude-code

Installs into .claude/skills of the current project.

Files

Code Tour

Create CodeTour .tour files for codebase walkthroughs that open directly to real files and line ranges. Tours live in .tours/ and are meant for the CodeTour format, not ad hoc Markdown notes.

A good tour is a narrative for a specific reader:

  • what they are looking at
  • why it matters
  • what path they should follow next

Only create .tour JSON files. Do not modify source code as part of this skill.

When to Use

Use this skill when:

  • the user asks for a code tour, onboarding tour, architecture walkthrough, or PR tour
  • the user says "explain how X works" and wants a reusable guided artifact
  • the user wants a ramp-up path for a new engineer or reviewer
  • the task is better served by a guided sequence than a flat summary

Examples:

  • onboarding a new maintainer
  • architecture tour for one service or package
  • PR-review walk-through anchored to changed files
  • RCA tour showing the failure path
  • security review tour of trust boundaries and key checks

When NOT to Use

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/affaan-m/ecc
Categories
Documentation, Code Review & Quality
First seen
Jul 14, 2026

More from affaan-m/ecc

All 263

Recommended

More Documentation
1forcedotcom avatarintegration-connectivity-connected-app-configureforcedotcom/sf-skillsSalesforce Connected Apps and External Client Apps OAuth configuration with 120-point scoring. Use this skill to configure OAuth flows, JWT bearer auth, Connect5.5Kskills.sh installs
2aws avatarmanaging-amazon-mskaws/agent-toolkit-for-awsOperates Amazon MSK Provisioned clusters (Standard and Express brokers). Required for ANY MSK Provisioned task — training data conflates Standard and Express, w5.5Kskills.sh installs
3trailofbits avataryara-rule-authoringtrailofbits/skillsGuides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming convent5.5Kskills.sh installs
4affaan-m avatarcustoms-trade-complianceaffaan-m/eccCodified expertise for customs documentation, tariff classification, duty optimization, restricted party screening, and regulatory compliance across multiple ju5.5Kskills.sh installs
5samber avatarconventional-gitsamber/cc-skillsConventional Commits v1.0.0 branch naming, worktree naming, and commit message standards for GitHub and GitLab projects. Use when creating branches, naming work5.4Kskills.sh installs
6samber avatarsite-launch-checklistsamber/cc-skillsPre-launch checklist for shipping a new website. Orchestrates analytics setup (GA4, PostHog, Google Search Console, Ahrefs), legal compliance, security headers 5.4Kskills.sh installs