{"id":46518677,"url":"https://github.com/agricidaniel/claude-youtube","last_synced_at":"2026-03-11T23:01:05.404Z","repository":{"id":342409161,"uuid":"1173830645","full_name":"AgriciDaniel/claude-youtube","owner":"AgriciDaniel","description":"Claude Code skill for YouTube creators — channel audits, video SEO, retention scripts, thumbnails, content strategy, Shorts optimization, analytics, monetization, and more.","archived":false,"fork":false,"pushed_at":"2026-03-09T09:21:18.000Z","size":142,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-10T00:46:34.662Z","etag":null,"topics":["ai-tools","claude","claude-code","claude-code-skill","content-strategy","seo","youtube","youtube-analytics","youtube-api","youtube-seo"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AgriciDaniel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T19:50:38.000Z","updated_at":"2026-03-09T21:11:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"38d6263d-f308-46b1-9e7f-234e212ca494","html_url":"https://github.com/AgriciDaniel/claude-youtube","commit_stats":null,"previous_names":["agricidaniel/claude-youtube"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AgriciDaniel/claude-youtube","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgriciDaniel%2Fclaude-youtube","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgriciDaniel%2Fclaude-youtube/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgriciDaniel%2Fclaude-youtube/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgriciDaniel%2Fclaude-youtube/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AgriciDaniel","download_url":"https://codeload.github.com/AgriciDaniel/claude-youtube/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgriciDaniel%2Fclaude-youtube/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30357614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude","claude-code","claude-code-skill","content-strategy","seo","youtube","youtube-analytics","youtube-api","youtube-seo"],"created_at":"2026-03-06T18:57:30.535Z","updated_at":"2026-03-10T22:01:04.259Z","avatar_url":"https://github.com/AgriciDaniel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-youtube\n\n\u003e **Status: Beta** -- Actively developed. Core functionality is complete and tested. Breaking changes may occur before v1.0.\n\nA 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.\n\n**39 files** | **5,300+ lines of markdown** | **1,300+ lines of Python** | **14 sub-skills** | **9 reference guides** | **9 channel templates** | **6 execution scripts**\n\n---\n\n## What It Does\n\nclaude-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.\n\n### 14 Commands\n\n| Command | What It Does |\n|---------|-------------|\n| `/youtube audit` | Full channel health audit across 4 dimensions (SEO, performance, content, monetization) with parallel agents |\n| `/youtube seo` | Video SEO package: 3 title variants, full description, tags, chapters, hashtags, VideoObject schema |\n| `/youtube script` | Retention-engineered script with hook/intro/content blocks, pattern interrupts every 60-90s, and CTA placement |\n| `/youtube hook` | 5 hook variants (shock, problem-agitation, story, curiosity-gap, social proof) with drop-off risk ratings |\n| `/youtube thumbnail` | Thumbnail brief with 3 A/B variants, color hex codes, composition specs, and title-thumbnail synergy check |\n| `/youtube strategy` | Channel positioning, content pillars (Hub/Hero/Help), niche viability, upload cadence, 30/60/90-day milestones |\n| `/youtube calendar` | Monthly content calendar with per-video metadata, Shorts supplement plan, and seasonal CPM timing |\n| `/youtube shorts` | Shorts production package: script with visual change markers, SEO metadata, performance prediction, loop setup |\n| `/youtube analyze` | Analytics interpretation: funnel diagnosis, retention graph classification, traffic source health, priority actions |\n| `/youtube repurpose` | Cross-platform package: Shorts clips, blog outline, LinkedIn post, X thread, email, podcast outline, community post |\n| `/youtube monetize` | Revenue strategy across 7 streams, brand deal rate card, external funnel design, 90-day activation plan |\n| `/youtube competitor` | Competitor analysis with 4 parallel agents: top videos, keyword gaps, format gaps, audience gaps |\n| `/youtube metadata` | Copy-paste-ready upload package: titles, description, tags, chapters, cards, end screens, publish settings |\n| `/youtube ideate` | 10 ranked video ideas with keyword analysis, hook angles, thumbnail concepts, and revenue potential |\n\n---\n\n## Architecture\n\nBuilt on the [Agent Skills](https://github.com/anthropics/claude-code) open standard with a 3-layer architecture:\n\n```\nskills/claude-youtube/\n  SKILL.md                          # Orchestrator (routing, context-gathering, quality gates)\n  sub-skills/                       # 14 sub-skill instruction files\n    audit.md, seo.md, script.md, hook.md, thumbnail.md,\n    strategy.md, calendar.md, shorts.md, analyze.md,\n    repurpose.md, monetize.md, competitor.md, metadata.md, ideate.md\n  references/                       # 9 data-grounded reference guides\n    algorithm-guide.md              # 3-system architecture, testing cascade, CTR/AVD benchmarks\n    seo-playbook.md                 # Title/description/tags/chapters rules, VideoObject schema\n    retention-scripting-guide.md    # Hook frameworks, pattern interrupts, CTA placement\n    thumbnail-ctr-guide.md          # CTR by niche, face psychology, A/B testing, title formulas\n    shorts-playbook.md              # Shorts algorithm, format specs, monetization\n    analytics-guide.md              # Metrics hierarchy, funnel ratios, RPM/CPM by niche\n    monetization-guide.md           # YPP tiers, 7 revenue streams, brand deal rates\n    repurposing-guide.md            # Hub/Hero/Help model, cross-platform workflows\n    dataforseo-integration.md       # DataForSEO MCP tool reference for live data\n  templates/                        # 9 channel-type templates\n    education-channel.md, entertainment-channel.md, tutorial-channel.md,\n    vlog-channel.md, review-channel.md, commentary-channel.md,\n    niche-authority-channel.md, personal-brand-channel.md, shorts-first-channel.md\n  execution/                        # 6 Python scripts for YouTube API integration\n    fetch_channel_data.py           # Channel stats + recent videos (~16 quota units)\n    fetch_video_analytics.py        # Private analytics via OAuth\n    search_competitor_videos.py     # Competitor video search (100 units/search)\n    fetch_transcript.py             # Transcript extraction via yt-dlp\n    utils/quota_tracker.py          # 10K unit/day quota management\n    utils/youtube_auth.py           # API key + OAuth 2.0 handler\n```\n\n### How It Works\n\n1. **Orchestrator** (`SKILL.md`) routes your request to the right sub-skill based on trigger phrases\n2. **Context-gathering** collects channel niche, size tier, and primary goal before any sub-skill runs\n3. **Channel type detection** loads the matching template (education, entertainment, tutorial, etc.) for niche-specific benchmarks\n4. **Sub-skills** load only the reference files they need, execute step-by-step, and produce structured output\n5. **Quality gates** verify specificity, data grounding, and completeness before delivery\n\n---\n\n## Installation\n\n### Prerequisites\n\n- [Claude Code](https://claude.com/claude-code) CLI installed and configured\n\n### Quick Install\n\nClone this repo into your Claude Code skills directory:\n\n```bash\ngit clone https://github.com/AgriciDaniel/claude-youtube.git\ncp -r claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube\n```\n\nOr symlink for development:\n\n```bash\ngit clone https://github.com/AgriciDaniel/claude-youtube.git ~/claude-youtube\nln -s ~/claude-youtube/skills/claude-youtube ~/.claude/skills/claude-youtube\n```\n\n### Optional: YouTube API (for live channel data)\n\nThe skill works without API credentials by accepting manual data input. For automated data fetching:\n\n1. Get a YouTube Data API v3 key from [Google Cloud Console](https://console.cloud.google.com/apis/library/youtube.googleapis.com)\n2. Set the environment variable:\n   ```bash\n   export YOUTUBE_API_KEY=\"your-api-key-here\"\n   ```\n3. For private analytics (own channel), set up OAuth 2.0 credentials\n\n### Optional: DataForSEO MCP (for live keyword/trend data)\n\nWhen 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.\n\nAdd to `~/.claude/settings.json` under `mcpServers`:\n\n```json\n{\n  \"dataforseo\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"dataforseo-mcp-server\"],\n    \"env\": {\n      \"DATAFORSEO_USERNAME\": \"your-username\",\n      \"DATAFORSEO_PASSWORD\": \"your-password\",\n      \"ENABLED_MODULES\": \"SERP,KEYWORDS_DATA,DATAFORSEO_LABS,ONPAGE\"\n    }\n  }\n}\n```\n\nTypical workflow costs $0.002-$0.04 per command. See [DataForSEO pricing](https://dataforseo.com/pricing).\n\n### Optional: NanoBanana MCP (for AI thumbnail generation)\n\nWhen configured, the `/youtube thumbnail` command generates actual thumbnail images using Gemini models instead of just text briefs.\n\n```json\n{\n  \"nanobanana\": {\n    \"command\": \"uvx\",\n    \"args\": [\"nanobanana-mcp-server\"],\n    \"env\": {\n      \"GEMINI_API_KEY\": \"your-gemini-api-key\"\n    }\n  }\n}\n```\n\n---\n\n## Usage\n\nAfter installation, use any command in Claude Code:\n\n```\n\u003e /youtube audit\n\u003e /youtube ideate\n\u003e /youtube script \"How to Build a PC in 2025\"\n\u003e /youtube thumbnail\n\u003e /youtube seo\n```\n\nThe skill will ask for any missing context (channel niche, size, goal) before running.\n\n### Multi-command workflows\n\nCommands chain naturally:\n\n```\n\u003e Help me plan and script my next video about meal prep for beginners\n```\n\nThis triggers `ideate` -\u003e `script` -\u003e `metadata` sequentially, passing output between each step.\n\n---\n\n## Reference Data\n\nAll benchmarks and statistics in the reference guides are sourced and tagged:\n\n- **CTR benchmarks by niche** -- Focus Digital, December 2025\n- **Retention data** -- 10xCreator, Wistia, AIR Media-Tech\n- **Algorithm mechanics** -- Retention Rabbit (150M+ minutes analyzed), vidIQ (5.08M channels)\n- **Shorts algorithm** -- 35B views study, Tubefilter, Digital i\n- **Monetization rates** -- YouTube Creator Academy, industry reports\n- **SEO rules** -- 10xCreator (3M+ videos analyzed), Backlinko, HubSpot\n- **MrBeast methodology** -- Validated at 100M+ views/video scale\n\nData points tagged with `[2025]` reflect 2024-2025 platform changes.\n\n---\n\n## Requirements\n\n| Requirement | Required | Notes |\n|-------------|----------|-------|\n| Claude Code | Yes | Core dependency |\n| Python 3.8+ | For execution scripts | Not needed if providing data manually |\n| YouTube API key | No | Enables automated channel data fetching |\n| DataForSEO MCP | No | Enables live keyword/trend data |\n| NanoBanana MCP | No | Enables AI thumbnail generation |\n\n---\n\n## Contributing\n\nThis project is in beta. Issues, bug reports, and feature suggestions are welcome via [GitHub Issues](https://github.com/AgriciDaniel/claude-youtube/issues).\n\n---\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagricidaniel%2Fclaude-youtube","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagricidaniel%2Fclaude-youtube","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagricidaniel%2Fclaude-youtube/lists"}