Communitygithub.com

assafkip/claude-video-editor

面向初学者的端到端视频创建技能,适用于 HyperFrames。当用户说“制作视频”、“创建视频”、“新视频”、“从头开始构建视频”或表示想要制作 MP4 时使用。它会一次性采访用户,然后通过强制预览和视觉验证关卡构建完整视频。

claude-video-editor 是什么?

此技能(assafkip/claude-video-editor)是为 HyperFrames 平台设计的完整视频制作流程,专门针对从零开始的初学者。它将视频创建过程拆分为两个阶段(访谈与构建)共八个顺序关卡,每个关卡都生成下一个关卡所需的可见产物,确保流程的确定性和质量。技能的核心价值在于强制性的双重预览关卡:构建完成后必须先通过 Studio 预览(Gate 7)和渲染后的 MP4 播放预览(Gate 8),且必须提取关键帧并通过 Read 工具进行视觉验证,杜绝“看起来没问题”的草率交付。它支持 16:9、9:16、1:1 等多种画幅比例,并与 `/short-form-video`、`/hyperframes` 等技能协同工作:当用户需求为 9:16 竖屏+头部出镜时,会在 Gate 5 自动转交给专门的短视频技能。此外,它遵循严格的非协商规则,如禁止跳过预览关卡、禁止使用 `Math.random()` 确保渲染确定性、禁止在用户未明确授权时强加品牌风格等,保证了输出的专业性和可控性。

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

在你喜欢的 AI 中提问

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

文档

制作视频 — 从初学者到完成 MP4 的技能

两个阶段,八个顺序关卡。每个关卡都生成下一个关卡所需的实际产物。不要跳过任何关卡。

何时使用此技能 — 以及何时转交

使用此技能当:

  • 用户是 HyperFrames 新手,从一个概念、脚本或提纲开始
  • 用户想要端到端的完整指导,而不是框架参考材料
  • 用户尚未决定视频格式

转交当:

  • 用户粘贴一个 URL 并希望从该网站制作视频 → 调用 /website-to-hyperframes
  • 用户明确想要 9:16 竖屏的头部出镜解说视频(包含面部摄像头和场景叠加层)→ 在此执行关卡 1–4,然后从关卡 5 起调用 /short-form-video
  • 用户询问的是框架规则,而不是视频 → 调用 /hyperframes

两个阶段

  • **阶段 1 — 访谈(关卡 1–4):**在执行任何代码之前,通过一次对话式访谈收集所有信息。意图、格式、脚本、声音、风格、素材、节奏。综合生成 BRIEF.md 并等待明确批准。
  • **阶段 2 — 构建(关卡 5–8):**搭建脚手架 → 分镜板 → 合成 → 检查 → Studio 预览 → 草稿渲染 → 视觉验证 → MP4 预览 → 最终渲染。

关卡 1 · 意图与格式

通过 AskUserQuestion 一次问一个问题,尽可能提供多项选择。

  1. 这个视频的用途是什么?(宣传 · 社交媒体广告 · 发布预告 · 产品演示 · 教程 · 讲解 · 开头/结尾卡片 · 其他)
  2. 目标观众是谁?(自由回答)
  3. 目标时长?(10–20 秒短 · 20–45 秒宣传 · 45–90 秒讲解 · 1.5–3 分钟教学 · 自定义)
  4. 画面比例?(16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. 帧率?(30 默认 · 60 用于清晰 UI · 24 电影感)
  6. 平台/交付限制?(文件大小 · 截止日期 · 播放平台)

**关卡标记:**全部六个问题已捕获。如果答案是 9:16 + 面部摄像头,计划在关卡 5 转交给 /short-form-video。

完整问题库:Read: references/interview-questions.md


关卡 2 · 脚本与声音

  1. 脚本来源?(粘贴 · 大纲 → 我来起草 · 我录制 · 文本转语音 · 无旁白)
  2. 如果使用 TTS:声音偏好。提供 npx hyperframes tts --help 中的选项。同时捕获语速。
  3. 如果使用面部摄像头:录制路径 · 全屏或角落放置 · 是否需要转录?(npx hyperframes transcribe <file> --model small.en --json)
  4. 字幕?(关闭 · 炫酷 · 企业 · 逐字卡拉OK · 极简)

**关卡标记:**脚本已捕获(或起草)、音频方案已捕获、字幕方案已捕获。


关卡 3 · 风格收集

**在向用户提问之前,先盘点现有素材。**检查 <workspace-root>/assets/ 和任何项目 assets/ 文件夹。不要询问已存在的文件。

然后逐步提问 — 用户不需要回答所有问题:

  1. 风格指南或品牌文档?(粘贴/路径 · 无)
  2. 调色板?(十六进制代码 · 无 — 使用 MOTION_PHILOSOPHY 默认值)
  3. 字体?(Google Fonts 名称 · 文件路径 · 无 — 使用默认的 Inter + JetBrains Mono)
  4. Logo 文件?(路径 · 无 — 改用文本文字标记)
  5. 参考视频以获得风格感?(URL/路径 · 无)
  6. 其他素材?(截图 · 产品照片 · 补充镜头 · 音乐 — 列出路径)
  7. MOTION_PHILOSOPHY 美学(黑色画布 · 铬金属文字 · 透视网格 · 挥鞭过渡)还是其他感觉?
  8. 节奏?(动感 1–2 秒 · 平衡 2–3 秒 · 轻松 3–5 秒)
  9. 音乐?(无 · 环境氛围 0.15 · 背景音乐 0.4 · 完整音量 0.8 — 如果用户已有文件则提供路径)
  10. 结尾/行动号召文字?

**切勿强加品牌风格给用户。**仅在用户明确拒绝提供风格时才回退到 MOTION_PHILOSOPHY 默认值。

完整风格流程 + MOTION_PHILOSOPHY 默认值:Read: references/style-intake.md


关卡 4 · 简报综合(构建前的硬关卡)

  1. 读取 MOTION_PHILOSOPHY.md(如果存在于工作区根目录)— 如果存在则必须读取。如果缺失,则使用 references/style-intake.md 中的默认值,并在简报中注明缺失。
  2. 询问项目存放位置(如果不明显):
    • 如果 video-projects/ 存在 → 使用 video-projects/<slug>/
    • 否则 → 询问用户
  3. 写入 <project-folder>/BRIEF.md:
    • 子弹 · 意图 · 观众 · 尺寸 · 帧率 · 时长
    • 脚本(完整或大纲)
    • 声音选择 · 字幕方案 · 面部摄像头方案
    • 风格档案:调色板(十六进制)、字体、Logo 路径、参考视频
    • 节奏
    • 素材清单及路径
    • 结尾 / CTA 文字
  4. **显示简报。等待明确批准。**在得到明确的“是,开始构建”之前,不要进入关卡 5。

关卡 5 · 搭建脚手架与分镜板

首先检查是否需要转交

如果简报描述的是 9:16 竖屏的头部出镜解说视频(面部摄像头 + 场景叠加层),立即调用 /short-form-video 并转交该简报。它的 4 层脚手架专为此格式设计。

否则继续:

脚手架

  1. mkdir <project-folder>
  2. 如果存在格式相似的兄弟项目,提供将其 hyperframes.json + meta.json 复制为模板的选项。否则在文件夹内运行:npx hyperframes init
  3. 编辑 meta.json,填入用户的子弹、尺寸和帧率。
  4. 将提供的素材复制到 <project-folder>/assets/。
  5. 从关卡 3 创建 <project-folder>/assets/style-profile.md — 调色板/字体/Logo 的单一事实来源。

分镜板

使用 references/storyboard-template.md 中的模板生成 <project-folder>/STORYBOARD.md。每个节拍包含:

节拍 N — 标题(开始–结束,时长)— 一句话概念
视觉元素:[每个元素,大小,动画,时机]
运动语言:[运动类型]
使用的缓动:[3–4 个不同的 GSAP 缓动]
退出:[过渡到下一个节拍]
音频:[VO 对白 / 音效 / 音乐层]

文件顶部:一个包含场景 · 开始 · 时长 · 合成文件的时机表。

提出三分结构建议:

  • 第一幕(钩子)≈ 总时长的 20%
  • 第二幕(主体)≈ 55%
  • 第三幕(回报 + 结尾,保持 4–6 秒)≈ 25%

(MOTION_PHILOSOPHY §0 法则 9, §1。)

将用户意图映射到目录块:Read: references/catalog-intent-map.md

**关卡标记:**显示分镜板 + 时机表。反复迭代直至用户批准。


关卡 6 · 构建合成

调用 /hyperframes 以获取框架规则。此技能负责脚手架和纪律;/hyperframes 负责执行规则。

为每个子合成搭建脚手架

<div data-composition-id="scene-name" data-start="..." data-duration="...">
  <style>[data-composition-id="scene-name"] { /* 作用域限制 */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... 补间动画 ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // 锚点 — MOTION_PHILOSOPHY 法则 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

完整模板 + 字幕模式 + 环境背景模式:Read: references/composition-scaffold.md

构建规则

  • 环境背景放在 data-track-index="0" 上,持续整个合成的时长。
  • **动感文字开场:**逐字交错 0.06–0.10 秒。
  • 字幕作为根合成 index.html 中 body 级别的同级元素放置,每个字幕带有 data-track-index ≥ 20。切勿放在场景时间线内(MOTION_PHILOSOPHY §3.13)。
  • 目录块通过 npx hyperframes add <name> 安装。立即限定该块的 CSS 作用域到 [data-composition-id="..."] — 目录块自带的 html, body { ... } 规则会渗透到父文档中,因为它们是作为子合成加载的。
  • **竖屏 + 面部摄像头:**将原生 1920×1080 面部用变换(translate + scale)包裹,用于下半部分或全屏模式。(如果你最终到达这里而不是 /short-form-video,强烈考虑转交。)
  • 仅应用用户提供的内容。 用户提供的调色板、字体、Logo。不要注入其他任何东西。如果他们选择了 MOTION_PHILOSOPHY 默认值,则从 references/style-intake.md 获取调色板 + 字体的默认组合。

确定性

不使用 Math.random()、Date.now() 或渲染时的 fetch()。使用种子化 PRNG 或正弦谐波哈希(MOTION_PHILOSOPHY §3.10)。


关卡 7 · 检查 → Studio 预览(预览关卡 1 — 强制)

  1. npx hyperframes lint — 修复所有错误,分类警告。
  2. 在后台运行 npx hyperframes preview。
  3. 等待“Studio running”出现在 http://localhost:3002。
  4. 将 URL 以及单个合成的 URL(http://localhost:3002/?comp=<id>)交给用户。如果项目包含 WebGL 着色器块,首先提供单个 URL — 软件 WebGL 回退可能会拖慢主合成。
  5. 等待明确的“看起来不错,渲染一个草稿” 后再继续。沉默不等于批准。

热重载已启用 — 编辑内容会实时显示。


关卡 8 · 草稿渲染 → 视觉验证 → MP4 预览 → 最终版本

草稿渲染

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

视觉验证(交付前强制)

通过检查不意味着设计有效。提取帧并查看它们。

  1. mkdir -p renders/frames
  2. 对每个节拍的高光时刻以及每个过渡:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. 在每张 PNG 上调用 Read 工具。Read 工具会将图像加载到上下文中 — 不要仅列出文件名。
  4. 逐帧确认:没有裁剪的面部、每张场景的面部模式正确、文字可读且符合调色板、没有溢出、过渡落在正确的词语上、没有空白帧。
  5. 如果发现问题:修复 → 重新渲染 → 重新验证。永远不要交付有问题的草稿。

MP4 预览(预览关卡 2 — 强制)

npx serve renders -p 8080 -n

请勿使用 Python 的 http.server — 它不支持 HTTP Range 请求,因此拖动进度条会出错。

将 http://localhost:8080/<slug>-draft.mp4 交给用户。等待明确的批准确认播放和音频同步。

最终渲染

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

报告输出路径。完成。

完整预检 + 交付前清单:Read: references/build-checklist.md


非协商规则(承重 — 请勿软化)

  • **不要跳过预览关卡 1(Studio)或预览关卡 2(渲染后的 MP4)。**每个构建始终有两个关卡。
  • 不要声称渲染已完成,直到帧已提取并通过 Read 工具读取。
  • **不要在任何专用项目文件夹之外构建。**切勿将 index.html 放在工作区根目录。
  • 在盘查用户工作区之前,不要向用户询问素材。
  • **不要跳过每个子合成时间线末尾的 tl.to({}, { duration: SLOT_DURATION }, 0) 锚点补间。**MOTION_PHILOSOPHY 法则 11。
  • **不要在渲染逻辑中使用 Math.random() / Date.now()。**仅使用种子化哈希。
  • **不要向 <video> 标签添加 class="clip"。**它会破坏视频播放。
  • **不要强加品牌风格给用户。**先询问;仅在用户明确拒绝时才回退到 MOTION_PHILOSOPHY 默认值。

参考资料

  • references/interview-questions.md — 按关卡划分的完整问题库
  • references/style-intake.md — 风格访谈 + MOTION_PHILOSOPHY 默认值
  • references/catalog-intent-map.md — “用户说 X → 安装 Y”
  • references/storyboard-template.md — 逐节拍模板 + 示例
  • references/composition-scaffold.md — 作用域样式 + IIFE GSAP 模板
  • references/build-checklist.md — 预检 + 交付前关卡

外部(工作区级别):

  • MOTION_PHILOSOPHY.md — 此技能假设存在的唯一外部参考。美学基线。如果文件缺失,则回退到 references/style-intake.md。

相关技能

  • /hyperframes — 框架规则,在关卡 6 调用
  • /hyperframes-cli — init · lint · preview · render · transcribe · tts
  • /hyperframes-registry — 安装目录块
  • /gsap — GSAP 动画参考
  • /short-form-video — 在关卡 5 转交,用于 9:16 头部出镜格式
  • /website-to-hyperframes — 如果起始输入是 URL,则在关卡 1 转交

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

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

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

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.

相关技能