Communitygithub.com

toxykdude/videoskill

触发词:编辑视频、原始素材、剪辑、短视频、Reels、TikTok、LinkedIn、缩略图、广告、Remotion。AI视频处理管线:根据语音能量自动剪除静音、同步多机位、3D场景动画,并交付到各个平台。

videoskill 是什么?

Videoskill 是一个面向 AI 代理(例如 Claude Code)的端到端视频编辑技能,专为白标品牌设计。它从 `marca/` 目录下的 JSON 文件中读取品牌标识、频道信息和项目配置,处理语言为西班牙语。该技能通过一系列 Python 和 Remotion 脚本,能够将原始素材自动处理为完整的水平视频(YouTube)、多种垂直版本(Shorts、Reels、TikTok)、LinkedIn 4:5 视频及 PDF 轮播图。核心功能包括:基于语音能量分析自动剪切静音、多机位同步、语音驱动的场景匹配、B-roll 合成、3D 场景动画以及最终音频标准化至 -14 LUFS。所有交付物会复制到指定的云端硬盘文件夹,但发布前需人工确认。Videoskill 还集成了严格的规则系统:渲染前必须通过 TypeScript 类型检查、逐帧 QA 以及错误日志记录,从而形成一个持续学习、不断优化的视频生产管线。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add toxykdude/videoskill

在你喜欢的 AI 中提问

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

文档

Videoskill — 端到端视频编辑(白标)

白标技能:代码中不包含任何固定的名称、Logo 或颜色。所有信息均来自 marca/(marca.json 品牌标识与颜色、canal.json 频道与社交平台、proyecto.json 团队与文件夹)。工作语言:西班牙语。

激活契约

当用户要求编辑视频或原始素材、制作 Shorts / Reels / TikTok、剪辑 YouTube 剧集、创建带配音的动画广告、缩略图或 LinkedIn 轮播图时使用。当用户带来了用于录制的脚本(videos/_shared/plantillas/guiones.md)或希望执行项目的完整流程(proyecto01、promo01、anuncio01)时也同样适用。

硬性规则

  1. 未经询问,不得发布任何内容、消耗任何额度或向任何服务上传文件 (例外情况始终允许:将交付物复制到其 Drive final/<id>/)。消耗额度时, 需告知消耗了多少以及剩余多少。
  2. 公开链接:始终使用 https://tumarca.com(绝不使用长域名)。社交平台信息在 marca/canal.json 中。
  3. 始终使用真实摄像机镜头;数字分身(例如 HeyGen)仅作为备选方案。
  4. 在进行任何操作之前,请阅读 references/reglas-tecnicas.md。 当某个环节失败并 修复后,需记录在此:系统会随着每个视频不断学习。
  5. 在设计场景、背景、卡片、缩略图或其他内容之前,请查阅 references/diseno.md (经过验证并映射到管线的灵感来源)。
  6. 每次渲染前执行 npx tsc --noEmit;始终进行逐帧 QA (node remotion/scripts/qa.mjs …)并在全面渲染之前查看这些帧。
  7. 始终在本地磁盘上进行处理;在 <DRIVE> 上仅进行复制,绝不进行加工处理 (pipeline/brutos.py traer|entregar <id>)。

结构

marca/            品牌标识(唯一包含名称、颜色、Logo、社交平台的地方)
pipeline/         Python 脚本(按流程顺序编号) + comun.py
remotion/         合成:Intro|Disclaimer|Catalogo (Parte), Grueso/GruesoGraficos,
                  Short, Linkedin, Lamina, Miniatura · 场景在 src/escenas · scripts/qa.mjs
videos/           Remotion 的 publicDir:仅包含 Remotion 读取的文件(片段、JSON、B-roll、音乐、Logo)
  _shared/        music/, logos/, fx/, marca/, obj/, descripciones/, plantillas/
  <id>/           plan.md, guia_grabacion.md, partes.json, <parte>.json, shorts.json, …
references/      辅助手册(查看决策门)
raw/<id>/        从 Drive 复制的原始素材 + 重型中间文件(不在 Git 中)
out/             渲染结果, qa/, miniatura/, entregas/<id>/(不在 Git 中)

流程(摘要)

步骤内容关键命令
0脚本和录制指南模板在 videos/_shared/plantillas/
1拉取原始素材并检查(ffprobe、方向、旋转)python pipeline/brutos.py traer <id> …
2摄像机部分:语音同步 → 转录 → 镜头 → 静音剪切05_sync → 02 → 03 → 01 (+ 仅 alinear.py)
3概念和锚定到语音的场景lectura.py → historial.py → <parte>.json → qa.mjs
4屏幕块(主体):准备、像素化、缩放、混合渲染04_grueso → 06_zooms → render_grueso
5B-roll、缩略图(Higgsfield + Remotion)和分部分渲染out/lote_<id>.cmd
6最终剪辑至 -14 LUFS,含章节和描述07_final.py
7竖版 + LinkedIn(Shorts/Reels/TikTok/4:5、PDF 轮播图)09_shorts.py → 10_linkedin.py
8收尾:记录历史和信息报告historial.py registrar <id> → LEEME_<id>.md

变体:短广告(promo01,带 cola 的高密度竖版)和带配音的动画广告(anuncio01,无摄像机镜头,3D 面板)。逐命令详情:references/flujo.md。

决策门

你需要…阅读
执行完整流程或某个具体步骤及其命令references/flujo.md
从目录(type)、图层、背景、样式和音效中选择场景references/escenas.md
设计:开场/钩子、CTA、结尾、玻璃卡片、3D 图标、动画背景references/diseno.md
缩略图、Higgsfield、ElevenLabs 语音、Logo、本地模型、环境references/herramientas.md
调试已知故障或避免已踩过的坑references/reglas-tecnicas.md

输出契约

每个项目最终交付:

  1. 横版 YouTube(1920×1080,-14 LUFS):剪辑好的各部分、有效的章节、 包含来源和缩略图的描述。
  2. 竖版 → 3 种不同文本的版本:YouTube Shorts(带音乐)、 Instagram Reels 和 TikTok(无音乐;用户发布时自行添加)。
  3. LinkedIn:4:5 视频、PDF 轮播图、单张图片和帖子文本。
  4. 所有内容位于 <DRIVE>/final/<id>/(shorts/、linkedin/)和信息报告 out/entregas/<id>/LEEME_<id>.md: 包含哪些内容、需要检查什么、消耗的额度以及可供粘贴的文本。发布为手动操作。

相关技能