What problem does it solve? Understanding what changed in a codebase—whether from a diff, branch, commit, PR, or an agent's work—often requires digging through raw diffs and surrounding code. This Skill produces a single readable HTML document that teaches the change to a human reviewer, including background, intuition, code walkthrough, behavior, and risks. ## Core Features & Use Cases - Self-contained HTML output: Writes one .html file with embedded CSS and lightweight JavaScript, saved outside the repo with a date-prefixed filename so it never enters version control. - Structured explanation sections: Enforces required sections—Background, Intuition, Code, Behavior And Proof, and Risks And Follow-Ups—with a table of contents and narrative flow. - Rich visual aids: Supports callouts, HTML/CSS diagrams (UI mockups, data-flow, before/after states), and whitespace-preserving code blocks. - Use Case: After an orchestrator worker finishes a substantial implementation, invoke the skill to produce a reviewable handoff artifact at /tmp/2026-07-02-explanation-<slug>.html that links to tests, screenshots, and logs as proof. ## Quick Start Ask the agent to explain the current diff or a specific PR as a self-contained HTML artifact and return the absolute file path.
