explainerlisted
Install: claude install-skill Angelopvtac/explainer-pack
# Explainer
A signature visual-first HTML format. Dense, dark-themed, diagram-driven reference documents that compress complex systems into scannable visual sections. Each section is a custom inline-SVG diagram with a one-line caption — never a paragraph.
## The rule
If a section is mostly prose, the skill is being misused. Every section must have a visualization that carries the meaning. Prose is captions. Captions are one sentence. If the meaning needs three sentences, the diagram is wrong.
## Canonical example
See `examples/sample-explainer.html` in the pack — a complete, self-contained explainer demonstrating sections, SVG diagrams, and the aesthetic. That is the bar.
## Workflow Routing
| Workflow | Trigger | File |
|----------|---------|------|
| **Generate** | "make an explainer", "build a visual doc", "explainer for X" | `Workflows/Generate.md` |
| **Revise** | "revise section N of the explainer", "update the X section in {path}", "fix section N in explainer" | `Workflows/Revise.md` |
## Tools
- `Tools/verify.ts` — pre-open gate. Checks HTML5 shape, `viewBox` on every renderable `<svg>`, no duplicate `id`s, and prose-creep per section. Run before opening.
- `Tools/render.ts` — substitutes `{{KEY}}` placeholders in `Boilerplate.html` from a JSON object (HTML-escaped by default; `raw_` prefix for raw HTML). Accepts `--theme=<name>` to pick a theme from `Themes/`. Default: `anthropic`.
## References
- `References/Philosophy.md` — visual-first rules, anti-patte