用途
Storytelling 用于将 9:16 竖屏口播片段加工为结构统一的叙事短片：画面上方横向并排三张图片卡片，下方配加粗黑底标题与一行白色小副标题，人物口播画面轻微放大，底部叠加 TikTok 风格字幕。它面向希望用“图片讲故事”方式呈现努力、物品与结果等要素的短视频创作者。
主要能力
- 处理任意 9:16 的口播视频，可指定起止时间截取片段，支持 zoom 缩放。
- 画面顶部固定放置三张卡片，三张卡片在第一秒内同时出现，不会逐张出现。
- 卡片类型：
- image：一张方形照片。
- cover：轮播封面，图片配文字，词 会转为黄色，\n 用于换行，并带有缓慢漂移效果。
- stat：由 label、value、unit 和 ring 组成；当 value 是数字（如 250、10,000）或时间（如 4:12）时，它会滚动计数；ring 取 0 到 1，表示环形填充程度。
- comments：最多 4 行 [handle, text] 评论。
- text：用 big 和 small 两段文字展示。
- 标题最多 1 到 2 行，每行约 22 字符以内；副标题为一行短句。
- 构建后会生成预览图 sheet.jpg，供检查布局。
使用方式
- 确定技能的基础目录（Claude Code 加载技能时显示的 “Base directory”），据此定位上层 kit 目录。
- 检查 kit/.venv/bin/python 是否可执行；如果不可用，就运行 kit/setup.sh。转录需要设置 GROQ_API_KEY，并依赖 ffmpeg 与 Node。
- 用 reel.py words <video> 输出逐句文本及每句末尾的结束时间标记，再从中选择一段 4 到 8 秒的连续片段，要求这段片段能讲一个小故事或展示证据；不要拼接多个片段，以免跳切显得突兀。
- 编写 <clip>.storytelling.json 规格文件，其中路径相对于该规格文件；cards 必须恰好为 3 个，并可设置 video、start、end、zoom、title、subtitle 等字段。
- 运行 build.py <spec.json> 进行构建。
- 查看输出 sheet.jpg：确认卡片与标题让出顶部 220 px 区域、字幕不遮挡嘴部（可调整 caption_top，默认 1385）、标题在各自行内放得下；然后交付 mp4 路径。
适用场景
适合将口播内容整理为带有数据、封面或评论证据的短叙事视频，例如展示耗时统计、作品封面、用户反馈截图等。设计上强调一次性同时呈现、标题一句话概括故事、副标题给出结果。
限制
需要视频为 9:16 口播，且片段为 4 到 8 秒连续镜头；卡片数量固定为 3，评论最多 4 行；标题每行约 22 字符以内。卡片必须展示真实内容，评论与账号必须由用户提供，不得虚构人物，没有真实评论时应改用文本或数据卡片。转写依赖 GROQ_API_KEY，运行环境需要 ffmpeg 与 Node。其他收费、平台与效果信息暂未提供。