html-kit
Write HTML documents (reports, architecture diagrams, plans, triage boards) with agent-html-kit components instead of hand-written CSS and SVG, at close to markdown token cost. Use when the user wants a document they will open in the browser, or asks for HTML output, a visual report, a diagram or an interactive board.
leex279 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add leex279/agent-html-kit --skill html-kit技能说明
name: html-kit description: Write HTML documents (reports, architecture diagrams, plans, triage boards) with agent-html-kit components instead of hand-written CSS and SVG, at close to markdown token cost. Use when the user wants a document they will open in the browser, or asks for HTML output, a visual report, a diagram or an interactive board.
agent-html-kit
The kit (kit/kit.js) holds all the design. You only write content, so an HTML file
costs about as many tokens as markdown. If the folder you write into has no kit/kit.js,
copy the kit/ folder from this skill's directory next to the documents first; every
document loads it with one line.
Writing an HTML document
Start the file with exactly this line, then write only content:
Never write , other tags, style attributes, CSS or SVG. The kit draws everything.
Plain are styled. In any text: bold, code,
status pills [done] [progress] [blocked] [todo] [warn], and IDs like ABC-123 are formatted.
page hero one stat per line: value | label | note 23 | PRs merged | +5 vs last week (note starting + is green, ! is red) one point per line: Label: number (0 or more) Mon: 3 first line is the header, cells split by | ID | Item | Status CHK-1 | Apple Pay | [done] text one edge per line: A -> B: label Browser [user] -> API: HTTPS node kinds: [user] [svc] [db] [queue] [cache] [ext] numbered steps, one per line: Title | detail Parse input | reject bad rows drag-and-drop board with markdown export ID | title | column (optional, items start in Inbox) ...... side-by-side columns
Or write markdown and render it
When the reader is another agent or a repo, write markdown. To give a human the same
rendered page, use these extensions and run node kit/md2html.js file.md:
Write GitHub-flavored Markdown, no raw HTML. Our renderer adds:
- The first "# Title" becomes the page hero.
- A line "stats: value label | value label | ..." becomes stat cards.
- Status pills anywhere, including table cells: [done] [progress] [blocked] [todo] [warn].
- IDs like ABC-123 become chips.
- Blockquotes starting "Risk:", "Warning:", "Note:" or "OK:" become colored callouts.
- Fenced blocks by language: chart optional header lines "title: ...", "type: bar|line|hbar", "unit: ms", then "Label: number" lines diagram optional "title: ...", then one edge per line "A -> B: label"; node kinds [user] [svc] [db] [queue] [cache] [ext], e.g. "Browser [user] -> API: HTTPS" steps numbered steps, one per line "Title | detail" board "title: ...", "columns: Now,Next,Later,Cut", then "ID | title | column" lines; renders a drag-and-drop board with markdown export (items without a column start in Inbox)
Rules
- Use only the data you were given. The kit computes summaries (status bar, chart average, peak bar) itself; do not write them out.
- If you need something the kit does not have, write plain HTML for that one part and keep the rest in components.