Use when you need to turn a long markdown report, design doc, research writeup, or blueprint into a polished, shareable single-file HTML onepager - light Linear/Notion style, card grid + tables + collapsible details l…
---
name: html-report
description: Use when you need to turn a long markdown report, design doc, research writeup, or blueprint into a polished, shareable single-file HTML onepager — light Linear/Notion style, card grid + tables + collapsible details library + top filter chips, no external CSS/JS. Triggers like "make an HTML version", "a web page I can show", "a browser-friendly report", "visualize this doc".
---
# html-report
Render a long markdown report into a single, self-contained HTML onepager that a
reader can actually skim. The job is not to dump markdown into `<p>` tags — it's
to give the content *structure*: a scannable hero, card grids and tables for the
substance, and a collapsible, filterable appendix for the long tail. Light theme
by default, no framework dependency, one `.html` file you can open or host.
## When to use
- A markdown report/design doc/blueprint that's too long to read top-to-bottom and
you want a presentable web view.
- Content with many sub-items (failure modes, findings, checklist entries) that
needs to be browsable, not an endless wall of text.
- Anything you'd "send someone a link to" rather than paste raw markdown.
**When *not* to use:** a short note (just send the markdown); something that needs
live data or interactivity beyond filtering (build a real app); a slide deck.
## Core principles… install to load the full skill