Skip to content
Back to search

claude-youtube

SkillWorks with Claude CodeGitHub

Claude Code skill for YouTube creators — channel audits, video SEO, retention scripts, thumbnails, content strategy, Shorts optimization, analytics, monetization, and more.

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/agricidaniel--claude-youtube/badge.svg)](/listings/agricidaniel--claude-youtube)

HTML

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

Install

i

Install instructions from the README

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

Prerequisites

- [Claude Code](https://claude.com/claude-code) CLI installed and configured

Quick Install

Clone this repo into your Claude Code skills directory:

git clone https://github.com/AgriciDaniel/claude-youtube.git
cp -r claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube

Or symlink for development:

git clone https://github.com/AgriciDaniel/claude-youtube.git ~/claude-youtube
ln -s ~/claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube

Optional: YouTube API (for live channel data)

The skill works without API credentials by accepting manual data input. For automated data fetching:

1. Get a YouTube Data API v3 key from [Google Cloud Console](https://console.cloud.google.com/apis/library/youtube.googleapis.com) 2. Set the environment variable:

   export YOUTUBE_API_KEY="your-api-key-here"

3. For private analytics (own channel), set up OAuth 2.0 credentials

Optional: DataForSEO MCP (for live keyword/trend data)

When configured, the skill uses live data for keyword research, YouTube SERP analysis, trend intelligence, and competitive research. Without it, the skill falls back to WebSearch.

Add to `~/.claude/settings.json` under `mcpServers`:

{
  "dataforseo": {
    "command": "npx",
    "args": ["-y", "dataforseo-mcp-server"],
    "env": {
      "DATAFORSEO_USERNAME": "your-username",
      "DATAFORSEO_PASSWORD": "your-password",
      "ENABLED_MODULES": "SERP,KEYWORDS_DATA,DATAFORSEO_LABS,ONPAGE"
    }
  }
}

Typical workflow costs $0.002-$0.04 per command. See [DataForSEO pricing](https://dataforseo.com/pricing).

Optional: NanoBanana MCP (for AI thumbnail generation)

When configured, the `/youtube thumbnail` command generates actual thumbnail images using Gemini models instead of just text briefs.

{
  "nanobanana": {
    "command": "uvx",
    "args": ["nanobanana-mcp-server"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key"
    }
  }
}

---

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.

README.md · README · 226 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # claude-youtube
  2. > **Status: Beta** -- Actively developed. Core functionality is complete and tested. Breaking changes may occur before v1.0.
  3. A comprehensive [Claude Code](https://claude.com/claude-code) skill for YouTube creators. Covers channel audits, video SEO, retention-engineered scripts, hook writing, thumbnail briefs, content strategy, content calendars, Shorts optimization, analytics interpretation, monetization planning, competitor research, cross-platform repurposing, upload metadata packages, and data-driven video idea generation.
  4. **39 files** | **5,300+ lines of markdown** | **1,300+ lines of Python** | **14 sub-skills** | **9 reference guides** | **9 channel templates** | **6 execution scripts**
  5. ---
  6. ## What It Does
  7. claude-youtube turns Claude Code into a YouTube growth consultant. Instead of generic advice, every recommendation is grounded in platform-specific benchmarks, algorithm mechanics, and data from your actual channel.
  8. ### 14 Commands
  9. | Command | What It Does |
  10. |---------|-------------|
  11. | `/youtube audit` | Full channel health audit across 4 dimensions (SEO, performance, content, monetization) with parallel agents |
  12. | `/youtube seo` | Video SEO package: 3 title variants, full description, tags, chapters, hashtags, VideoObject schema |
  13. | `/youtube script` | Retention-engineered script with hook/intro/content blocks, pattern interrupts every 60-90s, and CTA placement |
  14. | `/youtube hook` | 5 hook variants (shock, problem-agitation, story, curiosity-gap, social proof) with drop-off risk ratings |
  15. | `/youtube thumbnail` | Thumbnail brief with 3 A/B variants, color hex codes, composition specs, and title-thumbnail synergy check |
  16. | `/youtube strategy` | Channel positioning, content pillars (Hub/Hero/Help), niche viability, upload cadence, 30/60/90-day milestones |
  17. | `/youtube calendar` | Monthly content calendar with per-video metadata, Shorts supplement plan, and seasonal CPM timing |
  18. | `/youtube shorts` | Shorts production package: script with visual change markers, SEO metadata, performance prediction, loop setup |
  19. | `/youtube analyze` | Analytics interpretation: funnel diagnosis, retention graph classification, traffic source health, priority actions |
  20. | `/youtube repurpose` | Cross-platform package: Shorts clips, blog outline, LinkedIn post, X thread, email, podcast outline, community post |
  21. | `/youtube monetize` | Revenue strategy across 7 streams, brand deal rate card, external funnel design, 90-day activation plan |
  22. | `/youtube competitor` | Competitor analysis with 4 parallel agents: top videos, keyword gaps, format gaps, audience gaps |
  23. | `/youtube metadata` | Copy-paste-ready upload package: titles, description, tags, chapters, cards, end screens, publish settings |
  24. | `/youtube ideate` | 10 ranked video ideas with keyword analysis, hook angles, thumbnail concepts, and revenue potential |
  25. ---
  26. ## Architecture
  27. Built on the [Agent Skills](https://github.com/anthropics/claude-code) open standard with a 3-layer architecture:
  28. ```
  29. skills/claude-youtube/
  30. SKILL.md # Orchestrator (routing, context-gathering, quality gates)
  31. sub-skills/ # 14 sub-skill instruction files
  32. audit.md, seo.md, script.md, hook.md, thumbnail.md,
  33. strategy.md, calendar.md, shorts.md, analyze.md,
  34. repurpose.md, monetize.md, competitor.md, metadata.md, ideate.md
  35. references/ # 9 data-grounded reference guides
  36. algorithm-guide.md # 3-system architecture, testing cascade, CTR/AVD benchmarks
  37. seo-playbook.md # Title/description/tags/chapters rules, VideoObject schema
  38. retention-scripting-guide.md # Hook frameworks, pattern interrupts, CTA placement
  39. thumbnail-ctr-guide.md # CTR by niche, face psychology, A/B testing, title formulas
  40. shorts-playbook.md # Shorts algorithm, format specs, monetization
  41. analytics-guide.md # Metrics hierarchy, funnel ratios, RPM/CPM by niche
  42. monetization-guide.md # YPP tiers, 7 revenue streams, brand deal rates
  43. repurposing-guide.md # Hub/Hero/Help model, cross-platform workflows
  44. dataforseo-integration.md # DataForSEO MCP tool reference for live data
  45. templates/ # 9 channel-type templates
  46. education-channel.md, entertainment-channel.md, tutorial-channel.md,
  47. vlog-channel.md, review-channel.md, commentary-channel.md,
  48. niche-authority-channel.md, personal-brand-channel.md, shorts-first-channel.md
  49. execution/ # 6 Python scripts for YouTube API integration
  50. fetch_channel_data.py # Channel stats + recent videos (~16 quota units)
  51. fetch_video_analytics.py # Private analytics via OAuth
  52. search_competitor_videos.py # Competitor video search (100 units/search)
  53. fetch_transcript.py # Transcript extraction via yt-dlp
  54. utils/quota_tracker.py # 10K unit/day quota management
  55. utils/youtube_auth.py # API key + OAuth 2.0 handler
  56. ```
  57. ### How It Works
  58. 1. **Orchestrator** (`SKILL.md`) routes your request to the right sub-skill based on trigger phrases
  59. 2. **Context-gathering** collects channel niche, size tier, and primary goal before any sub-skill runs
  60. 3. **Channel type detection** loads the matching template (education, entertainment, tutorial, etc.) for niche-specific benchmarks
  61. 4. **Sub-skills** load only the reference files they need, execute step-by-step, and produce structured output
  62. 5. **Quality gates** verify specificity, data grounding, and completeness before delivery
  63. ---
  64. ## Installation
  65. ### Prerequisites
  66. - [Claude Code](https://claude.com/claude-code) CLI installed and configured
  67. ### Quick Install
  68. Clone this repo into your Claude Code skills directory:
  69. ```bash
  70. git clone https://github.com/AgriciDaniel/claude-youtube.git
  71. cp -r claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube
  72. ```
  73. Or symlink for development:
  74. ```bash
  75. git clone https://github.com/AgriciDaniel/claude-youtube.git ~/claude-youtube
  76. ln -s ~/claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube
  77. ```
  78. ### Optional: YouTube API (for live channel data)
  79. The skill works without API credentials by accepting manual data input. For automated data fetching:
  80. 1. Get a YouTube Data API v3 key from [Google Cloud Console](https://console.cloud.google.com/apis/library/youtube.googleapis.com)
  81. 2. Set the environment variable:
  82. ```bash
  83. export YOUTUBE_API_KEY="your-api-key-here"
  84. ```
  85. 3. For private analytics (own channel), set up OAuth 2.0 credentials
  86. ### Optional: DataForSEO MCP (for live keyword/trend data)
  87. When configured, the skill uses live data for keyword research, YouTube SERP analysis, trend intelligence, and competitive research. Without it, the skill falls back to WebSearch.
  88. Add to `~/.claude/settings.json` under `mcpServers`:
  89. ```json
  90. {
  91. "dataforseo": {
  92. "command": "npx",
  93. "args": ["-y", "dataforseo-mcp-server"],
  94. "env": {
  95. "DATAFORSEO_USERNAME": "your-username",
  96. "DATAFORSEO_PASSWORD": "your-password",
  97. "ENABLED_MODULES": "SERP,KEYWORDS_DATA,DATAFORSEO_LABS,ONPAGE"
  98. }
  99. }
  100. }
  101. ```
  102. Typical workflow costs $0.002-$0.04 per command. See [DataForSEO pricing](https://dataforseo.com/pricing).
  103. ### Optional: NanoBanana MCP (for AI thumbnail generation)
  104. When configured, the `/youtube thumbnail` command generates actual thumbnail images using Gemini models instead of just text briefs.
  105. ```json
  106. {
  107. "nanobanana": {
  108. "command": "uvx",
  109. "args": ["nanobanana-mcp-server"],
  110. "env": {
  111. "GEMINI_API_KEY": "your-gemini-api-key"
  112. }
  113. }
  114. }
  115. ```
  116. ---
  117. ## Usage
  118. After installation, use any command in Claude Code:
  119. ```
  120. > /youtube audit
  121. > /youtube ideate
  122. > /youtube script "How to Build a PC in 2025"
  123. > /youtube thumbnail
  124. > /youtube seo
  125. ```
  126. The skill will ask for any missing context (channel niche, size, goal) before running.
  127. ### Multi-command workflows
  128. Commands chain naturally:
  129. ```
  130. > Help me plan and script my next video about meal prep for beginners
  131. ```
  132. This triggers `ideate` -> `script` -> `metadata` sequentially, passing output between each step.
  133. ---
  134. ## Reference Data
  135. All benchmarks and statistics in the reference guides are sourced and tagged:
  136. - **CTR benchmarks by niche** -- Focus Digital, December 2025
  137. - **Retention data** -- 10xCreator, Wistia, AIR Media-Tech
  138. - **Algorithm mechanics** -- Retention Rabbit (150M+ minutes analyzed), vidIQ (5.08M channels)
  139. - **Shorts algorithm** -- 35B views study, Tubefilter, Digital i
  140. - **Monetization rates** -- YouTube Creator Academy, industry reports
  141. - **SEO rules** -- 10xCreator (3M+ videos analyzed), Backlinko, HubSpot
  142. - **MrBeast methodology** -- Validated at 100M+ views/video scale
  143. Data points tagged with `[2025]` reflect 2024-2025 platform changes.
  144. ---
  145. ## Requirements
  146. | Requirement | Required | Notes |
  147. |-------------|----------|-------|
  148. | Claude Code | Yes | Core dependency |
  149. | Python 3.8+ | For execution scripts | Not needed if providing data manually |
  150. | YouTube API key | No | Enables automated channel data fetching |
  151. | DataForSEO MCP | No | Enables live keyword/trend data |
  152. | NanoBanana MCP | No | Enables AI thumbnail generation |
  153. ---
  154. ## Contributing
  155. This project is in beta. Issues, bug reports, and feature suggestions are welcome via [GitHub Issues](https://github.com/AgriciDaniel/claude-youtube/issues).
  156. ---
  157. ## License
  158. MIT License. See [LICENSE](LICENSE) for details.
  159. ---
  160. ## Author
  161. Built by [Agrici Daniel](https://agricidaniel.com/about) - AI Workflow Architect.
  162. - [Blog](https://agricidaniel.com/blog) - Deep dives on AI marketing automation
  163. - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) - Free community, 2,800+ members
  164. - [YouTube](https://www.youtube.com/@AgriciDaniel) - Tutorials and demos
  165. - [All open-source tools](https://github.com/AgriciDaniel)

Ratings and comments

Sign in to rate this skill.

Sign in

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