Skip to main content
skill CX Codex

article-to-html — Claude Code skill: what it does, how to install

article-to-html turns Markdown or a document from the conversation into one self-contained HTML file. Use it for a static article page, not slides or a backend.

MIT 220 installs ★ 635 updated 2026-09-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add agentara/skills --skill article-to-html -a claude-code
Open on GitHub

What article-to-html does

This skill takes a Markdown file or a document from the conversation and renders it as a self-contained HTML page. Its paper-like structure includes a serif reading layer, monospace metadata, numbered sections, a TL;DR block, tables, callouts, and figure captions.

The output keeps CSS, SVG, and JavaScript inside one file. Figures use inline SVG, while optional behavior can add section toggles, code copying, or table filtering when the document calls for it. The workflow uses references/template.html, references/components.md, and the related figure or interaction references.

A backend, slide deck, or multi-page site falls outside its scope because the skill targets a single static HTML file.

What it helps with

  • turn Markdown into a single-page HTML document
  • render article sections with tables and callouts
  • draw figures as inline SVG
  • keep styles and scripts inside one output file

Example prompts for the agent

  • Turn this Markdown into one self-contained HTML file with a paper-style layout.
  • Render the document from this conversation with numbered sections, a table, and callouts.
  • Create a web version of this text and use inline SVG for any needed diagrams.

How to install article-to-html

1Skills CLI (Vercel)

npx skills add agentara/skills --skill article-to-html -a claude-code

2Manually: put the files in place

~/.claude/skills/article-to-html/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/article-to-html/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about article-to-html

How do I install article-to-html in Claude Code?

Run npx skills add agentara/skills --skill article-to-html -a claude-code, then check ~/.claude/skills/article-to-html/SKILL.md.

What does article-to-html do?

It renders Markdown or a document from the conversation as a self-contained HTML file with article styling, tables, callouts, and inline SVG.

What can article-to-html not handle?

It targets one static HTML file. Slides, backend work, and multi-page sites are outside its scope.

Source text

SKILL.md · MIT
---
name: article-to-html
description: Render a markdown draft / any document in the conversation context into a single-file "paper proposal" HTML — serif body, monospace meta, numbered sections, inline SVG figures, callouts, tables, optional interactive elements. Trigger when the user says "turn this into HTML / render as a web page / make a pretty HTML / give me a single-page doc / generate article HTML / paper-style HTML / convert to article html / render this as a doc html" or similar, and wants a **static single file** rather than Figma/PDF/PPT. Also fires when the user pastes some markdown and says "beautify this / typeset this / give me a web version". Do NOT trigger when the user wants slides, needs a backend, or needs a multi-page site.
---

# article-to-html

Turn a document (from conversation context or a given markdown file) into a **self-contained HTML file**, reusing the "paper proposal" design system defined in `references/template.html`: serif body + monospace meta + numbered sections + inline SVG figures + callouts + tables + optional JS interactivity.

## Flow after trigger

1. **Get the source.** If the user gave a file path, `Read` it. If the draft is in conversation context, use that directly.
2. **Extract document skeleton.** Title, subtitle, TL;DR, section list, whether figures are needed, whether tables are needed, whether interactivity is needed.
3. **Read the template.** `Read` `references/template.html` and use its full CSS + structure as the scaffold.
4. **Read the component reference.** `Read` `references/components.md` and pick out the snippets you need this round.
5. **If figures are needed:** consult `references/svg-figures.md` and draw with inline SVG (no external image references — keep the file portable).
6. **If interactivity is needed:** consult `references/interactive.md` and append a `<script>` block before `</body>`.
7. **Output.** `Write` to `{same dir as source or current working dir}/{slug}.html`. Filename = English slug of the title, or whatever the user specified.
8. **Report.** One sentence with the file path + a one-line command to open it in a browser.

## Design invariants (do NOT break)

- **Single file.** All CSS / SVG / JS inline. No external fonts, no CDNs, no remote images.
- **Don't change the `paper` palette.** `--paper: #f7f7f5` + `--ink: #1a1a1a` is this skill's visual signature. If the user explicitly asks for a different mood (dark mode, different accent), you can change `--accent` / `--warn`, but keep paper/ink.
- **Serif body + monospace meta.** `body` uses `ui-serif`; every "metadata slot" (`.doc-eyebrow / .doc-meta / th / code / figcaption / .num`) uses `ui-monospace`. This mix is the signature.
- **Section numbering prefix.** `<h2><span class="num">01</span>Section title</h2>` — small monospace, faint gray, 14px gap to the title. Add it even if the source has no numbers.
- **Figures need figcaption.** `<figcaption><span class="fig-num">FIG 1</span>caption text</figcaption>`, the `FIG N` in accent color.
- **TL;DR always on top.** If the source has no TL;DR, condense the first one or two paragraphs into a ~60-word summary and put it there.
- **No "generated by AI" footer watermark** unless the user explicitly asks.

## Component cheat sheet

| If the source contains... | Use... |
|---|---|
| Intro / abstract | `.tldr` block |
| Quotation | `.callout.cite` (with `.cite-source`) |
| Warning / heads-up | `.callout.warn` |
| Generic sidenote | `.callout` (default, white background) |
| Three parallel concepts / roles | `.cards` (three-column cards) |
| N parallel concepts | `.cards cols-2` / `cols-4` |
| Comparison / vendor matrix | `<table>` |
| Flow / architecture / timing / bar chart | inline SVG figure — see `references/svg-figures.md` |
| Open-questions list | `<ol>` with bold lead phrase per item |
| Reference links | `<footer>` containing a `<ul>` |

## Interactive elements (optional)

The template is static by default. Add interactivity **proactively** when the document clearly benefits:

- Section collapse / expand (long documents)
- "Copy" button on code blocks
- Table filter / sort (great for vendor comparison tables)
- Dark mode toggle (persisted to localStorage)
- TOC + scrollspy
- Forms (e.g. for an RFC / decision doc, a "vote / leave comment" form persisted to localStorage)

Specific snippets in `references/interactive.md`. **Default to none** unless (a) the doc is long — ≥3 sections + ≥2 figures, or (b) the source is interaction-shaped (tutorial, decision doc, vendor selection).

## Naming and output location

- Filename: English slug of the title, lowercase, hyphenated, ≤40 chars. For Chinese titles, use pinyin or a translated keyword hint, e.g. 《新基建提案》→ `infra-proposal.html`.
- Output location:
  - If the user gave a source markdown path, output in the **same directory**.
  - Otherwise output in the **current working directory**.
  - If the user specifies a path, honor it.
- If a file with the same name exists, append `-v2` / `-v3`. **Never silently overwrite** the user's existing output.

## Common mistakes

- **Recoloring the CSS.** Don't touch paper/ink/accent unless the user said "different palette please". Visual consistency is the entire point.
- **Switching body to sans-serif.** The whole "proposal paper" feel hinges on the serif body. Changing fonts breaks the look.
- **Using emoji as icons.** The character vocabulary of this skill is uppercase monospace labels + small color blocks (`.mascot` / `.layer-icon`). No emoji unless the user explicitly asks.
- **External `<img src="https://...">`.** Kills portability. Either inline SVG, base64, or omit.
- **Missing figcaption numbers.** The `FIG 1 / FIG 2 / FIG 3` running labels are key to the "academic paper" feel.
- **Callout on every paragraph.** Callouts highlight one or two passages, not decorate. Keep total callouts ≤ 5 per document.
- **Cramming 5 items into the three-column cards.** Switch to `repeat(N, 1fr)` (or use the `.cols-N` modifier), don't force wrap.
- **Leaking domain-specific names from the example.** The template is blank; if the source doesn't mention Crewlet / Anthropic / etc., the HTML shouldn't either.

## File manifest

- `references/template.html` — blank scaffold (full CSS + placeholder structure). Start here.
- `references/components.md` — cut-and-paste HTML snippets for every component.
- `references/svg-figures.md` — five typical SVG figure skeletons (architecture, timing, bar comparison, stacked layers, lifecycle).
- `references/interactive.md` — JS snippets (collapse, copy, table filter/sort, TOC, dark mode, form → localStorage, reading progress, figure zoom).
- `assets/example.html` — a completed reference render (the original Chinese article.html kept as a visual benchmark).

© agentara · MIT · agentara/skills

Similar skills

All skills for Writing and docs →

From the same set20

The whole set →
video-plan video-plan turns rough concepts into timed, scene-by-scene plans for short videos, vlogs, and social clips. It splits footage into 4-15 second cuts and sets a visual tone. CX Codex +1 321installs lab-interpreter lab-interpreter is a Claude Code skill that reads lab reports and explains abnormal results in plain language when you upload test results. CX Codex +1 284installs video-poster-design video-poster-design creates cinematic poster concepts and final images from a brief, storyboard, or project context. Useful for key art, teaser posters, and video campaigns. CX Codex +1 271installs presentation-design presentation-design creates a 6-slide presentation storyboard as a single 3:2 composite image. Useful for concept validation and pitch deck visuals via image generation models. CX Codex +1 250installs doctor-strange doctor-strange runs multi-branch causal scenario simulations using subagents and records synthetic projections into persistent assistant memory. CX Codex +1 212installs mega-goal-prompt mega-goal-prompt interviews you step by step to build a structured /goal mega prompt for autonomous tasks in Claude Code or Codex CLI. CX Codex +1 195installs soviet-storybook-grotesque soviet-storybook-grotesque transforms photos into strange retro storybook drawings with shaky ink lines, faded watercolor, and nonsensical English rhymes. CX Codex +1 190installs feature-dev-loop feature-dev-loop orchestrates multi-step feature development: planning, subagent reviews, TDD execution, and HTML acceptance reports. CX Codex +1 187installs

Project sponsors

Companies that keep this analytics open