Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.
- agent-skill
- video
- promo
- marketing
youtube-scout
/scout turns one topic into a ranked YouTube research workbook — performance, creators, comments, hooks and replay hotspots in one .xlsx.
Type /scout matcha recipe in Claude Code and get a workbook with the most relevant videos ranked by performance, the creators behind them, what the audience says, the opening lines that hooked viewers, and the moments people replay. Everything the public YouTube Data API v3 exposes lands in one sheet: 48 columns per video covering views, likes, comments, engagement, views per day, views per subscriber, format, category, tags, language, captions and more. Signals the YouTube UI does not show: breakout ratio (views per subscriber), momentum (views per day), the top comment per video, hook text from captions, and replay hotspots from the most-replayed curve — the closest public proxy for retention. Five sheets: Videos, Channels (one row per creator: subscribers, totals, average engagement, best video), Summary (quota used, medians, Shorts share, top channels and tags), plus optional Comments and Transcripts (hook text and full transcript via captions or Whisper) behind --comments, --hooks and --transcribe. --into your-sheet.xlsx appends YouTube rows next to TikTok and Instagram rows in an existing social ads sheet, dedups by video id and keeps manual columns and hyperlinks intact.
What it does
- One /scout <topic> in, one ranked .xlsx out — v0.2.0, 62 tests passing, CI-badge'd
- 48 columns per video straight from YouTube Data API v3; ranked by views, engagement, momentum or breakout
- Channels, Summary, Comments and Transcripts sheets auto-built; Whisper fallback when a video has no captions
- --into appends into an existing research sheet with dedup by video id; --target codex/agents/portable installs for other runtimes
When to use it
Content strategists and SEO researchers sizing up a topic before production — what performs, who ranks, which hooks hold attention; competitor audits and outreach lists fall out of the Channels sheet.
Getting started
git clone https://github.com/AgriciDaniel/youtube-scout.git cd youtube-scout ./install.sh # copies the skill to ~/.claude/skills/scout python3 -m pip install --user openpyxl python3 -m pip install --user yt-dlp # optional: --hooks, --download, --transcribe # or as a plugin, inside Claude Code: /plugin marketplace add AgriciDaniel/youtube-scout /plugin install youtube-scout@agricidaniel-youtube-scout
Things to know
MIT, v0.2.0. Bring your own YouTube Data API key — API quota bounds every run. Replay hotspots are the closest public proxy for retention, not retention itself. Not affiliated with, sponsored by or endorsed by YouTube or Google.
Repository
AgriciDaniel/youtube-scoutCharted
Related on the map
geo-sleuth
SkillAn agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.
- agent-skill
- geolocation
- osint
- openstreetmap
Birdview
SkillA skill that makes AI coding agents map the architecture and declare the blast radius before they touch a line of code — rendered as one standalone HTML page.
- skill
- architecture
- code-visualization
- change-scope