# Youtube Search

> Use this skill when the user asks to search YouTube or find videos by keyword. Trigger on phrases like "search youtube", "find on youtube", "look up on youtube", or when the user provides search keywords and wants YouTube results. Always use this skill for YouTube searches.

- Skill: `yysun/youtube-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yysun/youtube-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yysun/youtube-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yysun (https://skillmd.com/u/yysun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yysun/youtube-search

---


# youtube-search Skill

## How to Search

```
node scripts/ytdlp-search.mjs --q "<keywords>" [--n 5] 
```

**Output JSON fields:** `ok`, `code`, `results[]` (id, title, url, duration, uploader, view_count), `stderr`

- Default `--n` to 5 unless the user specifies otherwise.
- Present results as a numbered list: title · duration · uploader · URL.
- If `ok=false`, show the most relevant stderr lines and suggest checking the search terms.