Agent skill

Video Editing

by affaan-m in affaan-m/ECC

AI辅助的视频编辑工作流程,用于剪辑、构建和增强实拍素材。涵盖从原始拍摄到FFmpeg、Remotion、ElevenLabs、fal.ai,再到Descript或CapCut最终润色的完整流程。适用于用户想要编辑视频、剪辑素材、制作vlog或构建视频内容的情况。

MITAuto-check passedMedia & Creative

Install Video Editing

skills CLI
$ npx skills add affaan-m/ECC --skill video-editing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC video-editing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/video-editing .claude/skills/video-editing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
video-editing
GitHub stars
277k
Used in
2 other repos
Token cost
~1.6k tokens
SKILL.md length
166 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

AI辅助的视频编辑工作流程,用于剪辑、构建和增强实拍素材。涵盖从原始拍摄到FFmpeg、Remotion、ElevenLabs、fal.ai,再到Descript或CapCut最终润色的完整流程。适用于用户想要编辑视频、剪辑素材、制作vlog或构建视频内容的情况。

  • Works in 6 steps: 编辑,而非生成。 此工作流程用于剪辑真实素材,而非根据提示创建。 → 先结构,后风格。 在接触任何视觉元素之前,先在层级2确定好故事结构。 → FFmpeg是支柱。 枯燥但关键。长素材在此变得易于管理。 → …
  • Tasks that involve Video production
  • SKILL.md covers 何时激活, 核心理念, 处理流程 and 层级 1:采集(Screen Studio / 原始素材), plus 7 more sections
  • Calls ffmpeg and npx; reaches api.elevenlabs.io; needs ELEVENLABS_API_KEY

What it does

Video Editing is an agent skill from affaan-m/ECC. AI辅助的视频编辑工作流程,用于剪辑、构建和增强实拍素材。涵盖从原始拍摄到FFmpeg、Remotion、ElevenLabs、fal.ai,再到Descript或CapCut最终润色的完整流程。适用于用户想要编辑视频、剪辑素材、制作vlog或构建视频内容的情况。

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production. It works with Remotion, FFmpeg, fal and ElevenLabs. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Tasks that involve Video production

Example prompts

  • “/video-editing”

Requirements

  • Python 3
  • Node.js
  • A credential in ELEVENLABS_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 编辑,而非生成。 此工作流程用于剪辑真实素材,而非根据提示创建。
  2. 先结构,后风格。 在接触任何视觉元素之前,先在层级2确定好故事结构。
  3. FFmpeg是支柱。 枯燥但关键。长素材在此变得易于管理。
  4. Remotion用于可重复性。 如果你会多次执行某项操作,就将其制作成Remotion组件。
  5. 选择性生成。 仅对不存在的资产使用AI生成,而非所有内容。
  6. 品味是最后一层。 AI清理重复性工作。你做出最终的创意决定。

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ffmpeg
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.elevenlabs.io

    Also links to:

    • remotion.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ELEVENLABS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Video Editing loads about 1.6k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 166 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 166 words, ~1,591 tokens.

Download SKILL.mdSave it as .claude/skills/video-editing/SKILL.md (or your agent's skills folder).
name
video-editing
description
AI辅助的视频编辑工作流程,用于剪辑、构建和增强实拍素材。涵盖从原始拍摄到FFmpeg、Remotion、ElevenLabs、fal.ai,再到Descript或CapCut最终润色的完整流程。适用于用户想要编辑视频、剪辑素材、制作vlog或构建视频内容的情况。
origin
ECC

视频编辑

针对真实素材的AI辅助编辑。非根据提示生成。快速编辑现有视频。

何时激活

  • 用户想要编辑、剪辑或构建视频素材
  • 将长录制内容转化为短视频内容
  • 从原始素材构建vlog、教程或演示视频
  • 为现有视频添加叠加层、字幕、音乐或画外音
  • 为不同平台(YouTube、TikTok、Instagram)重新构图视频
  • 用户提到“编辑视频”、“剪辑这个素材”、“制作vlog”或“视频工作流”

核心理念

当你不再要求AI创建整个视频,而是开始使用它来压缩、构建和增强真实素材时,AI视频编辑就变得有用了。价值不在于生成。价值在于压缩。

处理流程

Screen Studio / 原始素材
  → Claude / Codex
  → FFmpeg
  → Remotion
  → ElevenLabs / fal.ai
  → Descript 或 CapCut

每个层级都有特定的工作。不要跳过层级。不要试图让一个工具完成所有事情。

层级 1:采集(Screen Studio / 原始素材)

收集源材料:

  • Screen Studio:用于应用演示、编码会话、浏览器工作流程的精致屏幕录制
  • 原始摄像机素材:vlog素材、采访、活动录制
  • 通过VideoDB的桌面采集:具有实时上下文的会话录制(参见 videodb 技能)

输出:准备进行组织的原始文件。

层级 2:组织(Claude / Codex)

使用Claude Code或Codex进行:

  • 转录和标记:生成转录稿,识别主题和要点
  • 规划结构:决定保留内容、剪切内容、确定顺序
  • 识别无效片段:查找停顿、离题、重复拍摄
  • 生成编辑决策列表:用于剪辑的时间戳、保留的片段
  • 搭建FFmpeg和Remotion代码:生成命令和合成
示例提示词:
"这是一份4小时录音的文字记录。找出最适合制作24分钟vlog的8个精彩片段。
为每个片段提供FFmpeg剪辑命令。"

此层级关乎结构,而非最终的创意品味。

层级 3:确定性剪辑(FFmpeg)

FFmpeg处理枯燥但关键的工作:分割、修剪、连接和预处理。

按时间戳提取片段
bash
ffmpeg -i raw.mp4 -ss 00:12:30 -to 00:15:45 -c copy segment_01.mp4
根据编辑决策列表批量剪辑
bash
#!/bin/bash
# cuts.txt: start,end,label
while IFS=, read -r start end label; do
  ffmpeg -i raw.mp4 -ss "$start" -to "$end" -c copy "segments/${label}.mp4"
done < cuts.txt
连接片段
bash
# Create file list
for f in segments/*.mp4; do echo "file '$f'"; done > concat.txt
ffmpeg -f concat -safe 0 -i concat.txt -c copy assembled.mp4
创建代理文件以加速编辑
bash
ffmpeg -i raw.mp4 -vf "scale=960:-2" -c:v libx264 -preset ultrafast -crf 28 proxy.mp4
提取音频用于转录
bash
ffmpeg -i raw.mp4 -vn -acodec pcm_s16le -ar 16000 audio.wav
标准化音频电平
bash
ffmpeg -i segment.mp4 -af loudnorm=I=-16:TP=-1.5:LRA=11 -c:v copy normalized.mp4

层级 4:可编程合成(Remotion)

Remotion将编辑问题转化为可组合的代码。用它来处理传统编辑器让工作变得痛苦的事情:

何时使用Remotion
  • 叠加层:文本、图像、品牌标识、下三分之一字幕
  • 数据可视化:图表、统计数据、动画数字
  • 动态图形:转场、解说动画
  • 可组合场景:跨视频可重复使用的模板
  • 产品演示:带注释的截图、UI高亮
基本的Remotion合成
tsx
import { AbsoluteFill, Sequence, Video, useCurrentFrame } from "remotion";

export const VlogComposition: React.FC = () => {
  const frame = useCurrentFrame();

  return (
    <AbsoluteFill>
      {/* Main footage */}
      <Sequence from={0} durationInFrames={300}>
        <Video src="/segments/intro.mp4" />
      </Sequence>

      {/* Title overlay */}
      <Sequence from={30} durationInFrames={90}>
        <AbsoluteFill style={{
          justifyContent: "center",
          alignItems: "center",
        }}>
          <h1 style={{
            fontSize: 72,
            color: "white",
            textShadow: "2px 2px 8px rgba(0,0,0,0.8)",
          }}>
            The AI Editing Stack
          </h1>
        </AbsoluteFill>
      </Sequence>

      {/* Next segment */}
      <Sequence from={300} durationInFrames={450}>
        <Video src="/segments/demo.mp4" />
      </Sequence>
    </AbsoluteFill>
  );
};
渲染输出
bash
npx remotion render src/index.ts VlogComposition output.mp4

有关详细模式和API参考,请参阅Remotion文档。

层级 5:生成资产(ElevenLabs / fal.ai)

仅生成所需内容。不要生成整个视频。

使用ElevenLabs进行画外音
python
import os
import requests

resp = requests.post(
    f"https://api.elevenlabs.io/v1/text-to-speech/{voice_id}",
    headers={
        "xi-api-key": os.environ["ELEVENLABS_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "text": "Your narration text here",
        "model_id": "eleven_turbo_v2_5",
        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75}
    }
)
with open("voiceover.mp3", "wb") as f:
    f.write(resp.content)
使用fal.ai生成音乐和音效

使用 fal-ai-media 技能进行:

  • 背景音乐生成
  • 音效(用于视频转音频的ThinkSound模型)
  • 转场音效
使用fal.ai生成视觉效果

用于不存在的插入镜头、缩略图或B-roll素材:

generate(app_id: "fal-ai/nano-banana-pro", input_data: {
  "prompt": "专业科技视频缩略图,深色背景,屏幕上显示代码",
  "image_size": "landscape_16_9"
})
VideoDB生成式音频

如果配置了VideoDB:

python
voiceover = coll.generate_voice(text="Narration here", voice="alloy")
music = coll.generate_music(prompt="lo-fi background for coding vlog", duration=120)
sfx = coll.generate_sound_effect(prompt="subtle whoosh transition")

层级 6:最终润色(Descript / CapCut)

最后一层由人工完成。使用传统编辑器进行:

  • 节奏调整:调整感觉太快或太慢的剪辑
  • 字幕:自动生成,然后手动清理
  • 色彩分级:基本校正和氛围调整
  • 最终音频混音:平衡人声、音乐和音效的电平
  • 导出:平台特定的格式和质量设置

品味体现在此。AI清理重复性工作。你做出最终决定。

社交媒体重新构图

不同平台需要不同的宽高比:

平台宽高比分辨率
YouTube16:91920x1080
TikTok / Reels9:161080x1920
Instagram Feed1:11080x1080
X / Twitter16:9 或 1:11280x720 或 720x720
使用FFmpeg重新构图
bash
# 16:9 to 9:16 (center crop)
ffmpeg -i input.mp4 -vf "crop=ih*9/16:ih,scale=1080:1920" vertical.mp4

# 16:9 to 1:1 (center crop)
ffmpeg -i input.mp4 -vf "crop=ih:ih,scale=1080:1080" square.mp4
使用VideoDB重新构图
python
from videodb import ReframeMode

# Smart reframe (AI-guided subject tracking)
reframed = video.reframe(start=0, end=60, target="vertical", mode=ReframeMode.smart)

场景检测与自动剪辑

FFmpeg场景检测
bash
# Detect scene changes (threshold 0.3 = moderate sensitivity)
ffmpeg -i input.mp4 -vf "select='gt(scene,0.3)',showinfo" -vsync vfr -f null - 2>&1 | grep showinfo
用于自动剪辑的静音检测
bash
# Find silent segments (useful for cutting dead air)
ffmpeg -i input.mp4 -af silencedetect=noise=-30dB:d=2 -f null - 2>&1 | grep silence
精彩片段提取

使用Claude分析转录稿 + 场景时间戳:

"根据这份带时间戳的转录稿和这些场景转换点,找出最适合社交媒体发布的5段30秒最吸引人的剪辑片段。"

每个工具最擅长什么

工具优势劣势
Claude / Codex组织、规划、代码生成不是创意品味层
FFmpeg确定性剪辑、批量处理、格式转换无可视化编辑UI
Remotion可编程叠加层、可组合场景、可重复使用模板对非开发者有学习曲线
Screen Studio即时获得精致的屏幕录制仅限屏幕采集
ElevenLabs人声、旁白、音乐、音效不是工作流程的核心
Descript / CapCut最终节奏调整、字幕、润色手动操作,不可自动化

关键原则

  1. 编辑,而非生成。 此工作流程用于剪辑真实素材,而非根据提示创建。
  2. 先结构,后风格。 在接触任何视觉元素之前,先在层级2确定好故事结构。
  3. FFmpeg是支柱。 枯燥但关键。长素材在此变得易于管理。
  4. Remotion用于可重复性。 如果你会多次执行某项操作,就将其制作成Remotion组件。
  5. 选择性生成。 仅对不存在的资产使用AI生成,而非所有内容。
  6. 品味是最后一层。 AI清理重复性工作。你做出最终的创意决定。

相关技能

  • fal-ai-media — AI图像、视频和音频生成
  • videodb — 服务器端视频处理、索引和流媒体
  • content-engine — 平台原生内容分发

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/zh-CN/skills/video-editing of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Video Editing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Video Editing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Video Editing this skillaffaan-m/ECC277k2 repos~1.6kAutomated safety check: PassMIT
Super Video MakerBomx/super-video-maker-skill310—~11kAutomated safety check: NotesNone
Promo Video Makerliyupi/ai-promo-video-maker121—~145Automated safety check: PassMIT
FFmpeg for Video Productiondigitalsamba/claude-code-video-toolkit2.2k3 repos~3.3kAutomated safety check: PassMIT
Remotion Best Practiceslyonjs/shortvid.io14733 repos~1kAutomated safety check: PassMIT
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0

Similar skills

  • Super Video Maker

    Bomx/super-video-maker-skill

    End-to-end AI video production skill for agentic frameworks.

    310 GitHub stars~11k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Promo Video Maker

    liyupi/ai-promo-video-maker

    为产品、网站、App、SaaS、开源项目、课程、AI 模型或活动制作有商业质感的宣传片(4K MP4 + 网页版),流程包括调研、需求问询、风格样帧、真实页面 4K 截图、配乐卡点、AI 旁白、混音和自动校验。用户说「做宣传片」「做产品介绍视频」「做推广视频 / 预告片」「给这个项目做个视频」,或者要求 promo video、product trailer、launch video 时使用。

    121 GitHub stars~145 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • FFmpeg for Video Production

    digitalsamba/claude-code-video-toolkit

    Command recipes for converting, resizing, compressing, trimming and extracting audio from video with FFmpeg, including settings for Remotion projects.

    2.2k GitHub starsUsed in 3 repos~3.3k tokens
    Media & CreativeAuto-check passed
  • Remotion Best Practices

    lyonjs/shortvid.io

    Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.

    147 GitHub starsUsed in 33 repos~1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Shorts

    AgriciDaniel/claude-shorts

    Interactive longform-to-shortform video creator. An agent skill from AgriciDaniel/claude-shorts.

    219 GitHub stars~3.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check: notes

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Questions about Video Editing

What does Video Editing do?

AI辅助的视频编辑工作流程,用于剪辑、构建和增强实拍素材。涵盖从原始拍摄到FFmpeg、Remotion、ElevenLabs、fal.ai,再到Descript或CapCut最终润色的完整流程。适用于用户想要编辑视频、剪辑素材、制作vlog或构建视频内容的情况。. Video Editing is an agent skill from affaan-m/ECC.

When should I use Video Editing?

Video Editing fits situations like: tasks that involve Video production.

How do I install Video Editing in Claude Code?

Run `npx skills add affaan-m/ECC --skill video-editing -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/video-editing in affaan-m/ECC) into .claude/skills/video-editing in your project. Claude Code loads it when a task matches its description.

How do I install Video Editing in Codex?

Run `npx skills add affaan-m/ECC --skill video-editing -a codex`. Or copy the skill folder (docs/zh-CN/skills/video-editing in affaan-m/ECC) into .agents/skills/video-editing in your project. Codex loads it when a task matches its description.

Can I use Video Editing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill video-editing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/video-editing, .gemini/skills/video-editing, .github/skills/video-editing and .opencode/skills/video-editing in your project.

What does Video Editing need to run?

Going by SKILL.md and its folder, Video Editing needs the command-line tools its instructions call (ffmpeg and npx) and credentials named ELEVENLABS_API_KEY. Our summary lists: Python 3; Node.js; A credential in ELEVENLABS_API_KEY.

Does Video Editing access the network?

SKILL.md names 2 domains. In commands or code: api.elevenlabs.io; the agent is likely to contact it when it follows the instructions. As links in the text: remotion.dev. This is read from the text; nothing was executed.

Is Video Editing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Video Editing use?

Video Editing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Video Editing use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Video Editing?

Skills that share tags, products or a category with Video Editing: Super Video Maker (Bomx/super-video-maker-skill, 310 stars), Promo Video Maker (liyupi/ai-promo-video-maker, 121 stars), FFmpeg for Video Production (digitalsamba/claude-code-video-toolkit, 2.2k stars) and Remotion Best Practices (lyonjs/shortvid.io, 147 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Video Editing?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.