Communitygithub.com

短视频脚本-短格式

为Reels、Shorts、TikTok生成逐节拍脚本:包含口播台词、屏幕文字和镜头描述,并提供三个A/B测试钩子和每个平台的标题。根据受众认知水平选择原型(发现、权威、培育、转化/广告、见证),适用于任何品牌,品牌资料一次填写即可。包括26种钩子公式、钩子检查器、测试Reels和无需摄像头的旁白+动态图形Reels。

短视频脚本-短格式 是什么?

该技能是一个专业工具,用于为短视频平台(如Instagram Reels、YouTube Shorts、TikTok)创建高度结构化和数据驱动的脚本。其核心原则是避免一刀切的通用视频:它首先根据Eugene Schwartz的经典模型确定受众的认知阶段(从无意识到最了解),然后根据此目标和观众准备程度选择合适的原型(发现、权威、培育、转化/广告、见证)。每个原型都链接到一个专门的、可执行的“剧本”,该剧本定义了脚本的激进程度、典型的行动号召和推荐平台(有机与广告)。基础是所有脚本通用的“留存引擎”,它强制执行像在行动中间开始、保持屏幕文字简洁、几乎每一秒改变镜头以保持注意力等规则。该技能还包括一个Python验证器,用于客观评估钩子并检查常见脚本问题,如长节拍或缺乏闭环。它在Claude Code和类似AI代理平台上运行,使用本地文件系统来维护品牌资料、剧本和参考文件。用户可以通过自然语言命令(如“脚本”、“钩子”或“测试Reels”)激活该技能,并指定他们需要一个完整的脚本、一个特定部分(如钩子)或仅一个结构。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mrchinocontact-star/guion-video-corto-skill/tree/HEAD/skills/guion-video-corto

在你喜欢的 AI 中提问

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

文档

短视频脚本

基于原型和认知水平的短视频脚本

此技能并非编写“通用视频”。首先确定该素材需要什么类型的视频,即其意图和观众的认知水平。然后加载相应的剧本,并将其构建在一个所有类型共享的留存引擎之上。外部数据被视为假设。真正有价值的是账户自身的数据。

交付物: 逐节拍脚本(口播 + 屏幕文字 + 镜头描述)+ 每个平台的标题 + 所使用的原型和认知水平。不生成视频:视频需单独录制或编辑。


1. 核心支柱:认知水平(Eugene Schwartz)

这决定了脚本可以有多激进。这不是风格问题:它取决于观众是谁。

  1. 无意识: 不知道自身存在问题。
  2. 意识到问题: 感受到痛苦,但不知道有解决方案。
  3. 意识到解决方案: 知道存在解决方案,但不知道你的方案。
  4. 意识到产品: 知道你,但尚未信服。
  5. 最了解: 已准备就绪,只需报价。

黄金法则: 只有对已经“热”的观众(级别4-5)才激进。对“冷”观众(级别1-2)强硬收尾会吓跑他们。这就是为什么有机发现视频不做销售,而重定向广告直接给出报价。


2. 首要指标

分配决策由早期留存决定,而非观看次数。按此顺序查看:

  1. 3秒留存率,即钩子之后继续观看的人数百分比。这是钩子的评分。
  2. 平均观看时长,以了解视频中间部分是否保持了注意力。
  3. 分享量/覆盖人数(分享÷覆盖人数),可以获得的最强信号。
  4. 非粉丝覆盖人数,以了解视频是否传播开来。
  5. 粉丝数/覆盖人数,以了解个人资料是否将注意力转化为关注。

无神奇数字。 像“70% 3秒留存率”这样的目标在网上流传,没有可验证的来源:仅将其作为假设。真正的参考是账户自身的中位数。 一个视频超过该中位数3倍是一个信号。低于1.5倍则是普通一天。

可节省数月诊断时间:

  • 有观看量但无粉丝的视频是账号资料问题,而非钩子问题。
  • 无观看量的视频是钩子问题。

在重写任何内容之前,先区分这两种情况。


3. 路由器

确定素材属于哪个原型并加载其剧本。如果用户未说明,请询问或根据目标推断。

原型认知水平脚本任务激进程度典型CTA渠道剧本
发现无意识 → 问题让你被发现零销售关注/保存有机playbooks/descubrimiento.md
权威问题 → 解决方案让你被信任温和关注/评论有机playbooks/autoridad.md
培育解决方案 → 产品让你被偏好中等关键词 → 私信有机 + 温和重定向playbooks/nutricion.md
转化/广告产品 → 最了解让你立刻选择高/直接预约/购买/申请广告(重定向)playbooks/cierre-ads.md
见证考虑 → 转化验证报价温和-中等关键词 → 私信有机 + 广告playbooks/testimonio.md

每个素材有一个主导意图。如果用户想要“一鱼多吃”,请将它们分成不同的素材。


4. 工作流程

  1. 品牌 → 资料。 如果perfiles/<marca>.md存在,加载它。否则,使用perfiles/plantilla-marca.md并在聊天中请求最低限度的上下文。切勿编造品牌数据。
  2. 原型 → 剧本。 使用第3节的路由器并阅读相应的剧本。它包含结构、钩子角度、激进程度和CTA。
  3. 通用引擎。 阅读references/motor_hooks_retencion.md和references/formulas_hooks.md。选择3种不同的公式,而不是同一公式的三个版本。对于每个公式,分别编写口播台词和屏幕文字。
  4. 通过验证器。 如果有终端,运行scripts/guion_check.py(第8节)并修正每个警告。如果没有终端,手动应用相同的规则。
  5. 构建脚本,使用剧本的结构和引擎。每个节拍一个想法,带有链式开放循环。
  6. 平台。 根据references/plataformas.md调整剪辑。不要在所有的网络平台上发布相同的剪辑。
  7. 标题 + CTA,针对所需平台,CTA由剧本和资料指定。
  8. 大声朗读。 一旦有人说出,就能察觉“书面化”的台词。重写所有听起来不像人说话的内容。

如果用户只需要钩子,或只需要结构,提供那部分即可。


5. 留存引擎(总结)

基础骨架,每个剧本都对其进行调整:钩子(0-3秒)→ 张力 → 带有迷你循环的价值节拍 → 证据 → 回报 → CTA。 详情见references/motor_hooks_retencion.md。

适用于所有意图的规则:

  • 从行动中间或回报开始。不要有“你好,在这个视频中……”。
  • 不要在开头放置Logo或品牌。
  • 第一帧承诺视频所交付的内容。
  • 每几秒进行剪辑或变化,如果视频超过30秒,在中间位置添加一个重新钩子。
  • 始终使用字幕:视频必须在无声音的情况下也能理解。
  • 屏幕文字是独立的脚本。
    • 每张卡片最多6个单词,钩子卡片出现在第一帧。
    • 尊重1080×1920的安全区域:不要超过y=230或低于y=1440,右侧230像素保持空白。在每个平台的预览中检查。
  • 在每个节拍处更换镜头。 一个固定的8秒镜头是观众流失的地方。
  • 一个视频一个想法。 如果脚本有两个想法,那就是两个视频:请明确说明。
  • 数字优于形容词。 如果缺少真实数字,保留{{你的数字}}并通知用户。切勿虚构。
  • 见证和案例 仅在真实且获得使用许可的情况下使用。
  • 每个素材一种语言: 口播、屏幕文字和标题使用同一种语言。

受监管的领域(健康、金融、法律等)

  • 不能承诺品牌无法证实的结果或声明。
  • 在付费投放的素材中,不要提及观众的個人属性,例如“你超重了吗?”或“你有债务吗?”。谈论服务和结果。
  • 前后对比仅当真实、获得同意且平台允许时使用。

6. 品牌资料

品牌不改变引擎:仅为其进行外表定制。

  • perfiles/plantilla-marca.md 是一个空白模板。每个品牌填写一次并保存为perfiles/<marca>.md。
  • 如果未指定素材的品牌,在编写前询问。
  • 缺失的内容(价格、期限、保证、数据)用[COMPLETAR]标记并通知用户。

7. 交付格式

| # | 时间 | 口播内容(旁白) | 屏幕文字 | 视觉/镜头 |
  • 3种钩子变体 放在上方,用于A/B测试。
  • 每个平台的标题 放在下方。第一行较短,带有好奇心,在「…更多」之前。
  • 标签 放在末尾:原型 + 认知水平 + 平台。

8. 验证器(scripts/guion_check.py)

用Python 3编写,无依赖,支持西班牙语和英语。

python scripts/guion_check.py hooks.txt                       # 每行一个钩子 → 0–100分排名
python scripts/guion_check.py --hook "我发现了一个错误。"
python scripts/guion_check.py guion.txt --beats --objetivo 30 --ppm 160   # 每行一个节拍

执行五项钩子检查:

  • 时长: 在3秒或更短时间内说出。
  • 具体性: 包含数字、名称或期限。
  • 风险: 提及成本、损失或错误。
  • 前置信息: 重要内容放在前几个词。
  • 说话对象: 使用你/您或提及特定受众。

低于50分则还不是钩子。

使用--beats检查完整脚本并标记:

  • 超过3.5秒的钩子;
  • 超过4.5秒的节拍;
  • 三个连续的节拍没有具体内容;
  • 缺乏闭环,当最后一行未回扣钩子中的任何词语。

不预测观看量:检测问候、开场白、空洞的钩子和冗长的脚本。

钩子有5个层面, 脚本仅衡量旁白和屏幕文字。在交付前,手动检查这些层面是否一致并在前3秒内传达:

  1. 屏幕文字;
  2. 视觉,即第一帧中看到的内容;
  3. 声音,第一句口播台词;
  4. 音效: 音乐、效果或有意的静音;
  5. 标题,其第一行。

如果有两个层面冲突,删除一个。

每分钟字数: 通过测量已录制视频的真实人物旁白来校准(字数÷分钟)。在测量之前,以西班牙语160和英语170为起点,并告知用户。


9. 测试Reels和“旁白+动态图形”格式

测试Reels 是Instagram首先仅向非粉丝展示的Reels。它们是测试钩子的免费实验室。

  • 每个Reel都可以有其测试版本,使用不同的钩子,以实现真正的A/B测试。
  • 查看3秒留存率、非粉丝覆盖人数、分享量和粉丝/覆盖人数。胜出的Reels可以正常发布或付费投放。
  • 建议保持可持续的发布量,而非爆发式。

旁白+动态图形格式 无需摄像头,可用于增加发布量:

  • 真实旁白单独录制,动画在After Effects或其他工具中完成。
  • 结构遵循引擎:第一帧带有文字的视觉钩子 → 4-7个2-4秒的节拍,每个节拍都有视觉变化 → 回报 → CTA。
  • 此外,提供动画表,说明每个节拍的屏幕文字、视觉元素、运动和时长。

10. 文件

  • playbooks/:每个意图的结构。在第2步中读取。
  • perfiles/:每个品牌的语气和身份。在第1步中读取。
  • references/motor_hooks_retencion.md:钩子模式、留存率、字幕、A/B测试和已完成脚本示例。在第3步中读取。
  • references/formulas_hooks.md:26种钩子公式(西班牙语和英语)。在第3步中读取。
  • references/plataformas.md:如何为Reels、Shorts和TikTok调整剪辑。在第6步中读取。
  • scripts/guion_check.py:本地验证器。

相关技能