Skip to content

AgriciDaniel/claude-youtube / skills/claude-youtube

youtube

Verified

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".

FileKindSize
SKILL.mdskill md12.2 KB
execution/fetch_channel_data.pyscript8.2 KB
execution/fetch_transcript.pyscript7.5 KB
execution/fetch_video_analytics.pyscript6.6 KB
execution/search_competitor_videos.pyscript7.0 KB
execution/utils/quota_tracker.pyscript5.8 KB
execution/utils/youtube_auth.pyscript5.7 KB
references/algorithm-guide.mdmarkdown6.3 KB
references/analytics-guide.mdmarkdown5.9 KB
references/dataforseo-integration.mdmarkdown12.8 KB
references/monetization-guide.mdmarkdown5.9 KB
references/repurposing-guide.mdmarkdown6.3 KB
references/retention-scripting-guide.mdmarkdown8.0 KB
references/seo-playbook.mdmarkdown6.0 KB
references/shorts-playbook.mdmarkdown5.2 KB
references/thumbnail-ctr-guide.mdmarkdown6.6 KB
sub-skills/analyze.mdmarkdown7.6 KB
sub-skills/audit.mdmarkdown8.9 KB
sub-skills/calendar.mdmarkdown8.6 KB
sub-skills/competitor.mdmarkdown10.2 KB
sub-skills/hook.mdmarkdown7.9 KB
sub-skills/ideate.mdmarkdown8.5 KB
sub-skills/metadata.mdmarkdown8.3 KB
sub-skills/monetize.mdmarkdown7.3 KB
sub-skills/repurpose.mdmarkdown6.7 KB
sub-skills/script.mdmarkdown7.1 KB
sub-skills/seo.mdmarkdown7.7 KB
sub-skills/shorts.mdmarkdown5.2 KB
sub-skills/strategy.mdmarkdown9.8 KB
sub-skills/thumbnail.mdmarkdown9.9 KB
templates/commentary-channel.mdmarkdown6.5 KB
templates/education-channel.mdmarkdown4.8 KB
templates/entertainment-channel.mdmarkdown5.5 KB
templates/niche-authority-channel.mdmarkdown7.8 KB
templates/personal-brand-channel.mdmarkdown8.3 KB
templates/review-channel.mdmarkdown6.3 KB
templates/shorts-first-channel.mdmarkdown8.4 KB
templates/tutorial-channel.mdmarkdown5.7 KB
templates/vlog-channel.mdmarkdown6.0 KB

references/seo-playbook.md

View on GitHub
# YouTube SEO Playbook

## Table of Contents

- [Title Optimization](#title-optimization)
- [Description Structure](#description-structure)
- [Tags](#tags)
- [Chapters & Timestamps](#chapters--timestamps)
- [Hashtags](#hashtags)
- [Captions & Transcription](#captions--transcription)
- [Cards & End Screens](#cards--end-screens)
- [VideoObject Schema Markup](#videoobject-schema-markup)
- [YouTube Search vs Google Search](#youtube-search-vs-google-search)
- [Keyword Research Tools](#keyword-research-tools)
- [Key Constraints & Gotchas](#key-constraints--gotchas)

---

## Title Optimization

| Property | Value |
|----------|-------|
| Hard character limit | 100 characters |
| Desktop truncation | ~60-70 characters |
| Mobile truncation | ~40-50 characters |
| Front-load keyword | First 40-50 characters |

### Performance Data

- **70-100 character titles** outperform shorter titles by **10-14%** (10xCreator, 3M+ videos analyzed)
- **Numbers in titles** = +20-30% CTR
- **Brackets** add useful context (e.g., `[2025 Update]`, `[Step-by-Step]`)

### Clickbait Penalty `[2025]`

- Official rollout: late 2024, India first, then global
- **Gemini AI** compares actual video content against title/thumbnail metadata
- Misleading titles are actively suppressed

---

## Description Structure

| Property | Value |
|----------|-------|
| Max length | 5,000 characters |
| Visible before "Show more" | First 150-200 characters |
| Primary keyword placement | First 25 words |

### Recommended Structure

| Section | Content |
|---------|---------|
| Lines 1-3 | Primary keyword + hook (visible in preview) |
| Next block | Timestamps/chapters |
| Body | 200-350 words, keyword appears 2-4x |
| Links | Relevant resources, social |
| CTA | Subscribe, comment prompt |
| Closing | 3 hashtags |

- `[2025]` **29.5%** of Google AI Overviews cite YouTube (BrightEdge, mid-2025)

---

## Tags

- **Status**: Vestigial -- minimal ranking impact
- **Limit**: 500 characters, spend max 30 seconds
- `[2025]` Gemini analyzes actual video content now, not tags

### Only Use Tags For

- Common misspellings of your topic
- Disambiguation (when your topic has multiple meanings)
- Brand-new channels with no content history

---

## Chapters & Timestamps

| Requirement | Value |
|-------------|-------|
| Must start at | 0:00 |
| Minimum chapters | 3 |
| Minimum chapter length | 10 seconds each |

### Impact

- Enables **Google Key Moments** in search results
- **25%+** of Google search results include video snippets
- **4% higher AVD** (Backlinko)
- **Retention up to 50% higher** with timestamps (HubSpot)
- Use keyword-rich chapter labels

---

## Hashtags

| Context | Optimal Count | Max Before Ignored |
|---------|--------------|-------------------|
| Regular videos | 3-5 | 15 (exceeding = ALL ignored) |
| Shorts | 1-5 | 60 total characters |

- First 3 hashtags appear **above the video title**
- Exceeding 15 hashtags causes YouTube to ignore ALL of them

---

## Captions & Transcription

- **12% longer watch time** with captions enabled
- **80%** of caption users are not deaf (accessibility + comprehension)
- Manual SRT uploads rank better for indexing than auto-captions
- **Say target keywords naturally** on camera -- YouTube transcribes audio as SEO signals

---

## Cards & End Screens

- Cards and end screens **do not directly affect ranking**
- End screen CTR benchmarks:
  - **2%+** = healthy
  - **4%+** = strong
- Optimal placement: last **15-20 seconds** of video
- End screens can **double post-viewing engagement**

---

## VideoObject Schema Markup

### Required Properties

| Property | Description |
|----------|-------------|
| `name` | Video title |
| `thumbnailUrl` | Thumbnail image URL |
| `uploadDate` | ISO 8601 date |

### Performance

- `[2025]` **30% higher CTR** with VideoObject schema (Backlinko 2025)
- Use **JSON-LD** format
- Add **Clip** and **SeekToAction** markup for chapter-level rich results
- Since late 2023: video must be **main content** of the page for rich snippets (not sidebar embeds)

---

## YouTube Search vs Google Search

| Factor | YouTube Search | Google Search |
|--------|---------------|---------------|
| Primary ranking signal | Retention & satisfaction | Information delivery |
| Content priority | Watch time, engagement | Relevance, authority |

### Video-Trigger Keywords (Appear in Google Video Results)

- "how to", "tutorial", "review", "vs", "explained"

### Discovery Tool

- Use **Google Trends** with **YouTube Search filter** for keyword demand validation

---

## Keyword Research Tools

| Tool | Best For | Price |
|------|----------|-------|
| **vidIQ** | Research quality, keyword scoring | $17.50/mo |
| **TubeBuddy** | A/B testing integration | $2.25/mo |
| **YouTube Studio Research** | Own channel analytics | Free |
| **Google Trends (YouTube filter)** | Trend validation | Free |

- Neither vidIQ nor TubeBuddy has a public API
- `[2025]` Jan 2026 Search Filter Update for long-tail keywords (unconfirmed -- mentioned in community reports, not officially documented)

---

## Key Constraints & Gotchas

- **Mobile truncates titles at ~40-50 chars** -- if the keyword or hook isn't in that range, mobile viewers miss it
- **Exceeding 15 hashtags causes ALL hashtags to be ignored** -- not just the extras
- **Tags are effectively dead** -- spending more than 30 seconds on them is wasted effort. Gemini reads video content directly `[2025]`
- **Description keyword stuffing hurts** -- 2-4x keyword density in 200-350 words is the ceiling
- **First 150-200 chars of description** are all viewers see before clicking "Show more" -- treat them as ad copy
- **VideoObject schema only works** when the video is the main page content (since late 2023)
- **Clickbait penalty is AI-enforced** `[2025]` -- Gemini compares metadata to actual content. No manual review needed to trigger suppression
- **Auto-captions are inferior** to manual SRT for SEO indexing
- **Chapters require 0:00 start** -- omitting it disables the entire chapter system
- **Google AI Overviews increasingly cite YouTube** (29.5%, BrightEdge mid-2025) -- optimize descriptions for Google, not just YouTube search
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall