Using Claude Code: The Unreasonable Effectiveness of HTML
Source
Thariq
Author
Thariq
Date
Key takeaways · AI-distilled
The practical argument for HTML is readership. The author stops reading his own markdown past about 100 lines and cannot get colleagues to read it at all, so a spec's chance of actually being read is the thing HTML improves.
Sharing is the mechanical difference. Browsers do not render .md natively, so markdown travels as an attachment; an HTML file uploaded anywhere becomes a link a colleague opens on any device.
When you deny the model a visual format, it improvises badly: ASCII diagrams, and in one case approximating colors with unicode characters. The output format is a constraint on what the model can tell you.
The author explicitly warns against packaging this as an /html agent skillA reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.Full definition →. Just ask for 'an HTML file' — the skill worth building is knowing what you want the artifact to do, and that only comes from prompting it from scratch a few times.
Terms in this piece · Glossary
AI agent — An AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.
agent skill — A reusable instruction file that teaches an agent how to do one job well — the procedure, the tools, and what counts as done.
Why it matters
Thariq's argument to make HTML, not Markdown, your AI agentAn AI system that doesn't just answer once but works toward a goal in a loop — taking actions, reading the results, and deciding what to do next.Full definition →'s default output — because tables, SVG, CSS, and interactivity beat plain text once an agent is generating real artifacts. A small default change with outsized effect on what your agent can produce.
Key quotes
“I would go so far as to say that there is almost no set of information that Claude can read that you cannot fairly efficiently represent with HTML.”
“The chance of someone actually reading your spec, report or PR writeup is much much higher if it’s in HTML.”
“Making HTML documents with Claude is just more fun and makes me feel more involved and invested in the creation, and that by itself is enough.”
“I’m a little bit afraid that people will read this article and turn it into a /html skill or something.”
