Rendering Spec Docs

Rendering Spec & Plan Docs

Overview

Render a markdown design/spec/plan/notes document to self-contained, house-style HTML (Times body, Helvetica headings, warm accent palette, CSS inlined). One look across every doc the user reads.

Core rule: author Markdown, render with the script. NEVER hand-roll a pandoc command, and NEVER hand-write HTML or invent CSS. Ad-hoc invocations drift from the house style and can't be re-rendered consistently.

This is the general renderer. For PR review walkthroughs (a specific narrative structure), use pr-walkthrough instead — same house CSS.

How to render

Pick the first that applies:

# 1. Inside the munis_home repo (source of truth for the CSS):
./utilities/bash/render_spec.sh path/to/doc.md

# 2. Any other repo (portable, bundled with this skill — only needs pandoc):
~/.claude/skills/rendering-spec-docs/render-doc.sh path/to/doc.md
#   add --open to open it in the browser after rendering

Both write doc.html next to the source, inline the CSS (--embed-resources), and highlight code with pygments. Only dependency: pandoc (brew install pandoc).

Verify self-contained

rg -c '= 1
rg -c '` to css) | Use the script — it passes `--embed-resources`. |

## Keywords

render spec, render plan, design doc to html, view markdown in browser, house
style, review.css, pandoc, self-contained html, superpowers specs, superpowers
plans, brainstorm doc, handoff doc.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [LouLouLibs](https://github.com/LouLouLibs)
- **Source:** [LouLouLibs/claude-skills](https://github.com/LouLouLibs/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.