Reel Analyzer

Reel Analyzer

Two companion [Claude Code](https://claude.com/claude-code) skills that turn a short-form video URL (Instagram Reel, TikTok, YouTube Shorts) into a full teardown of *why it works* — frame by frame, beat by beat. Neither skill generates or edits video; both are analysis-only.

The two skills

Skill	What it does
`reel-hook-analyzer`	Downloads a reel from a URL, extracts audio + frames, runs per-second vision analysis and speech transcription, and produces a written report, an HTML storyboard, a poster image, and audio graphs explaining the hook and pattern-interrupt.
`reel-audio-sync`	Takes the downloaded video (or any video/audio file) and does a much deeper audio-visual sync pass: beat detection, non-speech vocal events (shouts, impacts), cut-to-beat alignment scoring, and harmonic/percussive layer separation — with a psychology-grounded write-up of what's actually driving attention.

`reel-hook-analyzer` does the download and a first-pass analysis; `reel-audio-sync` is the deeper companion pass for anyone who wants to understand exactly how the edit is locked to the music. Run `reel-hook-analyzer` first, then optionally hand its `reel.mp4` to `reel-audio-sync`:

# 1. Full teardown (download + frames + audio + hook detection + report)
bash reel-hook-analyzer/scripts/analyze_reel.sh ""

# 2. Optional deeper audio-visual sync pass on the same downloaded video
bash reel-audio-sync/scripts/analyze_audio_sync.sh outputs//reel.mp4 outputs/

Why this is useful

Understanding *why* a short-form video hooks viewers usually means eyeballing it a dozen times and guessing. These skills replace the guessing with measurement: exact hook timestamps cross-checked against a deterministic cut/loudness estimate, real beat-alignment scoring instead of "feels on-beat," and vision analysis of every single frame instead of a few screenshots.

**Use