Scout

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.

68 stars 10 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add AgriciDaniel/youtube-scout --skill scout

Manual install

git clone --depth 1 https://github.com/AgriciDaniel/youtube-scout.git /tmp/youtube-scout
mkdir -p ~/.claude/skills
cp -r /tmp/youtube-scout/. ~/.claude/skills/scout

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# /scout

One topic in, one ranked research workbook out. The script does the whole job; your role is
to run it with the right flags, then relay the result.

## Step 1: Run

```bash
python3 "${CLAUDE_SKILL_DIR}/scripts/scout.py" <topic words> [flags]
```

Pass the user's topic as words after the script (quotes optional, the script joins them).
The API key is read from `YOUTUBE_API_KEY` in the environment, then from the file named by
`SCOUT_ENV_FILE`, then `~/.config/scout/.env`, then `./.env`. If the user keeps keys in another
env file, load it into the environment first (for example `set -a; . <keyfile>; set +a` in the
same Bash call) rather than copying the key anywhere. Never echo the key. The run prints
progress lines to stderr; a full run with `--hooks` on 50 videos takes a few minutes because
yt-dlp probes each video, so allow a long Bash timeout.

If the script reports that openpyxl is missing, run once:

```bash
pip install -r "${CLAUDE_SKILL_DIR}/requirements.txt" --quiet
```

## Flags

| Flag | Default | Meaning |
|---|---|---|
| `--max N` | 50 | Videos to collect, 1 to 200. Each block of 50 uses one of the 100 daily search calls. |
| `--since` | any | `hour`, `today`, `week`, `month`, `year`, `any` |
| `--length` | any | `short` (under 4 min), `medium` (4 to 20), `long` (over 20) |
| `--sort` | views | `views`, `engagement`, `likes`, `recent`, `momentum` (views per day), `breakout` (views per subscriber) |

Read the full skill on GitHub

Details

Skill name: scout
Repository: AgriciDaniel/youtube-scout
License: MIT
Repo updated: 30 October 2026

FAQ

What does the Scout skill do?

How do I install the Scout skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add AgriciDaniel/youtube-scout --skill scout. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Scout popular?

It lives in AgriciDaniel/youtube-scout, which has 68 GitHub stars and 10 forks.

Related skills

Confluence

SpillwaveSolutions/confluence-skill

Manage Confluence documentation with downloads, uploads, conversions, and diagrams. Use when asked to "download Confluence pages", "upload to Confluence", "convert Wiki Markup", "sync markdown to Confluence", "create Confluence page", or "handle Confluence images".

Images, Video & Audio

Video Storyboard Generator

OYYH-Apple/video-storyboard-generator

视频分镜脚本生成器，支持头脑风暴、用户偏好记忆、15秒镜头规则、角色提示词生成、音效/BGM建议。用于生成带运镜指导、画面设计、旁白、角色描述的完整分镜脚本。支持极简版（内容描述）和专业版（详细运镜）。适用：教程、书籍介绍、评论、剧情、产品介绍、数据报告。当用户说"做分镜"、"分镜脚本"、"视频分镜"时使用。

Images, Video & Audio

Dear

jiawei248/dear-skill

Use when the user wants to make a thoughtful digital gift for a specific person — a parent, partner, friend, colleague, anyone they care about. Triggered by inspiration, not schedule. Produces an expressive H5, generated image, or text artifact. Accepts context through three entries: a folder of raw material (screenshots, photos, chat exports, notes), a one-line brief, or zero-argument interactive intake.

Images, Video & Audio

Regional Culture Poster

dacnay816y62-hub/regional-culture-poster

Convert Chinese provinces, municipalities, autonomous regions, cities, counties, ancient cities, and cultural regions into restrained contemporary posters led by one culturally transformed Chinese character. Supports direct one-shot final image generation and layered production. Use when the user asks for a 中国省域文化海报、城市文化海报、地域文化视觉、极简大字海报、地区系列海报、展览主视觉、出版或社交封面，requests 直接生成、一次成图、不合成、不要后期、direct generation, or wants cultural analysis, art direction, image prompts, rendered poster images, or a coherent batch series for places such as 北京、广东、福建、江南、岭南、巴蜀 or 关中.

Images, Video & Audio13

Showreel

revfactory/showreel

한국어 모션그래픽 영상(이력서용 쇼릴·홍보 영상·프로필 영상·티저·브랜드 필름·행사 홍보·제품 소개·교육 영상·메이킹 필름)을 콘셉트부터 납품까지 만드는 스킬. 정해 둔 무드나 템플릿을 고르지 않는다. 요청마다 콘셉트 후보를 여러 개 세워 가장 강한 것을 고르고, 구간마다 아트 디렉션을 새로 정해 코드(DOM·캔버스·WebGL 셰이더·3D)로 화면을 만든 뒤, 렌더한 프레임을 직접 보며 약한 구간을 다시 만드는 일을 반복한다. 음악·효과음·ElevenLabs 나레이션·codex-image 이미지·믹스·자동 검수까지 끝낸다. 사용자에게는 사용자만 아는 사실(대상·꼭 넣을 정보·자료 위치)만 묻고, 무드·길이·구성·나레이션 여부 같은 창작 결정은 스스로 내린다. '쇼릴', '모션그래픽', '애니메이션 영상 만들어줘', '홍보 영상', '소개 영상', '인물 소개 영상', '1분 영상', 'N초 영상', '이력서용 쇼릴', '놀라운 모션 그래픽 디자이너', '전력을 다해요', '키네틱 타이포', '나레이션 넣은 영상', '티저 영상', '하네스가 어떻게 동작하는지 영상으로' 같은 요청이면 영상이라는 말이 없어도 이 스킬을 쓴다. 실사 촬영본 컷 편집, 파일 자르기

Images, Video & Audio19

Watch Video

Newuxtreme/watch-video-skill

SLASH-COMMAND-ONLY. Invoke ONLY when the user explicitly types the literal `/watch-video` slash command. Never auto-trigger on phrases like "watch this video," "summarize this video," "take notes on this video," or on a bare YouTube URL. For ad-hoc YouTube questions, fetch the transcript directly (YouTube page or yt-dlp) and skim — do not run this heavyweight pipeline.

Images, Video & Audio

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.