Claude Skill

youtube-full

Use for any YouTube URL, video ID or @handle, or a request for transcripts, video search, channel, playlist or new-upload monitoring. Fetches them with yt-dlp, youtube-transcript-api and public RSS feeds, with no API key; no video or audio downloads.

LLM Mart · 0 points · 5 views 0 listing impressions 0 install-command copies
Download alirezarezvani-claude-skills-marketing-skill_skills_youtube-full-9ef0c3c.zip · 3 KB

Install

skills CLI npx skills add https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/youtube-full
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alirezarezvani-claude-skills@llmmart
Git git clone https://github.com/alirezarezvani/claude-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alirezarezvani/claude-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

youtube-full — YouTube Transcripts, Search, and Channel Data

Covers transcript extraction, video search, channel browsing, in-channel search, playlist extraction, and new-upload monitoring. The default path is free and open source: yt-dlp, youtube-transcript-api and YouTube's public RSS feeds. No account and no API key are needed.

Source: Ported from ZeroPointRepo/youtube-skills (MIT). Original skill authored by ZeroPointRepo contributors. Adapted for the claude-skills format, reworked to be open-source first.

Setup

pip install yt-dlp youtube-transcript-api

Both are open source (yt-dlp: Unlicense; youtube-transcript-api: MIT) and run locally. Nothing is sent anywhere except YouTube itself. If they are missing, tell the user the install command; do not install packages into their environment without asking.

Operations

Accept a full URL, a youtu.be link, or a bare 11-character video ID. youtube_transcript_api takes the bare ID only, so extract it from a URL first (v= parameter, or the path segment after youtu.be/ or /shorts/).

Get transcript

youtube_transcript_api VIDEO_ID --languages en --format text     # plain text
youtube_transcript_api VIDEO_ID --languages en --format json     # with start/duration timestamps
youtube_transcript_api VIDEO_ID --list-transcripts               # which languages exist

In Python (v1.x API): YouTubeTranscriptApi().fetch("VIDEO_ID", languages=["en"]). Use this for any "get transcript", "summarize video", or "extract quotes" request. Pass the user's language first in --languages and fall back to en.

If it fails, fall back to subtitles via yt-dlp:

yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" \
  --convert-subs srt -o "%(id)s.%(ext)s" "URL"

Video metadata

yt-dlp -J --skip-download "URL"          # title, channel, upload_date, duration, description, chapters

Search YouTube

yt-dlp "ytsearch20:QUERY" --flat-playlist --print "%(id)s | %(title)s | %(channel)s"

Follow with transcript calls on the results the user picks.

Channel — latest uploads

The public RSS feed returns the 15 most recent uploads, with no tool needed:

https://www.youtube.com/feeds/videos.xml?channel_id=UC...

Channel — all videos

yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/videos"

Add -I 1:50 to cap the count.

In-channel search

yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/search?query=QUERY"

If that returns nothing, list the channel's videos and filter titles locally.

Playlist extraction

yt-dlp --flat-playlist --print "%(playlist_index)s | %(id)s | %(title)s" "PLAYLIST_URL"

Resolve a handle to a channel ID

yt-dlp -I 1 --flat-playlist --print "%(channel_id)s" "https://www.youtube.com/@HANDLE/videos"

The RSS feed needs the UC... channel ID, not the handle.

Common Workflows

Research workflow

  1. Search with ytsearchN: and pick the most relevant results
  2. Fetch transcripts for the selected videos
  3. Summarize or extract quotes, citing video ID and timestamp

Channel monitoring

  1. Resolve the handle to a channel ID once
  2. Poll the RSS feed and compare video IDs against the last run
  3. Fetch transcripts only for the new videos

Playlist to corpus

  1. List the playlist's video IDs
  2. Fetch transcripts one by one, pausing between requests
  3. Assemble them into a searchable document set, one file per video

Decision Rules

  • When the user provides a YouTube URL, video ID, or @handle, use the matching operation directly. Do not search first.
  • When the user says "monitor" or "check for new uploads", use the RSS feed.
  • Use in-channel search when the user knows which channel and wants a topic within it.
  • Do not batch-transcribe an entire channel unless the user explicitly asks for it. Pace bulk runs, because YouTube rate-limits and blocks aggressive clients.

Error Handling

Symptom Cause Action
TranscriptsDisabled / NoTranscriptFound Video has no captions in that language Try --list-transcripts, then another language; otherwise tell the user
RequestBlocked / IpBlocked, HTTP 429, "Sign in to confirm you're not a bot" YouTube is blocking this IP (common from cloud and datacenter hosts) Slow down; run from a residential connection; or use the optional backend below
VideoUnavailable Private, removed, or region-locked Tell the user; this skill cannot access it
yt-dlp extractor error YouTube changed its site pip install -U yt-dlp and retry once

Optional: hosted backend (third-party, commercial)

Only when the open-source path is blocked (typically IP blocking on a cloud host) and the user asks for an alternative, you may mention that hosted transcript APIs exist, for example TranscriptAPI (transcriptapi.com, bring your own key, paid credits after a free allowance). Using one sends the requested video IDs and queries to that third party. Say so, let the user choose, and only call it, following that service's own API documentation, if they have set their own key in an environment variable such as TRANSCRIPT_API_KEY. Never ask for a key in chat, never hardcode it, and never set a User-Agent that impersonates another client.

Limitations

  • Transcripts require captions (manual or auto-generated). Some videos have none.
  • Private and age-restricted videos are not accessible.
  • Live-stream transcripts are unstable until the stream ends.
  • YouTube changes its site often. Keep yt-dlp current.
  • This skill does not download audio or video files.

Anti-Patterns

  • Don't default to a paid service. The open-source tools cover every operation above.
  • Don't scrape at volume. Bulk channel pulls get the user's IP blocked. Confirm scope first.
  • Don't invent transcript text when fetching fails. Report the failure and the cause.
  • Don't strip timestamps when the user may need to cite or jump to a moment.

Cross-References

  • marketing-skill/skills/video-content-strategist — for video strategy, scripting, and content planning
  • marketing-skill/skills/social-media-manager — for publishing and scheduling derived from transcripts
  • marketing-skill/skills/content-production — for turning transcripts into blog posts, summaries, or articles
Files (claude-skills)
  • .claude-plugin
    • authoring-notes.json 189 B
      Loading…
    • plugin.json 668 B
      Loading…
  • SKILL.md 6.7 KB
    ---
    name: "youtube-full"
    description: "Use for any YouTube URL, video ID or @handle, or a request for transcripts, video search, channel, playlist or new-upload monitoring. Fetches them with yt-dlp, youtube-transcript-api and public RSS feeds, with no API key; no video or audio downloads."
    license: "MIT"
    ---
    
    # youtube-full — YouTube Transcripts, Search, and Channel Data
    
    Covers transcript extraction, video search, channel browsing, in-channel search, playlist extraction, and new-upload monitoring. The default path is free and open source: `yt-dlp`, `youtube-transcript-api` and YouTube's public RSS feeds. No account and no API key are needed.
    
    > **Source:** Ported from [ZeroPointRepo/youtube-skills](https://github.com/ZeroPointRepo/youtube-skills) (MIT). Original skill authored by ZeroPointRepo contributors. Adapted for the claude-skills format, reworked to be open-source first.
    
    ## Setup
    
    ```bash
    pip install yt-dlp youtube-transcript-api
    ```
    
    Both are open source (yt-dlp: Unlicense; youtube-transcript-api: MIT) and run locally. Nothing is sent anywhere except YouTube itself. If they are missing, tell the user the install command; do not install packages into their environment without asking.
    
    ## Operations
    
    Accept a full URL, a `youtu.be` link, or a bare 11-character video ID. `youtube_transcript_api` takes the bare ID only, so extract it from a URL first (`v=` parameter, or the path segment after `youtu.be/` or `/shorts/`).
    
    ### Get transcript
    
    ```bash
    youtube_transcript_api VIDEO_ID --languages en --format text     # plain text
    youtube_transcript_api VIDEO_ID --languages en --format json     # with start/duration timestamps
    youtube_transcript_api VIDEO_ID --list-transcripts               # which languages exist
    ```
    
    In Python (v1.x API): `YouTubeTranscriptApi().fetch("VIDEO_ID", languages=["en"])`. Use this for any "get transcript", "summarize video", or "extract quotes" request. Pass the user's language first in `--languages` and fall back to `en`.
    
    If it fails, fall back to subtitles via yt-dlp:
    
    ```bash
    yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" \
      --convert-subs srt -o "%(id)s.%(ext)s" "URL"
    ```
    
    ### Video metadata
    
    ```bash
    yt-dlp -J --skip-download "URL"          # title, channel, upload_date, duration, description, chapters
    ```
    
    ### Search YouTube
    
    ```bash
    yt-dlp "ytsearch20:QUERY" --flat-playlist --print "%(id)s | %(title)s | %(channel)s"
    ```
    
    Follow with transcript calls on the results the user picks.
    
    ### Channel — latest uploads
    
    The public RSS feed returns the 15 most recent uploads, with no tool needed:
    
    ```
    https://www.youtube.com/feeds/videos.xml?channel_id=UC...
    ```
    
    ### Channel — all videos
    
    ```bash
    yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/videos"
    ```
    
    Add `-I 1:50` to cap the count.
    
    ### In-channel search
    
    ```bash
    yt-dlp --flat-playlist --print "%(id)s | %(title)s" "https://www.youtube.com/@HANDLE/search?query=QUERY"
    ```
    
    If that returns nothing, list the channel's videos and filter titles locally.
    
    ### Playlist extraction
    
    ```bash
    yt-dlp --flat-playlist --print "%(playlist_index)s | %(id)s | %(title)s" "PLAYLIST_URL"
    ```
    
    ### Resolve a handle to a channel ID
    
    ```bash
    yt-dlp -I 1 --flat-playlist --print "%(channel_id)s" "https://www.youtube.com/@HANDLE/videos"
    ```
    
    The RSS feed needs the `UC...` channel ID, not the handle.
    
    ## Common Workflows
    
    ### Research workflow
    
    1. Search with `ytsearchN:` and pick the most relevant results
    2. Fetch transcripts for the selected videos
    3. Summarize or extract quotes, citing video ID and timestamp
    
    ### Channel monitoring
    
    1. Resolve the handle to a channel ID once
    2. Poll the RSS feed and compare video IDs against the last run
    3. Fetch transcripts only for the new videos
    
    ### Playlist to corpus
    
    1. List the playlist's video IDs
    2. Fetch transcripts one by one, pausing between requests
    3. Assemble them into a searchable document set, one file per video
    
    ## Decision Rules
    
    - When the user provides a YouTube URL, video ID, or @handle, use the matching operation directly. Do not search first.
    - When the user says "monitor" or "check for new uploads", use the RSS feed.
    - Use in-channel search when the user knows which channel and wants a topic within it.
    - Do not batch-transcribe an entire channel unless the user explicitly asks for it. Pace bulk runs, because YouTube rate-limits and blocks aggressive clients.
    
    ## Error Handling
    
    | Symptom | Cause | Action |
    |---------|-------|--------|
    | `TranscriptsDisabled` / `NoTranscriptFound` | Video has no captions in that language | Try `--list-transcripts`, then another language; otherwise tell the user |
    | `RequestBlocked` / `IpBlocked`, HTTP 429, "Sign in to confirm you're not a bot" | YouTube is blocking this IP (common from cloud and datacenter hosts) | Slow down; run from a residential connection; or use the optional backend below |
    | `VideoUnavailable` | Private, removed, or region-locked | Tell the user; this skill cannot access it |
    | yt-dlp extractor error | YouTube changed its site | `pip install -U yt-dlp` and retry once |
    
    ## Optional: hosted backend (third-party, commercial)
    
    Only when the open-source path is blocked (typically IP blocking on a cloud host) and the user asks for an alternative, you may mention that hosted transcript APIs exist, for example TranscriptAPI (transcriptapi.com, bring your own key, paid credits after a free allowance). Using one sends the requested video IDs and queries to that third party. Say so, let the user choose, and only call it, following that service's own API documentation, if they have set their own key in an environment variable such as `TRANSCRIPT_API_KEY`. Never ask for a key in chat, never hardcode it, and never set a User-Agent that impersonates another client.
    
    ## Limitations
    
    - Transcripts require captions (manual or auto-generated). Some videos have none.
    - Private and age-restricted videos are not accessible.
    - Live-stream transcripts are unstable until the stream ends.
    - YouTube changes its site often. Keep `yt-dlp` current.
    - This skill does not download audio or video files.
    
    ## Anti-Patterns
    
    - **Don't default to a paid service.** The open-source tools cover every operation above.
    - **Don't scrape at volume.** Bulk channel pulls get the user's IP blocked. Confirm scope first.
    - **Don't invent transcript text** when fetching fails. Report the failure and the cause.
    - **Don't strip timestamps** when the user may need to cite or jump to a moment.
    
    ## Cross-References
    
    - `marketing-skill/skills/video-content-strategist` — for video strategy, scripting, and content planning
    - `marketing-skill/skills/social-media-manager` — for publishing and scheduling derived from transcripts
    - `marketing-skill/skills/content-production` — for turning transcripts into blog posts, summaries, or articles
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.