关于 video-summarizer
使用 Gemini API 分析 MP4 文件,并在每个视频旁保存 Markdown 摘要的技能。支持递归处理目录、自定义提示词,以及跳过已有摘要的视频。
主要功能
- 01通过 Gemini API 分析 MP4
- 02递归处理目录
- 03以内联文本或文件指定提示词
- 04在视频旁生成 Markdown 摘要
- 05跳过已有摘要的视频
适用场景
- 01汇总目录中的视频录制
- 02提取提及的项目或行动事项
- 03制作带时间戳的视频大纲
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ maystudios/ claude-skills --skill video-summarizer安装后在 Claude Code 中输入/video-summarizer确认已加载。
附带文件README.mdscripts/summarize_videos.py
详细介绍
视频摘要
通过 Gemini API 分析目录中的 MP4 文件,并在每个视频旁边写入一个 .md 摘要文件。
前提条件
- 必须设置
GEMINI_API_KEY环境变量 - 已安装
google-genai:py -m pip install google-genai - Python 可通过
py(Windows)或python3运行
工作流
1. 确定提示词
检查用户是否提供了自定义提示词或特定的提取说明。
- 没有自定义提示词 -> 使用默认格式(包含标题、摘要、要点和收获的结构化摘要)
- 用户提供了自定义说明 -> 通过
--prompt或--prompt-file传入
自定义提示词会完全替代默认提示词。自定义提示词示例:
- “提取所有提到的工具、它们的价格,以及每个工具的一句话介绍”
- “列出视频中提到的每项待办事项和截止日期”
- “创建带时间戳的文字稿大纲”
2. 运行脚本
# Default summary — all videos in current directory (recursive)
py scripts/summarize_videos.py
# Default summary — specific directory
py scripts/summarize_videos.py "C:/path/to/videos"
# Custom prompt (inline) — replaces default summary format
py scripts/summarize_videos.py --prompt "Extract all product names and prices mentioned"
# Custom prompt (from file) — replaces default summary format
py scripts/summarize_videos.py --prompt-file my-prompt.txt
# Both directory and custom prompt
py scripts/summarize_videos.py "C:/path/to/videos" --prompt "List all key decisions made"
3. Claude 应如何处理用户参数
用户调用此技能时:
- 如果用户指定了自定义提示词或提取目标(例如“提取所有提到的工具”、“着重总结定价”或“列出待办事项”),通过
--prompt "..."传入。 - 如果用户提供了提示词文件路径,通过
--prompt-file path/to/file.txt传入。 - 如果用户没有提供具体说明,则不使用
--prompt运行,以采用默认格式。 - 如果用户指定了目录,将其作为第一个位置参数传入。
4. 默认输出格式(未提供自定义提示词时)
# [Video Title]
## Summary
[2-3 sentence description]
## Key Points
- point 1
- point 2
- ...
## Core Content & Takeaways
[Central message and key insight]
---
*Auto-generated with Gemini API*
备注
- 摘要语言与视频语言一致
- 处理后会自动从 Gemini 存储中删除文件(限时 48 小时)
- 再次运行时会跳过已生成摘要的视频
- 脚本路径:
scripts/summarize_videos.py - 模型:
gemini-3-flash-preview
评论
支持 Markdown