home / skills / theonelee / theone_claude_skill / script_to_speech

script_to_speech skill

safe

/vlog_workflow/script_to_speech

This skill converts handwritten drafts into ready-to-read vlog scripts with PPT page mappings and timing guidance.

npx playbooks add skill theonelee/theone_claude_skill --skill script_to_speech

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

1.8 KB

---
name: vlog_script_to_speech
description: 将手写稿转换为适合朗读的口播稿
---

# Vlog Script to Speech Skill

将用户的手写稿转换为适合口播的演讲稿，包含 PPT 页码对应关系。

## 输入

- 手写稿文件路径（`draft.md`）
- 节目风格偏好（可选：轻松活泼 / 专业严肃 / 亲切自然，默认"亲切自然"）

## 执行步骤

1. 读取 `draft.md` 内容
2. 使用下方 Prompt 模板将手写稿转换为口播稿
3. 输出完整口播稿，保存为 `speech.md`
4. 告知用户朗读建议和预计时长

## Prompt 模板

读取 [prompt_template.md](references/prompt_template.md) 作为提示词模板，将 `{draft_content}` 替换为手写稿内容后，AI 直接生成口播稿。

## 口播稿规范

### 结构

```markdown
# {节目标题}

> 预计朗读时长: X 分钟

## 开场白
<!-- 对应 PPT 第 1 页 -->
（吸引观众注意力的开场）

## 第一部分：{章节标题}
<!-- 对应 PPT 第 2-4 页 -->

### [PPT 第 2 页]
（对应该页内容的口播文字）

### [PPT 第 3 页]
（对应该页内容的口播文字）

## 结尾语
<!-- 对应 PPT 最后一页 -->
（感谢观众、引导互动）
```

### 口语化要求

1. **自然表达**：使用日常口语，避免书面语的生硬感
2. **节奏感**：句子长度适中（10-25 字），有明确的停顿点（用 `...` 或 `,` 标记）
3. **互动性**：适当加入"你有没有想过..."、"大家可能会问..."等互动句
4. **语气词**：适当保留"其实"、"那么"、"对吧"等过渡词
5. **PPT 对应**：每段标注对应的 PPT 页码，方便录制时翻页

## 输出

- 口播稿文件：`~/vlog_projects/{project}/speech.md`
- 朗读建议（重点强调位置、情感处理等）
- 预计朗读时长（按每分钟 200 字估算）

Overview

This skill converts a handwritten draft into a spoken-friendly vlog script with clear PPT page mapping. It produces a structured speech file, estimated read time, and reading suggestions tailored to the chosen program style. The output is optimized for natural oral delivery and easy recording.

How this skill works

You provide a draft file path and an optional style preference (casual, professional, or warm). The skill reads the draft, applies a prompt template to rewrite content into a conversational speech script, and maps sections to specific PPT pages. It saves the final speech.md in the project folder and returns reading tips and an estimated duration based on 200 words per minute.

When to use it

Preparing a vlog or presentation from rough handwritten notes.
Converting a lecture draft into a recording-ready script.
Aligning talk segments with a slide deck for smooth recording.
Quickly producing a natural-sounding narration version of text.
Adapting content tone to a specific audience or show style.

Best practices

Keep the draft concise and organized by logical sections or slides.
Specify the desired style early (casual, professional, or warm) for tone consistency.
Mark major slide breaks in the draft if you want exact PPT mapping.
Review generated pauses and interjections; adjust to fit your speaking habit.
Use the provided read-time estimate to rehearse and trim content before recording.

Example use cases

Turn a brainstorming notebook into a 5-minute vlog script with slide cues.
Convert a workshop outline into a step-by-step spoken script for online teaching.
Rework a technical draft into a listener-friendly narration for a conference talk.
Generate a friendly product demo script aligned to each demo slide.
Produce call-to-action endings and interaction prompts for viewer engagement.

FAQ

What input formats are supported?

Provide a plain markdown or text draft file path; the skill reads the file content for conversion.

How is read time estimated?

Read time is calculated at 200 words per minute and included in the script header.