tiktok-video-review/SKILL.md

name, description

name	description
tiktok-video-review	Download a TikTok video, extract evenly distributed frames (default 14), and inspect content quickly.

tiktok-video-review

Use this skill when someone wants you to actually look inside a TikTok video instead of only reading metadata.

Goal

Get a fast visual understanding of a TikTok by extracting evenly distributed frames across the full video.

Default assumption:

• 14 frames across the entire video.

Required tools

• yt-dlp
• ffprobe
• ffmpeg

If missing, install before proceeding.

Workflow

1. Download the TikTok URL to a local mp4.
2. Read duration with ffprobe.
3. Extract 14 evenly spaced frames using the helper script.
4. View the extracted frames and summarize what happens in the video.

Commands

# 1) Download
yt-dlp -o /tmp/tiktok_review.mp4 "<tiktok-url>"

# 2) Extract 14 frames across duration
skills/tiktok-video-review/scripts/extract-frames.sh \
  --input /tmp/tiktok_review.mp4 \
  --outdir /tmp/tiktok_review_frames \
  --count 14

Notes

• Keep frame extraction uniform across the timeline, not clustered at the start.
• If the video is very short, still aim for the requested count and accept near-duplicate moments.
• Always state clearly that the summary is based on sampled frames, not full per-frame playback.