plannotator /effective-html
Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.
★ 4,229⑂ 293👁 15⑃ 31● 4▤ 0
4,229
stars
293
forks
15
watchers
31
prs
4
issues
0
releases
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:
bash
npx skills add plannotator/effective-html
List or install individual skills:
bash
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
text
/plugin marketplace add plannotator/effective-html
/plugin install plannotator-effective-html@effective-html
Codex plugin
bash
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,