seo
Optimize YouTube titles, descriptions, and tags using competitive research. Analyzes top-performing videos on the topic, identifies keyword patterns and CTR hooks, and generates SEO-optimized titles with scorecards. Optionally generates social media titles. Triggers on: seo optimize, optimize title, youtube seo, optimize description, title ideas, seo this video, improve my title.
- License 许可
- MIT
- 最近更新
- 2026-10-04
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- seo
- description
- Optimize YouTube titles, descriptions, and tags using competitive research. Analyzes top-performing videos on the topic, identifies keyword patterns and CTR hooks, and generates SEO-optimized titles with scorecards. Optionally generates social media titles. Triggers on: seo optimize, optimize title, youtube seo, optimize description, title ideas, seo this video, improve my title.
- allowed-tools
- Read, Write, Edit, Glob, Grep, WebSearch, WebFetch, AskUserQuestion
- argument-hint
- [topic or ~/youtube/<slug>/]
- user-invocable
- true
03 SKILL.md 正文
Optimize YouTube SEO for the video topic or package at $ARGUMENTS.
Workflow Context
Step 4 of the weekly content pipeline (after /yt). Run once per long-form video package. After this, run /content to generate the LinkedIn + YT Community text posts for that video.
Data Location
- If a video package exists at
~/youtube/<slug>/: updatestitles.mdanddescription.mdin place (adds SEO section) - Standalone: outputs to
~/youtube/<slug>/seo.md
Flow
Step 1: Gather Context
Determine the input:
- Video package path (
~/youtube/<slug>/): Readtitles.md,script.md,description.md,analysis.md, andperformance.mdif they exist. Theperformance.mdfile tracks previously tried titles and thumbnails - never suggest a title that's already been tried. - Topic/title string: Use it directly as the starting point
- No argument: Ask the user for their video topic or title
Extract:
- The core topic and primary keyword
- Any existing titles to improve on
- The video's key points and value proposition (from script if available)
Check if --social flag is present in $ARGUMENTS — if so, also generate social media titles in the output.
Step 2: Competitive Research (WebSearch)
This step is NOT optional — always do real research.
First, check for existing research from /yt: If a video package exists at ~/youtube/<slug>/analysis.md, read it. The /yt skill already runs 4-6 web searches and saves competitor data, content gaps, and community sentiment. Extract what's already there:
- Competitor video titles and view counts
- Keywords and phrases already identified
- Content gaps already noted
Then fill in SEO-specific gaps — only run searches for data NOT already in analysis.md. Typically this means 2-3 targeted searches instead of 5-6:
- YouTube autocomplete: Search
<topic> youtube autocomplete suggestionsand<topic> how to / vs / best / tutorialto find what people actually search for - Title patterns: Search for variations of the topic to see how different creators title similar content (skip if analysis.md already has 10+ competitor titles)
- Related keywords: Search for synonyms, related terms, and long-tail variations
- Trending angles: Search for recent news/developments about the topic that could inform timely title angles (skip if analysis.md has recent news)
If no analysis.md exists (standalone SEO run without /yt), run the full 5-6 searches:
- Top videos on this topic: Search
"<topic>" site:youtube.comand<topic> youtubeto find the top-performing videos - Title patterns: Search for variations of the topic to see how different creators title similar content
- YouTube autocomplete: Search
<topic> youtube autocomplete suggestionsand<topic> how to / vs / best / tutorialto find what people actually search for - Related keywords: Search for synonyms, related terms, and long-tail variations
- Trending angles: Search for recent news/developments about the topic that could inform timely title angles
- Competitor analysis: Search for the top creators in this niche and analyze their title patterns
For each search, note:
- Video titles that appeared
- View counts where visible
- Common keywords and phrases
- Title formulas being used (How to X, X vs Y, I tried X, etc.)
Present a research summary to the user:
- Top 10-15 competitor titles with view counts
- Most common keywords (ranked by frequency)
- Title formulas that appear to perform well
- Content gaps — angles nobody is using
Step 3: Generate SEO-Optimized Content
Title Options (5 titles)
For each title:
- The title — Under 70 characters (YouTube truncates after that)
- Character count — Show the exact count
- CTR formula used — Name the technique (curiosity gap, specific number, how-to, comparison, bold claim, etc.)
- Primary keyword — What search term this targets
- Why it works — One sentence on the psychology/SEO reasoning
Rules for titles:
- Front-load the most important keyword in the first 40 characters
- Never use clickbait the video can't deliver on
- Include at least one title using a number/specific claim
- Include at least one curiosity-driven title
- Include at least one direct/search-optimized title
- Avoid overused words: "INSANE", "CRAZY", "YOU WON'T BELIEVE"
Title Scorecard
Rate each title on a 1-5 scale:
| Title | Curiosity | Specificity | SEO Strength | Click Factor | Total |
|---|
- Curiosity (1-5) — Does it create an information gap the viewer wants to close?
- Specificity (1-5) — Does it promise something concrete vs vague?
- SEO Strength (1-5) — Does it contain high-volume searchable keywords?
- Click Factor (1-5) — Would YOU click this in a sea of other thumbnails?
Mark the recommended title with the highest total score.
Optimized Description
- First 2 lines — These show in search results. Front-load keywords and value proposition. No fluff.
- Body — Natural keyword density (2-3% target keyword occurrence). Include related keywords organically.
- Chapters section —
00:00 - Titleformat (use placeholders if timestamps unknown, mark with [UPDATE]) - Links section — Placeholder for relevant links
- Tags line — Keywords at the bottom for additional SEO signal
If an existing description.md exists, add a ## SEO-Optimized Version section rather than replacing the original.
Tags (15-20)
Organize tags in three tiers:
- Exact match (3-5) — The exact phrases people search for
- Broad match (5-7) — Related topics and category terms
- Long-tail (5-8) — Specific, lower-competition phrases
Social Media Titles (if --social flag)
Generate platform-native titles:
- LinkedIn headline — Professional, insight-driven (under 150 chars). Focus on the lesson or takeaway, not the video.
- TikTok/Reels caption — Short, punchy, hook-first (under 100 chars). Create urgency or curiosity.
- Twitter/X post — Under 280 chars, curiosity-driven. Make it a standalone insight that happens to link to a video.
Rules for social titles:
- These should NOT just be the YouTube title copy-pasted
- Each platform has different psychology — LinkedIn = professional growth, TikTok = entertainment/discovery, Twitter = hot takes/insights
- The social title should make the content feel native to that platform
Step 4: Present Results
Show the user:
- The research summary (competitor titles + view counts)
- All 5 title options with the scorecard
- The recommended title (highlighted)
- The optimized description (first 3 lines preview)
- The tag list
- Social media titles (if generated)
Step 5: Iterate
Ask: "Want to go with one of these, or want me to generate more variants of a specific style?"
Options:
- Pick a title and finalize
- Generate 5 more in the style of a specific title
- Mix elements from multiple titles
- Adjust the description
- Regenerate with different target keywords
Output
If a video package exists at ~/youtube/<slug>/:
- Update
titles.md: Add a## SEO-Optimized Titlessection with the new titles, scorecard, and research data - Update
description.md: Add a## SEO-Optimized Versionsection with the new description and tags
If standalone (no existing package):
- Create
~/youtube/<slug>/seo.md: Contains all titles, scorecard, description, tags, research data, and social titles
Always include the research data (competitor titles with view counts) in the output so the user can see WHY each title works.
Rules
- ALWAYS do competitive research — never skip Step 2. The research is what makes this valuable.
- Titles must be under 70 characters — no exceptions
- Front-load the most important keyword in the first 40 characters
- Never use clickbait that the video can't deliver on
- Description first 2 lines are crucial — they show in search results
- Tags should include exact match, broad match, and long-tail variants
- Social titles should be platform-native, not just the YouTube title reformatted
- Always show the research data so the user can see the reasoning
- Include ALL competitor titles and view counts in the output — transparency builds trust
- If updating existing files, add new sections rather than overwriting the original content
04 同仓库更多 Skills
yt
Plan a YouTube video from a reference transcript and your own ideas. Analyzes source video structure, researches the topic online, asks for your angle, then generates titles, hooks, description, full script, and a filming guide. Triggers on: youtube video, video script, plan a video, video from transcript, yt plan.
yt-search
Search YouTube by keywords using yt-dlp. Finds recent videos, sorts by views, and generates a markdown report with full metadata. Triggers on: youtube search, search youtube, yt search, what's trending on youtube, youtube research.
thumbnail
Generate YouTube thumbnails using Kie.ai image APIs (Nano Banana 2, Nano Banana Pro, or Seedream 4.5). Supports text-to-image and remix (image + text). Creates multiple variants with configurable settings. Triggers on: create thumbnail, generate thumbnail, thumbnail for, make a thumbnail, youtube thumbnail, remix thumbnail.
repurpose
Repurpose a VIDEO transcript or script into short-form VIDEO scripts for YouTube Shorts, TikTok, and Reels — plus matching captions and a community post. Input must be a video transcript, script path, or YouTube URL. Use this for video-first content only. For text posts, LinkedIn posts, carousels, or static visuals, use /content instead. Triggers on: repurpose this video, repurpose transcript, create shorts from, make social posts from, repurpose content, turn this into shorts.
video-understanding
Analyze local video files with Gemini multimodal models, especially Gemini 3.1 Pro Preview, by uploading supported video formats and answering grounded questions with timestamps. Use when the user asks to analyze, understand, describe, summarize, inspect, or answer questions about videos such as .mp4, .mov, .webm, .avi, .wmv, .mpeg, .mpg, .flv, or .3gp files.
goal-orchestrator
Turn broad requests into an execution-ready brief and a measurable native goal for Codex, Claude Code, or Kimi Code. Use when the user asks to draft, refine, start, or run a goal whose outcome or verification still needs definition. Already precise tasks can use native /goal or an ordinary prompt directly.