Agent skill

Ffmpeg Best Practice

by linyqh in linyqh/speclip-skills

Lean FFmpeg playbook for reliable video compression, WeChat-compatible MP4 export, clip stitching, audio mixing, subtitle handling, and quick fallback decisions.

No licenceAuto-check passedMedia & Creative

Install Ffmpeg Best Practice

skills CLI
$ npx skills add linyqh/speclip-skills --skill ffmpeg-best-practice -a claude-code

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

GitHub CLI
$ gh skill install linyqh/speclip-skills ffmpeg-best-practice --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/linyqh/speclip-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ffmpeg-best-practice .claude/skills/ffmpeg-best-practice && 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
ffmpeg-best-practice
GitHub stars
110
Token cost
~2.3k tokens
SKILL.md length
892 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
None found

At a glance

Lean FFmpeg playbook for reliable video compression, WeChat-compatible MP4 export, clip stitching, audio mixing, subtitle handling, and quick fallback decisions.

  • Works in 6 steps: Fast remux, no compression → Web-safe baseline export → Recommended WeChat-style compression → …
  • Requests like 压缩视频
  • SKILL.md covers Scope, Core Workflow, Probe First and Compression Rules, plus 6 more sections
  • Calls ffmpeg and ffprobe

What it does

Ffmpeg Best Practice is an agent skill from linyqh/speclip-skills. Lean FFmpeg playbook for reliable video compression, WeChat-compatible MP4 export, clip stitching, audio mixing, subtitle handling, and quick fallback decisions. Use for requests like “压缩视频”, “微信上传”, “体积太大”, “导出更小但别糊”, “多段素材拼接”, “字幕烧录”, and “ffmpeg 报错”.

Its SKILL.md is about 2.3k 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, Transcription and Messaging and chat bots. It works with FFmpeg and WeChat. The repository describes itself as: Speclip is an AI-driven video editing tool that automates complex editing workflows through conversational AI. It provides:.

When your agent uses it

  • Requests like 压缩视频
  • Tasks that involve Video production
  • Tasks that involve Transcription

Example prompts

  • “导出更小但别糊”
  • “多段素材拼接”
  • “ffmpeg 报错”
  • “/ffmpeg-best-practice”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Fast remux, no compression
  2. Web-safe baseline export
  3. Recommended WeChat-style compression
  4. Hard file-size target with 2-pass H.264
  5. Concat and normalize mixed clips
  6. Subtitle handling

What it can do on your machine

Read from SKILL.md and the folder at commit cb51e23. 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
    • ffprobe

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Ffmpeg Best Practice loads about 2.3k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 892 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 892 words (~2,302 tokens).

“Use this skill when the task requires direct FFmpeg work and the answer should be stable, compatible, and easy to adapt.”

— opening of SKILL.md by linyqh
name
ffmpeg-best-practice

Read the full SKILL.md on GitHub

Files

Just SKILL.md in ffmpeg-best-practice of linyqh/speclip-skills.

Open the folder on GitHubat commit cb51e23

Compare with similar skills

Ffmpeg Best Practice 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.

Ffmpeg Best Practice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ffmpeg Best Practice this skilllinyqh/speclip-skills110—~2.3kAutomated safety check: PassNone
Video Downloaderkangarooking/kangarooking-skills661—~8.3kAutomated safety check: PassNone
Ffmpeg Skillkajisho5/ffmpeg-skill1.9k—~7.4kAutomated safety check: PassMIT
ShortsAgriciDaniel/claude-shorts219—~3.2kAutomated safety check: NotesMIT
Explain Videolimin112/min-skill412—~2.4kAutomated safety check: PassNone
Cassette Video EditCassette-Editor/oh-my-cassette1581 repos~3.4kAutomated safety check: PassMIT

Similar skills

  • Video Downloader

    kangarooking/kangarooking-skills

    Download or open videos and recover platform captions, audio transcripts, keyframes, screen text, visual facts, and editing observations as a plain multimodaltranscript.md.

    661 GitHub stars~8.3k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Ffmpeg Skill

    kajisho5/ffmpeg-skill

    Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…

    1.9k GitHub stars~7.4k tokensUpdated 4 days ago
    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
  • Explain Video

    limin112/min-skill

    Build a narrated explainer video from a concept — discussion → structure → HTML slide deck → narration script → TTS voice → subtitles → background music → Playwright screen recording → ffmpeg…

    412 GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    158 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Qiaomu Cut

    joeseesun/qiaomu-cut-skill

    把一句话需求转成可复现、可验收视频工程的乔木智能剪辑导演。Use when the user asks to create, plan, edit, remix, explain, narrate, subtitle, animate, composite, or render a video—including one-line requests such as “制作一个科普视频:介绍…

    372 GitHub stars~6.8k tokensUpdated 11 days ago
    Media & CreativeAuto-check: notes

More from linyqh/speclip-skills

  • Drama Explainer

    linyqh/speclip-skills

    制作“解说配音 + 原片高张力片段穿插”的短剧解说成片技能。适用于短剧二创、剧情解说、狗血短剧混剪、情绪冲突型剧情拆解、影视解说口播成片等场景;当用户希望从短剧原片直接产出可剪辑脚本、解说配音、分镜数据和最终成片时应触发。尤其适合“保留原片最有戏的台词和表演,再用解说串联剧情”的任务。不要在普通剧情总结、影评、纯文案改写、纯字幕烧录、普通视频剪切中使用本技能。

    110 GitHub stars~2.5k tokensUpdated 6 mo ago
    Auto-check passed
  • Talking Head Editor

    linyqh/speclip-skills

    口播 / talking-head 视频精剪 skill。适用于单人出镜口播、采访、自述、 课程讲解、播客切条等以 A-roll 说话为主的视频。Use when the user asks for “剪口播”, “删停顿”, “去废话”, “删语气词”, “jump cut”, “按字幕精剪”, “根据 transcript 粗剪”, “采访精剪”, “单人口播提速”, or “把这段…

    110 GitHub stars~869 tokensUpdated 6 mo ago
    Auto-check passed
  • Landscape Subtitle Layout

    linyqh/speclip-skills

    横屏视频字幕位置与参数配置 skill。适用于 16:9 或其他横屏视频的字幕烧录、ASS 样式调整、底部安全区控制,以及“字幕太高/太低/太贴边/太挤”这类字幕排版请求。

    110 GitHub stars~665 tokensUpdated 6 mo ago
    Auto-check passed
  • Portrait Subtitle Layout

    linyqh/speclip-skills

    竖屏视频字幕位置与参数配置 skill。适用于 9:16 或其他竖屏视频的字幕烧录、ASS 样式调整、安全区控制、替换或压住原视频自带字幕,以及“字幕别挡脸/别压底部按钮/盖住原字幕/字体太小/字幕超宽/字幕变成三行”这类字幕排版请求。当前版本只优化字幕参数,不处理遮罩、底板、背景条或毛玻璃效果。只要用户提到竖屏字幕位置、字号、边距、换行、盖住原字幕,都应优先使用这个 skill。

    110 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Drama Script Writer

    linyqh/speclip-skills

    为短剧、影视、悬疑剧情视频创作解说文案。适用于根据字幕、剧情梗概、人物关系、视觉笔记撰写或改写解说词;默认采用《豺狼的日子1-6》这类高信息密度、短句推进、先抛钩子后回顾的连载解说风格。触发场景:用户要求写短剧解说文案、影视解说词、连载剧情旁白、根据字幕改写成解说、模仿《豺狼的日子》这类风格。

    110 GitHub stars~860 tokensUpdated 6 mo ago
    Auto-check passed
  • Short Drama Commentary

    linyqh/speclip-skills

    字幕优先的短剧解说结构设计 skill。适用于分析优秀短剧解说字幕、拆解它们的结构与节奏、判断什么时候插原片什么时候上解说,或基于原剧字幕 / 梗概直接产出短剧解说的 beat sheet、插片计划和口播稿。用户一旦提到“短剧解说结构”“原片穿插”“什么时候放原声”“根据字幕做解说”“学习优秀短剧解说”“拆解短剧解说账号”这类需求,应优先触发。不要在纯视频裁切、纯字幕排版、普通剧情总结、纯影评里…

    110 GitHub stars~949 tokensUpdated 6 mo ago
    Auto-check passed

Works with

Questions about Ffmpeg Best Practice

What does Ffmpeg Best Practice do?

Lean FFmpeg playbook for reliable video compression, WeChat-compatible MP4 export, clip stitching, audio mixing, subtitle handling, and quick fallback decisions. Ffmpeg Best Practice is an agent skill from linyqh/speclip-skills. Lean FFmpeg playbook for reliable video compression, WeChat-compatible MP4 export, clip stitching, audio mixing, subtitle handling, and quick fallback decisions.

When should I use Ffmpeg Best Practice?

Ffmpeg Best Practice fits situations like: requests like 压缩视频; tasks that involve Video production; tasks that involve Transcription.

How do I install Ffmpeg Best Practice in Claude Code?

Run `npx skills add linyqh/speclip-skills --skill ffmpeg-best-practice -a claude-code`. Or copy the skill folder (ffmpeg-best-practice in linyqh/speclip-skills) into .claude/skills/ffmpeg-best-practice in your project. Claude Code loads it when a task matches its description.

How do I install Ffmpeg Best Practice in Codex?

Run `npx skills add linyqh/speclip-skills --skill ffmpeg-best-practice -a codex`. Or copy the skill folder (ffmpeg-best-practice in linyqh/speclip-skills) into .agents/skills/ffmpeg-best-practice in your project. Codex loads it when a task matches its description.

Can I use Ffmpeg Best Practice 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 linyqh/speclip-skills --skill ffmpeg-best-practice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ffmpeg-best-practice, .gemini/skills/ffmpeg-best-practice, .github/skills/ffmpeg-best-practice and .opencode/skills/ffmpeg-best-practice in your project.

What does Ffmpeg Best Practice need to run?

Going by SKILL.md and its folder, Ffmpeg Best Practice needs the command-line tools its instructions call (ffmpeg and ffprobe).

Does Ffmpeg Best Practice access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ffmpeg Best Practice 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 Ffmpeg Best Practice use?

No licence was found for Ffmpeg Best Practice or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Ffmpeg Best Practice use?

About 2.3k tokens (SKILL.md is roughly 9.2k 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 Ffmpeg Best Practice?

Skills that share tags, products or a category with Ffmpeg Best Practice: Video Downloader (kangarooking/kangarooking-skills, 661 stars), Ffmpeg Skill (kajisho5/ffmpeg-skill, 1.9k stars), Shorts (AgriciDaniel/claude-shorts, 219 stars) and Explain Video (limin112/min-skill, 412 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ffmpeg Best Practice?

linyqh (a GitHub user) maintains it in linyqh/speclip-skills, which has 110 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on April 12, 2026.

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