AGENT SKILL

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>/: updates titles.md and description.md in place (adds SEO section)
  • Standalone: outputs to ~/youtube/<slug>/seo.md

Flow

Step 1: Gather Context

Determine the input:

  • Video package path (~/youtube/<slug>/): Read titles.md, script.md, description.md, analysis.md, and performance.md if they exist. The performance.md file 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:

  1. YouTube autocomplete: Search <topic> youtube autocomplete suggestions and <topic> how to / vs / best / tutorial to find what people actually search for
  2. 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)
  3. Related keywords: Search for synonyms, related terms, and long-tail variations
  4. 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:

  1. Top videos on this topic: Search "<topic>" site:youtube.com and <topic> youtube to find the top-performing videos
  2. Title patterns: Search for variations of the topic to see how different creators title similar content
  3. YouTube autocomplete: Search <topic> youtube autocomplete suggestions and <topic> how to / vs / best / tutorial to find what people actually search for
  4. Related keywords: Search for synonyms, related terms, and long-tail variations
  5. Trending angles: Search for recent news/developments about the topic that could inform timely title angles
  6. 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 - Title format (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:

  1. Exact match (3-5) — The exact phrases people search for
  2. Broad match (5-7) — Related topics and category terms
  3. 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:

  1. The research summary (competitor titles + view counts)
  2. All 5 title options with the scorecard
  3. The recommended title (highlighted)
  4. The optimized description (first 3 lines preview)
  5. The tag list
  6. 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 Titles section with the new titles, scorecard, and research data
  • Update description.md: Add a ## SEO-Optimized Version section 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

jayozer
jayozer/jay-marketplace

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.

★ 0
jayozer
jayozer/jay-marketplace

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.

★ 0
jayozer
jayozer/jay-marketplace

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.

★ 0
jayozer
jayozer/jay-marketplace

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.

★ 0
jayozer
jayozer/jay-marketplace

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.

★ 0
jayozer
jayozer/jay-marketplace

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.

★ 0