minutes-video-review

name	minutes-video-review
description	Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review. Use when the user wants a recorded demo or bug clip turned into a durable brief with transcript, key frames, issues, and next steps.
triggers	["analyze this video","review this video","review this walkthrough","review this bug report video","summarize this Loom","summarize this ScreenPal","video intel"]
user_invocable	true
metadata	{"display_name":"Minutes Video Review","short_description":"Review a demo, walkthrough, or bug video into a durable brief.","default_prompt":"Use Minutes Video Review to analyze this recorded video and return a transcript plus actionable brief.","site_category":"Artifacts","site_example":"/minutes-video-review https://go.screenpal.com/watch/...","site_best_for":"Turn a Loom, ScreenPal, or local walkthrough video into a durable artifact bundle for agent review."}
assets	{"scripts":["scripts/video_review.py"],"templates":[],"references":["references/dependencies.md","references/output-schema.md"]}
output	{"claude":{"path":".claude/plugins/minutes/skills/minutes-video-review/SKILL.md"},"codex":{"path":".agents/skills/minutes/minutes-video-review/SKILL.md"}}
tests	{"golden":true,"lint_commands":true}

/minutes-video-review

Analyze a product walkthrough, bug report video, Loom, ScreenPal, or local recording into a durable artifact bundle that agents can keep working from.

This skill is for meeting-adjacent product artifacts, not for generic "understand any video" requests. Use it when the user wants a recorded demo, bug repro, or walkthrough turned into something actionable for engineering, product, support, or follow-up agent work.

What this skill does

The bundled script handles the deterministic pipeline:

• resolve a local file or hosted video URL
• download hosted video when needed
• extract audio with ffmpeg
• transcribe with Minutes first, using the user's existing Minutes transcription setup
• sample key frames with adaptive caps so long videos do not blow up context
• write a durable artifact bundle under ~/.minutes/video-reviews/

Then you review the resulting artifacts and return the actual user-facing brief.

Primary command

Local file:

python3 "${CLAUDE_PLUGIN_ROOT}/skills/minutes-video-review/scripts/video_review.py" \
  "/absolute/path/to/video.mp4"

Hosted video:

python3 "${CLAUDE_PLUGIN_ROOT}/skills/minutes-video-review/scripts/video_review.py" \
  "https://go.screenpal.com/watch/..."

Useful options:

python3 "${CLAUDE_PLUGIN_ROOT}/skills/minutes-video-review/scripts/video_review.py" \
  "https://www.loom.com/share/..." \
  --focus "customer signup bug repro" \
  --cookies-from-browser chrome \
  --env-file /absolute/path/to/.env \
  --frame-step 15 \
  --max-frames 36 \
  --keep-temp

How to use it

Phase 1: Run the pipeline

Run the script on the provided local file or hosted video URL.

The script prints JSON with the output artifact paths. Important outputs include:

• analysis_md
• analysis_json
• transcript_md
• metadata_json