From 974ddf827ea99502988f715e8052693818978777 Mon Sep 17 00:00:00 2001
From: luna <clawy@reversed.dev>
Date: Mon, 25 May 2026 10:02:07 +0000
Subject: [PATCH] Add README for tiktok-video-review skill

---
 README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4b5eabd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# tiktok-video-review
+
+Quick utility skill to review TikTok videos by sampling evenly distributed frames across the full video timeline.
+
+## What it does
+
+- Downloads a TikTok video with `yt-dlp`
+- Measures duration with `ffprobe`
+- Extracts evenly spaced frames with `ffmpeg`
+- Lets you quickly inspect the visual flow without full playback
+
+Default sampling count is `14` frames.
+
+## Files
+
+- `SKILL.md` - skill instructions for OpenClaw/Codex
+- `scripts/extract-frames.sh` - frame extraction helper script
+- `_meta.json` - skill metadata
+
+## Requirements
+
+- `yt-dlp`
+- `ffprobe` (from FFmpeg)
+- `ffmpeg`
+- `python3`
+
+## Usage
+
+```bash
+# 1) Download a TikTok video
+yt-dlp -o /tmp/tiktok_review.mp4 "<tiktok-url>"
+
+# 2) Extract 14 evenly distributed frames
+./scripts/extract-frames.sh \
+  --input /tmp/tiktok_review.mp4 \
+  --outdir /tmp/tiktok_review_frames \
+  --count 14
+```
+
+The script outputs files like:
+
+- `/tmp/tiktok_review_frames/frame_01.jpg`
+- ...
+- `/tmp/tiktok_review_frames/frame_14.jpg`
+
+## Notes
+
+- Sampling is centered and uniform across the entire duration.
+- For very short videos, near-duplicate frames are expected.
+- Any summary from this workflow is based on sampled frames, not every frame of the video.