Communitygithub.com

assafkip/claude-video-editor

通过对话编辑任意视频 — 为捆绑的视频流水线提供协调。当用户想要编辑、剪切、添加字幕、调色或为素材添加动态图形时使用;放下素材文件夹并说“编辑这个”;或要求制作宣传片/预告片/教程/短视频。路由至video-use(剪辑引擎)和HyperFrames(动态图形叠加),并附带品味导向的动态设计库。

claude-video-editor 是什么?

video-studio 是一个基于对话的视频编辑技能,它通过三个层次协作工作:核心剪辑引擎 video-use、动态图形层 HyperFrames 和品味层 make-a-video。AI 模型并不实际观看视频,而是通过转录文本和按需生成的 PNG 时间轴来“阅读”视频,从而实现基于词语边界的精准剪辑。该技能支持字幕烧录、色彩分级、音频淡入淡出、动态文字、转场效果等专业功能,并遵守严格的质量规则(如必须使用 ProRes 4444 格式保留 Alpha 通道)。它运行一个标准循环:素材盘库 → 转录打包 → 策略确认 → 编辑决策列表(EDL)→ 动态图形渲染 → 合成输出 → 自我评估。适用于 Cursor、Claude Code 等支持技能编排的 AI 智能体平台,通过 `render.py` 处理 EDL 并输出最终视频。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/video-studio

在你喜欢的 AI 中提问

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

文档

视频工作室

一条对话式流水线,用于编辑任意视频。三层结构组合而成;本技能在它们之间进行路由。LLM 并不观看视频——而是阅读它(通过转录文本 + 按需生成的 PNG 时间轴),并以词语边界的精度进行剪辑。

三层结构(此处捆绑的内容)

  1. 剪辑引擎 — video-use (skills/video-use/)
    转录 → 打包 → 推理 → EDL → 渲染 → 自我评估。负责:填充词去除、死区修剪、色彩分级、30ms 音频淡入、字幕烧录,以及 render.py 复合层——它将叠加层放置在剪辑之上。这是每个剪辑的主干。 阅读 skills/video-use/SKILL.md 了解 12 条生产规则。

  2. 动态图形层 — HyperFrames (skills/hyperframes/、hyperframes-cli/、hyperframes-registry/、gsap/、website-to-hyperframes/)
    HTML + GSAP 动画通过无头 Chrome 渲染为带 Alpha 通道的 .mov。用于:下三分之一字幕、标题卡、标注、音频反应元素、场景过渡、动态文字。video-use 将它们作为叠加层生成并复合。

  3. 品味层 — make-a-video、short-form-video、docs/MOTION_PHILOSOPHY.md
    故事板、品牌体系、节奏、动态品味。在这里查找应该如何感觉,而不是如何渲染。

标准循环

  1. 盘库。 列出文件夹中的素材。不要主动转录——等待用户指向素材并说出他们的需求。
  2. 转录 + 打包 (video-use):每个素材调用一次转录 → 生成一个 takes_packed.md。
  3. 策略 → 确认。 提出剪辑方案(节拍、顺序、剪掉的内容)。等待确认。未经批准绝不触碰剪辑。
  4. EDL。 编写剪辑列表(ranges = 素材秒数,overlays = 输出秒数内的字幕 .mov)。参见 templates/project/ 了解格式。
  5. 动态图形 (HyperFrames,当节拍需要时):创建一个合成,通过 --format mov 参数渲染每个变体(带 Alpha —— webm 输出为不透明)。
  6. 复合 (video-use):render.py <edl> -o final.mp4 --no-subtitles --no-loudnorm(仅当素材包含真实音频时去掉 --no-loudnorm)。
  7. 自我评估 → 持久化。 引擎在展示任何内容之前检查每个剪辑边界。会话记忆保存在项目的 project.md 中。

硬性规则(不可协商;品味自由)

  • 字幕以 --format mov 渲染(ProRes 4444 yuva)。webm = 不透明,无 Alpha。
  • 静音素材需要在 render.py 之前创建一条立体声静音轨道(其音频路径期望如此)并添加 --no-loudnorm。
  • 变速片段作为预渲染的 setpts 剪辑处理,在 EDL 中作为独立素材引用。不支持原生 EDL 变速。
  • 输出文件位于 <videos>/edit/ — 保持技能目录整洁。

安装

运行 ./install.sh 一次(检查 ffmpeg/node/chrome,设置 video-use 的 venv,连接各个技能,提示输入 ElevenLabs 密钥)。然后 cd 进入素材文件夹并开始会话。参见仓库 README.md。

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

相关技能