Agent Skills › htekdev/vidpipe › video-review

video-review

GitHub

利用 Gemini AI 视觉模型审查和分析视频文件。支持传入视频路径及自定义提示词，用于描述内容、检查字幕质量或评估剪辑效果，返回详细分析结果。

100 .github/skills/video-review/SKILL.md htekdev/vidpipe

Trigger Scenarios

需要审查视频内容分析视频中的视觉元素检查字幕可读性评估视频剪辑流畅度

Install

npx skills add htekdev/vidpipe --skill video-review -g -y

More Options

Non-standard path

npx skills add https://github.com/htekdev/vidpipe/tree/main/.github/skills/video-review -g -y

Use without installing

npx skills use htekdev/vidpipe@video-review

指定 Agent (Claude Code)

npx skills add htekdev/vidpipe --skill video-review -a claude-code -g -y

安装 repo 全部 skill

npx skills add htekdev/vidpipe --all -g -y

预览 repo 内 skill

npx skills add htekdev/vidpipe --list

SKILL.md

Frontmatter

{
    "name": "video-review",
    "description": "Review and inspect video files using Gemini AI vision. Use this skill when asked to inspect, review, analyze, describe, or understand what's happening in a video file. Supports custom prompts for targeted analysis."
}

Video Review Skill

Analyze any video file using Google Gemini's vision model. Upload the video, send a custom prompt (or use a default review prompt), and return Gemini's analysis.

Prerequisites

GEMINI_API_KEY environment variable set (get one at https://aistudio.google.com/apikey)
Video file must exist on disk (mp4, webm, mov)

How to Use

Run the review-video.ts script in this skill directory with the video path and an optional prompt:

cd C:\Repos\htekdev\video-auto-note-taker
npx tsx .github/skills/video-review/review-video.ts "<video-path>" "<optional-prompt>"

Arguments

video-path (required): Absolute or relative path to the video file
prompt (optional): Custom prompt to send alongside the video. If omitted, uses a general review prompt that describes what's happening in the video.

Examples

# General review — describe what's in the video
npx tsx .github/skills/video-review/review-video.ts "recordings/my-video/short-clip.mp4"

# Custom prompt — ask specific questions
npx tsx .github/skills/video-review/review-video.ts "recordings/my-video/short-clip.mp4" "Are the captions readable? Do they overlap with any important content on screen?"

# Check caption quality on a short
npx tsx .github/skills/video-review/review-video.ts "recordings/my-video/shorts/clip-square-captioned.mp4" "Describe what you see. Are there any visual issues, glitches, or misaligned elements?"

# Review editorial decisions
npx tsx .github/skills/video-review/review-video.ts "recordings/my-video/my-video-edited.mp4" "Does this video flow well? Are there any jarring cuts or awkward transitions?"

Environment Variables

Variable	Required	Description
`GEMINI_API_KEY`	Yes	Google AI Studio API key
`GEMINI_MODEL`	No	Model to use (default: `gemini-2.5-pro`)

Output

The script prints Gemini's full analysis to stdout. For large outputs, pipe to a file:

npx tsx .github/skills/video-review/review-video.ts "video.mp4" "What's wrong?" > review-output.md

Default Prompt

When no custom prompt is provided, the script uses:

Describe everything you see in this video in detail. Cover: visual layout, text/captions visible, any overlays or graphics, video quality, audio sync observations, pacing, and anything that looks wrong or could be improved. Be specific with timestamps.

Troubleshooting

"GEMINI_API_KEY is required": Set the env var in your .env file or shell
Timeout on large videos: Gemini processes uploads async — long videos may take 30-60s to become ready
Empty response: Try a simpler prompt or a shorter video clip