Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.
Overview
https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0 _** The diagram was made by Fable 5, I will create more fable 5 artifacts and add them to the skill folder for smaller models to distill._ example demo Focused skills for generating self-contained HTML deliverables with a strong visual bias: - html: an HTML file for whatever you're describing, in the effective HTML style - html-diagram: architecture, stack, and systems understanding rendered as full-screen HTML diagrams with high-quality SVG - html-plan: HTML plan pages in the effective HTML style Render and annotate your HTML with Plannotator (optional): https://github.com/backnotprop/plannotator This repo is also a plugin marketplace. Add it and install: Create instant share links for your HTML files (optional): https://github.com/plannotator/tot HTML from video: https://tot.
README
Effective HTML
Focused agent skills for creating useful, self-contained HTML artifacts, from low-fidelity wireframes to working interactive prototypes.
Fat artifacts + fat context
Modern models can do a lot. Give them plenty of useful references and use artifacts to show what you mean. HTML can visualize almost anything, often more clearly than a wall of text. Your prompt can simply point to the artifacts, repositories, and folders that carry the context.
[!NOTE] You can use this repo without installing anything. Treat it as a reference first and an installable skill collection second. See the Effective HTML guide.
https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0
Render and annotate local HTML with Plannotator.
Skill references
The repo includes eight optional skills for pragmatic visual artifacts.
| Skill | Use it for |
|---|---|
html |
Broad HTML requests, mixed artifacts, reports, explainers, presentations, landing pages, tools, and routing to a specialist |
big-pics-little-words |
Explain the current subject in HTML with large visuals and minimal text while preserving key details; copied from bro |
one-pager |
Make a one-pager: one HTML page that shares an idea with teammates early, or recaps work for them, with big pictures and little words; copied from bro |
design-artifact |
Subject-specific creative direction for any HTML artifact without imposing a reusable house style |
html-wireframe |
Low-fidelity layout directions that test content, hierarchy, navigation, flows, and responsive structure |
html-prototype |
Working prototypes with realistic states, interaction, keyboard support, and responsive behavior |
html-plan |
Plans, roadmaps, rollouts, and implementation sequences that preserve source commitments |
html-diagram |
Architecture, sequence, process, state, hierarchy, timeline, and system diagrams |
Practical guide: HTML Wireframes and Prototypes for Coding Agents.
Install
Install the collection when you want these references available to your agent as reusable workflows:
npx skills add plannotator/effective-html
List or install individual skills:
npx skills add plannotator/effective-html --list
npx skills add plannotator/effective-html --skill big-pics-little-words
npx skills add plannotator/effective-html --skill one-pager
npx skills add plannotator/effective-html --skill design-artifact
npx skills add plannotator/effective-html --skill html-wireframe
npx skills add plannotator/effective-html --skill html-prototype
Claude Code plugin
/plugin marketplace add plannotator/effective-html
/plugin install plannotator-effective-html@effective-html
Codex plugin
codex plugin marketplace add plannotator/effective-html
codex plugin add plannotator-effective-html@effective-html
How the skills work
The skills separate creative freedom from reliability:
- Visual direction comes from the conversation, project, audience, and subject.
design-artifactprovides a reusable design process without prescribing a reusable look.- Wireframes stay intentionally unfinished so reviewers focus on structure.
- Prototypes implement one credible flow and its relevant states.
- Plans preserve source commitments.
- Diagrams choose a visual model and rendering method that fit the relationship being explained.
- Every artifact is responsive, accessible, self-contained, and verified in a browser.
Detailed guidance lives only where it is needed. The broad html skill routes the work, design-artifact supplies optional creative direction, and specialist skills own fidelity and behavior. Each skill remains independently usable.
This project was inspired by Thariq Shihipar’s The unreasonable effectiveness of HTML.
Create a shareable link for an HTML file with tot.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add plannotator/effective-html