cutmv Video Tool

Perform video/audio cutting, format conversion, compression, frame/audio extraction, watermarking, and subtitle addition using FFmpeg.

Security Scan

The skill is internally consistent with its stated purpose (FFmpeg-based video processing); it needs no credentials or unusual installs and primarily runs local ffmpeg/ffprobe commands.

Purpose & Capability

Name/description (video cutting, conversion, compression, frame/audio extraction, watermarking, subtitles) align with the code and SKILL.md. The skill only requires FFmpeg on PATH and Python 3.7+, which is appropriate for the claimed functionality. The package does not request unrelated binaries, env vars, or config paths.

Instruction Scope

SKILL.md and skill.py direct the agent to run local ffmpeg/ffprobe subprocesses and operate on local files only, which matches the purpose. Minor note: skill.py uses eval(video_stream.get('r_frame_rate', '0/1')) to compute FPS from ffprobe output — this is convenient but introduces a small code-injection risk if ffprobe output is tampered with or maliciously crafted. Otherwise instructions do not read unrelated files or exfiltrate data.

Install Mechanism

No install spec; this is an instruction-only skill that expects a system ffmpeg. No remote downloads or extracted archives are executed by the skill, minimizing install-time risk.

Credentials

The skill requests no environment variables, credentials, or config paths. All operations are local filesystem and subprocess calls to ffmpeg/ffprobe, which is proportionate to video processing.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes or modify other skill configs. It does not declare autonomous elevation or special privileges beyond normal execution.

Assessment

This skill appears to do only local video processing via your system ffmpeg and does not request secrets or network endpoints. Before installing: (1) ensure ffmpeg is from a trusted source (official builds) because the skill will execute it on files you provide; (2) be aware that running ffmpeg on untrusted media can expose ffmpeg vulnerabilities—avoid processing files from unknown sources; (3) if you want maximum assurance, inspect skill.py (particularly the eval() use for frame-rate parsing) and consider replacing eval with a safe parser; (4) note that the repository/source metadata and homepage are missing — if provenance is important, ask the author for a repository or signed release.

SKILL.md - cutmv Video Tool

Skill Name

cutmv-video-tool

Description

A video processing skill for OpenClaw that leverages FFmpeg to perform video/audio cutting, format conversion, and compression. Perfect for handling video files for messaging apps with file size limits.

Capabilities

• Video Cutting: Split video/audio by time range
• Format Conversion: Convert between video/audio formats (mp4, avi, mp3, wav, etc.)
• Video Compression: Compress videos with adjustable bitrate
• Frame Extraction: Extract frames from videos at specified intervals
• Audio Extraction: Extract audio track from video
• Audio Replacement: Replace or mix audio in video
• Text Watermark: Add text overlay on video (requires freetype)
• Subtitle: Add .srt/.ass subtitle files to video

Use Cases

1. Compress videos to send via WeChat/Lark/Telegram (16MB limit)
2. Extract screenshots from videos for analysis
3. Convert video formats for different platforms
4. Cut specific segments from long videos

Requirements

System Requirements

• FFmpeg installed and available in PATH
• Python 3.7+

Python Dependencies

• None (uses subprocess to call ffmpeg)

Installation

1. Ensure FFmpeg is installed on your system:

   • macOS: brew install ffmpeg
   • Ubuntu: sudo apt install ffmpeg
   • Windows: Download from ffmpeg.org or winget install ffmpeg

2. Place the skill files in your workspace:

   ~/openclaw-workspace/skills/cutmv-video-tool/
   ├── SKILL.md
   ├── skill.py
   ├── README.md
   └── README-CN.md
   

Usage

Python API

from skill import VideoTool

tool = VideoTool()

# Compress video for messaging
tool.compress("input.mp4", "output.mp4", bitrate="1000k")

# Cut video segment
tool.cut("input.mp4", "clip.mp4", start_time=30, end_time=90)

# Convert format
tool.convert("input.mp4", "output.avi", "avi")

# Extract frames every 10 seconds
tool.extract_frames("input.mp4", "./frames/", interval=10)

CLI Usage

# Compress video
python skill.py compress input.mp4 output.mp4 1000k

# Cut video
python skill.py cut input.mp4 clip.mp4 0 60

# Convert format
python skill.py convert input.mp4 output.mp3 mp3

Configuration

No additional configuration required. The skill uses system FFmpeg installation.

Testing

Run the built-in tests:

python skill.py test

License

MIT License

Author

• Isaac (@QiaoTuCodes)

Acknowledgments

• OpenClaw team for the platform
• FFmpeg team for media processing tools

---

Author Identity: yanyan@3c3d77679723a2fe95d3faf9d2c2e5a65559acbc97fef1ef37783514a80ae453