[!IMPORTANT] PRE-REQUISITE DIRECTIVE FOR THE AGENT: Before generating any HTML codebase or design, you MUST read and check references/matching-your-style.md first. Use it to resolve the visual source of truth, apply the fallback tokens when no stronger source exists, and avoid AI-default visual traps. Its prose measure applies to reading columns, not to the whole page shell, diagrams, comparisons, decks, or editors. Additionally, if the workspace contains related reference documents, read them to align visual parameters.

HTML Artifacts Plus

Markdown is the default agent output, but for many substantial deliverables it flattens the shape of the work. HTML can show comparisons side by side, render real diagrams, make hierarchy visible, add interaction, and give the user a shareable file they are more likely to read.

This skill is based on dogum/html-artifacts and keeps its core idea: choose HTML only when the format helps. The personal addition is a Level 2 document-bound editor mode: when the user wants to edit an existing source document or config through an HTML tool, generate a self-contained editor that exports a reviewable patch. The HTML never writes files directly; the agent applies the exported patch after the user sends it back.

When to reach for HTML

Reach for HTML when any of the following is true: