htmlify
stdout, made permanent.
Agent answers become self-contained HTML documents and presentation decks — one file you can open, print, annotate, and keep.
Coding agents answer in walls of markdown. When the answer has shape — a comparison, an architecture, a timeline, a review — that wall flattens it. htmlify is a skill family that makes agents ship designed, self-contained HTML instead: operator briefs, PR review packets, incident timelines, decision briefs, explainers, interactive boards, and full presentation decks with speaker notes. Zero dependencies, zero build step, one auditable file.
See it live: the gallery — every artifact there was generated by these skills, about this repository.
What's in the box
| Piece | What it is |
|---|
skills/htmlify | Document skill — 10 modes: operator-brief, build-plan, implementation-map, pr-review-packet, release-brief, incident-report, decision-brief, status-report, explainer, prototype/editor |
skills/deckify | Deck skill — 6 modes: talk-deck, workshop-deck, essay-deck, demo-deck, launch-deck, teaching-guide; speaker notes, run-of-show, downloadable guide/PDF |
htmlify-answer CLI | Pipe any text into a designed artifact; validate any artifact against the rich/app/deck safety profiles |
| Pi / OMP extension | /htmlify commands, render modes, browser annotation layer |
| Claude Code plugin | One-command install of both skills, optional long-answer Stop hook |
| Hardcopy | The design system every artifact ships in — engineering-plate language: warm paper, ink hairlines, serif display, mono metadata, one signal-orange accent |
Install
| Agent | Install |
|---|
| Claude Code | /plugin marketplace add zakelfassi/htmlify then /plugin install htmlify@htmlify |
| Codex | git clone https://github.com/zakelfassi/htmlify.git ~/.htmlify && ln -sfn ~/.htmlify/skills/htmlify ~/.codex/skills/htmlify && ln -sfn ~/.htmlify/skills/deckify ~/.codex/skills/deckify |
| Cursor / Windsurf | Clone the repo, point a project rule at skills/htmlify/SKILL.md / skills/deckify/SKILL.md |
| Aider / anything | printf '%s' "$ANSWER" | npx -y @zakelfassi/htmlify htmlify-answer --title "Review" |
| Pi / Oh-My-Pi | pi install npm:@zakelfassi/htmlify |
Per-agent recipes, project rules, and hook setup: agent-integrations.md.
How it works
- Evidence first. The skill reads the repo, git state, PRs, CI, and logs before designing anything; unverifiable claims are stamped
needs verification.
- One HTML file. Inline CSS+JS in the Hardcopy design language. No CDNs, no fonts, no analytics, no build.
- Prove it. The bundled validator gates the output — then it opens in your browser.
npx -y @zakelfassi/htmlify htmlify-answer --validate artifact.html --profile auto
| Profile | Rules |
|---|
rich | No scripts at all — for model-generated documents |
app | Inline scripts allowed (editors, boards); external scripts, on*= handlers, javascript: URLs still banned |
deck | app plus the deck contract: ≥2 slides, keyboard nav, speaker notes on substantive slides, print CSS |
auto | Detected per file from the document shape |
Exit codes: 0 valid · 1 validation errors · 2 usage/IO. Add --format json for agent consumption.
Artifact modes
