diffity-tour

Create interactive browser-based code tours with narrated steps and highlighted code blocks.

739|50|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/nilbuild/diffity --skill diffity-tour-nilbuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diffity-tour
Source: https://github.com/nilbuild/diffity/tree/main/packages/skills/diffity-tour
Command: npx skills add https://github.com/nilbuild/diffity --skill diffity-tour-nilbuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing and delivering interactive, browser-based guided code tours that explain features or answer user questions by stepping through code with narrative and highlighted segments.

Core Features & Use Cases

  • Narrated tours that open in a browser and present step-by-step navigation with code highlights.
  • Mode-based scoping including Focused, Feature, System, Concept, and Review to match user intent.
  • CLI-driven lifecycle with commands to start, step through, list, and finish tours, enabling deterministic exploration of a codebase.
  • Real-world use cases include onboarding new contributors, explaining complex features, and reviewing PRs via tour-guided diffs.

Quick Start

Start a tour with the topic "Diffity Tour" and follow the prompts to navigate the codebase.

Frequently Asked Questions about diffity-tour

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

FAQPage Schema
How do I create a guided walkthrough of a codebase for new contributors?

Guided code tours orchestrate interactive, browser-based walkthroughs of a codebase with narrated steps and highlighted code blocks. You can launch them via a CLI lifecycle to explain features and onboard new contributors.

How does a CLI-driven code tour lifecycle work?

The CLI-driven code tour lifecycle uses commands like tour-start, tour-step, tour-done, and list to create, navigate, and complete tours deterministically. These commands orchestrate interactive, browser-based walkthroughs with narrated steps.

Can I adjust the scope of a code tour for different review workflows?

Yes, mode options including Focused, Feature, System, Concept, and Review tailor the scope and output of code tours for different questions and workflows. These modes guide users from entry points to final outcomes.

What is the best way to review a PR diff using a guided code tour?

Guided code tours support PR reviews via tour-guided diffs using the Review mode. This mode orchestrates interactive, browser-based walkthroughs with narrated steps and highlighted code blocks to explain the changes.

Does Diffity Tour support navigation aids like diagrams and links?

Yes, code tours support optional navigation aids like goto links and diagrams. These aids supplement the CLI lifecycle commands to help users navigate walkthroughs from entry points to final outcomes.

What are the limitations of using a CLI to orchestrate browser-based code tours?

Code tours require CLI lifecycle commands to orchestrate browser-based walkthroughs deterministically. Tours are limited to narrated steps and highlighted code blocks, relying on optional goto links and diagrams for navigation.