explain

Generate structured markdown or Showboat walkthrough documents from source files.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/jamesc/skills --skill explain-jamesc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: explain
Source: https://github.com/jamesc/skills/tree/main/skills/explain
Command: npx skills add https://github.com/jamesc/skills --skill explain-jamesc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed walkthrough documents for code, patterns, or features, making complex subjects easier to understand.

Core Features & Use Cases

  • Multiple Walkthrough Styles: Generates documentation in formats like Demo (interactive Showboat), Linear (narrative prose), Architecture (high-level overview), or API Reference.
  • Code Exploration: Intelligently reads and analyzes source files to extract relevant information.
  • Use Case: Onboarding a new developer to a complex module by generating a linear walkthrough of its codebase.

Quick Start

Use the explain skill to create a demo walkthrough for the 'utils/string_helpers.py' file.

Frequently Asked Questions about explain

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

FAQPage Schema
How do I generate a code walkthrough for my source files?

To generate a code walkthrough, you analyze source files to produce structured markdown or Showboat documents. This process creates comprehensive walkthrough documents that make complex codebases, patterns, or features easier to understand.

What is the best way to create API reference documentation from existing code?

Creating API reference documentation is best handled by generating walkthrough documents in specific formats like API reference or architecture styles. This approach analyzes source files directly to extract relevant information and produce structured markdown.

Can I generate interactive demo walkthroughs for onboarding new developers?

Yes, you can generate interactive demo walkthroughs using the Showboat format. This onboarding method analyzes source files to create interactive documents that guide new developers through complex modules and features.

Does the code walkthrough generation support architectural diagrams and test case explanations?

Yes, code walkthrough generation supports both architectural diagrams and test case explanations. It analyzes source files to produce structured documents that include code snippets, architectural overviews, and detailed test case explanations.

What walkthrough styles are available for documenting code patterns?

Available walkthrough styles for documenting code patterns include demo, linear, architecture, and API reference formats. These styles generate structured markdown or Showboat documents by analyzing source files to explain complex subjects.