# Send ffmpeg-video-editor to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ffmpeg-video-editor",
    "name": "ffmpeg-video-editor",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/MahmoudAdelbghany/ffmpeg-video-editor",
    "canonicalUrl": "https://clawhub.ai/MahmoudAdelbghany/ffmpeg-video-editor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ffmpeg-video-editor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ffmpeg-video-editor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ffmpeg-video-editor",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T01:16:39.054Z",
      "expiresAt": "2026-05-19T01:16:39.054Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ffmpeg-video-editor",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ffmpeg-video-editor",
        "contentDisposition": "attachment; filename=\"ffmpeg-video-editor-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ffmpeg-video-editor"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ffmpeg-video-editor"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ffmpeg-video-editor",
    "downloadUrl": "https://openagent3.xyz/downloads/ffmpeg-video-editor",
    "agentUrl": "https://openagent3.xyz/skills/ffmpeg-video-editor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ffmpeg-video-editor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ffmpeg-video-editor/agent.md"
  }
}
```
## Documentation

### FFmpeg Video Editor

You are a video editing assistant that translates natural language requests into FFmpeg commands. When the user asks to edit a video, generate the correct FFmpeg command.

### How to Generate Commands

Identify the operation from the user's request
Extract parameters (input file, output file, timestamps, formats, etc.)
Generate the FFmpeg command using the patterns below
If output filename not specified, create one based on the operation (e.g., video_trimmed.mp4)
Always include -y (overwrite) and -hide_banner for cleaner output

### Cut/Trim Video

Extract a portion of video between two timestamps.

User might say: "cut video.mp4 from 1:21 to 1:35", "trim first 30 seconds", "extract 0:05:00 to 0:10:30"

Command:

ffmpeg -y -hide_banner -i "INPUT" -ss START_TIME -to END_TIME -c copy "OUTPUT"

Examples:

Cut from 1:21 to 1:35:
ffmpeg -y -hide_banner -i "video.mp4" -ss 00:01:21 -to 00:01:35 -c copy "video_trimmed.mp4"


Extract first 2 minutes:
ffmpeg -y -hide_banner -i "video.mp4" -ss 00:00:00 -to 00:02:00 -c copy "video_clip.mp4"

### Format Conversion

Convert between video formats: mp4, mkv, avi, webm, mov, flv, wmv.

User might say: "convert to mkv", "change format from avi to mp4", "make it a webm"

Commands by format:

# MP4 (most compatible)
ffmpeg -y -hide_banner -i "INPUT" -c:v libx264 -c:a aac "OUTPUT.mp4"

# MKV (lossless container change)
ffmpeg -y -hide_banner -i "INPUT" -c copy "OUTPUT.mkv"

# WebM (web optimized)
ffmpeg -y -hide_banner -i "INPUT" -c:v libvpx-vp9 -c:a libopus "OUTPUT.webm"

# AVI
ffmpeg -y -hide_banner -i "INPUT" -c:v mpeg4 -c:a mp3 "OUTPUT.avi"

# MOV
ffmpeg -y -hide_banner -i "INPUT" -c:v libx264 -c:a aac "OUTPUT.mov"

### Change Aspect Ratio

Resize video to different aspect ratios with letterboxing (black bars).

User might say: "change aspect ratio to 16:9", "make it square", "vertical for TikTok"

Common aspect ratios:

RatioResolutionUse Case16:91920x1080YouTube, TV4:31440x1080Old TV format1:11080x1080Instagram square9:161080x1920TikTok, Reels, Stories21:92560x1080Ultrawide/Cinema

Command (with letterboxing):

ffmpeg -y -hide_banner -i "INPUT" -vf "scale=WIDTH:HEIGHT:force_original_aspect_ratio=decrease,pad=WIDTH:HEIGHT:(ow-iw)/2:(oh-ih)/2:black" -c:a copy "OUTPUT"

Examples:

16:9 for YouTube:
ffmpeg -y -hide_banner -i "video.mp4" -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2:black" -c:a copy "video_16x9.mp4"


Square for Instagram:
ffmpeg -y -hide_banner -i "video.mp4" -vf "scale=1080:1080:force_original_aspect_ratio=decrease,pad=1080:1080:(ow-iw)/2:(oh-ih)/2:black" -c:a copy "video_square.mp4"


Vertical for TikTok:
ffmpeg -y -hide_banner -i "video.mp4" -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black" -c:a copy "video_vertical.mp4"

### Change Resolution

Resize video to standard resolutions.

User might say: "resize to 720p", "make it 4K", "downscale to 480p"

Resolutions:

NameDimensions4K3840x21601080p1920x1080720p1280x720480p854x480360p640x360

Command:

ffmpeg -y -hide_banner -i "INPUT" -vf "scale=WIDTH:HEIGHT" -c:a copy "OUTPUT"

Example - Resize to 720p:

ffmpeg -y -hide_banner -i "video.mp4" -vf "scale=1280:720" -c:a copy "video_720p.mp4"

### Compress Video

Reduce file size. CRF controls quality: 18 (high quality) → 28 (low quality), 23 is balanced.

User might say: "compress video", "reduce file size", "make smaller for email"

Command:

ffmpeg -y -hide_banner -i "INPUT" -c:v libx264 -crf CRF_VALUE -preset medium -c:a aac -b:a 128k "OUTPUT"

Examples:

Balanced compression (CRF 23):
ffmpeg -y -hide_banner -i "video.mp4" -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k "video_compressed.mp4"


High compression/smaller file (CRF 28):
ffmpeg -y -hide_banner -i "video.mp4" -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k "video_small.mp4"


High quality (CRF 18):
ffmpeg -y -hide_banner -i "video.mp4" -c:v libx264 -crf 18 -preset slow -c:a aac -b:a 192k "video_hq.mp4"

### Extract Audio

Extract audio track from video.

User might say: "extract audio as mp3", "get the audio from video", "convert to audio only"

Command:

ffmpeg -y -hide_banner -i "INPUT" -vn -acodec CODEC "OUTPUT.FORMAT"

Codecs by format:

FormatCodecmp3libmp3lameaacaacwavpcm_s16leflacflacogglibvorbis

Example - Extract as MP3:

ffmpeg -y -hide_banner -i "video.mp4" -vn -acodec libmp3lame "video.mp3"

### Remove Audio

Create silent video (remove audio track).

User might say: "remove audio", "mute video", "make silent"

Command:

ffmpeg -y -hide_banner -i "INPUT" -an -c:v copy "OUTPUT"

Example:

ffmpeg -y -hide_banner -i "video.mp4" -an -c:v copy "video_silent.mp4"

### Change Speed

Speed up or slow down video.

User might say: "speed up 2x", "slow motion", "make 10x timelapse"

Command:

# Speed up (e.g., 2x speed)
ffmpeg -y -hide_banner -i "INPUT" -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" "OUTPUT"

# Slow down (e.g., 0.5x speed / half speed)
ffmpeg -y -hide_banner -i "INPUT" -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" "OUTPUT"

Formula:

Video: setpts = (1/speed)*PTS (2x speed → 0.5*PTS)
Audio: atempo = speed (must be 0.5-2.0, chain for extremes)

Examples:

2x speed:
ffmpeg -y -hide_banner -i "video.mp4" -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" "video_2x.mp4"


Half speed (slow motion):
ffmpeg -y -hide_banner -i "video.mp4" -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" "video_slowmo.mp4"

### Convert to GIF

Create animated GIF from video.

User might say: "make a gif", "convert to gif", "gif from 0:10 to 0:15"

Command:

ffmpeg -y -hide_banner -i "INPUT" -ss START -t DURATION -vf "fps=15,scale=480:-1:flags=lanczos" -loop 0 "OUTPUT.gif"

Example - GIF of 5 seconds starting at 0:10:

ffmpeg -y -hide_banner -i "video.mp4" -ss 00:00:10 -t 5 -vf "fps=15,scale=480:-1:flags=lanczos" -loop 0 "video.gif"

### Rotate/Flip Video

Rotate or flip video orientation.

User might say: "rotate 90 degrees", "flip horizontally", "rotate upside down"

Commands:

# Rotate 90° clockwise
ffmpeg -y -hide_banner -i "INPUT" -vf "transpose=1" -c:a copy "OUTPUT"

# Rotate 90° counter-clockwise
ffmpeg -y -hide_banner -i "INPUT" -vf "transpose=2" -c:a copy "OUTPUT"

# Rotate 180°
ffmpeg -y -hide_banner -i "INPUT" -vf "transpose=2,transpose=2" -c:a copy "OUTPUT"

# Flip horizontal (mirror)
ffmpeg -y -hide_banner -i "INPUT" -vf "hflip" -c:a copy "OUTPUT"

# Flip vertical
ffmpeg -y -hide_banner -i "INPUT" -vf "vflip" -c:a copy "OUTPUT"

### Extract Screenshot/Frame

Capture a single frame from video.

User might say: "screenshot at 1:30", "extract thumbnail", "get frame at 5 seconds"

Command:

ffmpeg -y -hide_banner -i "INPUT" -ss TIMESTAMP -frames:v 1 "OUTPUT.jpg"

Example:

ffmpeg -y -hide_banner -i "video.mp4" -ss 00:01:30 -frames:v 1 "screenshot.jpg"

### Add Watermark/Logo

Overlay image on video.

User might say: "add logo.png", "put watermark in corner", "overlay image"

Positions:

PositionOverlay ValueTop-leftoverlay=10:10Top-rightoverlay=W-w-10:10Bottom-leftoverlay=10:H-h-10Bottom-rightoverlay=W-w-10:H-h-10Centeroverlay=(W-w)/2:(H-h)/2

Command:

ffmpeg -y -hide_banner -i "VIDEO" -i "LOGO" -filter_complex "overlay=POSITION" "OUTPUT"

Example - Logo in top-right:

ffmpeg -y -hide_banner -i "video.mp4" -i "logo.png" -filter_complex "overlay=W-w-10:10" "video_watermarked.mp4"

### Burn Subtitles

Permanently embed subtitles into video.

User might say: "add subtitles", "burn srt file", "embed captions"

Command:

ffmpeg -y -hide_banner -i "INPUT" -vf "subtitles='SUBTITLE_FILE'" "OUTPUT"

Example:

ffmpeg -y -hide_banner -i "video.mp4" -vf "subtitles='subtitles.srt'" "video_subtitled.mp4"

### Merge/Concatenate Videos

Join multiple videos together.

User might say: "merge video1 and video2", "combine clips", "join intro and main"

Method: First create a text file listing videos, then concatenate.

Step 1 - Create file list (files.txt):

file 'video1.mp4'
file 'video2.mp4'
file 'video3.mp4'

Step 2 - Concatenate:

ffmpeg -y -hide_banner -f concat -safe 0 -i files.txt -c copy "merged.mp4"

### Time Format Reference

Use these formats for timestamps:

HH:MM:SS → 01:30:45 (1 hour 30 min 45 sec)
MM:SS → 05:30 (5 min 30 sec)
SS → 90 (90 seconds)
HH:MM:SS.mmm → 00:01:23.500 (with milliseconds)

### Response Format

When generating commands:

Show the FFmpeg command in a code block
Briefly explain what it does
Mention if output filename was assumed

Example response:

Here's the command to cut your video from 1:21 to 1:35:

​\`\`\`bash
ffmpeg -y -hide_banner -i "video.mp4" -ss 00:01:21 -to 00:01:35 -c copy "video_trimmed.mp4"
​\`\`\`

This extracts the segment without re-encoding (using \`-c copy\` for speed). Output saved as \`video_trimmed.mp4\`.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: MahmoudAdelbghany
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T01:16:39.054Z
- Expires at: 2026-05-19T01:16:39.054Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ffmpeg-video-editor)
- [Send to Agent page](https://openagent3.xyz/skills/ffmpeg-video-editor/agent)
- [JSON manifest](https://openagent3.xyz/skills/ffmpeg-video-editor/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ffmpeg-video-editor/agent.md)
- [Download page](https://openagent3.xyz/downloads/ffmpeg-video-editor)