win4r/video-director

项目介绍

video-director 是一个 Claude Code 技能，用来把短视频当作代码来制作，而不是走剪辑软件流程。目标载体包括 HTML、Canvas、SVG、Three.js、GSAP 和 Remotion，逐帧渲染为 MP4。适用内容有产品发布片、宣传片、讲解片、数据故事、动态文字、循环视频和社交 Reels。

该技能主要面向 Claude Code 中的 Claude Opus 5.5。它提供导演立场、每部片子的参数（时钟、连续性、语域、文字策略）、13 条原则、构建约定、brief 结构和完成标准，并附带模板、工艺数值与两个 QA 脚本。仓库有意不提供可直接照抄的镜头库。

安装与使用

官方流程假定使用 Claude Code 并已选择 Claude Opus 5.5。克隆仓库后，把内层技能目录复制到个人 skills 目录：

git clone https://github.com/win4r/video-director.git
cp -R video-director/video-director ~/.claude/skills/

在 Claude 应用中，则是把内层 video-director/ 打包成 zip 后作为自定义技能上传 安装步骤。

脚本需要 ffmpeg/ffprobe，以及带 numpy 和 Pillow 的 Python 3。渲染 HTML 影片需要 Node、Playwright 和 Chromium，也可以改用 Remotion。faster-whisper 仅用于检查旁白，可选；配音可以用任意文本转语音工具完成。

安装后，用自然语言给出 brief 即可，例如 15 秒循环上线视频、16:9 的 30 秒旁白讲解，或根据 CSV 制作 20 秒 Reel。技能会按流程规划、编写动画代码、渲染并针对具体缺陷修改。

两个 QA 脚本也可以单独运行：check_timeline.py 在写代码前校验时间线计划，qa_video.py 测量成片的钩子文字大小与对比度、首帧、闪烁、剪辑、冻结、循环接缝、响度、静音段和联系表 使用示例。

python3 video-director/scripts/check_timeline.py timeline.json
python3 video-director/scripts/qa_video.py film.mp4 --out qa/ --beats timeline.json

使用约束

这是一个指令与质检技能，不是捆绑模型，也不是托管式视频生成服务。产出依赖编程智能体和可用的代码执行、渲染工具。Claude Opus 5.5 是主要面向的模型，其他有能力的编程智能体也可以尝试这套流程。

仓库自己的评估只用了三份 brief，每种配置各跑一次。它报告第一轮技能组通过 28/28 条断言、无技能组 25/28，第二轮为 30/32 对 26/32，盲评偏好分别为 2–1 和 3–0 评估结果。由于每个配置只跑一次，维护者把这些结果视为方向参考而非受控测量。针对角色与插画类影片、修改和实时页面的指导是在第二轮之后加入的，尚未评估。项目采用 MIT 许可证。

HotRepo 点评

HotRepo 没有记录到该项目进入全语言日榜，因此不存在基于名次的判断。2026 年 11 月 3 日的新项目快照记录了 274 星、约 24 小时窗口内新增 51 星、新增 5 个 fork。逐小时采样显示，星数从 10 月 30 日的 184 升至 11 月 3 日的 274，其中 11 月 2 日晚间增长更快。这只能说明几天内持续有人关注，不足以判断更长趋势。对读者而言，更具体的信号是仓库自己那份范围很小、并明确标注局限的评估，而不是星数。