Intel / post

Using Claude Code: The Unreasonable Effectiveness of HTML

Source: x.com
Author: Thariq
Date: Indexed May 9, 2026

Context

Thariq describes using HTML to make work with Anthropic's Claude Code more interactive. His article proposes small, task-specific pages where a person can adjust a design or edit structured information, then export those choices as text to send back to the .

The export completes the feedback loop. A visual editor helps someone choose values that are awkward to describe in prose; a copy button turns the choice into explicit input for the next coding step. Thariq presents this as his preferred working method and acknowledges a tradeoff: generated HTML can make version-control changes noisier to review than Markdown.

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

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.”

Read the source x.com