Skip to content
nyashknPublic

About

Reusable HTML artifact patterns for Claude Code (Anthropic-palette archetypes)

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

html-kit

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.

Why use this

  • One command, shareable output. You hand Claude Code your raw content; it picks the right template, renders a single .html file 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 a recipe.md that 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-drain feeds your notes back to the agent for the next revision.

Quick start

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.

What's in here

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

Skills

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.

Scripts (Bun)

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 next NN_ 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.

The annotation loop (v0.4.x)

  1. Render an artifact with /html-kit.
  2. The daemon serves it with a Cmd+K search modal and an annotation strip on [data-annotatable] components (accept / reject / comment / tag). In file:// mode (no daemon) annotations fall back to localStorage with a "Copy annotations" JSONL button.
  3. /html-kit-drain reads your pending notes and routes them into the next revision.

Tests

bun run test            # Playwright suite (tests/)
bun run test:headed     # with a visible browser
bun run test:ui         # Playwright UI mode

See CONTRIBUTING.md for the dev loop and how to add an archetype.

Roadmap

  • 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-plan artifacts.

License & attribution

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.

About

Reusable HTML artifact patterns for Claude Code (Anthropic-palette archetypes)

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages