html-explainer

Installation
SKILL.md

HTML Explainer

Build one self-contained HTML file that teaches a reader how a real system works. The page is trusted because every snippet is real, and readers use its path:line bars to jump into the repo. It explains; it does not judge. A quality verdict belongs to architecture-lens.

Choose the depth

Depth Answers Shape Default path
orientation What are the pieces, how do they fit, where do I start? Map, four to six sections, one traced flow, where to look next. docs/<scope>-architecture.html
walkthrough How does this subsystem actually work? Map, stack, six to nine sections, many verbatim panels. docs/<topic>-explainer.html

"Explain the architecture" with no qualifier means orientation for a newcomer over the whole repo. "Explain how X works" means walkthrough. When the reader of an orientation page wants to descend into one subsystem, build its walkthrough and reuse the scope and evidence already gathered rather than exploring again.

An explicit request to update an existing page authorizes that edit. Otherwise use a new path or ask which page to replace, and preserve unrelated content.

Scope and audience

Settle the subject and the audience before exploring. Infer them from the request; ask at most one short question when you can't. One page holds one idea: split two unrelated subsystems into two linked pages.

Installs
63
GitHub Stars
2
First Seen
Aug 8, 2026