Initial skill: tiktok-video-review with 14-frame extraction workflow

This commit is contained in:
2026-05-25 09:49:01 +00:00
commit ece0d57388
3 changed files with 130 additions and 0 deletions

49
SKILL.md Normal file
View File

@@ -0,0 +1,49 @@
---
name: tiktok-video-review
description: 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
```bash
# 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.