effective-html README

项目的 README,来自 github.com/plannotator/effective-html。合并为一个 markdown 文件:README.md。

Effective HTML by Plannotator — HTML wireframes, mockups, prototypes, charts, and diagrams

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

Star Plannotator on GitHub

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:

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.

Share HTML with tot

Create a shareable link for an HTML file with tot.

effective-html (plannotator/effective-html)

正在搜索数据库…

这是什么?一组 agent skill,用来教 Claude Code 或 Codex 生成实用、自包含的 HTML 成果物:低保真线框图、可交互的原型、计划和图表。
这是框架、库,还是只是提示词?都不是。它包含八个可选的 skill,也就是可复用的编码 agent 工作流说明,以插件形式安装。你也可以把这个仓库当作普通参考资料来读。
怎么把它跑起来?以 Claude Code 或 Codex 插件的形式安装整个集合,或列出并安装单个 skill。具体命令在 README 的安装部分。如果只是把它当参考资料阅读,不需要安装任何东西。
它支持哪些编码 agent?Claude Code 和 Codex,各自通过自己的插件使用。
输出的会是可直接上线的界面吗?不是现成可用的。线框图本来就是故意做得不完整的,原型则是实现一条可信的流程以及相关状态,而不是完整的产品。
我能不借助 agent,只把这些 skill 当参考资料用吗?可以。README 说,你可以先把这个仓库当参考资料阅读,只有当你想把 skill 当作可复用的工作流来使用时,再去安装它们。
作者为什么要做这个?灵感来自 Thariq Shihipar 的文章《The unreasonable effectiveness of HTML》。核心理念是「胖成果物 + 胖上下文」:给模型提供足够多的参考资料,并用 HTML 把你的意思直接展示出来。
哪个 skill 用来制作计划和图表?html-plan 用于制作路线图、发布计划和实施步骤,并保留源文件中的承诺事项。html-diagram 用于绘制架构图、时序图、状态图、时间线以及其他系统图表。
有没有用于快速制作视觉讲解的 skill?有。big-pics-little-words 用大图和少量文字讲解一个主题;one-pager 则制作一个单页 HTML,用于尽早分享想法或回顾工作成果。
每个成果物都会在浏览器里检查吗?README 说,每个成果物都是响应式的、可访问的、自包含的,并且都会在浏览器中验证,因此这些 skill 的设计目标是在交付之前先检查自己的输出。
大小
19.7 MB
星标
4.2K
更新
提交Oct 31
时长
5个月
提交 · 90 天