Back to Details

presentation-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Presentation Builder

演示文稿构建器

Use 
slides-grab
when the user needs a real slide deck artifact, not just an outline. The workflow is HTML-first: plan the deck, generate slide HTML, review visually, then export to PPTX/PDF.
当用户需要真实的演示文稿产物而非仅大纲时，使用
slides-grab
。工作流以HTML为优先：规划演示文稿、生成幻灯片HTML、可视化审核，然后导出为PPTX/PDF。

When to use this skill

何时使用该技能

  • Create a presentation from a topic, document, or brief
  • Iterate on slide design visually instead of editing raw PPT manually
  • Export approved decks to 
    .pptx
    or 
    .pdf
  • Maintain multi-deck workspaces under 
    decks/<deck-name>/
  • 基于主题、文档或简报创建演示文稿
  • 可视化迭代幻灯片设计，无需手动编辑原始PPT
  • 将审核通过的演示文稿导出为
    .pptx
    或
    .pdf
    格式
  • 在
    decks/<deck-name>/
    路径下维护多演示文稿工作区

Preflight

前置检查

Install and verify 
slides-grab
before authoring:
bash
git clone https://github.com/vkehfdl1/slides-grab.git
cd slides-grab
npm ci
npx playwright install chromium
npm exec -- slides-grab --help
Minimum requirement: 
Node.js >= 18
.
If 
slides-grab
is already available in the current project, reuse the existing install instead of cloning again.
在创作前先安装并验证
slides-grab
：
bash
git clone https://github.com/vkehfdl1/slides-grab.git
cd slides-grab
npm ci
npx playwright install chromium
npm exec -- slides-grab --help
最低要求：
Node.js >= 18
。
如果当前项目中已经安装了
slides-grab
，请复用现有安装，无需重复克隆。

Workflow

工作流

1. Plan the deck

1. 规划演示文稿

Collect:
  • presentation goal
  • audience
  • tone/style
  • target slide count
  • required source material
Create a concise outline, usually 
slide-outline.md
, with:
  • slide number
  • slide title
  • key message
  • required visuals/data
Do not move to slide generation until the outline is approved.
收集以下信息：
  • 演示目标
  • 受众
  • 语气/风格
  • 目标幻灯片数量
  • 所需素材
创建简洁的大纲，通常命名为
slide-outline.md
，包含以下内容：
  • 幻灯片编号
  • 幻灯片标题
  • 核心信息
  • 所需的视觉素材/数据
在大纲通过审核前，请勿进入幻灯片生成环节。

2. Generate slide HTML

2. 生成幻灯片HTML

Use a dedicated workspace such as 
decks/<deck-name>/
.
Create self-contained slide files:
text
decks/<deck-name>/
  slide-01-cover.html
  slide-02-problem.html
  slide-03-solution.html
  ...
Rules:
  • one primary idea per slide
  • keep HTML/CSS easy for agents to edit
  • inline only the assets/styles the deck actually needs
  • keep speaker notes or rationale outside slide body when possible
使用专用工作区，例如
decks/<deck-name>/
。
创建独立的幻灯片文件：
text
decks/<deck-name>/
  slide-01-cover.html
  slide-02-problem.html
  slide-03-solution.html
  ...
规则：
  • 每张幻灯片仅表达一个核心观点
  • 保持HTML/CSS足够简单，方便Agent编辑
  • 仅内联演示文稿实际需要的资源/样式
  • 尽可能将演讲者备注或设计逻辑放在幻灯片主体之外

3. Build and review

3. 构建与审核

After generating or editing slides:
bash
slides-grab build-viewer --slides-dir decks/<deck-name>
slides-grab validate --slides-dir decks/<deck-name>
For visual iteration:
bash
slides-grab edit --slides-dir decks/<deck-name>
Use the editor to select a region, request changes, and revise the corresponding HTML until the deck is approved.
生成或编辑幻灯片后：
bash
slides-grab build-viewer --slides-dir decks/<deck-name>
slides-grab validate --slides-dir decks/<deck-name>
如需可视化迭代：
bash
slides-grab edit --slides-dir decks/<deck-name>
使用编辑器选择区域、提交修改需求、修订对应的HTML，直到演示文稿通过审核。

4. Export artifacts

4. 导出产物

Only export after the design is approved.
bash
slides-grab convert --slides-dir decks/<deck-name> --output decks/<deck-name>.pptx
slides-grab pdf --slides-dir decks/<deck-name> --output decks/<deck-name>.pdf
Report:
  • output file paths
  • validation status
  • any slides that still need manual polish
仅在设计通过审核后再执行导出：
bash
slides-grab convert --slides-dir decks/<deck-name> --output decks/<deck-name>.pptx
slides-grab pdf --slides-dir decks/<deck-name> --output decks/<deck-name>.pdf
报告内容：
  • 输出文件路径
  • 验证状态
  • 所有仍需手动优化的幻灯片

Core commands

核心命令

bash
slides-grab edit
slides-grab build-viewer
slides-grab validate
slides-grab convert
slides-grab pdf
slides-grab list-templates
slides-grab list-themes
All commands support 
--slides-dir <path>
.
bash
slides-grab edit
slides-grab build-viewer
slides-grab validate
slides-grab convert
slides-grab pdf
slides-grab list-templates
slides-grab list-themes
所有命令都支持
--slides-dir <path>
参数。

Guardrails

使用规则

  • Follow the stage order: Plan -> Design -> Review -> Export
  • Do not export a deck the user has not approved
  • Fix source HTML/CSS when validation or conversion fails; do not patch exported binaries
  • Reuse the same deck directory through revisions to preserve stable iteration history
  • 遵循阶段顺序：规划 -> 设计 -> 审核 -> 导出
  • 不得导出用户未审核通过的演示文稿
  • 验证或转换失败时，请修复源HTML/CSS，不要修改导出的二进制文件
  • 修订过程中复用同一个演示文稿目录，以保留稳定的迭代历史

Example prompts

示例提示

text
Create an 8-slide enterprise product deck in decks/acme-launch.
Audience: IT buyers.
Tone: confident, clean, technical.
Need PPTX and PDF exports after approval.
text
Turn this product brief into a 10-slide investor deck.
Use slides-grab, show me the outline first, then generate the deck in decks/series-a.
text
Create an 8-slide enterprise product deck in decks/acme-launch.
Audience: IT buyers.
Tone: confident, clean, technical.
Need PPTX and PDF exports after approval.
text
Turn this product brief into a 10-slide investor deck.
Use slides-grab, show me the outline first, then generate the deck in decks/series-a.

References

参考资料

  • Source repo: 
    https://github.com/vkehfdl1/slides-grab
  • Key workflow from upstream: plan -> design -> visual edit -> export
  • 源仓库：
    https://github.com/vkehfdl1/slides-grab
  • 上游核心工作流：规划 -> 设计 -> 可视化编辑 -> 导出