How do I install the Video Frames skill?

Run npx skillmds@latest add caoronglin/video-frames in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Video Frames skill do?

Extract frames or short clips from videos using ffmpeg. Supports extracting single frames, generating thumbnails, creating previews, and extracting clips from videos in various formats (MP4, AVI, MKV, MOV, etc.). It is listed under Coding & Dev Tools on SkillMD.

Is Video Frames safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Video Frames?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Video Frames free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Video Frames?

caoronglin (@caoronglin) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Video Frames by caoronglin — Agent Skill

Name: Video Frames
Author: caoronglin

Video Frames - 视频帧提取技能

使用 ffmpeg 从视频中提取帧、生成缩略图或创建短视频片段。

🎯 核心功能

帧提取

单帧提取 - 从指定时间点提取单张图片
缩略图生成 - 自动生成视频缩略图
预览帧 - 创建视频预览图片序列
关键帧提取 - 提取视频关键帧

视频处理

片段提取 - 提取视频特定时间段的片段
格式转换 - 视频格式转换和压缩
分辨率调整 - 调整视频分辨率和质量
元数据提取 - 提取视频信息和元数据

🚀 快速开始

安装依赖

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y ffmpeg

# CentOS/RHEL
sudo yum install -y ffmpeg

# macOS (使用Homebrew)
brew install ffmpeg

# 检查安装
ffmpeg -version

基础使用

# 提取第一帧
{baseDir}/scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg

# 指定时间点提取
{baseDir}/scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg

# 提取视频片段
{baseDir}/scripts/clip.sh /path/to/video.mp4 --start 00:00:05 --duration 10 --out /tmp/clip.mp4

📖 使用示例

中文示例

# 1. 从视频提取封面帧
{baseDir}/scripts/frame.sh /path/to/教学视频.mp4 --out 封面.jpg

# 2. 提取视频中间帧作为预览
{baseDir}/scripts/frame.sh /path/to/演示视频.mp4 --time 00:01:30 --out 预览.jpg

# 3. 生成缩略图网格（3x3）
{baseDir}/scripts/thumbnails.sh /path/to/完整视频.mp4 --grid 3x3 --out 缩略图网格.jpg

# 4. 提取视频关键片段
{baseDir}/scripts/clip.sh /path/to/会议录像.mp4 --start 00:10:00 --duration 300 --out 会议精华.mp4

# 5. 批量提取视频帧
for video in *.mp4; do
    {baseDir}/scripts/frame.sh "$video" --time 00:00:05 --out "${video%.mp4}-preview.jpg"
done

英文示例

# 1. Extract cover frame from video
{baseDir}/scripts/frame.sh /path/to/tutorial.mp4 --out cover.jpg

# 2. Extract frame at specific timestamp
{baseDir}/scripts/frame.sh /path/to/demo.mp4 --time 00:01:30 --out preview.jpg

# 3. Generate thumbnail grid (3x3)
{baseDir}/scripts/thumbnails.sh /path/to/full-video.mp4 --grid 3x3 --out thumbnail-grid.jpg

# 4. Extract important clip from video
{baseDir}/scripts/clip.sh /path/to/meeting-recording.mp4 --start 00:10:00 --duration 300 --out highlights.mp4

# 5. Batch extract frames from videos
for video in *.mp4; do
    {baseDir}/scripts/frame.sh "$video" --time 00:00:05 --out "${video%.mp4}-preview.jpg"
done

🔧 核心脚本

frame.sh - 帧提取脚本

#!/bin/bash
# 提取视频帧

VIDEO="$1"
OUTPUT="$2"
TIME="${3:-00:00:00}"

# 基本帧提取
ffmpeg -i "$VIDEO" -ss "$TIME" -vframes 1 -q:v 2 "$OUTPUT" 2>/dev/null

# 带缩放和优化的帧提取
# ffmpeg -i "$VIDEO" -ss "$TIME" -vframes 1 -vf "scale='min(1280,iw)':-1" -q:v 2 "$OUTPUT" 2>/dev/null

clip.sh - 片段提取脚本

#!/bin/bash
# 提取视频片段

VIDEO="$1"
START="$2"
DURATION="$3"
OUTPUT="$4"

# 提取片段
ffmpeg -i "$VIDEO" -ss "$START" -t "$DURATION" -c copy "$OUTPUT" 2>/dev/null

# 带重编码的片段提取
# ffmpeg -i "$VIDEO" -ss "$START" -t "$DURATION" -c:v libx264 -c:a aac "$OUTPUT" 2>/dev/null

thumbnails.sh - 缩略图生成脚本

#!/bin/bash
# 生成缩略图网格

VIDEO="$1"
GRID="$2"  # 格式: 3x3
OUTPUT="$3"

# 计算总帧数和间隔
TOTAL_FRAMES=9  # 3x3网格
VIDEO_DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$VIDEO")
INTERVAL=$(echo "$VIDEO_DURATION / ($TOTAL_FRAMES + 1)" | bc)

# 生成缩略图
for i in $(seq 1 $TOTAL_FRAMES); do
    TIME=$(echo "$INTERVAL * $i" | bc)
    ffmpeg -i "$VIDEO" -ss "$TIME" -vframes 1 -q:v 2 "temp_$i.jpg" 2>/dev/null
done

# 合并为网格
montage temp_*.jpg -tile "$GRID" -geometry +0+0 "$OUTPUT"
rm temp_*.jpg

🛠️ 高级功能

关键帧提取

# 提取所有关键帧
{baseDir}/scripts/keyframes.sh /path/to/video.mp4 --out keyframes/

# 提取关键帧并生成摘要
{baseDir}/scripts/keyframes.sh /path/to/video.mp4 --summary --out video-summary/

视频分析

# 获取视频信息
{baseDir}/scripts/info.sh /path/to/video.mp4

# 分析视频场景变化
{baseDir}/scripts/scene-detect.sh /path/to/video.mp4 --out scenes.json

# 检测视频中的文本和字幕
{baseDir}/scripts/subtitle-detect.sh /path/to/video.mp4 --out subtitles.txt

批量处理

# 批量提取所有视频的预览帧
{baseDir}/scripts/batch-process.sh /path/to/videos/ --action frame --time 00:00:05

# 批量生成缩略图
{baseDir}/scripts/batch-process.sh /path/to/videos/ --action thumbnail --grid 2x2

# 批量提取片段
{baseDir}/scripts/batch-process.sh /path/to/videos/ --action clip --start 00:00:00 --duration 10

📁 文件结构

video-frames/
├── SKILL.md                    # 技能说明文档
├── _meta.json                  # 元数据
├── scripts/
│   ├── frame.sh                # 帧提取脚本
│   ├── clip.sh                 # 片段提取脚本
│   ├── thumbnails.sh           # 缩略图脚本
│   ├── keyframes.sh            # 关键帧提取
│   ├── info.sh                 # 视频信息提取
│   ├── scene-detect.sh         # 场景检测
│   ├── subtitle-detect.sh      # 字幕检测
│   ├── batch-process.sh        # 批量处理
│   └── utils.sh                # 工具函数
├── examples/
│   ├── basic-examples/         # 基础示例
│   ├── advanced-examples/      # 高级示例
│   └── batch-examples/         # 批量处理示例
└── references/
    ├── ffmpeg-guide.md         # ffmpeg使用指南
    ├── video-formats.md        # 视频格式参考
    └── optimization-tips.md    # 优化技巧

⚠️ 故障排除

常见问题

ffmpeg未安装

# 检查是否安装
which ffmpeg

# 安装ffmpeg
# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y ffmpeg

# CentOS/RHEL
sudo yum install -y ffmpeg

# macOS
brew install ffmpeg

视频格式不支持

# 检查视频信息
ffprobe /path/to/video.mp4

# 转换视频格式
ffmpeg -i input.avi -c:v libx264 -c:a aac output.mp4

帧提取质量差

# 提高提取质量
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -q:v 1 high-quality.jpg

# 使用精确搜索模式
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -accurate_seek -q:v 2 accurate.jpg

调试模式

# 启用详细输出
export FFMPEG_VERBOSE=1

# 运行脚本
./scripts/frame.sh video.mp4 --out test.jpg --debug

# 查看ffmpeg日志
tail -f ffmpeg.log

🔄 与其他技能集成

与image-recognition技能集成

# 提取视频帧并进行图像识别
{baseDir}/scripts/frame.sh video.mp4 --time 00:00:10 --out frame.jpg
python3 -m image_recognition recognize frame.jpg --output analysis.json

# 批量提取并识别
{baseDir}/scripts/batch-process.sh videos/ --action frame --interval 30 | \
  xargs -I {} python3 -m image_recognition recognize {} --output {}.json

与飞书技能集成

# 提取视频预览并发送到飞书
{baseDir}/scripts/frame.sh presentation.mp4 --time 00:02:00 --out preview.jpg
python3 -c "
import requests
# 发送图片到飞书
print('发送视频预览到飞书')
"

# 生成视频摘要并分享
{baseDir}/scripts/thumbnails.sh tutorial.mp4 --grid 2x2 --out summary.jpg
# 发送到飞书群组

与self-improving-agent集成

# 记录视频处理经验
cat >> .learnings/LEARNINGS.md << 'EOF'
## [LRN-202603121-001] 视频帧提取

**记录时间**: 2026-03-12T16:30:00Z
**优先级**: 中
**状态**: 已验证
**领域**: 多媒体

### 总结
使用ffmpeg提取视频帧的最佳实践

### 详细
1. 使用-ss参数进行精确时间定位
2. 使用-q:v 2平衡质量和文件大小
3. 批量处理时使用并行处理提高效率
4. 关键帧提取使用-seek精确模式
EOF

📊 性能优化

提取优化

# 使用硬件加速（如果可用）
ffmpeg -hwaccel cuda -i video.mp4 -ss 00:00:10 -vframes 1 frame.jpg

# 优化内存使用
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -threads 2 frame.jpg

# 批量处理优化
parallel -j 4 ffmpeg -i {} -ss 00:00:05 -vframes 1 {.}.jpg ::: *.mp4

质量设置

# 高质量提取（大文件）
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -q:v 1 high-quality.jpg

# 中等质量（推荐）
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -q:v 2 medium-quality.jpg

# 低质量（快速预览）
ffmpeg -i video.mp4 -ss 00:00:10 -vframes 1 -q:v 5 low-quality.jpg

🎯 最佳实践

帧提取

精确时间 - 使用-ss参数进行精确时间定位
质量平衡 - 根据用途选择适当的质量级别
格式选择 - JPEG用于预览，PNG用于精确分析
错误处理 - 检查视频是否存在，格式是否支持

批量处理

并行处理 - 使用GNU parallel提高处理速度
内存管理 - 控制同时处理的视频数量
进度跟踪 - 显示处理进度和预估时间
结果验证 - 验证提取的帧是否正确

🔮 未来计划

v2.0.0 计划功能

AI驱动的智能帧选择
视频内容分析摘要
自动字幕生成
人脸和物体检测
视频风格转换

短期改进

更多视频格式支持
更好的错误处理和恢复
GPU加速处理
云存储集成
移动设备优化

✨ 从视频中提取精彩瞬间，让内容创作更简单！

Video Frames

File contents

Video Frames - 视频帧提取技能

🎯 核心功能

帧提取

视频处理

🚀 快速开始

安装依赖

基础使用

📖 使用示例

中文示例

英文示例

🔧 核心脚本

frame.sh - 帧提取脚本

clip.sh - 片段提取脚本

thumbnails.sh - 缩略图生成脚本

🛠️ 高级功能

关键帧提取

视频分析

批量处理

📁 文件结构

⚠️ 故障排除

常见问题

调试模式

🔄 与其他技能集成

与image-recognition技能集成

与飞书技能集成

与self-improving-agent集成

📊 性能优化

提取优化

质量设置

🎯 最佳实践

帧提取

批量处理

🔮 未来计划

v2.0.0 计划功能

短期改进

Frequently asked questions

Video Frames

File contents

Video Frames - 视频帧提取技能

🎯 核心功能

帧提取

视频处理

🚀 快速开始

安装依赖

基础使用

📖 使用示例

中文示例

英文示例

🔧 核心脚本

frame.sh - 帧提取脚本

clip.sh - 片段提取脚本

thumbnails.sh - 缩略图生成脚本

🛠️ 高级功能

关键帧提取

视频分析

批量处理

📁 文件结构

⚠️ 故障排除

常见问题

调试模式

🔄 与其他技能集成

与image-recognition技能集成

与飞书技能集成

与self-improving-agent集成

📊 性能优化

提取优化

质量设置

🎯 最佳实践

帧提取

批量处理

🔮 未来计划

v2.0.0 计划功能

短期改进

Related skills

Frequently asked questions

How do I install the Video Frames skill?

What does the Video Frames skill do?

Is Video Frames safe to use?

Which AI agents work with Video Frames?

Is Video Frames free to use?

Who published Video Frames?