Youtube SEO Optimizer Agent Skill
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
one command, takes just this skill from the repositorynpx skills add https://github.com/nicepkg/ai-workflow --skill youtube-seo-optimizerThe instruction itself
22 sections, as written by the authorYouTube 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 |
Other skills for the same job
different authors, same section of the catalogue
A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.
Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.
Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store
NGS analysis toolkit. BAM to bigWig conversion, QC (correlation, PCA, fingerprints), heatmaps/profiles (TSS, peaks), for ChIP-seq, RNA-seq, ATAC-seq visualization.
Materials science toolkit. Crystal structures (CIF, POSCAR), phase diagrams, band structure, DOS, Materials Project integration, format conversion, for computational materials science.
Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results.
How to use it
Take nicepkg/youtube-seo-optimizer from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.