Agent notes for youtube-scout
Portable instructions for any coding agent (Codex, Gemini, Cursor, and others) working in this
repository. Claude Code reads CLAUDE.md, which says the same thing.
What this is
A single-script Claude Code skill. scripts/scout.py searches YouTube Data API v3 for a topic,
enriches each video, and writes an .xlsx research workbook. SKILL.md is the runtime contract
the agent follows when a user types /scout.
Rules
- Keep dependencies to the standard library plus openpyxl. yt-dlp is optional.
- Run
python -m pytestandruff check .before proposing a change. Tests are offline. - Never commit keys,
.envfiles, workbooks, downloads, or cache. The hygiene test enforces it. - No em dashes in any output.
- Update
SKILL.md,README.md, andCHANGELOG.mdwhen flags, columns, or exit codes change. - Do not change repository visibility, create releases, or push without explicit instruction.