Skip to content
Back to search

html-ppt-yufei

SkillWorks with Claude CodeGitHub

Use when building a 16:9 HTML presentation from a PPT template or brand kit, an outline, notes, screenshots, or pasted content. The focus is presentation craft — narrative, theme, layout rhythm, and a self-contained viewer with thumbnail rail, overview, presenter mode, and PDF export. Triggers include "HTML PPT", "网页版 PPT", "HTML 幻灯片", "PPT 模板", "大纲做成 PPT", "outline to slides", "重新设计版式", "缩略图侧栏", "演讲者模式".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yufei616--html-ppt-yufei/badge.svg)](/listings/yufei616--html-ppt-yufei)

HTML

<a href="/listings/yufei616--html-ppt-yufei"><img src="/api/listings/yufei616--html-ppt-yufei/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 134 lines
  1. ---
  2. name: html-ppt-yufei
  3. description: Use when building a 16:9 HTML presentation from a PPT template or brand kit, an outline, notes, screenshots, or pasted content. The focus is presentation craft — narrative, theme, layout rhythm, and a self-contained viewer with thumbnail rail, overview, presenter mode, and PDF export. Triggers include "HTML PPT", "网页版 PPT", "HTML 幻灯片", "PPT 模板", "大纲做成 PPT", "outline to slides", "重新设计版式", "缩略图侧栏", "演讲者模式".
  4. ---
  5. # HTML PPT — Presentation First
  6. Build the **presentation**, not a file converter. The output is always a single-file 16:9 HTML deck with a polished viewer. Content comes from the user — a template, an outline, notes, screenshots, or pasted copy — and the work is narrative, theme, layout, and interaction.
  7. The viewer shell in `assets/deck-template.html` is part of the deliverable — never regress its navigation, thumbnail rail, overview, presenter mode, or print behavior.
  8. ## Input modes
  9. | Input | Content | Theme |
  10. | --- | --- | --- |
  11. | PPT template / brand kit | Author content to fit the template's story | Keep the template's colors, type, and identity |
  12. | Outline / notes / Markdown | Structure into a narrative first; confirm the outline | Use the brand if given, otherwise propose 2–3 palettes |
  13. | Screenshots / existing HTML / PDF | Reconstruct the content; do not copy the layout | Derive from the reference or propose |
  14. | Pasted copy / raw content | Edit into slide-sized messages | Propose or use the brand |
  15. | Just a topic | Draft an outline, confirm, then build | Propose |
  16. Ask only for what is missing. Never wait for a file when the user already supplied the content.
  17. ## Workflow
  18. 1. **Clarify the frame.** Content source, audience, page count, language, and whether a theme/brand exists. If already supplied, proceed without re-asking.
  19. 2. **Shape the content.** Turn an outline or notes into a slide-by-slide plan: one title + one key message per page. Confirm the plan before designing.
  20. 3. **Decide the theme source.**
  21. - Template/brand provided: use it, including its type identity.
  22. - No theme: choose a restrained palette and type pairing. Pick a tasteful default rather than asking a dozen questions.
  23. 4. **Plan the rhythm.** Assign a different composition to each page before writing HTML. Use the layout recipes below; never mirror a reference deck's grids.
  24. 5. **Build.** Copy `assets/deck-template.html`, replace the `<section class="slide">` bodies, keep the viewer CSS + script intact. Update `data-page` and footer numbers when the count changes; the counter adapts automatically. Thumbnails are generated from the DOM — no screenshots.
  25. 6. **Verify.** Walk the checklist in `references/viewer-spec.md`: single-page display, click/wheel/keyboard/touch, rail hover preview, overview, fullscreen, print PDF, no overflow.
  26. 7. **Deliver.** Give the HTML path, page count, and controls. If content was authored from an outline, deliver the slide-by-slide outline alongside.
  27. ## Presentation craft
  28. The deck is judged on how it presents, not on how much content it carries.
  29. - One idea per page; the title states the takeaway, not a category.
  30. - Build a narrative arc: context → tension → solution → proof → next step. See `references/presentation-craft.md`.
  31. - Vary density: a hero statement, a diagram, a comparison, a data page, a quiet quote.
  32. - Vary composition: at least 4 layout types in a 6–10 page deck.
  33. - Prefer diagrams, timelines, big numbers, and annotated mockups over bullet walls.
  34. - Body copy 11–13 px at 1280×720; if it needs 9 px, the slide is doing too much.
  35. - Dark full-bleed pages are a rhythm tool — roughly ⅓ of pages or fewer.
  36. - Keep one accent color for emphasis; everything else is ink and muted neutrals.
  37. ## Hard rules
  38. - 16:9, **one slide per HTML page**, 1280×720 base, scaled to fit the window.
  39. - Single HTML file, offline, system font stack, no CDN.
  40. - Preserve the user's facts, numbers, quotes, and attribution. Do not invent evidence.
  41. - When a template/brand is provided, keep its colors and type identity.
  42. - **Never mirror the reference layout.** A template's 2×2 cards / three columns are not a design.
  43. - One visual focus per page; clipped text is a failure.
  44. - Dark pages are not the default.
  45. - Mark any invented example metrics or UI data as `示意` / `UI Preview`.
  46. - Sanitize company names and internal data before putting a demo in a public repo.
  47. ## Theme tokens
  48. Define once in `:root`, whatever the source:
  49. ```css
  50. --bg:#FAFAF7; /* page background */
  51. --panel:#F5F1E8; /* light panel */
  52. --ink:#1A1A1A; /* primary text */
  53. --muted:#6B6B6B; /* secondary text */
  54. --line:#E5E0D4; /* hairlines */
  55. --gold:#B8924C; /* accent */
  56. ```
  57. Use a serif (Georgia) for large numerals and an editorial sans for Chinese copy. See `references/design-system.md` for palette choices, spacing, type scale, and layout recipes.
  58. ## Viewer contract — do not regress
  59. | Feature | Required behavior |
  60. | --- | --- |
  61. | Display | One slide at a time; no vertical stack; centered and scaled |
  62. | Pagination | Click anywhere → next; wheel down/up → next/prev with a ~520 ms lock; keyboard arrows/space/PageUp/PageDown/Home/End; touch swipe |
  63. | Controls | Round prev/next buttons, dots + `01 / 06`, fullscreen (`F`), overview (`O`) |
  64. | Thumbnail rail | Left, one column, only in windowed (non-presenter) mode; real rendered miniatures; current page highlighted; hover shows a larger preview to the right; click jumps |
  65. | Overview | Grid of all pages (3/2/1 columns by viewport), click to open, `O` / `Esc` to leave; wheel scrolls the grid, never flips pages |
  66. | Presenter mode | Fullscreen hides the rail, preview, and deck chrome; `Esc`/browser exits |
  67. | Print | `13.333in × 7.5in` pages, one slide per page, all slides visible, chrome hidden, transforms reset |
  68. | Performance | ≤ 0.2 s fade only; no `backdrop-filter` blur; no large moving shadows; honor `prefers-reduced-motion` |
  69. Details and math: `references/viewer-spec.md`.
  70. ## Layout recipes
  71. | Page intent | Composition |
  72. | --- | --- |
  73. | Pain / problem | Massive pull quote + numbered ledger; tools as small chips |
  74. | Workflow | Dark full-bleed journey map; alternating nodes above/below an axis; gate labels; dashed feedback loop |
  75. | Product solution | Bento grid: product mock in a window frame + feature ledger + two comparison cards + roadmap cells |
  76. | Chaotic source material | Tilted file-card collage + oversized outlined numerals |
  77. | Pipeline | Five-step rail with outlined numerals + dark capability base |
  78. | KPI / impact | Hero number card (dark) + bars/blocks/ring for supporting metrics |
  79. | Comparison | Side-by-side cards, never a plain table |
  80. | Template showcase | Follow the template's composition rules, but keep the page rhythm varied |
  81. Five or six different recipes per deck is normal. Repeat only for an intentional series.
  82. ## Common mistakes
  83. | Mistake | Fix |
  84. | --- | --- |
  85. | Waiting for a PPT file when an outline already exists | Build from the outline |
  86. | Treating a template as a layout to copy | Borrow the theme, redesign each page |
  87. | Chasing content fidelity and forgetting the presentation | Spend the effort on hierarchy, pacing, and layout |
  88. | Rebuilding the reference deck's grid | Choose a new composition per page first |
  89. | Theme colors eyeballed | Use the provided brand tokens or a defined default palette |
  90. | Text clipped at 720 px | Budget header/body/footer heights before writing |
  91. | Rail overlays slide | Reserve 160 px left padding and subtract it in the fit math |
  92. | Wheel over the rail flips pages | Ignore wheel events inside `.rail`, `.preview`, `.deck-ui` |
  93. | Overview click advances twice | Stop propagation on thumbnail clicks |
  94. | Animating a full-screen blur | Use a short opacity fade only |
  95. | Print includes controls | Force all frames visible, hide `.deck-ui`, `.rail`, `.preview` |
  96. ## Files
  97. ```
  98. html-ppt-yufei/
  99. ├── SKILL.md
  100. ├── README.md
  101. ├── assets/deck-template.html # working 6-page deck; copy and rewrite slide bodies
  102. ├── references/design-system.md # palette, type, spacing, layout recipes
  103. ├── references/presentation-craft.md # narrative, pacing, slide roles
  104. └── references/viewer-spec.md # interaction + print + performance spec
  105. ```
  106. Read the references before building. Start from the template; do not rebuild the viewer from scratch.
README.md · README · 119 lines
  1. # HTML PPT Yufei — Presentation First
  2. 把 **PPT 模板、大纲、笔记、截图或零散内容**做成 16:9 的 HTML 演示文稿。
  3. 重点在「呈现」:叙事结构、主题气质、版式节奏和演示交互。输入可以是一套模板、一段大纲、一份笔记,甚至只是一个主题。
  4. - 单页显示,16:9 等比缩放
  5. - 单击 / 滚轮 / 键盘 / 触屏翻页
  6. - 左侧缩略图栏:真实页面缩略图、悬浮放大预览、点击跳转
  7. - 总览模式:全部页面网格,点击进入
  8. - 演讲者全屏模式(自动隐藏侧栏与控件)
  9. - 打印导出为 13.333in × 7.5in 的 PDF,一页一张
  10. - 纯静态单文件,离线可用,无 CDN
  11. ## 快速开始
  12. 把整个目录复制到你的 skills 目录:
  13. ```bash
  14. # Claude Code
  15. git clone https://github.com/Yufei616/html-ppt-yufei.git ~/.claude/skills/html-ppt-yufei
  16. # opencode
  17. git clone https://github.com/Yufei616/html-ppt-yufei.git ~/.config/opencode/skills/html-ppt-yufei
  18. ```
  19. > 如果你已经装过同名的 `html-ppt-yufei` skill,请先备份或移除旧版,否则会冲突。
  20. 然后直接说需求,例如:
  21. > 用 html-ppt-yufei 把这份大纲做成 8 页 HTML 演示,偏编辑设计风。
  22. > 用 html-ppt-yufei 按这套 PPT 模板做一份产品发布演示,保留模板的主题色和字体。
  23. > 用 html-ppt-yufei 按这份产品笔记做 6 页演示,偏深色技术风。
  24. Skill 会先确认输入类型和主题来源,再规划叙事与页面节奏,最后基于 `assets/deck-template.html` 生成单文件 HTML。
  25. ## 手动使用模板
  26. 直接用浏览器打开:
  27. ```bash
  28. open assets/deck-template.html
  29. ```
  30. 模板本身是一份 6 页示例(ACME 虚构数据),可以直接:
  31. 1. 修改 `:root` 中的主题 token
  32. 2. 替换每个 `<section class="slide">` 里的内容
  33. 3. 保留 `.frame`、`.deck-ui`、缩略图脚本、打印样式
  34. ## 功能与快捷键
  35. | 操作 | 行为 |
  36. | --- | --- |
  37. | 单击页面 | 下一页 |
  38. | 滚轮下 / 上 | 下一页 / 上一页 |
  39. | `← → ↑ ↓` / 空格 / PageUp / PageDown | 翻页 |
  40. | `Home` / `End` | 首页 / 末页 |
  41. | `F` | 全屏(演讲者模式) |
  42. | `O` | 所有页面总览 |
  43. | `Esc` | 退出总览 / 全屏 |
  44. | 触屏左右滑 | 翻页 |
  45. 缩略图栏:
  46. - 只在普通窗口显示,全屏、总览、打印时自动隐藏
  47. - 悬浮缩略图 → 右侧放大预览
  48. - 点击 → 跳转
  49. - 在侧栏上滚轮只滚动缩略图,不翻页
  50. - 窗口宽度 < 980px 自动隐藏
  51. ## 输入类型
  52. | 输入 | 内容来源 | 主题来源 |
  53. | --- | --- | --- |
  54. | PPT 模板 / 品牌 | 按模板写内容 | 沿用模板 |
  55. | 大纲 / 笔记 / Markdown | 先结构化为逐页大纲 | 推荐 2–3 套配色,或使用品牌色 |
  56. | 截图 / 现有网页 / PDF | 重建内容 | 参考提炼或推荐 |
  57. | 只有一个主题 | 先起草大纲 | 推荐 |
  58. ## 目录
  59. ```
  60. html-ppt-yufei/
  61. ├── SKILL.md # 技能主文件
  62. ├── assets/deck-template.html # 可运行的 6 页模板
  63. ├── references/
  64. │ ├── design-system.md # 主题来源、字号、版式配方
  65. │ ├── presentation-craft.md # 叙事、节奏、页面角色
  66. │ └── viewer-spec.md # 交互、缩略图、总览、打印、性能
  67. ```
  68. ## 设计原则
  69. - **输入不限,呈现优先**:PPT 模板、大纲、笔记、截图都可以是起点
  70. - 主题来源优先级:模板 / 品牌 > 视觉参考 > 默认方案
  71. - 先定叙事,再定版式;每页一个 takeaway
  72. - 每页一个视觉重心,整份 deck 至少 4 种不同版式
  73. - 深色整版页用来调节节奏,不超过约 1/3
  74. - 内容不改事实;自拟数据标注 `UI Preview · 示意界面`
  75. - 单文件、离线、系统字体
  76. 详细规范见 `references/design-system.md`、`references/presentation-craft.md` 和 `references/viewer-spec.md`。
  77. ## 自定义
  78. 常见调整位置:
  79. - 主题色:`assets/deck-template.html` 顶部 `:root`
  80. - 侧栏宽度:`.rail`、`.thumb`、`body.rail-on .stage`,以及 `fit()` 中的 `160`
  81. - 放大预览尺寸:`.preview` 与 `fit()/openPreview()` 中的 `472 / 265.5`
  82. - 翻页防抖:`wheelTimer` 的 `520`
  83. - 打印尺寸:`@media print` 中的 `@page`
  84. ## License
  85. MIT © 2026 Yufei616. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.