explainer

Scan a codebase to create ordered walkthroughs with code highlights and TTS narration.

88|8|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Royal-lobster/code-explainer --skill explainer-royal-lobster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: explainer
Source: https://github.com/Royal-lobster/code-explainer/tree/main
Command: npx skills add https://github.com/Royal-lobster/code-explainer --skill explainer-royal-lobster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-audio, sounddevice, and includes scripts (resource) components.

What problem does it solve?

The Code Explainer skill helps developers understand codebases by generating an narrated, segment-based walkthrough with live code highlighting.

Core Features & Use Cases

  • Creates an ordered plan by scanning the repository and maps it to a narrative of segments.
  • Displays explanations in a VS Code/Cursor sidebar with per-segment highlighting and optional TTS narration.
  • Supports Save/Load of walkthroughs and multiple delivery modes (Walkthrough, Read, Podcast) for reuse and sharing.

Quick Start

Ask your coding agent to explain a feature or code path to start the guided walkthrough.

Frequently Asked Questions about explainer

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

FAQPage Schema
How do I generate an audio code walkthrough for a repository?

To generate an audio code walkthrough, the skill scans your repository to build an ordered plan, explains each segment with code highlights, and uses local TTS narration for playback. You can ask your coding agent to explain a feature to start.

What is the best way to understand an unfamiliar codebase in VS Code?

The best way to understand an unfamiliar codebase in VS Code is using a guided walkthrough that maps an ordered plan to narrative segments. It displays explanations in a sidebar with per-segment code highlighting and optional TTS narration.

Does the code explainer skill support saving and loading walkthroughs?

Yes, the code explainer supports saving and loading walkthroughs. You can reuse and share generated code explanations later, utilizing multiple delivery modes like Walkthrough, Read, or Podcast formats.

Can I use local TTS for code narration without external APIs?

Yes, you can use local TTS for code narration without external APIs. The skill uses local TTS capabilities via mlx-audio and sounddevice dependencies to generate spoken explanations for your code segments.

What are the available delivery modes for AI-assisted code walkthroughs?

The available delivery modes for AI-assisted code walkthroughs are Walkthrough, Read, and Podcast. These modes allow you to experience narrated code explanations with segment-based highlighting in different formats.

Do I need mlx-audio and sounddevice to run code walkthroughs?

Yes, you need mlx-audio and sounddevice installed to run code walkthroughs with TTS narration. These dependencies enable the local text-to-speech audio playback functionality within the VS Code or Cursor sidebar.