Skip to content
Back to search

ultimate-youtube-skill

MarketplaceWorks with Claude CodeGitHub

All-in-one Claude Code skill for YouTube creators: publish, analytics, competitor and outlier research with transcripts, SEO and content planning. Any niche, any language.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ksriramreddy--ultimate-youtube-skill/badge.svg)](/listings/ksriramreddy--ultimate-youtube-skill)

HTML

<a href="/listings/ksriramreddy--ultimate-youtube-skill"><img src="/api/listings/ksriramreddy--ultimate-youtube-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Python 3.10+ and Claude Code.

Option 1: plugin (recommended)

claude plugin marketplace add ksriramreddy/ultimate-youtube-skill
claude plugin install ultimate-youtube@ultimate-youtube-skill

Then ask Claude to "set up the YouTube skill". Its first check installs the Python dependencies from the skill's `requirements.txt` (or uses `uv run`).

Option 2: install script

git clone https://github.com/ksriramreddy/ultimate-youtube-skill.git
cd ultimate-youtube-skill
./install.sh            # macOS / Linux
.\install.ps1           # Windows PowerShell

The scripts copy `skills/ultimate-youtube` to `~/.claude/skills/ultimate-youtube` and install the Python dependencies. For a single project only, copy the folder to `<project>/.claude/skills/ultimate-youtube` instead.

Option 3: uv (no install step for dependencies)

Every script declares its dependencies inline, so with [uv](https://docs.astral.sh/uv/) you can skip `pip install` and run `uv run scripts/yt_auth.py doctor`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "ultimate-youtube-skill",
  3. "owner": {
  4. "name": "Ultimate YouTube Skill contributors"
  5. },
  6. "plugins": [
  7. {
  8. "name": "ultimate-youtube",
  9. "source": "./",
  10. "description": "All-in-one YouTube skill: publish, analyze, research competitors and plan content for any channel, niche or language."
  11. }
  12. ]
  13. }
README.md · README · 150 lines
  1. # Ultimate YouTube - a Claude Code skill for any YouTube creator
  2. One installable skill that lets Claude **publish**, **analyze**, **research
  3. competitors** and **plan content** for any YouTube channel, in any niche and
  4. any language. Real data comes from the official YouTube APIs and public
  5. transcripts; workflow guides tell Claude how to turn that data into decisions.
  6. ```
  7. "Upload video.mp4 as a private video scheduled for Friday 6pm"
  8. "Why did my views drop this month?"
  9. "Scan @somechannel and tell me which videos broke out and why"
  10. "Break down this video's hook and structure: <url>"
  11. "Give me 10 video ideas backed by data"
  12. "Write the script, titles, thumbnail brief and upload package for idea #2"
  13. "Run my daily competitor check"
  14. ```
  15. ## What's inside
  16. | Job | Capabilities |
  17. |---|---|
  18. | **Publish** (Data API v3, write token) | resumable upload, scheduling, edit title/description/tags/privacy, thumbnails, playlists, captions, translated titles/descriptions, delete. Every change is a dry run first, needs explicit approval, is backed up, and can be reverted. |
  19. | **Analyze** (Analytics + Reporting APIs) | overview vs previous period, daily trends, top videos, retention curves with drop-off points, traffic sources, search terms, suggesting videos, external sites, audience, geography, devices, revenue, impressions and CTR, saved reports |
  20. | **Research** (public data, any channel) | competitor discovery, channel scans with outlier detection, cross-channel outliers, "why did this video work" evidence packs, watchlist with early-breakout alerts, transcripts (any public video, any language) with a searchable library, comment mining, autocomplete keywords, search and trending research, SEO audits |
  21. | **Create** (workflows) | onboarding/channel profile, idea scoring, hooks and scripts, titles and thumbnails, upload packages, Shorts, content calendars, audits, strategy and monetization |
  22. ### Layout
  23. ```
  24. skills/ultimate-youtube/ <- the skill (copy this folder to install)
  25. ├── SKILL.md master router + rules Claude follows
  26. ├── requirements.txt
  27. ├── scripts/
  28. │ ├── ytkit/ shared core: auth, quota, API client, analysis, transcripts, SEO
  29. │ ├── yt_auth.py setup, doctor, login (read/write tokens), quota
  30. │ ├── yt_publish.py upload/update/revert/delete/thumbnail/localize/captions/playlists
  31. │ ├── yt_analytics.py private channel analytics
  32. │ ├── yt_reporting.py impressions + CTR (Reporting API)
  33. │ ├── yt_competitors.py scan/compare/outliers/video breakdown/discover/watchlist
  34. │ ├── yt_transcripts.py transcripts + library search
  35. │ ├── yt_comments.py comment mining
  36. │ ├── yt_trends.py autocomplete, search, trending
  37. │ └── yt_seo.py metadata linting and audits
  38. ├── workflows/ 16 step-by-step playbooks Claude loads on demand
  39. ├── references/ 12 knowledge guides (API, algorithm, hooks, packaging, SEO/GEO, ...)
  40. └── templates/ 11 report and planning templates
  41. tests/ network-free unit tests
  42. ```
  43. No niche or persona is built in. Each creator's details live in a
  44. `channel-profile.md` in **their own project**, created by the onboarding workflow.
  45. ## Install
  46. Requires Python 3.10+ and Claude Code.
  47. ### Option 1: plugin (recommended)
  48. ```bash
  49. claude plugin marketplace add ksriramreddy/ultimate-youtube-skill
  50. claude plugin install ultimate-youtube@ultimate-youtube-skill
  51. ```
  52. Then ask Claude to "set up the YouTube skill". Its first check installs the
  53. Python dependencies from the skill's `requirements.txt` (or uses `uv run`).
  54. ### Option 2: install script
  55. ```bash
  56. git clone https://github.com/ksriramreddy/ultimate-youtube-skill.git
  57. cd ultimate-youtube-skill
  58. ./install.sh # macOS / Linux
  59. ```
  60. ```powershell
  61. .\install.ps1 # Windows PowerShell
  62. ```
  63. The scripts copy `skills/ultimate-youtube` to `~/.claude/skills/ultimate-youtube`
  64. and install the Python dependencies. For a single project only, copy the folder
  65. to `<project>/.claude/skills/ultimate-youtube` instead.
  66. ### Option 3: uv (no install step for dependencies)
  67. Every script declares its dependencies inline, so with [uv](https://docs.astral.sh/uv/)
  68. you can skip `pip install` and run `uv run scripts/yt_auth.py doctor`.
  69. ## Set up credentials
  70. Ask Claude: **"set up the YouTube skill"**. It runs `yt_auth.py doctor` and walks
  71. you through only what you need (full guide: `skills/ultimate-youtube/workflows/setup.md`):
  72. | You want | You need | Time |
  73. |---|---|---|
  74. | Transcripts and keyword suggestions | nothing | 0 min |
  75. | Research any channel/video | a free YouTube Data API key | 5 min |
  76. | Your private analytics | OAuth client + `yt_auth.py login` | 10 min |
  77. | Uploading and editing | `yt_auth.py login --write` (separate token) | 2 min |
  78. | Impressions and CTR | `yt_reporting.py setup`, then wait 24-48h | 1 min |
  79. Credentials, cache, backups and the watchlist live in `~/.ultimate-youtube/`
  80. (override with `YT_SKILL_HOME`), never inside the skill or your repo. Reports go
  81. to `./youtube-reports/` (override with `YT_REPORTS_DIR`).
  82. ## Safety
  83. - Research and analytics tokens are **read-only**. Writing uses a separate token
  84. with only the `youtube.force-ssl` scope; delete `token_write.json` to remove it.
  85. - Every write command is a dry run unless `--confirm` is passed, and Claude is
  86. instructed to pass it only after you approve that specific preview.
  87. - Updates are backed up and reversible (`yt_publish.py revert`). Uploads default
  88. to private. Deletion asks twice and suggests making the video private instead.
  89. - A local quota tracker warns before a workflow burns the daily API quota.
  90. ## Using the scripts directly
  91. Every script works on its own and prints JSON:
  92. ```bash
  93. cd ~/.claude/skills/ultimate-youtube
  94. python scripts/yt_auth.py doctor
  95. python scripts/yt_competitors.py scan @somechannel --max 100 --tz 5.5
  96. python scripts/yt_competitors.py video https://youtu.be/VIDEO_ID --lang en
  97. python scripts/yt_transcripts.py hook https://youtu.be/VIDEO_ID --seconds 45
  98. python scripts/yt_trends.py suggest "home workout" --expand
  99. python scripts/yt_analytics.py overview --days 28
  100. python scripts/yt_publish.py upload video.mp4 --title "..." --not-made-for-kids # dry run
  101. ```
  102. Run `python scripts/<script> --help` for every command and option.
  103. ## Development
  104. ```bash
  105. python -m unittest discover tests -v
  106. ```
  107. Contributions welcome: keep the skill niche-neutral, keep every API call in
  108. `ytkit/`, add tests for pure logic, and never let a write path skip the
  109. dry-run/confirm step. See `CONTRIBUTING.md`.
  110. ## Credits and license
  111. MIT licensed (see `LICENSE`). Built by studying and consolidating ideas from
  112. claude-youtube (AgriciDaniel), youtube-research-skills (TubeLab), youtube-skill
  113. (nevaaron) and youtube-data-skills (Nikhil Bhansali); see `NOTICE.md` for what
  114. came from where.
  115. Not affiliated with or endorsed by YouTube or Google. Use within the
  116. [YouTube API Services Terms of Service](https://developers.google.com/youtube/terms/api-services-terms-of-service).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.