| name | video-review |
| description | Review and summarize online videos (especially YouTube) by extracting transcript + keyframes with local tools. Use when the user asks you to "watch" a video link, react to a video, summarize a video, or extract highlights/timestamps. |
Video Review
Purpose
Review and summarize online videos (especially YouTube) by extracting transcript and keyframes with local tools.
Use when the user asks you to "watch" a video link, react to a video, summarize a video, or extract highlights and timestamps.
Workflow
- Run
skills/video-review/scripts/review_video.py with the target URL or file path.
- Read the generated
REVIEW.md in the output directory.
- Reply with:
- 3-6 bullet summary
- best moments with timestamps
- your opinion/take
- any missing capability note (if transcription failed)
Command
python3 skills/video-review/scripts/review_video.py --url "<video-url-or-file>" [--out-dir "./video-review"] [--sample-seconds 20]
Output Location
<out-dir>/<timestamp>-<slug>/REVIEW.md<out-dir>/<timestamp>-<slug>/transcript.txt (if available)<out-dir>/<timestamp>-<slug>/frames/
Notes
- Requires
yt-dlp + ffmpeg in PATH.
- Uses
whisper CLI if available for local transcription.
- If transcript is unavailable, still provide visual/keyframe-based observations and clearly say transcription was unavailable.
Smoke Test
Verify end-to-end function:
```bash
python3 skills/video-review/scripts/review_video.py \
--url "https://www.youtube.com/watch?v=jNQXAC9IVRw" \
--out-dir "./test-output" \
--sample-seconds 5
Expect: test-output/*/REVIEW.md with content summary, transcript.txt, frames/
```
Dependencies: yt-dlp, ffmpeg, whisper CLI
