Turn any plan, spec, decision doc, synth, or dataset into a polished,
self-contained single-page HTML artifact — styled in the Anthropic palette —
with one /html-kit command inside Claude Code.
Status: alpha (v0.x). The skill workflow is stable, but the daemon, index, and annotation surfaces are evolving. Paths, ports, and APIs may change between minor versions.
- One command, shareable output. You hand Claude Code your raw content; it
picks the right template, renders a single
.htmlfile with inline CSS / SVG / JS, and opens it. No external assets — paste it into Notion, email, a PR, or serve it as a link. - 30 battle-tested archetypes. Implementation plans, incident timelines,
PR reviews, explainers, dashboards, slide decks, triage boards, and more —
each one a vendored exemplar (MIT or Apache-2.0 per file — see
ATTRIBUTION.md) plus arecipe.mdthat tells the agent when to use it and how to adapt it. - Consistent house style. Every artifact uses the same Anthropic palette tokens and component vocabulary, so a folder of renders looks like one product, not fifteen ad-hoc pages.
- A read/write loop, not just one-shot output. A local daemon serves all
your artifacts at one URL with full-text search (Cmd+K), and an annotation
strip lets you accept / reject / comment / tag inline in the browser — then
/html-kit-drainfeeds your notes back to the agent for the next revision.
Prerequisites: Bun >= 1.1 and Claude Code.
| Install as… | Steps |
|---|---|
| Claude Code plugin (recommended) | /plugin marketplace add nyashkn/html-kit then /plugin install html-kit@html-kit. If you previously ran ./install.sh, run ./install.sh --uninstall first — otherwise each skill loads twice (once from the symlinks, once from the plugin). |
| Manual (dev / non-plugin) | git clone git@github.com:nyashkn/html-kit.git && cd html-kit && bun install && ./install.sh |
./install.sh symlinks the skills into ~/.agents/skills + ~/.claude/skills.
Restart Claude Code, then in any session:
/html-kit <paste or point at your source content> # manual install
/html-kit:html-kit <paste or point at your source content> # plugin install (namespaced)
The skill browses archetypes/, reads a few recipe.md files to choose the
best fit, studies the matching exemplar.html, and renders new HTML adapted to
your data — saved under .html-kit/NN_<topic>.html in the current repo (or
~/.html-kit/<project>/ outside a repo) and auto-opened.
To uninstall: ./install.sh --uninstall.
html-kit/
├── .claude-plugin/
│ ├── plugin.json # plugin manifest
│ └── marketplace.json # self-hosted marketplace (single plugin, source "./")
├── archetypes/<slug>/ # 30 battle-tested archetypes, one dir each
│ ├── exemplar.html # vendored exemplar, MIT or Apache-2.0 per file — see ATTRIBUTION.md
│ └── recipe.md # when to use, expected data shape, gotchas
├── patterns/<slug>.md # cross-archetype reusable fragments
│ ├── decision-box.md option-card.md swimlane-flow.md annotation-strip.md
├── tokens/anthropic-palette.css # shared CSS custom properties (palette + type)
├── assets/pagefind-overrides.css # Anthropic skin for the search modal
├── scripts/ # Bun helper scripts (see below)
├── skills/<name>/SKILL.md # the three Claude Code skills (see below)
├── tests/ # Playwright suite
├── install.sh # idempotent symlink installer (manual/dev install)
├── LICENSE ATTRIBUTION.md CHANGELOG.md
| Skill | Manual install | Plugin install (namespaced) | What it does |
|---|---|---|---|
html-kit |
/html-kit |
/html-kit:html-kit |
Router. Picks an archetype, learns its pattern, renders a new self-contained artifact, audits it, opens it. |
html-kit-add-to-patterns |
/html-kit-add-to-patterns |
/html-kit:html-kit-add-to-patterns |
Extracts a reusable cross-archetype pattern (CSS + HTML fragment + when-to-use) from a finished artifact and promotes it into patterns/. |
html-kit-drain |
/html-kit-drain |
/html-kit:html-kit-drain |
Reads pending browser annotations for the artifact in focus and acts on them inline (accept / reject / comment / tag). |
All three are auto-discovered. As a plugin, they're bundled from skills/.
For a manual install, install.sh symlinks them — drop a new directory
under skills/ with a SKILL.md and re-run the installer.
Requirements: Bun >= 1.1.
There is a small toolchain behind the skill — it's not pure-prompt:
resolve-out-path.ts— decides where an artifact is written (in-repo.html-kit/vs~/.html-kit/<project>/), with a first-use gitignore prompt.inject-palette.ts— emits the:root { … }token block to inline.render-audit.ts— fails a render that's missing palette tokens (unless it opts out with<meta name="html-kit:palette" content="custom">) or that references an external asset (CDN script/style/font/image) — artifacts must be self-contained.next-number.ts— assigns the nextNN_prefix.build-index.ts(bun run html-kit:index) — scans every registered repo's.html-kit/plus~/.html-kit/, runs Pagefind for full-text search, and renders a dense index page.html-kit-daemon.ts— singleton on port 63839 (Bun.serve). Serves the index, every registered artifact, the Pagefind bundle, the annotation API + SSE filewatch, and the auto-attached annotation strip.annotate-read.ts— cursor-paginated reader for the per-artifact annotation log (the engine behind/html-kit-drain).register-all.ts/discover-roots.ts— repo registration + discovery.
- Render an artifact with
/html-kit. - The daemon serves it with a Cmd+K search modal and an annotation strip on
[data-annotatable]components (accept / reject / comment / tag). Infile://mode (no daemon) annotations fall back tolocalStoragewith a "Copy annotations" JSONL button. /html-kit-drainreads your pending notes and routes them into the next revision.
bun run test # Playwright suite (tests/)
bun run test:headed # with a visible browser
bun run test:ui # Playwright UI modeSee CONTRIBUTING.md for the dev loop and how to add
an archetype.
- Per-archetype skills (
/html-kit:plan,/html-kit:incident, etc.) - CLI extraction so non-Claude consumers can render directly.
- Spec adapter — auto-render approved specs as
implementation-planartifacts.
MIT — see LICENSE.
The HTML exemplars are vendored, MIT or Apache-2.0 per file — see
ATTRIBUTION.md for the source repo, per-file license, and
provenance mapping.