explain-to-melisted

Produce a self-contained, richly styled HTML explainer for any topic the user asks about. Picks the right template from a bundled set of 22 visual patterns (feature explainer, concept explainer, module map, PR review, ADR, options paper / trade-off analysis, system diagram, flow- chart, status report, slide deck, prototype, editor, etc.), fills it with real content, augments with inline diagrams via sister skills (/fireworks-tech-graph for architecture / flow / sequence diagrams, /graphify for knowledge graphs), applies a Claude-brand polish layer, and publishes to here.now at a topic-slug URL so the link is shareable immediately. Local-only output is available with --local. Use when Stevie says "/explain-to-me", "explain-to-me X", "make me an explainer for X", "give me an HTML explainer", "render this as a webpage", "ADR for X", "options paper for X", or asks for a rich visual writeup. The skill picks the template, names the choice up-front, and reaches for diagrams whenever the content shape needs them.
stevengonsalvez/agents-in-a-box · ★ 10 · AI & Automation · score 73

Install: claude install-skill stevengonsalvez/agents-in-a-box

# /explain-to-me — rich HTML explainers ## What it does Takes a topic (a feature, a concept, a decision, a plan, an incident, …) and produces a single self-contained HTML file styled in Claude's brand, using whichever bundled template best fits the topic's shape. By default it then publishes the file via `/here-now` and returns the shareable URL. All 22 templates use Claude's palette (`#FAF9F5` ivory, `#141413` slate, `#D97757` clay, `#E3DACC` oat, `#788C5D` olive). The skill applies [`assets/claude-theme.css`](assets/claude-theme.css) on top for typography + brand badge. ## Trigger - `/explain-to-me <topic>` — primary - `/explain-to-me <topic> --local` — skip the here.now publish, just write the file - `/explain-to-me` (no args) — ask the user what to explain - Natural language: "explain X to me as a webpage", "make an HTML explainer for X", "render this concept as HTML", "ADR for choosing X", "options paper on Y", "give me a visual writeup of Z" ## Flow ### 1. Lock the topic and intent If `$ARGUMENTS` is non-empty, use it as the topic. Otherwise ask one question via `AskUserQuestion`: "What should I explain? One line." Then classify the topic against this table — this drives template choice. **Pick exactly one template; do not merge.** Templates are tagged **★** when they are visual-first (diagrams, charts, SVG flows). When two templates fit, prefer the **★** one unless the topic is intrinsically prose-heavy. | Topic shape | Template | Visual | |---|---|---|