Skip to content
Skills Library
Documents & office · Building & coding

html-deck-kit

/html-deck-kit

按“HTML Deck Kit”v2.0 严格规范制作交付级 HTML 演讲稿(1600×900 单文件、逐字稿、精讲/完整两档、模型卡、70% 版面规则、6 套主题、筛片台与逐页修改意见)。当用户要做或改 HTML 演讲稿、课件、培训/分享 slides,或提到 deck-kit、演讲稿规范、换主题时使用。

Licence
MIT
Last repository change
03.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

按“HTML Deck Kit”v2.0 严格规范制作交付级 HTML 演讲稿(1600×900 单文件、逐字稿、精讲/完整两档、模型卡、70% 版面规则、6 套主题、筛片台与逐页修改意见)。当用户要做或改 HTML 演讲稿、课件、培训/分享 slides,或提到 deck-kit、演讲稿规范、换主题时使用。

Triggers from the description

HTML Deck Kit
Original author description

按“HTML Deck Kit”v2.0 严格规范制作交付级 HTML 演讲稿(1600×900 单文件、逐字稿、精讲/完整两档、模型卡、70% 版面规则、6 套主题、筛片台与逐页修改意见)。当用户要做或改 HTML 演讲稿、课件、培训/分享 slides,或提到 deck-kit、演讲稿规范、换主题时使用。

How it works

  1. 0. 先读这些(按需)
  2. 1. 工作流程(按顺序执行)
  3. 2. 不可违反的 11 条(摘要,完整见 01-spec)
  4. 3. 输出给用户时
Original SKILL.md headings · 50 lines, 281 words
SKILL.md preview
---
name: html-deck-kit
description: 按“HTML Deck Kit”v2.0 严格规范制作交付级 HTML 演讲稿(1600×900 单文件、逐字稿、精讲/完整两档、模型卡、70% 版面规则、6 套主题、筛片台与逐页修改意见)。当用户要做或改 HTML 演讲稿、课件、培训/分享 slides,或提到 deck-kit、演讲稿规范、换主题时使用。
---

# HTML Deck Kit · 演讲稿规范 Skill

把任何主题的讲稿,做成一个**可直接交付**的单文件 HTML 演讲稿:能演示、能看逐字稿、能切精讲 / 完整、能换主题、投到大屏也看得清。

## 0. 先读这些(按需)

| 文件 | 什么时候读 |
|---|---|
| `references/01-spec.md` | **每次必读**。严格规范:文件、版面、字号、页面结构、展示方式、写作、案例、篇幅、封面 |
| `references/02-components.md` | 选页面模板和组件时 |
| `references/03-themes.md` | 选主题 / 新增主题时 |
| `references/04-interaction.md` | 写讲稿、做交互、说明快捷键时 |
| `references/05-checklist.md` | 交付前逐项检查 |
| `references/06-prompts.md` | 用户要在 Codex / WorkBuddy / 飞书等工具里使用时 |
| `references/07-icons.md` | 需要图标时(只用线性图标) |
| `CHANGELOG.md` | 想知道 v2.0 改了什么 |
| `template/deck-template.html` | 母版。所有页面从这里的示例页复制 |

## 1. 工作流程(按顺序执行)

1. **确认 4 件事**(缺了就问,一次问完):主题与受众;时长(决定精讲页数,约 1.5–2 分钟 / 页);默认主题(warm / mono / void / lunar / linen / stellar,未指定用 warm);素材(讲稿、PPT、截图、数据)。
2. **先出大纲,不先写页面**:按“开场 → 总分总全课地图 → 各章(章节页 + 内容页)→ 收尾”列出逐页表:页号、id、标题、模板代号、档位(c/f/x)、展示方式(一次性 / 弹出 n / 交互)。精讲页数默认 40–50。
3. **复制母版**:`template/deck-template.html` → 新文件。删除示例页,保留引擎、样式、脚本不动。设置 `<html data-theme="…">`。
4. **逐页制作**:从示例页复制对应模板;遵守 01-spec 的 P1–P6、W1–W6、C1–C5。用到模型的页必须有 `.mdl`;模型第一次出现时在其后加一张模型卡(`data-tier="x"`)。
5. **写讲稿**:每页 `aside.notes`,段数 = `.step` 数 + 1;口语、带标记(【转场】【点题】……)。
5b. **视觉克制**:标题重点词用 `<mark>`(每页最多一个);不用大面积实心深色块;图标只用 `07-icons.md` 的线性图标;截图用 T14 编号批注;章节 ≥ 5 步时每章开头放 T13 定位页。给制作者的提醒写进 `<p class="ed">`。
6. **检查**:运行 `python3 tools/check_layout.py 文件.html`(默认字号)和 `--zoom 1.3`(最大字号)。有 `OVER` 就拆页、精简或加 `data-czmax`。再按 `05-checklist.md` 逐项打勾。
7. **交付**:一个 HTML 文件(图片 base64 内嵌)。告诉用户快捷键:→ 翻页、S 讲稿、G 目录、**O 筛片台**、**E 修改本页**、T 主题、V 精讲 / 完整、+ / − 字号、L 安全线。
8. **修改闭环**:用户贴来“修改汇总”(`【第 N 页 · 页面id】标题` + 意见)时,按页面 id 定位,只改列出的页,id 不变;改完再跑第 6 步。

## 2. 不可违反的 11 条(摘要,完整见 01-spec)

1. 单文件 HTML,1600×900 画布,不改引擎 CSS / JS。
2. 正文与结论行全部在 **y ≤ 630px**(70% 规则);结论行紧跟正文。
3. 页面标题 46px、眉标 17px 固定;正文 ≥ 18px,次要文字 ≥ 15px。
4. 每页有 `id / data-title / data-key / data-sec-time / aside.notes`,讲稿段数 = 步数 + 1;`id` 唯一,确定后不改(筛片台与修改意见按 id 保存)。
5. 默认一次性展示;只有“先问后答 / 层层深挖 / 案例拆解”才逐步弹出,每页 ≤ 4 步。
6. 用到模型的页面必须列出模型名 + 一句白话;模型卡只讲一次,默认隐藏。
7. 概念用三段式:一句话 / 生活例子 / 怎么用。
8. 数字、引语照抄并写出处;模拟数据、示意点位、教学解读写在页脚 `.cav`“说明”。
9. 不放视频;不用品牌标志与官方产品图;颜色只用 `var(--token)`。
10. 必须有“总—分—总”全课地图页,步骤卡下方列出所用模型。
11. 保留母版左下角署名 `#tplcredit`(Template by Gavin © 2026):不删除、不改字、不放大;它默认暗淡,鼠标移上才加亮。

## 3. 输出给用户时

- 先给文件,再用 3–5 行说明:页数(精讲 / 完整)、默认主题、需要用户补的素材。
- 有模拟或未核实内容时,明确告诉用户在哪几页。
Files in this package (5)
  • .gitignore 1 KB
  • CHANGELOG.md 3 KB
  • LICENSE 1 KB
  • README.md 11 KB
  • SKILL.md 5 KB

Versions

The database has no other skills named html-deck-kit.

Database snapshot: 13.11.2026 · package version 795e60ee0e7d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100html-deck-builder
    Build professional HTML slide presentations as single self-contained files with keyboard navigation, speaker notes, and progress tracking. Use when asked to 'build a presentation', 'create a slide deck', 'make slides', 'build a deck', 'presentation about X', 'create a…
  • 95html-ppt
    HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a…
  • 100html-ppt
    HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a…
  • 100html-ppt
    HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a…
  • 100html-ppt
    HTML PPT Studio — author professional static HTML presentations in many styles, layouts, and animations, all driven by templates. Use when the user asks for a presentation, PPT, slides, keynote, deck, slideshow, "幻灯片", "演讲稿", "做一份 PPT", "做一份 slides", a reveal-style HTML deck, a…
  • 100html-presentation
    Converts documents, outlines, or notes into self-contained HTML slide decks with horizontal (Reveal.js) or vertical scroll navigation and multiple themes. Triggers on: "create a presentation", "slide deck", "pitch deck", "HTML presentation", "web-based slides", "reveal.js deck",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.