New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Youtube

by sigcli in sigcli/sigcli

Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels.

MITAuto-check passed

Install Youtube

skills CLI
$ npx skills add sigcli/sigcli --skill youtube -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sigcli/sigcli youtube --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sigcli/sigcli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube .claude/skills/youtube && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube
GitHub stars
293
Token cost
~2.2k tokens
SKILL.md length
708 words
Files
19 (incl. scripts, references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels.

  • Works in 5 steps: Read /references/provider-config.yaml → Append the provider block to… → IMPORTANT! ASK THE USER: "Do you need a… → …
  • The user mentions YouTube
  • SKILL.md covers Skill Directory, Setup (run FIRST — every time,…, Running Scripts and Scripts Reference, plus 4 more sections
  • Runs Python scripts from its folder; reaches youtube.com and youtu.be

What it does

Youtube is an agent skill from sigcli/sigcli. Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels. Use this skill whenever the user mentions YouTube, wants to search for videos, get video info, read comments, browse a channel, check trending videos, view a playlist, or interact with YouTube content. Also trigger when the user pastes a YouTube URL (e.g. youtube.com/watch?v=..., youtu.be/...) or mentions a YouTube channel.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files, including scripts and reference files (for example `references/provider-config.yaml`, `scripts/youtube_channel.py` and `scripts/youtube_client.py`).

It works with YouTube. The repository describes itself as: The authentication CLI & Proxy for AI agents. Give agents access, not your credentials. The licence is MIT.

When your agent uses it

  • The user mentions YouTube
  • Wants to search for videos
  • Browse a channel
  • Check trending videos

Example prompts

  • “/youtube”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read /references/provider-config.yaml
  2. Append the provider block to ~/.sig/config.yaml under providers
  3. IMPORTANT! ASK THE USER: "Do you need a proxy to access this site?" — if yes, add networkProxy: under the provider in config.yaml
  4. Run sig login youtube (with --network-proxy if proxy was specified)
  5. Verify: run sig status youtube again — must show valid: true before proceeding

What it can do on your machine

Read from SKILL.md and the folder at commit 9ba8b35. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 9 files in scripts/ (Python, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com
    • youtu.be

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube loads about 2.2k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 128 tokens; SKILL.md has 708 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~128
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sigcli/sigcli at commit 9ba8b35, republished under its MIT licence (© sigcli). 708 words, ~2,211 tokens.

Download SKILL.mdSave it as .claude/skills/youtube/SKILL.md (or your agent's skills folder). This skill also uses 18 other files; get the full folder from GitHub.
name
youtube
description
Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels. Use this skill whenever the user mentions YouTube, wants to search for videos, get video info, read comments, browse a channel, check trending videos, view a playlist, or interact with YouTube content. Also trigger when the user pastes a YouTube URL (e.g. youtube.com/watch?v=..., youtu.be/...) or mentions a YouTube channel.

YouTube

Search videos, get video details, browse channels, read comments, view trending, browse playlists, and interact with YouTube.

Skill Directory

<SKILL_DIR> is the directory containing this SKILL.md file. Determine it ONCE at the start and reuse it.

Setup (run FIRST — every time, before any operation)

You MUST complete this setup before running any script. Do NOT skip this step.

bash
sig status youtube 2>&1

Check the JSON output fields configured and valid:

  • configured: false → run Provider Setup below. Do NOT proceed without completing it.
  • valid: false (but configured: true) → run sig login youtube, then re-check.
  • valid: true → detect proxy (see below), then execute the user's request.
Provider Setup
  1. Read <SKILL_DIR>/references/provider-config.yaml
  2. Append the provider block to ~/.sig/config.yaml under providers:
  3. IMPORTANT! ASK THE USER: "Do you need a proxy to access this site?" — if yes, add networkProxy: <url> under the provider in config.yaml
  4. Run sig login youtube (with --network-proxy <url> if proxy was specified)
  5. Verify: run sig status youtube again — must show valid: true before proceeding
Proxy Detection (after provider is valid)
bash
grep -A15 "^\s*youtube:" ~/.sig/config.yaml | grep networkProxy | awk '{print $2}'

If this outputs a URL, prefix ALL python3 commands with HTTPS_PROXY=<url> HTTP_PROXY=<url>. If using socks5, convert to socks5h for python (e.g. socks5://... → socks5h://...). If empty, no proxy needed.

Running Scripts

All scripts require setup to be completed first (see above).

Read operations — use sig run to inject cookie (enables authenticated features):

bash
sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_video.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ'

Write operations — require sig run (cookie is mandatory):

bash
sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_like.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ'

Env var: SIG_YOUTUBE_COOKIE

On auth error (401/403): run sig login youtube automatically (no user prompt), then retry.

Scripts Reference

All scripts are in this skill's scripts/ directory. Run via Bash tool.

Read Operations
ScriptPurposeAuth
youtube_video.pyVideo detailsNone
youtube_search.pySearch videosNone
youtube_channel.pyChannel info and videosNone
youtube_comments.pyVideo commentsNone
youtube_trending.pyTrending videosNone
youtube_playlist.pyPlaylist info and videosNone
Write Operations
ScriptPurposeAuth
youtube_like.pyLike/unlike a videoRequired
youtube_subscribe.pySubscribe/unsubscribeRequired
youtube_video.py
--video URL           YouTube video URL or video ID (required)
youtube_search.py
--query TEXT          Search query (required)
--limit N            Max results (default: 20)
youtube_channel.py
--channel ID         Channel ID (UCxxxx), handle (@name), or URL (required)
--limit N            Max recent videos (default: 10)
youtube_comments.py
--video URL          YouTube video URL or video ID (required)
--limit N            Max comments (default: 20)
--limit N            Max videos (default: 20)
youtube_playlist.py
--playlist ID        Playlist URL or ID (PLxxxxxx) (required)
--limit N            Max videos (default: 50)
youtube_like.py
--cookie COOKIE      YouTube session cookie (required)
--video URL          YouTube video URL or video ID (required)
--action ACTION      Action: like, unlike (default: like)
youtube_subscribe.py
--cookie COOKIE      YouTube session cookie (required)
--channel ID         Channel ID (UCxxxx), handle (@name), or URL (required)
--action ACTION      Action: subscribe, unsubscribe (default: subscribe)

Safety

youtube_like.py and youtube_subscribe.py are reversible — use --action unlike to remove a like, --action unsubscribe to unsubscribe.

Key Concepts

Video IDs — youtube_video.py and youtube_comments.py accept: bare ID (dQw4w9WgXcQ), full URL (https://www.youtube.com/watch?v=dQw4w9WgXcQ), short link (https://youtu.be/dQw4w9WgXcQ), or shorts/embed/live URLs.

Channel IDs — Accept UCxxxx channel IDs, @handle format, or full channel URLs. Handles are resolved to channel IDs automatically.

Playlist IDs — Accept PLxxxxxx playlist IDs or full playlist URLs. The list= parameter is extracted from URLs.

InnerTube API — All operations use YouTube's InnerTube API (/youtubei/v1/), which is the same internal API the YouTube website uses. Read operations require no auth; write operations require SAPISIDHASH authentication derived from session cookies.

SAPISIDHASH Auth — Write operations compute SAPISIDHASH {timestamp}_{SHA1(timestamp + " " + SAPISID + " " + origin)} from the SAPISID cookie for the Authorization header.

Show full SKILL.md (271 more words)Show less

Error Handling

ErrorCauseFix
HTTP_403Forbidden or rate limitedWait and retry
HTTP_404Video/channel not foundCheck the ID is correct
AUTH_REQUIREDNo cookie for write opAuto-run sig login (no user prompt needed), retry
AUTH_EXPIREDSession cookie expiredAuto-run sig login (no user prompt needed), retry
INVALID_CHANNELCannot resolve channel IDUse UCxxxx format instead of handle

Workflow Examples

Get video details
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_video.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ'
  2. Or with URL: sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_video.py --cookie "$SIG_YOUTUBE_COOKIE" --video "https://www.youtube.com/watch?v=dQw4w9WgXcQ"'
Search for videos
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_search.py --cookie "$SIG_YOUTUBE_COOKIE" --query "python tutorial" --limit 10'
Browse a channel
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_channel.py --cookie "$SIG_YOUTUBE_COOKIE" --channel @RickAstleyYT --limit 5'
  2. Or by ID: sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_channel.py --cookie "$SIG_YOUTUBE_COOKIE" --channel UCuAXFkgsw1L7xaCfnd5JJOw'
Read video comments
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_comments.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ --limit 30'
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_trending.py --cookie "$SIG_YOUTUBE_COOKIE" --limit 10'
Browse a playlist
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_playlist.py --cookie "$SIG_YOUTUBE_COOKIE" --playlist PLxxxxxxxx --limit 20'
  2. Or with URL: sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_playlist.py --cookie "$SIG_YOUTUBE_COOKIE" --playlist "https://www.youtube.com/playlist?list=PLxxxxxxxx"'
Like a video
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_like.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ'
Unlike a video
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_like.py --cookie "$SIG_YOUTUBE_COOKIE" --video dQw4w9WgXcQ --action unlike'
Subscribe to a channel
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_subscribe.py --cookie "$SIG_YOUTUBE_COOKIE" --channel @RickAstleyYT'
Unsubscribe from a channel
  1. sig run youtube -- bash -c 'python3 <SKILL_DIR>/scripts/youtube_subscribe.py --cookie "$SIG_YOUTUBE_COOKIE" --channel UCuAXFkgsw1L7xaCfnd5JJOw --action unsubscribe'

© sigcli, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 18 other files (scripts, references) in skills/youtube of sigcli/sigcli.

  • SKILL.md
  • references/provider-config.yaml
  • scripts/youtube_channel.py
  • scripts/youtube_client.py
  • scripts/youtube_comments.py
  • scripts/youtube_like.py
  • scripts/youtube_playlist.py
  • scripts/youtube_search.py
  • scripts/youtube_subscribe.py
  • scripts/youtube_trending.py
  • scripts/youtube_video.py
  • tests/test_youtube_channel.py
  • tests/test_youtube_comments.py
  • tests/test_youtube_like.py
  • tests/test_youtube_playlist.py
  • tests/test_youtube_search.py
  • tests/test_youtube_subscribe.py
  • tests/test_youtube_trending.py
  • … and 1 more

Open the folder on GitHubat commit 9ba8b35

Compare with similar skills

Youtube next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube this skillsigcli/sigcli293—~2.2kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill134k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach93k—~1.4kAutomated safety check: PassMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone
Google SEO APIsAgriciDaniel/claude-seo18k1 repos~4.2kAutomated safety check: PassMIT

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes

  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    134k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed

  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    93k GitHub stars~1.4k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed

  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    18k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

  • YouTube Video Downloader

    ComposioHQ/awesome-claude-skills

    Downloads a single YouTube video with chosen quality, format or audio-only MP3 output, using a bundled Python script built on yt-dlp.

    77k GitHub starsUsed in 9 repos~668 tokens
    Media & CreativeAuto-check passed

More from sigcli/sigcli

All 15 skills in this repo

  • Bilibili

    sigcli/sigcli

    Interact with Bilibili (B站) — browse trending videos, view video details, read comments, search videos and users, view user profiles, like, coin, and favorite videos.

    293 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check passed

  • Hackernews

    sigcli/sigcli

    Interact with Hacker News (news.ycombinator.com) — browse top, new, and best stories, read item details and comment threads, look up user profiles, and search posts via Algolia.

    293 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed

  • Linkedin

    sigcli/sigcli

    Interact with LinkedIn — view your profile, browse other profiles, read the feed, search jobs/posts/people, get job details, create posts, like/unlike posts, comment, send connection requests, and…

    293 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed

  • Msteams

    sigcli/sigcli

    Interact with Microsoft Teams — send and read messages, search conversations, look up people, check calendar, get meeting transcripts, and manage chats.

    293 GitHub stars~2.7k tokensUpdated 9 days ago
    Auto-check passed

  • Outlook

    sigcli/sigcli

    Interact with Outlook email — read inbox, send emails, search messages, reply/forward, manage folders, download attachments.

    293 GitHub stars~2.6k tokensUpdated 9 days ago
    Auto-check passed

  • Reddit

    sigcli/sigcli

    Interact with Reddit — browse subreddits, read posts and comments, search content, view user profiles, post comments, vote, save posts, subscribe to subreddits.

    293 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed

Works with

Questions about Youtube

What does Youtube do?

Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels. Youtube is an agent skill from sigcli/sigcli. Interact with YouTube — search videos, get video details, browse channels, read comments, view trending, browse playlists, like/unlike videos, subscribe/unsubscribe to channels.

When should I use Youtube?

Youtube fits situations like: the user mentions YouTube; wants to search for videos; browse a channel; check trending videos.

How do I install Youtube in Claude Code?

Run `npx skills add sigcli/sigcli --skill youtube -a claude-code`. Or copy the skill folder (skills/youtube in sigcli/sigcli) into .claude/skills/youtube in your project. Claude Code loads it when a task matches its description.

How do I install Youtube in Codex?

Run `npx skills add sigcli/sigcli --skill youtube -a codex`. Or copy the skill folder (skills/youtube in sigcli/sigcli) into .agents/skills/youtube in your project. Codex loads it when a task matches its description.

Can I use Youtube in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sigcli/sigcli --skill youtube -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube, .gemini/skills/youtube, .github/skills/youtube and .opencode/skills/youtube in your project.

What does Youtube need to run?

Going by SKILL.md and its folder, Youtube needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Youtube access the network?

SKILL.md names 2 domains. In commands or code: youtube.com and youtu.be; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Youtube safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube use?

Youtube is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube use?

About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 134 tokens, read only when the agent opens those files.

What are the alternatives to Youtube?

Skills that share tags, products or a category with Youtube: Markitdown (ImCa0/just-laws, 781 stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), Agent Reach (Panniantong/Agent-Reach, 93k stars) and Baoyu URL To Markdown (sdyckjq-lab/llm-wiki-skill, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube?

sigcli (a GitHub organization) maintains it in sigcli/sigcli, which has 293 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 28, 2026.

Source: sigcli/sigcli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.