Index of every page on this site: llms.txt
All skills
agricidaniel avatar

/youtube-scout

@8edb2b6
Run it yourself

Scout a topic on YouTube. Searches YouTube Data API v3 for the most relevant videos, ranks them by views (or engagement, likes, recency, momentum, breakout), and writes a research workbook in the OWT-Social-Ads layout with Videos, Channels, and Summary sheets, plus optional Comments and Transcripts (hooks, replay hotspots) sheets. Can also append into an existing sheet. Use when the user says "scout <topic>", wants a spreadsheet of top YouTube videos on a topic, wants creator or hook research, or wants YouTube rows added to their social ads sheet.

  • 36 files
  • 451.3 KB
  • Updated 2 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/agricidaniel/youtube-scout/youtube-scout

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

AGENTS.md

≈240 tokens on demand. Your agent reads this file only when SKILL.md points to it.

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

  1. Keep dependencies to the standard library plus openpyxl. yt-dlp is optional.
  2. Run python -m pytest and ruff check . before proposing a change. Tests are offline.
  3. Never commit keys, .env files, workbooks, downloads, or cache. The hygiene test enforces it.
  4. No em dashes in any output.
  5. Update SKILL.md, README.md, and CHANGELOG.md when flags, columns, or exit codes change.
  6. Do not change repository visibility, create releases, or push without explicit instruction.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 8edb2b6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Activeupdated 2 months ago
What it can do
Runs commands Reads files
user-invocable
true
All 2 allowed tools
BashRead
Other metadata
argument-hint
<topic> [--max 50] [--since month] [--length short] [--sort views] [--comments] [--hooks] [--transcribe] [--into file.xlsx] [--download [N]] [--dry-run]

README badge

README badge for agricidaniel/youtube-scout