explain

Generates interactive visual explanations of concepts, code changes, and conversations as HTML pages.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/JongDeug/dotfiles --skill explain-jongdeug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: explain
Source: https://github.com/JongDeug/dotfiles/tree/main/ai/claude/skills/explain
Command: npx skills add https://github.com/JongDeug/dotfiles --skill explain-jongdeug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a complex concept, code diff, PR, or long conversation into something a reader can actually understand requires structured writing, diagrams, and examples — this Skill automates that by producing a rich, interactive explanation page. ## Core Features & Use Cases - Four-section structure: Every explanation includes Background, Intuition (with a required flow diagram carrying concrete example values), Detail, and an interactive five-question multiple-choice Quiz. - Flexible subjects: Explain the current conversation, a concept, a file or system, or a code change resolved via git diff or gh pr view. - Publishable output: Produces a single self-contained HTML page (inlined CSS/JS, responsive, light/dark aware) published as a Claude Artifact, with a dated local HTML fallback. - Use Case: After finishing a PR, run /explain HEAD~1 to get a shareable visual walkthrough of the change with before/after flow diagrams and a comprehension quiz. ## Quick Start Ask the assistant to explain the current conversation or a specific code change, for example by saying "explain this PR visually with a diagram and quiz".

Frequently Asked Questions about explain

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

FAQPage Schema
How do I generate a visual explanation of a code change or PR?▼

Invoke the skill with a commit range, branch, or PR reference such as /explain HEAD~1 or a PR URL. It resolves the change with git diff or gh pr view, reads the surrounding code, and produces a structured HTML explanation with diagrams and a quiz.

What sections does the generated explanation page include?▼

Every explanation has four sections in order: Background, Intuition with a required flow diagram showing concrete example values, Detail covering the substance, and an interactive five-question multiple-choice quiz with randomized options.

Can the explanation be published as a shareable page?▼

Yes, the page is published as a Claude Artifact by default with a favicon and description. If publishing fails, it falls back to a self-contained HTML file saved outside the repo with a date-prefixed filename.

Why do code blocks in the HTML output lose their line breaks?▼

Browsers collapse newlines unless the element uses white-space: pre or pre-wrap. The skill requires code blocks to use <pre> tags or styled divs carrying white-space: pre-wrap, and each block is checked before saving.

Does the explanation page work without external CDNs or fonts?▼

Yes, the output is a single self-contained page with all CSS and JavaScript inlined. External CDNs, fonts, and scripts are excluded because the Artifact content security policy blocks them.