Communitygithub.com

旁白脚本

为教程或演示撰写口语化旁白——针对听觉优化措辞,按照每个操作对应一句指令的方式同步画面内容,配合节奏预算,语气自信且经专业术语筛查。当有人说“帮我写个教程旁白”时使用。

旁白脚本 是什么?

该技能专注于为技术教程或产品演示生成高质量的旁白脚本。其核心价值在于将书面语言转化为适合听觉的口语,确保每句旁白都与屏幕上的具体操作精准同步,从而最大化学习效率。它遵循三大原则:为耳而写(短句、主动语态、去掉“只是”这类打击用户的词)、同步动作(指令在操作发生前或同步说出)、控制节奏(目标语速140-160词/分钟)。技能还提供了可靠的三段式步骤结构(目标-行动-确认),并建议使用两栏表格(屏幕动作/旁白内容)输出,便于编辑和配音演员使用。该技能适用于任何需要录制教程旁白的场景,支持Claude Code、Cursor等AI编程助手,通过严格的写作规则和输出格式确保脚本的专业性和可用性。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SkillMedev/tutorial-video-studio/tree/main/skills/narration-script

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

旁白脚本 是做什么的?

一个教程的成败取决于旁白。观众正在边听边尝试操作,所以每个词都在与屏幕上的注意力竞争。写得少一点,说得明白一点,把每句话都钉在一个可见的操作上。

为耳而写,不为纸面

口语不是书面语。在保留每句话之前,先大声读一遍。

  • 短句。每句一个意思。如果你一口气读不完,说明句子太长了。
  • 主动语态、现在时、第二人称:说“点击保存”——而不是“保存按钮随后会被用户点击”。
  • 砍掉所有“基本上”、“简单来说”和“只需”。“只需点击设置”会悄悄告诉卡住的观众他们很笨。去掉它。
  • 缩略形式很好(像“你会”、“它是”);听起来更有人情味。

同步旁白与动作

黄金法则:每个屏幕动作对应一句指令,且话语与动作同时发生,绝不描述已经发生的事情。

  • 在动作即将发生或恰好发生时说出指令,让观众的手和光标一起移动。
  • 绝不要叙述已经完成的点击——在保存动画结束后说“现在我们保存好了”就是死气沉沉。
  • 当屏幕上有复杂变化时,停止说话,让它自然呈现。清晰的视觉效果配上静默,胜过拼凑的旁白。

控制节奏

  • 指令部分目标语速约为每分钟140-160词。太快会失去跟随操作的观众。
  • 根据分镜的每个场景时长来规划脚本。如果一个节拍是8秒,那就大约20个词,而不是50个。
  • 在转场和观众需要看而不是听的时刻,刻意加入停顿。

构建每一步

每一步都采用可靠的三段式结构,让观众始终有方向感:

  1. 目标——我们要做什么以及为什么这么做(“为了分享这个,我们将创建一个公开链接。”)。
  2. 操作——单一具体的指令(“打开分享菜单,选择任何拥有链接的人。”)。
  3. 确认——成功的样子(“当你看到链接变绿,就说明它准备好了。”)。

用轻巧的过渡词为步骤间做标记——“接下来”、“既然链接已经存在,我们……”——让教程的主线始终能被听到。

语调

自信而温暖,像一位坐在旁边、能力出众的同事。绝不居高临下,绝不夸张。第一次出现术语时定义它,然后一致地使用。与屏幕上的 UI 标签完全匹配——如果按钮上写着“新项目”,就说“新项目”,不要说“创建一个项目”。

输出格式

以两栏脚本的形式交付,让编辑和配音演员都能轻松理解:

屏幕动作旁白内容
光标打开分享菜单“打开右上角的分享菜单。”
链接切换为公开“把它切换为任何拥有链接的人。”

在视觉应该承载内容的地方标记 [暂停],并用粗体标注需要强调的词。如果知道分镜的时长,请为每行标注大致的时序。

不要做

  • 不要在这里写音乐、音效或混合提示——音频节奏、闪避和节拍匹配属于音效与音乐同步的范畴。
  • 不要规划场景顺序或镜头列表——那是视频分镜的工作,本脚本应遵循它。
  • 不要描述观众已经能看到的填充内容(“这是屏幕,如你所见,上面有一些按钮”)。
  • 不要让一句台词超出其场景的时长预算;删减词语,而不是停顿。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Captions From Transcript

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video

Kinetic Typography

Put text in motion the right way - title cards, animated captions, lower-thirds, callouts, and word-by-word reveals - with a reading-time-per-word budget so copy holds long enough to read, plus enter/exit timing, weight and size transitions, and type hierarchy in motion. Use when someone asks to

Motion Design Principles

The craft layer for motion: pick the right easing (ease-in / ease-out / ease-in-out / spring), get timing and spacing right, build the anticipation→action→follow-through arc, and apply Disney

Product Demo Director

Direct the craft of putting a real software UI on screen - cursor choreography, zoom/pan/callout language, screen-recording vs recreated-UI, and making state changes legible with highlights, focus pulls, and slow-downs. Use when filming or recreating an app for a product demo, feature walkthrough, onboarding clip, or release reel and asking

Remotion Compose

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says

Remotion Render

Renders a Remotion composition to MP4 and runs the edit-and-re-render loop - CLI render commands, 1080p/4K/9:16 presets, concurrency tuning, codec selection, batch variants from a JSON data file, and Lambda for cloud rendering. Use when someone says

Remotion Setup

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just

Screencast Capture

Capture clean raw screen and camera footage for a tutorial or product demo - choosing the recorder (macOS Screenshot toolbar, QuickTime, OBS, Windows Game Bar), setting resolution / frame-rate / cursor / microphone, prepping a distraction-free stage, and recording in retakeable segments. Use when someone says

SkillMedev/tutorial-video-studio

Plan a product demo, feature announcement, or launch video as a beat sheet and shot list BEFORE animating - hook in the first 3s, problem, reveal, proof, CTA - with target duration and pacing per scene type, output as a JSON scene plan that remotion-compose consumes directly. Use when someone says

Social Video Formatter

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says

Sound and Music Sync

Score a video like an editor: beat-match cuts to the music, land SFX on transitions, pace the voiceover so it breathes, source royalty-free tracks safely, and duck the music so the VO sits clearly on top. Use when adding music, sound effects, or voiceover to a video, when asked to

相关技能