Ai-workflow youtube-seo-optimizer
Optimize YouTube videos for search and discovery. Generates SEO-optimized titles, descriptions, tags, hashtags, and chapters. Includes keyword research and competitor analysis. Use when publishing videos, improving discoverability, or optimizing existing content.
install
source · Clone the upstream repo
git clone https://github.com/nicepkg/ai-workflow
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/nicepkg/ai-workflow "$T" && mkdir -p ~/.claude/skills && cp -r "$T/workflows/video-creator-workflow/.claude/skills/youtube-seo-optimizer" ~/.claude/skills/nicepkg-ai-workflow-youtube-seo-optimizer && rm -rf "$T"
manifest:
workflows/video-creator-workflow/.claude/skills/youtube-seo-optimizer/SKILL.mdsource content
YouTube SEO Optimizer
Maximize video discoverability through strategic SEO optimization.
YouTube Algorithm Factors
📊 RANKING FACTORS (Estimated Weight): 1. Click-Through Rate (CTR) - 25% 2. Watch Time & Retention - 30% 3. Engagement (likes, comments, shares) - 15% 4. Keyword Relevance - 15% 5. Upload Consistency - 10% 6. Channel Authority - 5% KEY INSIGHT: SEO gets you discovered, CTR+Retention determines success
SEO Elements
1. Title Optimization
FORMULA: [Primary Keyword] + [Modifier] + [Benefit/Hook] Character Limit: 100 (recommend 50-70) Keyword Placement: First 50 characters Case: Title Case or Sentence case (consistent) ✅ "iPhone 16 Pro Review: 6 Months Later (Honest Opinion)" ✅ "How to Edit Videos Like a Pro in Premiere Pro 2025" ❌ "MY VIDEO about PHONES!!! [WATCH NOW] #iPhone #Review"
2. Description Optimization
CHARACTER LIMIT: 5,000 (first 150-200 shown in search) STRUCTURE: ───────────────────────────────────────────────────────────── [ABOVE THE FOLD - First 150 chars] Hook + Primary keyword + Call to action [MAIN DESCRIPTION - 200-500 words] - What the video covers - Key timestamps/chapters - Natural keyword integration - Related context [LINKS & RESOURCES] - Links mentioned in video - Affiliate links (disclosed) - Social media links [HASHTAGS] #keyword1 #keyword2 #keyword3 (max 3-5) [ABOUT/BOILERPLATE] - Channel description - Contact info - Posting schedule ─────────────────────────────────────────────────────────────
3. Tags (Still Relevant!)
TAG STRATEGY: - Primary keyword (exact match) - Long-tail variations - Misspellings of popular terms - Related topics - Channel/brand name LIMIT: 500 characters total IDEAL: 8-12 tags Example for "iPhone 16 Review": - iphone 16 review - iphone 16 pro review - iphone 16 camera test - apple iphone 2024 - best smartphone 2024 - iphone vs android - [your channel name]
4. Hashtags
PLACEMENT: Description (appear above title) LIMIT: First 3 hashtags shown BEST PRACTICE: 3-5 relevant hashtags #primarykeyword #secondarykeyword #broadtopic ✅ #iPhone16 #TechReview #Smartphone ❌ #fyp #viral #trending (YouTube isn't TikTok)
5. Chapters (Timestamps)
FORMAT: 0:00 - Intro 1:23 - Chapter Title 4:56 - Chapter Title RULES: - First timestamp MUST be 0:00 - Minimum 3 chapters - Each chapter minimum 10 seconds - Use keywords in chapter titles SEO BENEFIT: Chapters appear in Google search results
Description Template
[HOOK - What viewers will learn/see] In this video, I [primary action] + [key benefit]. [Secondary hook]. 📌 KEY POINTS: • [Point 1 with keyword] • [Point 2 with keyword] • [Point 3 with keyword] ⏱️ TIMESTAMPS: 0:00 - Introduction [X:XX] - [Chapter with keyword] [X:XX] - [Chapter with keyword] [X:XX] - [Chapter with keyword] [X:XX] - Conclusion 🔗 LINKS MENTIONED: • [Product/Resource]: [URL] • [Product/Resource]: [URL] • My [Related Video]: [URL] 📱 CONNECT WITH ME: • Instagram: [link] • Twitter: [link] • Website: [link] #Hashtag1 #Hashtag2 #Hashtag3 ────────────────── [Brief channel description] [Upload schedule] [Business inquiries email]
Keyword Research Process
Step 1: Find Primary Keywords
TOOLS: - YouTube Search Autocomplete (free) - Google Trends - YouTube Search - TubeBuddy / VidIQ (freemium) - Ahrefs YouTube Keyword Tool METHOD: 1. Type topic in YouTube search 2. Note autocomplete suggestions 3. Check competitor video titles 4. Look at "People also search for"
Step 2: Analyze Competition
FOR EACH KEYWORD, CHECK: - Number of results - Quality of top 10 videos - View counts of top videos - Channel sizes of competitors SWEET SPOT: High search volume + Weak competition (Large channels ignoring the keyword)
Step 3: Long-tail Opportunities
Add modifiers to primary keyword: - [year]: "best camera 2025" - [comparison]: "vs", "compared to" - [specificity]: "for beginners", "under $500" - [intent]: "how to", "tutorial", "review"
Output Format
═══════════════════════════════════════════════════════════════ YOUTUBE SEO OPTIMIZATION Video Topic: [Topic] Target Keyword: [Primary Keyword] ═══════════════════════════════════════════════════════════════ 🎯 OPTIMIZED TITLE: ───────────────────────────────────────────────────────────── Primary: "[Title]" (XX characters) Alternative A: "[Title]" Alternative B: "[Title]" 📝 OPTIMIZED DESCRIPTION: ───────────────────────────────────────────────────────────── [Full description following template above] 🏷️ TAGS (Copy-paste ready): ───────────────────────────────────────────────────────────── [tag1], [tag2], [tag3], [tag4], [tag5], [tag6], [tag7], [tag8] Total characters: XXX/500 #️⃣ HASHTAGS: ───────────────────────────────────────────────────────────── #Hashtag1 #Hashtag2 #Hashtag3 ⏱️ SUGGESTED CHAPTERS: ───────────────────────────────────────────────────────────── 0:00 - [Intro hook] [Suggestions based on typical video structure] 🔍 KEYWORD ANALYSIS: ───────────────────────────────────────────────────────────── Primary Keyword: [keyword] - Search Volume: [estimate] - Competition: [Low/Medium/High] - Suggested variants: [list] 📊 COMPETITOR ANALYSIS: ───────────────────────────────────────────────────────────── Top 3 videos for this keyword: 1. "[Title]" - [Views] - [Channel] 2. "[Title]" - [Views] - [Channel] 3. "[Title]" - [Views] - [Channel] Gap Opportunity: [What's missing from current results] ✅ SEO CHECKLIST: ───────────────────────────────────────────────────────────── [ ] Primary keyword in first 50 chars of title [ ] Primary keyword in first 150 chars of description [ ] 8-12 relevant tags added [ ] 3-5 hashtags included [ ] Chapters with keywords [ ] End screen and cards planned [ ] Custom thumbnail uploaded [ ] Playlist added (if applicable) ═══════════════════════════════════════════════════════════════
How to Use
Full SEO Package
Create YouTube SEO for a video about [topic] Target audience: [who] Main keyword: [keyword] (or suggest one) Video length: [X minutes]
Optimize Existing Video
Optimize this video for SEO: Current title: [title] Topic: [what it's about] Target keyword: [keyword] Current performance: [views, CTR if known]
Keyword Research Only
Research YouTube keywords for [topic] My channel size: [subscriber count] Looking for: [high volume / low competition / both]
YouTube SEO Checklist
Before Publishing
- Title contains primary keyword (first 50 chars)
- Description has keyword in first 150 characters
- Description is 200+ words
- 8-12 relevant tags added
- 3-5 hashtags included
- Chapters added with keywords
- Custom thumbnail uploaded
- Cards and end screen configured
- Added to relevant playlist
- Category selected correctly
- Language set correctly
After Publishing (24-48 hours)
- Check CTR in Analytics
- Monitor average view duration
- Respond to early comments
- Share on social media
- Update description if needed
Common SEO Mistakes
| Mistake | Impact | Fix |
|---|---|---|
| Keyword stuffing | Looks spammy, ignored | Natural integration |
| No timestamps | Missing search features | Add chapters |
| Generic tags | Weak targeting | Specific, relevant tags |
| Empty description | Lost SEO opportunity | 200+ word description |
| Irrelevant hashtags | Confuses algorithm | 3-5 relevant hashtags |
| Ignoring autocomplete | Missing search intent | Research suggestions |