valisted
Install: claude install-skill TomSchoe/visualizer
# Visualizer (/va) — truly understand videos
All scripts and prompt templates live in `scripts/` and `prompts/` next to this file —
resolve their paths from this skill's base directory (shown when the skill loads).
Two passes run by default (both, whenever a Gemini key is available), then YOU merge
the results into one answer. Without a key, Pass 1 alone still works (transcript-only).
## Pass 0 — Dedup check (0 tokens, only if the user keeps a notes folder)
If `VA_NOTES_DIR` is set (or the user has told you where their video notes live), grep
that folder for the video ID before analyzing. Hit → point to the existing note instead
of re-analyzing. No notes folder → skip this pass.
## Pass 1 — yt-dlp (free, seconds, no API key needed)
```bash
<skill-dir>/scripts/yt_fetch.sh "<URL>" "<outdir>"
```
Writes to `<outdir>`:
- `meta.md` — title, channel, duration, date, chapters, **full video description**
- `links.md` — every URL from the description (the main source for mentioned tools/repos — Gemini never sees the description!)
- `transcript.md` — cleaned transcript with `[MM:SS]` timestamps
Use a temp/scratch directory. For videos >1h, read the transcript in sections.
## Pass 2 — Gemini as video eyes (free tier: 8h YouTube/day)
```bash
<skill-dir>/scripts/gemini_watch.sh "<URL-or-file>" "<prompt>" > "<outdir>/gemini.md"
```
ALWAYS redirect output to a file (it is long and gets truncated otherwise), then read the file.
- Accepts YouTube URLs (direct, no download), **any o