YouTube Marketing Skills

Build a YouTube personal brand with live channel data, AI-generated SEO, and organic-only growth strategy — no paid ads, no $99/month subscription.

21 commands · 10 live channel tools · Works with Claude Code, Cursor, Codex, Gemini CLI · MIT

⭐ Star Goal: 500 in 30 days → unlocks v1.1 (CTR rescue + plateau buster + outlier detector)

⭐ Star this repo if you've ever spent a Sunday planning a video that got 43 views. Every star tells me what to ship next — and v1.1 unlocks at 500.

What This Is

An agent-agnostic skill suite + MCP server that connects your AI agent of choice to your real YouTube channel — reads your private analytics, writes SEO back to YouTube, and publishes companion posts to WordPress. Works with Claude Code, Claude Desktop, Cursor, Windsurf, OpenAI Codex, Gemini CLI, or any MCP-compatible client. Not locked to any single LLM or vendor.

Three things no other YouTube AI tool does:

1. Reads your private analytics via OAuth — watch time, retention %, traffic sources, demographics. Not just public stats anyone can scrape.

2. Writes back to YouTube — pushes updated titles, descriptions, and tags directly from your agent. No opening YouTube Studio.

3. Double-ranks on Google — publishes a companion WordPress post with VideoObject schema so the same topic ranks on both Google and YouTube simultaneously.

/youtube-ideate  →  /youtube-script  →  /youtube-seo  →  push to YouTube
                                                        ↓
                                         /youtube-wp-post  →  published to WordPress

Related MCP server: YouTube MCP Agent

Who This Is For

Built for developers, consultants, and product makers who use YouTube to build authority — not entertainment creators chasing trending content.

• You make tutorials, walkthroughs, or educational content in your niche

• You want organic-only growth — no paid ads, no bought subscribers, no gaming the system

• You have a product, service, open-source project, or community to grow through video

• You want evergreen content — videos that get discovered for years, not just 48 hours after upload

One subscriber from your niche is worth more than 10,000 random views. This tool understands that.

Quick Start

Full guide: INSTALL.md.

Requirements: Node.js 18+, Google Cloud project with YouTube Data API v3 + YouTube Analytics API enabled, OAuth 2.0 Desktop credentials.

# 1. Clone + install
git clone https://github.com/adityaarsharma/youtube-marketing-skills.git
cd youtube-marketing-skills && npm install

# 2. Drop your Google OAuth credentials.json into the directory

# 3. Authenticate — opens browser once, saves tokens locally
node auth.js

# 4. Install the skill files into your agent
cp -r skills/youtube-marketing ~/.claude/skills/

Add the MCP server to your agent's config (~/.claude/settings.json, ~/.cursor/mcp.json, etc.):

{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/full/path/to/youtube-marketing-skills/server.js"]
    }
  }
}

Open your agent (Claude Code, Cursor, Codex, Windsurf, Gemini CLI — any MCP+Skills client) and type /youtube-strategy. You now have all 21 commands + live channel data + SEO write-back.

A no-install hosted option is coming soon for users who don't want to set up Node + Google Cloud.

Add to Claude Code settings.json:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["youtube-channel-mcp"]
    }
  },
  "skills": ["/path/to/youtube-marketing-skills/skills/youtube-marketing/SKILL.md"]
}

Configure your channel once — open skills/youtube-marketing/SKILL.md and set:

Channel: [Your channel name and handle]
Products: [Your products with URLs]
Best publish time: [Your optimal time + timezone]
Fixed links: [Product / docs / community URLs to embed in every description]

Every command now knows your business. Start with:

/youtube-ideate

21 Commands

Strategy & Planning

Production

SEO & Upload

Analytics & Optimization

Growth & Expansion

Live Channel Tools

What makes this different from every other YouTube AI skill: it connects to your real channel.

Direct read/write via OAuth2. Runs entirely on your machine — your data never leaves your computer.

The Organic Growth Playbook

No ads. No paid promotion. No viral luck. This is how personal brands compound on YouTube.

1. Find Evergreen Gaps

Evergreen content = keywords with consistent monthly search volume, not trending spikes that collapse in a week.

/youtube-ideate pulls live keyword data and surfaces gaps: real searches with volume that your competitors aren't targeting yet.

What to look for: Keywords where the top-ranking videos are 12+ months old, have weak titles, or come from channels outside your niche. That's unclaimed territory.

2. One Video, Three Discovery Paths

Every video you make should be built to win across three separate discovery systems:

• YouTube Search — title + description + tags targeting one specific query

• Google Search — companion WordPress post with VideoObject schema (same topic, two rankings)

• Suggested — thumbnail + hook optimized for your existing subscriber cohort

/youtube-seo + /youtube-wp-post handles all three in one workflow.

3. The Compounding Loop

Month 1:  Publish optimized tutorial → earns YouTube Search traffic
Month 2:  Companion post ranks on Google → new audience discovers the video
Month 3:  Video earns Suggested placement from a similar viewer cohort
Month 6:  Run /youtube-batch-seo → refresh titles with updated keyword data
Year 1:   This video drives 30–40% of your channel's total subscriber growth

/youtube-batch-seo automates the quarterly refresh. It finds your underperforming videos and pushes improved SEO — without you touching YouTube Studio.

4. Build a Gap Map, Not Just a Content Calendar

Most creators plan content by topic. Personal brands should plan by competitive gap.

/youtube-competitor  →  find what your niche isn't covering yet
/youtube-ideate      →  rank those gaps by keyword volume and competition score
/youtube-calendar    →  sequence by production effort and seasonal timing

This is the difference between a content calendar and a growth strategy.

Channel Templates

Pick the template that fits your channel type — configure it once in SKILL.md:

Integrations

Live Data Layer

Video Production Stack

Chain these together to produce finished videos from inside your agent — no manual editing, no leaving your terminal.

Roadmap details: marketing/integration-roadmap.md — 5 new orchestrator skills that chain these MCPs into one-command video production workflows.

Works With

Research Foundation

Every recommendation in every command is grounded in published data — not opinions.

Full citations: references/whitepapers.md

What's Inside

skills/youtube-marketing/
  SKILL.md          ← entry point — configure your channel once here
  sub-skills/       ← 21 command files
  references/       ← 9 knowledge guides (algorithm, analytics, SEO, Shorts, retention)
  templates/        ← 6 channel type configs
references/
  whitepapers.md    ← full citation database (14 published studies)

vs. VidIQ / TubeBuddy

Other Install Options

See INSTALL.md for the full guide — skill-only (no Node.js), full live mode, remote mode for teams, and Cursor / Claude Desktop / Codex / Gemini CLI configs.

FAQ

Is this a free VidIQ alternative?

Yes. 100% free, open source, MIT licensed. No subscription, no paywalled features, no usage limits. Everything VidIQ charges $49–$99/month for — keyword research, SEO scoring, bulk SEO updates, channel audits — runs locally on your machine with this toolkit.

Can my AI agent manage my YouTube channel?

Yes — with Mode 2 (Hosted MCP) or Mode 3 (Local MCP), your agent connects to your channel via OAuth and can read your private analytics (watch time, retention, traffic sources) and write back SEO updates (title, description, tags) directly. Works with Claude Code, Cursor, Windsurf, Codex, Gemini CLI, or any MCP-compatible client. You stay in control: the agent proposes changes, you approve before they push.

Do I need to install Node.js?

Yes — Node.js 18+ runs the MCP server that connects to your live YouTube data and pushes SEO updates back. That's how all 21 commands actually work against your real channel.

A hosted, no-install version is coming soon for users who don't want to set up Node + Google Cloud locally.

How is this different from claude-youtube by AgriciDaniel?

claude-youtube is skill-only — you paste analytics in manually. This repo offers both: pure skill mode + a live MCP server that reads private analytics and writes SEO directly to YouTube. You also get a WordPress companion-post pipeline, batch SEO updates, and 21 commands vs 14.

How is this different from VidIQ or TubeBuddy?

VidIQ and TubeBuddy show you scores. This gives you a workflow. They suggest keywords; this pushes the optimized title directly to YouTube. They give you a CTR number; this diagnoses why CTR is low and rewrites your thumbnail brief. They cost $49–$99/month; this is free and runs on your machine.

How do I grow a YouTube channel without paid ads?

Use the Organic Growth Playbook above: find evergreen keyword gaps (/youtube-ideate), publish optimized tutorials with companion WordPress posts (/youtube-wp-post), then run /youtube-batch-seo quarterly to refresh older videos. This stacks YouTube Search + Google Search + Suggested traffic into one compounding system. No paid ads required.

What is a YouTube MCP server?

An MCP (Model Context Protocol) server is a local program that gives AI agents like Claude direct access to a service. This repo's MCP server exposes 10 YouTube tools — read analytics, search your channel, update video SEO — so Claude can act on your real channel data. It runs entirely on your machine via OAuth2; nothing is sent to third parties.

Does this work with channels that have a product to sell?

Yes — it was specifically built for channels where one subscriber is worth more than 10,000 ad views. Configure your products and fixed links once in SKILL.md, then every command writes descriptions, CTAs, and funnels around your real product pages. There are channel templates for plugin/SaaS, agency, consultancy, personal brand, and tutorial channels.

Will this work for new channels under 1,000 subscribers?

Yes — the strategy and ideation commands work without any channel data (/youtube-strategy, /youtube-ideate, /youtube-script, /youtube-hook, /youtube-thumbnail). Live analytics commands obviously need an existing channel. The Organic Growth Playbook is designed to take a channel from zero to its first thousand subscribers using SEO-driven discovery.

License

MIT — Aditya Sharma

Built for channels where one subscriber is worth more than ten thousand ad views.