菜单
Manually add individual YouTube URLs to a custom collection CSV. Use when adding one-off videos to folders like library-of-minds or random, not from a channel extraction.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | add-video-to-collection |
| description | Manually add individual YouTube URLs to a custom collection CSV. Use when adding one-off videos to folders like library-of-minds or random, not from a channel extraction. |
Why? Curated collections contain videos from multiple sources—manually editing CSVs causes formatting bugs and duplicates. This skill uses the CLI to add videos safely.
ytscriber add "<youtube-url>" --folder <collection>
[!IMPORTANT] Always quote URLs to prevent shell interpretation of
?and&characters.
| Collection | Description |
|---|---|
| library-of-minds | Thought leaders, interviews, educational content |
| random | Miscellaneous, one-off interesting content |
| (custom) | Any folder name you specify |
Determine which collection the video belongs to:
| If the video is... | Use collection |
|---|---|
| Thought leader, interview, educational | library-of-minds |
| Miscellaneous, one-off interesting content | random |
| User specifies a collection | Use that collection |
ytscriber add "<youtube-url>" --folder <collection>
[!CAUTION] NEVER manually edit CSV files to add videos. Always use
ytscriber addto ensure proper formatting and duplicate detection.
Examples:
# Add to library-of-minds
ytscriber add "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --folder library-of-minds
# Add to random collection
ytscriber add "https://www.youtube.com/watch?v=jNQXAC9IVRw" --folder random
# Verbose output for debugging
ytscriber add "https://www.youtube.com/watch?v=9bZkp7q19f0" --folder random -v
| Output | Meaning |
|---|---|
Added video XXX to ... | Success — video was added |
Video XXX already exists in ... | Duplicate — no action needed |
| Error message | See Troubleshooting below |
After adding, ask the user if they want to download the transcript:
ytscriber download --folder <collection>
| Problem | Cause | Solution |
|---|---|---|
command not found: ytscriber | CLI not installed | Run pip install -e . from project root |
Invalid YouTube URL | Malformed URL | Use full URL: https://www.youtube.com/watch?v=VIDEO_ID |
Permission denied | File permissions | Check write access to data directory |
| Video not appearing in CSV | Silent failure | Run with -v flag to see debug output |
? as glob. Always wrap URLs in double quotes.youtu.be/XXX works, but full youtube.com/watch?v=XXX is preferred.ytscriber download separately.What the CLI handles automatically:
Metadata populated during transcript download:
Generate AI summaries for downloaded YouTube transcripts. Use when you want to add summaries to existing transcript files, batch process transcripts for summarization, summarize a channel's videos, generate frontmatter summaries, or when the user mentions summarize, AI summaries, OpenRouter, or transcript metadata.
Consolidate transcripts from a channel into a single file, sorted by date (newest first), up to 800K tokens. Use when preparing transcripts for LLM context or bulk analysis.
Download transcripts for all data folders sequentially. Use for overnight batch processing or when you need to download pending transcripts across all channels and collections.
Download YouTube transcripts for videos tracked in a CSV file. Use when you need to download transcripts in bulk with progress tracking, fetching transcripts overnight, processing video libraries, or when the user mentions "get transcripts", "download captions", or "bulk transcript download".
Extract video metadata from a YouTube channel and save to CSV for tracking. Use when adding a new channel, extracting conference videos, populating video lists, or when the user mentions "extract videos", "get videos from channel", "add channel", or "video metadata".
Extract videos from all enabled YouTube channels in channels.yaml. Use for batch updating video lists before downloading transcripts overnight, when the user mentions "sync channels", "update video lists", "refresh channels", or before running download-all-transcripts.