agentleFS
mategogmategog/mateai-youtube-mcp/skills/claude-youtube/SKILL.md

youtube

Skill1 starsChanged 12 days agoApache-2.0View on GitHub

The ultimate YouTube creator skill. Covers channel audits, video SEO, retention-engineered scripts, hook writing, thumbnail briefs, content strategy, content calendars, Shorts optimisation, analytics interpretation, monetisation planning, competitor research, cross-platform repurposing, upload metadata packages, and data-driven video idea generation. Triggers on: "youtube", "channel", "video", "views", "subscribers", "watch time", "shorts", "thumbnail", "CTR", "retention", "monetize", "script", "hook", "upload", "youtube audit", "video ideas", "content calendar", "competitor analysis", "repurpose video", "youtube seo", "youtube strategy", "youtube analytics".

  • Reads credentials

36 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use tiktok, linkedin and 2 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • G-HunterAiSkill

    tiktok

    TikTok platform integration. Manage videos, view analytics, and track engagement.

    Also in 5 projects that use this

  • kkoppenhaverSkill

    linkedin

    Write LinkedIn posts in Keanan's voice. Use when drafting LinkedIn content, creating professional posts, or sharing builder-focused insights. Triggers include requests to "write a LinkedIn post", "draft something for LinkedIn", "help me post on LinkedIn", or any LinkedIn content creation. Generates upbeat, builder-centric content mixing practical how-tos with candid humor.

    Also in 3 projects that use this

  • OpenAISkill

    email

    Email sending integration guidance — Resend (native Vercel Marketplace) with React Email templates. Covers API setup, transactional emails, domain verification, and template patterns. Use when sending emails from a Vercel-deployed application.

    Also in 3 projects that use this

  • SentrySkill

    skill-creator

    Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, writing, registration, and verification.

    Also in 4 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

19 rules. 0 are common, 14 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 28 edited versions we read keep these.

  • 14

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the user's request doesn't clearly match one command, ask a clarifying question.

    line 50
  2. Distinctive:

    If the request spans multiple sub-skills (e.g., "help me plan and script my next video"), run the relevant sub-skills sequentially, passing …

    line 51
  3. Distinctive:

    Before invoking ANY sub-skill, you MUST collect these three inputs.

    line 56
  4. Distinctive:

    All other sub-skills run inline (single-threaded).

    line 99
  5. Distinctive:

    Do not reload a reference file already in context for this session.

    line 105
  6. Very specific:

    When the DataForSEO MCP server is available (configured in ~/.claude/settings.json), youtube skills use live data for keyword research, …

    line 121
  7. Distinctive:

    If it fails, fall back to WebSearch + execution scripts.

    line 130
  8. Distinctive:

    Don't re-fetch data already retrieved in the same session

    line 171
  9. Very specific:

    Use dataforseo_labs_google_keyword_overview for single-keyword lookups

    line 172
  10. Very specific:

    When the NanoBanana MCP server is configured, the thumbnail sub-skill can generate actual thumbnail images using Gemini models instead of …

    line 177
  11. Very specific:

    Check if YOUTUBE_API_KEY environment variable exists

    line 196
  12. Distinctive:

    If missing, provide the user with setup instructions instead of failing silently

    line 197
  13. Distinctive:

    If credentials are absent, fall back to asking the user to provide data manually (e.g., paste YouTube Studio screenshots or describe their …

    line 200
  14. Distinctive:

    Every sub-skill output MUST pass these checks before delivery:

    line 214
  15. Distinctive:

    No generic advice like "post consistently" without specifying cadence for their tier.

    line 217
  16. Distinctive:

    Never hallucinate statistics.

    line 219
  17. Distinctive:

    If a sub-skill output fails a quality gate:

    line 225
  18. Distinctive:

    If still failing after 2 attempts, deliver with explicit caveats noting the limitation

    line 230
  19. Very specific:

    Default to markdown. For metadata sub-skill, produce copy-paste-ready plain text blocks.

    line 234

“Common” is measured: kept by at least 6 in 10 of the 28 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Claude YouTube — YouTube Creator Skill

Orchestrator for 14 sub-skills covering every aspect of YouTube channel growth, optimisation, and monetisation. You route, delegate, and quality-check — sub-skills and execution scripts do the work.

Command Router

CommandSub-SkillTrigger Phrases
/youtube auditsub-skills/audit.md"audit my channel", "channel health", "what's wrong with my channel", "my channel isn't growing"
/youtube seosub-skills/seo.md"video SEO", "rank higher", "keyword research", "improve search ranking"
/youtube scriptsub-skills/script.md"write a script", "script for my video", "help me script"
/youtube hooksub-skills/hook.md"write a hook", "improve my intro", "first 30 seconds", "opening"
/youtube thumbnailsub-skills/thumbnail.md"thumbnail brief", "improve CTR", "design thumbnail"
/youtube strategysub-skills/strategy.md"channel strategy", "content plan", "positioning", "niche"
/youtube calendarsub-skills/calendar.md"content calendar", "upload schedule", "what should I post this month"
/youtube shortssub-skills/shorts.md"Shorts", "short video", "vertical video", "Shorts strategy"
/youtube analyzesub-skills/analyze.md"analyze metrics", "why are views dropping", "interpret analytics"
/youtube repurposesub-skills/repurpose.md"repurpose video", "turn into Shorts", "cross-platform", "extract clips"
/youtube monetizesub-skills/monetize.md"monetize", "make money", "revenue", "brand deals", "memberships"
/youtube competitorsub-skills/competitor.md"competitor analysis", "spy on channel", "what is [channel] doing"
/youtube metadatasub-skills/metadata.md"upload metadata", "title and description", "pre-publish checklist"
/youtube ideatesub-skills/ideate.md"video ideas", "what should I make next", "brainstorm", "content ideas"

If the user's request doesn't clearly match one command, ask a clarifying question. If the request spans multiple sub-skills (e.g., "help me plan and script my next video"), run the relevant sub-skills sequentially, passing output from each as input to the next.

Context-Gathering Protocol

Before invoking ANY sub-skill, you MUST collect these three inputs. If any are missing, ask:

  1. Channel niche/topic — What is the channel about? Be specific (not "tech" — "budget Android phone reviews").
  2. Channel size tier:
    • New: < 1K subscribers
    • Growing: 1K–10K subscribers
    • Established: 10K–100K subscribers
    • Authority: 100K+ subscribers
  3. Primary goal: Growth / Monetisation / Brand Authority / Audience Engagement

For audit, analyze, and competitor sub-skills, also collect the channel URL or handle.

Channel Type Detection

Based on niche and content description, classify into one of 9 types and load the matching template from templates/:

TypeTemplateSignals
Educationtemplates/education-channel.mdHow-to, explainers, courses
Entertainmenttemplates/entertainment-channel.mdComedy, challenges, reactions
Tutorialtemplates/tutorial-channel.mdStep-by-step, walkthroughs, demos
Vlogtemplates/vlog-channel.mdDay-in-life, personal updates
Reviewtemplates/review-channel.mdProduct reviews, comparisons, unboxing
Commentarytemplates/commentary-channel.mdNews commentary, opinion, essays
Niche Authoritytemplates/niche-authority-channel.mdDeep-dive single topic, expert positioning
Personal Brandtemplates/personal-brand-channel.mdCreator-as-brand, multi-format
Shorts-Firsttemplates/shorts-first-channel.mdPrimarily vertical content

Parallel Agent Rules

audit sub-skill — spawn 4 parallel agents:

  • Agent A: Technical SEO audit (loads references/seo-playbook.md)
  • Agent B: Performance audit (loads references/analytics-guide.md)
  • Agent C: Content strategy audit (loads references/algorithm-guide.md)
  • Agent D: Monetisation audit (loads references/monetization-guide.md)

competitor sub-skill — spawn 4 parallel agents:

  • Agent A: Top video analysis
  • Agent B: Keyword gap analysis
  • Agent C: Format gap analysis
  • Agent D: Audience gap analysis (comment mining)

All other sub-skills run inline (single-threaded). If Agent tool is unavailable, fall back to sequential inline execution.

Reference Files

Load on-demand when a sub-skill requests them. Never pre-load all at once. Do not reload a reference file already in context for this session.

FileContent
references/algorithm-guide.md3-system architecture, testing cascade, CTR/AVD benchmarks, 2024-2025 changes
references/seo-playbook.mdTitle/description/tags/chapters/hashtags rules, VideoObject schema
references/retention-scripting-guide.mdHook frameworks, pattern interrupts, CTA placement, retention graphs
references/thumbnail-ctr-guide.mdCTR by niche, face psychology, A/B testing, title formulas
references/shorts-playbook.mdShorts algorithm, format specs, monetisation, repurposing
references/analytics-guide.mdMetrics hierarchy, funnel ratios, RPM/CPM by niche
references/monetization-guide.mdYPP tiers, 7 revenue streams, brand deal rates
references/repurposing-guide.mdHub/Hero/Help model, cross-platform workflows, platform specs
references/dataforseo-integration.mdDataForSEO MCP tool reference, YouTube SERP, keyword research, trends

DataForSEO MCP Integration (Optional)

When the DataForSEO MCP server is available (configured in ~/.claude/settings.json), youtube skills use live data for keyword research, YouTube SERP analysis, trend intelligence, video metadata, and competitive research. Falls back to WebSearch + execution scripts when unavailable.

Reference: Load references/dataforseo-integration.md for full tool reference, parameters, and efficiency guidelines.

Detection: Attempt any DataForSEO tool call (e.g., serp_youtube_organic_live_advanced). If it fails, fall back to WebSearch + execution scripts. Never block a workflow because DataForSEO is unavailable.

Default parameters: location_code=2840 (US), language_code="en"

Key YouTube DataForSEO Tools

ToolPurpose
serp_youtube_organic_live_advancedYouTube search results for a keyword — videos, channels, playlists with view counts
serp_youtube_video_info_live_advancedDeep video analysis — views, likes, comments, tags, category, subtitles
serp_youtube_video_comments_live_advancedVideo comments with engagement data
serp_youtube_video_subtitles_live_advancedVideo transcript/subtitles extraction
kw_data_google_ads_search_volumeSearch volume, CPC, competition for keyword arrays
dataforseo_labs_google_keyword_ideasKeyword ideas from seed keywords
dataforseo_labs_google_keyword_suggestionsAutocomplete-style keyword suggestions
dataforseo_labs_bulk_keyword_difficultyKeyword difficulty scores (0-100)
dataforseo_labs_search_intentIntent classification (informational/commercial/transactional)
kw_data_google_trends_exploreGoogle Trends time series (supports YouTube-specific filtering)

Sub-Skill → DataForSEO Module Mapping

Sub-SkillDataForSEO Tools Used
ideateYouTube SERP + keyword ideas + trends + volume
seoVolume + difficulty + intent + YouTube SERP competition
competitorYouTube SERP × keywords + video info + comments
strategyTrends + volume + YouTube SERP + keyword ideas
calendarGoogle Trends for seasonal planning + volume for prioritisation
analyzeYouTube SERP position tracking + video info
auditYouTube SERP + volume + video info + keyword difficulty
shortsYouTube SERP (Shorts filter) + trends
hookYouTube SERP top video titles for keyword
thumbnailYouTube SERP competitor thumbnails
metadataVolume + difficulty for tag optimisation

API Credit Awareness

DataForSEO charges per API call. Typical workflow costs $0.002-$0.04. Rules:

  • Batch keywords into single calls (volume, difficulty, intent tools accept arrays)
  • Don't re-fetch data already retrieved in the same session
  • Use dataforseo_labs_google_keyword_overview for single-keyword lookups
  • Warn the user before running expensive operations

NanoBanana MCP — Thumbnail Generation (Optional)

When the NanoBanana MCP server is configured, the thumbnail sub-skill can generate actual thumbnail images using Gemini models instead of just producing text briefs.

Tool: generate_image

Recommended thumbnail settings:

  • aspect_ratio: "16:9" (YouTube standard)
  • resolution: "4k" (1280×720 minimum for YouTube)
  • model_tier: "nb2" (fast, high-quality production assets)

Detection: Attempt generate_image tool call. If unavailable, deliver text-based thumbnail briefs only — they are detailed enough for any designer to execute.

Workflow: Primary thumbnail + 3 A/B variants = 4 generate_image calls per brief. See sub-skills/thumbnail.md for prompt engineering guidelines.

Execution Scripts

Scripts require YouTube API credentials. Before calling any script:

  1. Check if YOUTUBE_API_KEY environment variable exists
  2. If missing, provide the user with setup instructions instead of failing silently
  3. For Analytics API scripts, check OAuth token exists

If credentials are absent, fall back to asking the user to provide data manually (e.g., paste YouTube Studio screenshots or describe their metrics).

ScriptPurposeQuota Cost
execution/fetch_channel_data.pyChannel stats + last N videos via Data API v3~16 units
execution/fetch_video_analytics.pyPrivate analytics (own channel, OAuth)~5 units
execution/search_competitor_videos.pySearch competitor videos (expensive)100 units/search
execution/fetch_transcript.pyVideo transcript extraction1-2 units
execution/utils/quota_tracker.pyTracks 10K unit/day quota0 units
execution/utils/youtube_auth.pyAPI key + OAuth handler0 units

Quality Gates

Every sub-skill output MUST pass these checks before delivery:

  1. Specificity — Every recommendation must be actionable for THIS channel. No generic advice like "post consistently" without specifying cadence for their tier.
  2. Data grounding — Every benchmark cited must come from a reference file. Never hallucinate statistics. If unsure, say "benchmark unavailable" and explain.
  3. Completeness — All sections in the sub-skill's output template must be present. Missing sections = incomplete deliverable.

Self-Anneal Loop

If a sub-skill output fails a quality gate:

  1. Identify which gate failed and why
  2. Re-read the relevant reference file for missing data
  3. Re-generate only the failing sections
  4. Re-check all three gates
  5. If still failing after 2 attempts, deliver with explicit caveats noting the limitation

Output Format

Default to markdown. For metadata sub-skill, produce copy-paste-ready plain text blocks. For calendar, produce a markdown table. For audit, produce a structured report with scores. Always end with a "Next Steps" section pointing the user to the logical next sub-skill (e.g., after audit → suggest strategy or the lowest-scoring dimension's sub-skill).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.