HTML Skill for Claude Code & Cursor

A single agent skill that teaches your AI tool to produce a self-contained .html file instead of a markdown wall — when the underlying content has shape. Comparisons, plans, post-mortems, code reviews, triage boards, sortable tables, decks: each becomes a small, disposable HTML artifact you’d actually read.

Based on Thariq Shihipar’s The unreasonable effectiveness of HTML — the observation that markdown flattens information that is inherently spatial, comparative, or interactive, and a small HTML file fixes this.

Installation

npx skills add julianoczkowski/html

The interactive CLI walks you through scope (global vs project) and which agents to target. A few things to know as you click through:

• Universal agents (Cursor, Codex, GitHub Copilot, and 12+ others) are always included; Claude Code lives under “Additional agents” and must be toggled on explicitly with the spacebar.
• When the CLI asks whether to copy files or symlink them, pick copy. Symlinks work for some agents and silently break for others (Claude Code among them on macOS).

Manual install

The skill lives in skills/html/ inside this repo. Copy just that folder:

# Personal (available across all projects)
git clone https://github.com/julianoczkowski/html /tmp/html-skill-src
cp -r /tmp/html-skill-src/skills/html ~/.claude/skills/html
rm -rf /tmp/html-skill-src

# Project-scoped (checked into the repo)
mkdir -p .claude/skills
git clone https://github.com/julianoczkowski/html /tmp/html-skill-src