Communitygithub.com

elkl111/Reels编辑实验室-新手引导

首次使用Reels编辑实验室的引导流程。自动安装缺失组件、进行简短的品牌访谈,让用户在素材上预览并选择自己的风格,最后保存为个人套件。

Reels编辑实验室-新手引导 是什么?

此技能专门用于Reels编辑实验室的首次配置(新手引导)。当用户表达“开始设置”、“上手”或“引导我”等意图时,或者检测到实验室尚未配置(缺少brand/kit.txt文件),该技能便会自动触发。其工作流程完全自动化:首先运行“医生”脚本检查并指导安装macOS、Homebrew、FFmpeg、Python工具及一个2.3GB的语音模型等必要依赖;在后台下载模型时,通过3个对话式问题收集用户的品牌偏好、风格(如“安静内敛”、“温暖亲切”或“高能活跃”)以及禁忌内容;用户只需拖入一段20秒以上的样片,系统便会自动转录、粗剪并使用所有预设风格生成并排对比图,支持用户实时切换查看动态效果;最终保存个性化套件(包含颜色、字体、动画强度等参数)。该技能支持macOS(Apple Silicon芯片、约6GB磁盘空间),严格遵守“一次一步”、“不输出原始工具日志”、“不要求用户执行除Homebrew安装外的命令行”等设计原则。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elkl111/reels-editing-lab-beta/tree/HEAD/.claude/skills/setup

在你喜欢的 AI 中提问

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

文档

开始设置

用户首次打开实验室。他们不熟悉技术。最终,他们将完成所有安装,在自拍样片上选择喜欢的样式,并保存专属套件。然后,他们就可以开始制作第一个Reels视频了。

语气:亲切、简洁、循序渐进。在等待时告知进度。绝不粘贴原始工具输出。除了第一步中缺失Homebrew时的一条命令外,绝不要求用户运行任何命令。

从一句简短的消息开始:

欢迎来到 Reels 编辑实验室。设置大约需要10分钟:我会安装一些必要组件,问你3个简短问题,然后你可以在自己的视频上看到不同风格的效果并做出选择。我们开始吧。

1. 安装(约5分钟,主要是语音模型下载)

运行 python3 tools/doctor.py。它会打印一个检查清单和 DOCTOR=ok 或 DOCTOR=missing:<names>。按此顺序修复缺失项,最后重新运行医生脚本:

  1. mac / space: 如果两者之一失败,请友好地解释(需要Apple芯片的Mac;约6GB可用空间)。
  2. homebrew: 你无法替他们安装,因为需要在真实的终端中输入Mac密码。用一行话解释原因,然后给出医生修复建议中的准确命令,告诉他们打开 Terminal 应用(Cmd+Space,输入Terminal),粘贴命令,按回车,输入Mac密码(输入时不会显示任何字符,这是正常的)并按照提示操作。最后Homebrew会输出两行以 echo 和 eval 开头的“下一步”步骤;请他们也粘贴这些命令。等待他们确认完成后,重新检查。
  3. apple-tools: 运行 xcode-select --install。会弹出一个Mac窗口;告诉他们点击 Install 并告知完成(需要几分钟)。通常Homebrew会事先安装好这些,所以先检查一下。
  4. ffmpeg: brew install ffmpeg(如果 brew 还不在PATH中,则使用 /opt/homebrew/bin/brew)。
  5. uv: curl -LsSf https://astral.sh/uv/install.sh | sh,然后如果 uv 未找到,使用 ~/.local/bin/uv。
  6. python-tools: uv sync
  7. renderer: uv run playwright install chromium
  8. speech-model: 在后台运行 uv run tools/get_models.py(2.3 GB)。如果连接中断,它会自动恢复。启动后,继续进行访谈。在步骤3需要使用前,再回来检查。

在安装过程中,用一句话告诉他们每个组件的用途(医生脚本的描述就是为此设计的)。

2. 品牌访谈(3个问题,逐一提问)

以对话方式提问,每次一个消息。保留他们的确切措辞。

不要询问名称、标语或“你是做什么的”标签:实验室默认不会添加这些(请参见new-reel技能中的“标签”)。

  1. 能量。 “你在镜头前感觉如何:安静内敛、温暖亲切,还是高能活跃?” 这将决定剪辑的活跃程度(参见步骤4中的表格)。
  2. 品牌。 “你有品牌或设计文件、品牌色或字体吗?将你的设计文件(.md或PDF)拖到这里,我会从中构建你的风格。或者粘贴颜色代码,或者将3–6张你喜欢的Reels样式截图放入 inspiration 文件夹。或者直接说'不,给我看看选项'。”
  3. 禁忌。 “你的Reels中绝对不想要什么?例如全大写文本、某些表情符号、音效、你永远不会说的词。”

将答案保存到 brand/profile.md:

# 个人资料
- 能量:温暖亲切
- 品牌:颜色 #… / 字体 … / 截图在 inspiration/ / 无
- 禁忌:…

另外,将每个“禁忌”作为一条规则添加到 brand/preferences.md。

3. 在用户视频上查看样式

询问:“现在拖入一段你对着镜头说话的片段,最好20秒或更长。将它拖到这个聊天中或 inbox 文件夹。不一定非要拍得好;它只是用来预览样式的。”

当片段传入(且语音模型已完成下载)后:

  1. uv run tools/transcribe.py "<片段>" --name welcome-sample

  2. 读取 projects/welcome-sample/lines.md。使用 前3–5条清晰的台词,大约12–20秒 编写 cut.json,遵循new-reel粗剪规则(最后一条干净的台词,无错误开头)。运行 uv run tools/roughcut.py projects/welcome-sample --no-open 和 uv run tools/verify.py projects/welcome-sample,并修复其标记的任何问题。不要让他们审阅这个粗剪版本;它只是样本。

  3. 像new-reel技能一样编写 build.json:使用 hooks 技能根据他们的实际讲话内容编写一个钩子(这是他们对实验室的第一印象,所以要做好),1–2个突出词,1个缩放,以及一句对最强台词的陈述。使用 visuals 技能添加2–4个弹出提示(例如,如果他们提到一个列表,则添加标签;如果他们谈论提示词,则添加聊天窗口),让他们看到实验室的真实能力。不要添加背景时刻。

  4. 样式表: uv run tools/build.py projects/welcome-sample --looks presets。它会打开一张图片,他们的片段以所有样式并排显示,顺序和 LOOKS= 之后打印的一致。自己先查看图片(读取它)并检查文字是否清晰可读以及是否遮挡面部。

  5. 按照打印的顺序,每个样式用一句简短的话介绍,使用每个套件的 description(packs/<名称>/kit.json)。顶部行显示钩子和字幕;底部行显示弹出提示。 然后明确说明 一个样式是起点,而非最终选择:

    选择你最喜欢其感觉的那个。之后一切都可以更改:“就这个,但要鼠尾草色和奶油色”、“用我的颜色:#…”、“柔和点的字体”、“不要粉色”。我会在你的片段上重做,以便你看到效果。

    询问他们想看哪个 动态效果。

  6. 对于他们选择的每个样式:uv run tools/build.py projects/welcome-sample --kit <名称> --out sample-<名称>。它会在QuickTime中打开。如果他们选了2个,则都构建并依次打开。

如果他们在步骤2中提供了品牌色、字体或截图,也要提供:“或者我可以从你的品牌中创建一个样式。” 参见步骤5。

4. 保存他们的套件

当他们选择后(例如“Editorial,但用鼠尾草色和奶油色”或“Playful,但更平静”):

  1. 将 packs/<预设>/kit.json 复制到 packs/<他们的小写名字>/kit.json。在副本中:

    • "name": 他们的名字
    • "preset": false
    • "based_on": "<预设>"
  2. 应用他们的能量:

    能量intensityzoom jump / punchsfx volume_dbstatements
    冷静内敛clean1.04 / 1.08−17最多1个
    温暖亲切signature1.07 / 1.13−13最多1–2个
    高能活跃full1.12 / 1.22−10最多2个

    相应地更改 rules.intensity、zoom、sfx.volume_db 和 rules.statement 的措辞。

    音效集 (sfx.palette):

    • 冷静:soft
    • 温暖:soft 或 playful
    • 高能:punchy
    • 科技或AI话题:考虑 clicky

    提醒一次,他们可以在 sfx/sound-menu.mp4 中听到所有声音,并通过提问(“使用俏皮的声音”)切换音效集。如果他们说“不要音效”,则设置 "sfx": {}。如果他们说不要全大写,则设置 style.caption_case、style.hook_case 和 style.statement_case 为 "none"。

  3. 应用他们的颜色,无论是来自访谈还是他们当场要求(“改用这些颜色”):

    • 从十六进制代码或普通名称: “sage”或“dusty pink”都可以;选择品味得当的十六进制代码并告知他们。
    • 交换 colors 中的值并保持角色:浅色用于卡片和字幕,深色用于陈述背景和墨水色,亮色用于高亮和 visuals.rotate。
    • 检查对比度: 文字在其背景上必须可读。
    • 为其套件重新渲染样式表 (--looks <他们的套件>),以便他们在制作完整样本前看到效果。
    • 字体同理: 任何免费的Google字体(fonts.py 确认其存在)。
  4. 将套件的文件夹名称写入 brand/kit.txt。

  5. 使用其套件再次构建样本:uv run tools/build.py projects/welcome-sample --out sample-mine。它会在QuickTime中打开。询问:“这是你的样式。想更改什么吗?” 将更改应用到他们的套件(而非预设)并重新构建,直到他们满意为止。像“字幕小一点”、“少点黄色”或“不要倾斜”这样的小改动在 kit.json 中都是一行编辑。

5. 根据品牌创建样式(当被要求时)

从设计文件(最佳方式)

如果他们有品牌或设计文档(.md、PDF或Google Doc导出文件,例如 BRAND-DESIGN.md):

  1. 获取文件。 要求他们将文件拖入聊天或放入 brand/ 文件夹,然后将副本保存为 brand/design.md(或保留PDF)作为他们样式的唯一真实来源。

  2. 将其映射到他们的套件:

    设计文件中kit.json 中
    调色板(十六进制代码及其用途)colors,加上 roles:背景 → hook_card 和 label_bg;文字颜色 → ink 和 hook_text;“陈述”或深色块 → statement_bg;高亮颜色 → highlight_blocks;强调色 → accent_pill、visuals.rotate
    “永远不要纯黑或纯白”类规则使用他们最深的品牌色作为墨水色
    标题和展示字体fonts.display / poster,其斜体作为 fonts.italic,用于 label 和字幕的无衬线字体
    标志性动作(斜体混用、高亮色块位于文字后、倾斜、贴纸、全大写)moves 和 style(hook_case、statement_case、radius)
    情绪(“冷静”、“俏皮”、“奢华”)visuals.motion、visuals.density、sfx.palette
    照片或视频风格(温暖、阴沉、明亮、胶片感)grade:contrast、saturation、brightness、warmth(−0.05 到 0.05)、vignette(0–0.5)、legibility(文字后的深色渐变,0–0.5)。保持肤色自然:无胶片颗粒,无重度压暗。
    图标、图形元素、贴纸、按钮(线条粗细、圆角或直角、填充色块)visuals.icon_stroke(细 1.5 → 粗 2.5)、visuals.radius、visuals.card(实心/线框/玻璃)、visuals.accent(图标色块颜色)、visuals.rotate(标签和贴纸颜色)
  3. 付费或自定义字体: 查找字体文件。如果他们有,则放入 fonts/private/ 文件夹,套件使用 "file"。如果没有,则选择 最接近的免费Google字体:匹配对比度、宽度(高挑或紧凑?)以及是否存在斜体。告诉他们你替换了什么以及原因。例如,“你的付费衬线字体 → Instrument Serif:相同的修长、高对比度感觉,有斜体。”

  4. 展示它: 渲染 --looks <他们的套件> 并构建 sample-mine。说明哪些部分直接来自他们的文件,哪些是你诠释的。

  5. 保持同步: 如果他们稍后更新设计文件(“我改了品牌色”),重新读取 brand/design.md 并以相同方式更新套件。

从截图或粘贴的颜色

当他们想要自己的风格而非预设时:

  1. 读取 inspiration/ 文件夹中的截图、他们的品牌指南或他们粘贴的代码。注意:
    • 类型:衬线或无衬线,粗细程度,是否全大写,是否混用斜体
    • 字幕处理:轮廓、阴影或方框;整个短语或逐词
    • 卡片形状和圆角半径
    • 4–6种颜色
    • 复杂程度
  2. 从最接近的预设开始,只更改不同的部分。字体必须是 免费Google字体:写入 {"family": "<Google Font name>", "google": true, "weight": N}(如有斜体则添加 "italic": true)。通过运行 uv run tools/fonts.py "<family>" --weight N 确认每个字体都能下载。如果他们拥有付费字体,则可以将文件放入 fonts/private/ 并使用 {"family": "...", "file": "fonts/private/<file>", "weight": N}。
  3. 不要复制其他创作者的精确字体和颜色。借鉴感觉,而非受商标保护的样式。
  4. 渲染 --looks <他们的套件> 进行检查,然后按照步骤4构建 sample-mine,并在聊天中进行迭代。

6. 完成

用大约3行话告诉他们:

  • 他们的样式已保存,每个Reels视频都会自动使用它
  • 如何编辑Reels:将片段拖入 inbox/ 文件夹或聊天并说“编辑这个Reels”。你进行剪辑,他们在聊天中审阅台词,然后你根据他们的样式构建视频
  • 弹出图形说明他们所说内容;“显示图形”会播放所有14种图形在其样式下的目录
  • 可选扩展:将用户自己的6个Reels视频拖入聊天以实现“Reels围绕你”效果和主页网格(tools/reels.py add);一次性提供他们的真实Instagram数据(保存到 brand/instagram.json)以实现关注动画
  • 他们可以在任何台词上请求一个表情包或GIF(“这里的David Rose 'ew' 表情包”)。搜索需要免费的GIPHY密钥,你会在第一次时帮助他们获取;他们自己的GIF文件可以立即使用
  • 颜色和字体从来都不是固定的:“改用这些颜色”随时可以在任何Reels上生效
  • 他们可以随时更改任何设置,只需说出来(“字幕小一点”、“这个不要声音”、“试试这个Reels上的Loud样式”)
  • 完成的Reels会放入 Finished reels 文件夹
  • 命令:/new-reel 用于新片段(为此文件夹中的每个Reels启动一个新聊天),/update 用于获取新版本,/report-problem 用于问题报告

然后询问:“想把你刚才给我的完整片段编辑成你的第一个真正的Reels吗?” 如果是,则在此聊天中对其运行new-reel技能。

套件风格开关(用于调整)

kit.json → "style":

  • caption_outline:像素;0表示只有阴影
  • caption_case:"none" / "uppercase"
  • hook:"card" / "bare"(无卡片,仅轮廓文字)
  • hook_size
  • hook_case
  • statement_case
  • label:"ticket" / "pill"
  • label_mark:名称和主题之间的符号
  • radius
  • shadow / shadow_soft:rgba颜色

"captions":

  • mode:"karaoke"(逐词高亮),"phrase"(整个短语),"word"(一次一个词)
  • size
  • max_words
  • position_y

"moves":

  • tilt_degrees
  • highlighter_blocks

Individual skills in this repo

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

elkl111/reels-editing-lab-beta

Write hooks for a reel that are curious but human, true to the reel and specific to it. Use in the new-reel flow (opening check after the rough cut; on-screen hook and cover title in the build), when the user asks to change the hook ("hook 2", "different hook", "punchier hook"), or before filming ("give me hooks for a reel about X", "how should I open this?").

elkl111/reels-editing-lab-beta

Edit a talking-head reel from a raw clip. Use whenever the user says "I have a new reel", "edit this reel", "new clip", drags a video into the chat or drops one in inbox/, or gives edits to a rough cut ("drop line 3", "end line 9 at…", "good, move on"). Covers transcription, the rough cut and the review, all in the chat.

elkl111/reels-editing-lab-beta

Bundle a problem report for the Lab's maker. Use when the user says something is broken, wrong or confusing and wants to report it ("report a problem", "this isn't working, tell Elena", "send feedback"), or when a tool keeps failing after you've tried to fix it.

elkl111/reels-editing-lab-beta

Update the Reels Editing Lab to the newest version. Use when the user says "update", "update the Lab", "is there a new version?", or was told a new version is out.

elkl111/reels-editing-lab-beta

The visual director. Plans the pop-up explainer graphics (chips, numbers, chat windows, checklists, diagrams…) that illustrate what the speaker says, beat by beat, in their kit's style. Use in the new-reel build step, when the user asks for more or fewer graphics ("more pop-ups", "illustrate this part", "a checklist here"), or asks what graphics exist ("what can you add?", "show me the options").

相关技能