← ClaudeAtlas

grill-with-docs-htmllisted

Grilling session that walks the design decision tree Socratically and exports it as a self-contained interactive HTML decision form. Use when the user wants a design interview or existing decisions exported as a reviewable HTML decision form; ordinary plan discussion does not require this export workflow.
cskwork/grill-with-docs-html · ★ 1 · Web & Frontend · score 74
Install: claude install-skill cskwork/grill-with-docs-html
<what-to-do> Run the grilling interview exactly as [`grill-with-docs`](../grill-with-docs/SKILL.md) does — Socratic, one question at a time, recommended answer each time, codebase exploration over speculation, inline `CONTEXT.md` / ADR updates as decisions crystallise. **Default add-on (this skill):** once the interview has produced 3+ structured decisions (typically D1.x / D2.x style grouped under candidates), export the full decision tree as a self-contained HTML form so the user can review the recommendations side-by-side, override any choice, write notes, and copy a final decision text back into chat. Order of operations: 1. Run the interview when needed (see `../grill-with-docs/SKILL.md`); use existing agreed decisions directly when the user requests export only. 2. As decisions land, keep a mental ledger of: candidate id, decision id, options, trade-offs, recommended option, the "why" reasoning, side effects. 3. Draft Before/After Mermaid diagrams for each candidate (current shape vs. deepened shape) — read `MERMAID-SAFE-SUBSET.md` before writing the first diagram. 4. **Validate every Mermaid block with mmdc BEFORE writing the HTML.** Read `VALIDATION.md` for the extract-and-render snippet and run it — an unrendered block shows the user a syntax error instead of a diagram. 5. Write the HTML using the template in `HTML-FORM.md` to `$TMPDIR/grill-decisions-<YYYYMMDD-HHMMSS>.html` (fallback `/tmp`), then open it (see **File location**). 6. Return the form for review. P