🎤 Claw Presenter — Prepare Presentation Narration

Converts PPT/PPTX/PDF files into a ready-to-present package: per-slide images + narration scripts.

What This Skill Does

Two jobs only:

1. 1. Split — Convert each slide/page into a PNG image
2. Script — Generate a narration script for each slide

Output is a folder that Claw Body can load for presentation playback with digital avatar narration.

Works With Claw Body

This skill is designed to pair with the claw-body skill (digital avatar). The workflow:

1. 1. Claw Presenter (this skill) → parses PPT/PDF, generates slide images + narration scripts
2. Claw Body → loads the output folder, displays slides with the digital avatar narrating each page

Typical usage:

1. 1. User: "帮我准备 xxx.pptx 的讲解稿" → triggers claw-presenter
2. After preparation is done, user: "讲解 presentations/xxx" → triggers claw-body presentation mode

⚠️ Make sure the claw-body skill is also installed if you want avatar-powered presentation playback.

When To Use

When user says anything like:

• - "帮我准备PPT讲解稿"
• "准备讲解 xxx.pptx"
• "帮我准备演讲稿"
• "生成PPT演讲词"
• "prepare presentation for xxx.pdf"
• "生成演讲词"
• "准备讲稿"

Do NOT use this skill when user just says "讲PPT" without preparation — that implies they want to present, and they should use Claw Body's presentation mode with an already-prepared folder.

Step 0: Get the File

If user didn't provide a file path, ask:

"请告诉我PPT/PDF文件的路径，例如 ~/Desktop/我的演讲.pptx"

Wait for user to provide the path before proceeding.

Step 1: Parse the File

Run the parse script to extract slides and text:

CODEBLOCK0

This creates:
CODEBLOCK1

Step 2: Generate Narration Scripts

After parsing, read presentation.json. For each slide:

• - If slide.script is already filled (from speaker notes) → keep it, but optionally polish
• If slide.script is empty → generate natural narration based on slide.title and INLINECODE4

Style Guidelines

Ask the user (if not specified):

• - 风格: 正式汇报 / 轻松分享 / 教学讲解 / 幽默风趣
• 受众: 老板/领导 / 同事 / 客户 / 学生
• 语言: 中文 / English / 跟随原文
• 时长: 简短（每页15-30秒）/ 标准（30-60秒）/ 详细（1-2分钟）

Writing Good Narration

• - Open naturally: "首先我们来看..." / "接下来..."
• Don't just read the slide — explain, add context, connect to previous slide
• Keep transitions smooth between slides
• Match the style throughout

Step 3: Save the Scripts

After generating all scripts, update presentation.json — fill in the script field for each slide, then write back:

CODEBLOCK2

Step 4: Confirm with User

Show a summary:

📊 演讲稿准备完成！

• - 文件: xxx.pptx
• 共 12 页，其中 3 页使用了原始备注，9 页已生成演讲词
• 风格: 轻松分享
• 输出目录: presentations/xxx/

你可以：

• - 预览/修改某页的演讲词
• 在 Claw Body 中说"讲解 presentations/xxx" 开始演讲
• 或直接在这里文字预览

Output Format

INLINECODE7 structure:
CODEBLOCK3

Setup

Run the setup script to install all dependencies:

CODEBLOCK4

Or install manually:

Python Packages

CODEBLOCK5

System Dependencies

poppler (required — converts PDF to images):

LibreOffice (optional — high-fidelity PPTX→image conversion):

Without LibreOffice, PPTX slides will fall back to simple text rendering (lower quality images).

Verify Installation

CODEBLOCK6