Optimize YouTube and podcast metadata for search rankings
Produces a researched YouTube/podcast/Shorts SEO package, or audits and rewrites one that isn't getting views.
Maintainer of this project? Claim this page to edit the listing.
13.5.0Add to Favorites
Why it matters
Help content creators maximize discoverability and views by generating SEO-optimized titles, descriptions, tags, and hashtags for video and podcast uploads, or auditing underperforming content to identify ranking issues.
Outcomes
What it gets done
Research target keywords and trending phrases using live web search to ground all SEO recommendations in real data
Generate platform-optimized titles (60-70 chars) with power words, outcome hooks, and primary keyword placement
Build complete metadata packages including 14-19 strategic tags, 5-8 hashtags, and 700-900 word descriptions with natural keyword integration
Audit live videos or podcast episodes to diagnose why content isn't ranking and recommend specific fixes
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-youtube-seo-optimizer | bash Overview
YouTube & Podcast SEO Optimizer
Produces a researched title, description, tags, and hashtags package for a video, podcast episode, or short-form clip, or audits and rewrites one that isn't ranking, across six content-type and new/existing modes. Use it for exactly one video, episode, or clip at a time, when the user wants an SEO package or an audit. Every keyword must come from real research, never memory.
What it does
Produces a researched title, description, tags, and hashtags package for YouTube videos, podcast episodes, or short-form clips and Reels, or audits a live video or episode that isn't getting views and rewrites its metadata - covering six scenarios in total: three content types (standalone video, podcast episode, short-form clip) crossed with two states (new upload or existing/underperforming), each handled by its own mode. Two rules run through every mode: every keyword is researched via real web search rather than guessed or pulled from memory, and the output matches exactly what was asked - a request for just a title gets just a title, a request for the full package gets every numbered section, never more than what was asked for.
When to use - and when NOT to
Use it when the user wants a title, description, tags, and hashtags package for a new upload, an audit of a live video or podcast episode that isn't getting views, show notes or timestamps or podcast episode metadata, or says something like "SEO my video," "audit my YouTube video," "write a podcast description," "why isn't my video ranking," "generate tags," or "fix my podcast SEO" - for a new, already-published, or short-form piece of content. It handles exactly one video, episode, or clip at a time, never an entire channel or playlist; if asked for something broader, the correct response is to ask which single item to start with, then restart the flow for that one item. It needs real web search and URL fetch tools to function at all, under whatever name the host environment gives them.
Inputs and outputs
The flow runs in a fixed order: read the user's request and check scope first; classify content type and status, inferred from whether a URL, "no views," or "uploading" language was given, fetching live metadata immediately if a URL was provided rather than asking the user to repeat it, to land on one of six modes; find the target keyword, either confirmed from what the user already said or extracted from their topic and researched with a real search batch (the keyword itself, a year-qualified version, trending or reddit-style real phrasing, and for podcasts the guest's name), pulling 3-6 secondary long-tail keywords from that research and never fabricating search volume, view counts, or algorithm claims - a thin result set is treated as a legitimate signal of lower competition, not a failure; gather any remaining links, CTA goal, offer details, or podcast-specific info by scraping what's available first and asking one question at a time only when scraping and inference both dead-end, using an explicit placeholder marker rather than ever inventing a fake URL; then build only the sections the user actually asked for and run a quality checklist before sending. Titles across every mode follow one formula:
[Primary Keyword] : [Outcome or Benefit] + [Power Word / Number / Year]
held to 60-70 characters counted exactly, with the primary keyword in the first 4-5 words, one emotional hook, a year only when the research shows year-stamped titles are actually common, no all-caps except a single emphasis word, no misleading promise, and an A/B variant that uses a genuinely different hook rather than a reworded version of the same one, drawn from named patterns for how-to, list, story, question, geo, comparison, and podcast-guest framings.
Integrations
Long-form modes generate 14-19 tags across seven required types (an exact-match primary keyword, broad umbrella topics, long-tail phrases from research, question-based phrasing, a branded or show-name tag, a year tag only when research supports it, and a geo tag for location-specific content), all lowercase except proper nouns, under 500 characters total, never repeating a phrase; short-form content instead uses 5-8 tags reused from its parent video where applicable. Hashtags run 5-8 for video and podcast content or 3-5 for short-form, with the first three chosen strategically since they surface directly below the title, placed only on the description's final line and never in the tags field, formatted in CamelCase, mixed across broad, specific, geo, and branded types, and varied rather than reused identically across every upload. The description itself is a fixed three-block structure: a roughly 80-120 word hook whose first sentence carries the target keyword naturally, a 4-6 paragraph body weaving in one secondary keyword per paragraph plus repeated geo mentions and a guest-bio paragraph for podcasts, and a footer with real resource links, a two-sentence subscribe CTA, platform-listen links for podcasts, and hashtags on the very last line, totaling 700-900 words for video, 800-1,000 for podcast, or 150-200 for a short. Chapters, required for the four long-form modes, are hard-capped at 6-10 markers with adjacent topics merged if there would be more, must start at 0:00 or YouTube ignores every chapter entirely, and use short 3-6 word action-oriented titles that actually reflect the content, marking guest intros and sponsor reads separately for podcasts. Geo-specific content adds location mentions 2-4 times in the description, location-qualified tags, at least one geo hashtag among the first three, and for bilingual channels one sentence in the local language alongside the English description. The six modes each have their own detailed output template: Mode A builds a full new-video package including title, A/B variant, description, five primary keywords, tags, hashtags, chapters, thumbnail overlay text, end-screen cards, a playlist SEO note, a pinned comment, and an end-screen script; Mode B audits an existing video with a scorecard across ten elements, detailed per-element findings, a fully rewritten metadata set, and a three-step post-fix action plan spanning immediate changes, a 48-hour follow-up, and a 7-day CTR check; Mode C and D mirror A and B for podcast episodes, adding guest bio and platform-link handling, sponsor-read placement in the timestamps, and leading the title with the guest's name whenever research shows people actually search for it; and Mode E and F mirror the same new-versus-existing split for short-form clips and Reels, with a tighter 150-200 word description, no chapters, a mandatory Shorts hashtag, and an optional cross-post caption for Reels or TikTok. A named list of specific failure modes calls out exactly the mistakes to avoid: generating tags from memory instead of running the research batch, inventing unverified numbers, hardcoding a stale year, shipping a description full of unfilled placeholders, missing the 0:00 chapter marker, skipping geo signals on local content, an A/B title that's just reworded rather than a genuinely different hook, and a generic pinned comment instead of one carrying a keyword and a value teaser.
Who it's for
Creators and channel managers who need a fully researched, correctly structured SEO package for a single video, podcast episode, or short-form clip, either building one from scratch before upload or diagnosing and rewriting one that already exists and isn't getting views.
Source README
YouTube & Podcast SEO Optimizer
When to Use
- User wants a title/description/tags/hashtags package for a new upload
- User needs an audit of a live video or podcast episode that isn't getting views
- User asks for show notes, timestamps, or podcast episode metadata
- User says "SEO my video", "audit my YouTube video", "write a podcast description", "why isn't my video ranking", "generate tags", "fix my podcast SEO"
- Use this for any video or podcast SEO request - new, already published, or short-form
Overview
You need web search + URL fetch for this to work. Whatever your host calls them - web_search/web_fetch, WebSearch/WebFetch, an MCP tool - use those.
This skill covers 6 scenarios: 3 content types (video, podcast, short-form) × 2 states (new or underperforming). Each has its own mode below.
Two rules:
- Every keyword is researched, not guessed. Never generate tags or "trending" from memory. Ask the creator what they want to rank for, then search it.
- Match the ask. If the user asked for just a title, deliver just a title. If they asked for the full package, ship every numbered section. Don't overwhelm them.
How to execute this skill
The sections below are organized as: Steps → Rules → Templates → Checks. Follow them in order:
- Read the user's request - scope check first (see below)
- Steps 0-2 - Classify, find the keyword, research it, gather missing info
- Pick your mode (A-F) from the templates below
- Build what they asked for using the rules (Title Rules, Tags Strategy, etc.)
- Run the Quality Checklist before sending
Step 0 - Check scope then classify
Scope check first. This skill handles one video, podcast episode, or short-form clip at a time - not entire channels or playlists. If the user asks for something outside that, say: "I can optimize individual videos or episodes. Which one should I start with?" Once they pick one, restart the flow from Step 0 with that specific item.
Then classify. Read the user's message first - they might have already told you everything. Don't ask something they just said.
Content type - If unclear from what they said, ask once: "Is this a regular video, a podcast episode, or a Short/Reel?"
Status - Did they give a URL? Fetch it. Did they say "no views" or "not ranking"? It's existing. Did they say "uploading" or "about to post"? It's new. If you can't tell, ask once.
| Content type | New | Existing |
|---|---|---|
| Standalone video | Mode A | Mode B |
| Podcast episode | Mode C | Mode D |
| Short-form clip / Reel | Mode E | Mode F |
If they gave a URL, fetch the live metadata - don't ask them to repeat what's already there.
Step 1 - Find the target keyword
Check if they already named one. If not, extract it from their topic/outline and propose it. Only ask if you genuinely can't infer it.
If the user asked for just a title or just tags, skip the full research batch - but still do one quick search to validate the keyword angle. Otherwise run the full research:
[target keyword]- see what's ranking[target keyword] [current year][niche/topic] trendingor[target keyword] reddit- real phrasing people use- For podcasts: also search the guest's name
Pull 3-6 related phrases as secondary/long-tail keywords.
No data you don't have: never make up search volume, view counts, or algorithm claims. A thin result set is fine - lower competition.
Use today's real date for every "[Year]" slot.
Verify superlatives. If they say "top 10," "#1," "fastest-growing" - search for proof. If unverified, drop it or mark [VERIFY: ...].
Step 2 - Gather what you still need (scrape first, ask last)
Before writing the Resources/CTA block, check what info the user already gave or that you can scrape from their URL/name/channel. For anything still unknown, look it up. Ask the user only if you hit a dead end:
- Links: website, socials, newsletter, affiliate/products
- CTA goal: subscribe, visit, join, buy
- Offer, lead magnet, discount code, or sponsor
- For podcasts: guest name, bio, links; episode number; sponsor details; platform links (Spotify, Apple Podcasts, etc.)
One question at a time. After each answer, see if you can fill the rest from what you learned. If they say "placeholders," use [ADD: ...] markers - never fake URLs.
Title Rules
Use these rules for every mode that includes a title (A-F).
Formula
[Primary Keyword] : [Outcome or Benefit] + [Power Word / Number / Year]
Power word bank
How · Why · What · Best · Full · Real · Free · New · Step-by-Step · Complete · Proven · Ultimate · Inside · Secret · Zero to · In [X] Days · [Number] Ways · [Year]
Rules
- 60-70 characters exactly - count them
- Primary keyword in the first 4-5 words where possible
- One emotional hook per title
- Include year only if Step 1 research shows year-stamped titles are common
- No ALL CAPS except one word for emphasis
- No misleading promise
- A/B variant must use a genuinely different hook, not a word-order shuffle
Title patterns by content type
| Type | Pattern | Example |
|---|---|---|
| How-to | How to [Result] in [Time/Steps] | How to Rank #1 on YouTube in 30 Days |
| List | [N] [Things] Every [Audience] Needs | 7 SEO Tools Every Creator Needs in [Year] |
| Story | How [Subject] [Achieved Outcome] | How One Farmer Built Nepal's First Agritech App |
| Question | [Burning Question]? (Full Answer) | Why Your YouTube Videos Get No Views (Fixed) |
| Geo | [Topic] in [Location]: [Outcome] | Agritech in Nepal: Farmers Earning 3x More |
| Comparison | [A] vs [B]: Which [Outcome]? | YouTube SEO vs Google SEO: What Actually Works |
| Podcast | [Guest] on [Topic]: [Outcome] | [Show] #[Ep] | Sara Lin on Cold Outreach That Works | Growth Lab #42 |
Tags Strategy
Use for long-form modes (A-D) that include tags. Generate 14-19 tags using this mix. For short-form (E-F), see the Shorts section for the 5-8 tag rule.
| Type | Count | Rule |
|---|---|---|
| Exact match primary keyword | 1 | Must match Step 1 target keyword exactly |
| Broad topic | 3-4 | 1-2 word umbrella terms |
| Long-tail (3-5 words) | 5-6 | Pulled from Step 1 research |
| Question-based | 2 | "how to [topic]", "what is [topic]" |
| Branded / show name | 1-2 | Channel/podcast/website name |
| Year-tagged | 1-2 | Only if Step 1 research shows it's common |
| Geo-tagged | 1-2 | Always include for location-specific content |
Rules:
- All lowercase except proper nouns
- No special characters, no hashtags, no commas within a tag
- Under 500 characters total
- Never repeat the same keyword phrase
Hashtag Rules
Use for every mode that includes hashtags (A-F).
- 5-8 hashtags (video/podcast); 3-5 (short-form)
- First 3 hashtags surface below the title - choose strategically
- Placement: final line of the description only - never in the tags field
- Format: CamelCase (
#AgritechNepal) - Mix: 2 broad + 2 specific + 1-2 geo + 1 branded
- Don't reuse an identical set across every upload - vary 3-6 per video
Description Structure
Use for every mode that includes a description (A-F).
Block 1 - Hook (first ~150 characters, shown in search results)
- Sentence 1: Step 1 target keyword used naturally
- Sentence 2: core promise
- Sentence 3: who this is for
- 80-120 words total
Block 2 - Body
- 4-6 short paragraphs or ▶-marked list
- Weave in secondary keywords - one per paragraph, naturally
- Geo signal: mention location 2-4 times
- For podcasts: guest bio paragraph with links
- 450-650 words (video); podcasts can run slightly longer
Block 3 - Footer
- 🔗 Resources & Links with real links from Step 2
- Subscribe CTA, 2 sentences
- For podcasts: "Listen on" platform-links block
- Hashtags on the very last line
Total length: 700-900 words (video), 800-1,000 (podcast). Shorts: 150-200 words.
Full description template
[Hook — target keyword in sentence 1. Core promise. Who this is for.]
In this video/episode you'll learn:
▶ [Point 1]
▶ [Point 2]
▶ [Point 3]
▶ [Point 4]
▶ [Point 5]
[Body paragraph — secondary keyword woven in naturally]
[Body paragraph — secondary keyword woven in naturally]
[Body paragraph — geo signal if applicable]
[Body paragraph — guest bio (podcast) or credentials (video)]
Use the chapters below to jump to any section ↓
📌 CHAPTERS / TOPICS DISCUSSED
0:00 – [Chapter/topic]
[N:NN] – [Continue]
==========================
🔗 RESOURCES & LINKS
🌐 Website: [real link from Step 2]
💼 LinkedIn: [real link from Step 2]
📺 Subscribe: [real link from Step 2]
📧 Contact: [real link from Step 2]
[Podcast — 🎧 Listen on: Spotify | Apple Podcasts | ...]
[Subscribe CTA — 2 sentences, includes channel/show name]
#Hashtag1 #Hashtag2 #Hashtag3 #Hashtag4 #Hashtag5 [#Tag6 #Tag7 optional]
Chapters / Timestamps Rules
Use for modes A-D. Hard cap: 6-10 markers. Merge adjacent topics if you have more.
- First chapter MUST be
0:00- YouTube ignores all chapters without it - Each title: 3-6 words, action-oriented, keyword signal where natural
- Titles must reflect actual content
- For podcast episodes: mark guest intro and sponsor reads in the timestamps
Geo / Local SEO Rules
Do this when the content is tied to a place:
- Mention location 2-4 times in description
- Geo-tagged tags:
[topic] [city],[topic] [country] - First 3 hashtags: include at least one geo hashtag
- Bilingual channels: English description + one sentence in local language
- Location in title: use when it's a competitive differentiator
Shorts / Clips Adaptation (secondary clip)
Use when the user asks for a Short cut from a specific video they mentioned.
If they ask for a Short without mentioning a source video, ask: "Which video should I pull the Short from?" - once they tell you, treat the Short as the primary request and use Mode E directly (no need to also package the source video).
If they ask for both a main video SEO package + a Short cut from it, produce the main mode first, then append this as a separate block.
- Title: 60-70 characters, keyword in first 3 words
- Description: 150-200 words - hook + hashtags, no chapters
- Hashtags: 3-5 with
#Shorts, placed in description - Tags: reuse 5-8 from the main video
- No chapters (Shorts don't support them)
Output this as a separate block after the main package if they ask for it.
Mode A - New Video Upload Package
Required input (minimum one)
- Video topic, title idea, or the Step 1 target keyword
- Outline / roadmap of what the video covers
- Niche + target audience
Optional inputs
- Channel name, target location, language, video length
- CTA goal, whether a Shorts version will be posted
- Links/offers for the description
If only a topic is given, extract the keyword, research it. When sections of the Mode template lack input (chapters, thumbnail, playlist, etc.), use reasonable defaults based on the topic - don't leave them blank or ask for every detail. Ask one question at a time, and only if you genuinely can't infer or look up the answer.
Output template
==================================================
📺 YOUTUBE SEO PACKAGE — NEW UPLOAD
==================================================
① SEO TITLE (Primary)
[Title — 60-70 characters, built around Step 1 target keyword]
Character count: [N]/70
② SEO TITLE (A/B Variant)
[Alternative title — different hook, same keyword]
Character count: [N]/70
③ DESCRIPTION
[Full description — see Description Structure section]
④ PRIMARY KEYWORDS
1. [Step 1 target keyword, exact phrase]
2. [secondary keyword from Step 1 research]
3. [secondary keyword from Step 1 research]
4. [secondary keyword from Step 1 research]
5. [secondary keyword from Step 1 research]
⑤ TAGS
[tag1], [tag2], [tag3] ... [tag14-19 total]
Total character count: [N]/500
⑥ HASHTAGS
#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 [#Tag6 #Tag7 #Tag8 optional]
⑦ CHAPTERS / TIMESTAMPS (6-10 markers)
0:00 – [Chapter title]
[N:NN] – [Chapter title]
⑧ THUMBNAIL TEXT
"[3-5 bold words for overlay]"
Style note: [color contrast / emotion / visual hook]
⑨ CARDS & END SCREEN
Card 1 (at [N:NN]): [Related video to link]
Card 2 (at [N:NN]): [Playlist or external link]
End Screen: Subscribe + [related video]
⑩ PLAYLIST SEO NOTE
Suggested playlist: [Playlist name]
Description if new: [50-100 word SEO description]
⑪ PINNED COMMENT
[2-3 sentences. Target keyword + chapter teaser + question]
⑫ END SCREEN SCRIPT
"[2-3 sentences — natural speech, next topic + subscribe]"
==================================================
Mode B - Existing Video Audit + Fix
Required input
- YouTube URL (preferred - fetch live metadata) or current title/description
- Views/performance complaint
Output template
==================================================
🔍 YOUTUBE SEO AUDIT REPORT
==================================================
VIDEO: [Title or URL]
TARGET KEYWORD: [confirmed in Step 1]
AUDIT DATE: [today's date]
==================================================
SECTION 1 — AUDIT SCORECARD
==================================================
| Element | Score | Issue Found |
|--------------------|-----------|-------------|
| Title | ✅/⚠️/❌ | [Finding] |
| Description | ✅/⚠️/❌ | [Finding] |
| Tags | ✅/⚠️/❌ | [Finding] |
| Hashtags | ✅/⚠️/❌ | [Finding] |
| Chapters | ✅/⚠️/❌ | [Finding] |
| Keyword targeting | ✅/⚠️/❌ | [Finding] |
| Geo/Local SEO | ✅/⚠️/❌ | [Finding] |
| Thumbnail text | ✅/⚠️/❌ | [Finding] |
| Cards/End screen | ✅/⚠️/❌ | [Finding] |
| Pinned comment | ✅/⚠️/❌ | [Finding] |
OVERALL SEO SCORE: [X/10]
PRIORITY FIXES: [Top 3 issues]
==================================================
SECTION 2 — DETAILED FINDINGS
==================================================
TITLE ANALYSIS
Current: "[existing title]"
Character count: [N] (ideal: 60-70)
Target keyword position: [where, or "absent"]
Missing: [power words, year, hook]
DESCRIPTION ANALYSIS
Current word count: [N] (ideal: 700-900)
Above-the-fold (first 150 chars): [paste]
Target keyword in first sentence: Yes / No
Chapters in description: Yes / No
Links/CTA present: Yes / No
TAGS ANALYSIS
Count: [N] (ideal: 14-19)
Tag type coverage: [which of 7 types are missing]
HASHTAG ANALYSIS
Count: [N] (ideal: 5-8)
Placement: [where they appear]
Issues: [in tags field? missing?]
CHAPTERS ANALYSIS
Present: Yes / No | Starts at 0:00: Yes / No
GEO / LOCAL SEO
Location signals: Yes / No
==================================================
SECTION 3 — FULL REWRITTEN METADATA
==================================================
① REWRITTEN TITLE (Primary)
[New title — 60-70 chars]
Character count: [N]/70
② REWRITTEN TITLE (A/B Variant)
[Alternative title — different hook]
Character count: [N]/70
③ REWRITTEN DESCRIPTION
[Full 3-block description]
④ REWRITTEN TAGS
[14-19 tags across all 7 types]
⑤ REWRITTEN HASHTAGS
#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 [#Tag6 #Tag7 optional]
⑥ REWRITTEN CHAPTERS (6-10 markers)
0:00 – [Chapter]
[N:NN] – [Continue]
⑦ THUMBNAIL TEXT
"[3-5 word overlay]"
Note: [needs change?]
⑧ PINNED COMMENT (replace existing)
[Target keyword + value teaser]
==================================================
SECTION 4 — POST-FIX ACTION PLAN
==================================================
Step 1 — Do immediately (YouTube Studio):
□ Replace title
□ Replace description
□ Replace tags
□ Add chapters if missing
□ Post new pinned comment
Step 2 — Within 48 hours:
□ Update thumbnail if flagged
□ Add to correct playlist
□ Share updated link
Step 3 — Check in 7 days:
□ Monitor CTR in Analytics
□ If impressions up but CTR flat, fix thumbnail
□ Try A/B title after 14 days if no improvement
==================================================
Mode C - New Podcast Episode Package
Podcast-specific inputs (gather alongside Steps 1-2)
- Show name and episode number
- Guest name(s), one-line bio, and links
- Sponsor: name and where the read goes (pre/mid/post-roll)
- Platform links: Spotify, Apple Podcasts, etc.
- Series/season for playlist note
If Step 1 research shows people search the guest's name, lead the title with it. Otherwise lead with the topic.
Output template
==================================================
🎙️ PODCAST EPISODE SEO PACKAGE — NEW EPISODE
==================================================
① SEO TITLE (Primary)
[Title — 60-70 chars. Lead with guest name if searchable, else keyword.]
Character count: [N]/70
② SEO TITLE (A/B Variant)
[Different hook, same target keyword]
Character count: [N]/70
③ DESCRIPTION
[Full description — guest bio in Block 2, platform links in Block 3]
④ PRIMARY KEYWORDS
1. [Step 1 target keyword]
2. [guest name + "podcast" / "interview"]
3. [secondary keyword from research]
4. [secondary keyword from research]
5. [show name + topic]
⑤ TAGS
[tag1], [tag2] ... [tag14-19 — include show + guest name]
Total: [N]/500
⑥ HASHTAGS
#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 [#Tag6 #Tag7 optional]
⑦ TOPICS DISCUSSED (6-10 markers)
0:00 – Intro
[N:NN] – Guest intro
[N:NN] – [Topic 1]
[N:NN] – Sponsor read (if applicable)
[N:NN] – [Topic 2]
[N:NN] – Closing / where to find guest
⑧ THUMBNAIL TEXT
"[3-5 bold words]"
Style note: [color contrast / visual hook]
⑨ CARDS & END SCREEN
Card 1 (at [N:NN]): Related past episode
Card 2 (at [N:NN]): Playlist or guest's site
End Screen: Subscribe + related episode
⑩ SERIES / PLAYLIST NOTE
Suggested playlist: [Series/season name]
Description: [50-100 word SEO description]
⑪ PINNED COMMENT
[2-3 sentences. Keyword + teaser + question]
⑫ LISTEN ON
🎧 Spotify: [link]
🎧 Apple Podcasts: [link]
🎧 [Other platforms as supplied]
⑬ END SCREEN SCRIPT
"[2-3 sentences — thank guest, tease next, subscribe]"
==================================================
Mode D - Existing Podcast Episode Audit + Fix
Required input
- YouTube URL (preferred - fetch live metadata) or current title/description
- Views/performance complaint
Output template
==================================================
🔍 PODCAST EPISODE SEO AUDIT REPORT
==================================================
EPISODE: [Title or URL]
SHOW / EP #: [if known]
TARGET KEYWORD: [confirmed in Step 1]
AUDIT DATE: [today's date]
==================================================
SECTION 1 — SCORECARD
==================================================
| Element | Score | Issue Found |
|----------------------|-----------|-------------|
| Title | ✅/⚠️/❌ | [Finding] |
| Description | ✅/⚠️/❌ | [Finding] |
| Tags | ✅/⚠️/❌ | [Finding] |
| Hashtags | ✅/⚠️/❌ | [Finding] |
| Topics/Timestamps | ✅/⚠️/❌ | [Finding] |
| Keyword targeting | ✅/⚠️/❌ | [Finding] |
| Guest bio + links | ✅/⚠️/❌ | [Finding] |
| Platform links | ✅/⚠️/❌ | [Finding] |
| Sponsor disclosure | ✅/⚠️/❌ | [Finding] |
| Series/playlist | ✅/⚠️/❌ | [Finding] |
| Pinned comment | ✅/⚠️/❌ | [Finding] |
OVERALL SCORE: [X/10]
PRIORITY FIXES: [Top 3]
==================================================
SECTION 2 — DETAILED FINDINGS
==================================================
TITLE ANALYSIS
Current: "[existing title]"
Character count: [N] (ideal: 60-70)
Guest name / keyword position: [where, or "absent"]
DESCRIPTION ANALYSIS
Word count: [N] (ideal: 800-1,000)
Keyword in first sentence: Yes / No
Guest bio present: Yes / No
Timestamps present: Yes / No
Platform links present: Yes / No
TAGS ANALYSIS
Count: [N] (ideal: 14-19)
Show / guest name as tags: Yes / No
TOPICS / TIMESTAMPS ANALYSIS
Present: Yes / No | Starts at 0:00: Yes / No
Sponsor marked (if applicable): Yes / No
==================================================
SECTION 3 — FULL REWRITTEN METADATA
==================================================
① REWRITTEN TITLE (Primary)
[New title — 60-70 chars]
Character count: [N]/70
② REWRITTEN TITLE (A/B Variant)
[Different hook]
Character count: [N]/70
③ REWRITTEN DESCRIPTION
[3-block structure, guest bio in Block 2, platform links in Block 3]
④ REWRITTEN TAGS
[14-19 tags including show + guest name]
⑤ REWRITTEN HASHTAGS
#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 [#Tag6 #Tag7 optional]
⑥ REWRITTEN TOPICS / TIMESTAMPS (6-10)
0:00 – Intro
[N:NN] – [Continue]
⑦ THUMBNAIL TEXT
"[3-5 word overlay]"
Note: [needs change?]
⑧ PINNED COMMENT (replace existing)
[Rewritten comment]
==================================================
SECTION 4 — ACTION PLAN
==================================================
Step 1 — Do immediately (YouTube Studio):
□ Replace title
□ Replace description
□ Replace tags
□ Add/fix timestamps
□ Post new pinned comment
Step 2 — Within 48 hours:
□ Update thumbnail if flagged
□ Add to correct playlist
□ Cross-post platform links
□ Share with guest
Step 3 — Check in 7 days:
□ Monitor CTR
□ Try A/B title after 14 days if flat
==================================================
Mode E - New Short-Form / Reel Package
Required input
- Clip's topic/hook or the Step 1 target keyword
- If cut from a longer video: which moment and the parent video's tags
- Platform(s): YouTube Shorts (primary), plus Instagram Reels / TikTok if needed
Output template
==================================================
🎬 SHORT-FORM SEO PACKAGE — NEW SHORT / REEL / CLIP
==================================================
① YOUTUBE SHORTS TITLE (Primary)
[Title — 60-70 chars. Keyword in first 3 words. One power word/hook.]
Character count: [N]/70
② TITLE (A/B Variant)
[Different hook, same keyword]
Character count: [N]/70
③ DESCRIPTION (150-200 words)
[Sentence 1: target keyword. 2-4 more sentences. Hashtags on final line.]
④ PRIMARY KEYWORDS
1. [Step 1 target keyword]
2. [secondary keyword]
3. [secondary keyword]
⑤ TAGS (5-8)
[tag1], [tag2] ... [tag5-8]
If cut from a longer video: reuse 5-8 of its tags.
⑥ HASHTAGS (3-5, #Shorts always included)
#Shorts #Tag2 #Tag3 [#Tag4 #Tag5 optional]
⑦ CROSS-POST CAPTION (Reels / TikTok — if cross-posting)
[60-150 words. Keyword in first ~125 chars. End with 3-5 hashtags.]
⑧ COVER FRAME / THUMBNAIL TEXT
"[3-5 bold words]"
⑨ PINNED COMMENT
[1-2 sentences. Keyword + question]
⑩ END-OF-CLIP CTA
[1 sentence — "full episode linked above", "part 2 tomorrow", etc.]
==================================================
Mode F - Existing Short-Form Audit + Fix
Required input
- URL (preferred) or current title/description/hashtags
- Views/performance complaint
Output template
==================================================
🔍 SHORT-FORM SEO AUDIT REPORT
==================================================
CLIP: [Title or URL]
TARGET KEYWORD: [confirmed in Step 1]
AUDIT DATE: [today's date]
==================================================
SECTION 1 — SCORECARD
==================================================
| Element | Score | Issue Found |
|---------------------|-----------|-------------|
| Title | ✅/⚠️/❌ | [Finding] |
| Description/Caption | ✅/⚠️/❌ | [Finding] |
| Hashtags | ✅/⚠️/❌ | [Finding] |
| Keyword targeting | ✅/⚠️/❌ | [Finding] |
| Cover/thumbnail text| ✅/⚠️/❌ | [Finding] |
OVERALL SCORE: [X/10]
PRIORITY FIXES: [Top 3]
==================================================
SECTION 2 — DETAILED FINDINGS
==================================================
TITLE ANALYSIS
Current: "[existing]"
Chars: [N] (ideal: 60-70)
Keyword position: [where or "absent"]
DESCRIPTION ANALYSIS
Word count: [N] (ideal: 150-200)
Keyword in sentence 1: Yes / No
HASHTAG ANALYSIS
Count: [N] (ideal: 3-5)
#Shorts present: Yes / No
Placement: [description vs title]
==================================================
SECTION 3 — REWRITTEN METADATA
==================================================
① REWRITTEN TITLE (Primary)
[60-70 chars]
Character count: [N]/70
② REWRITTEN TITLE (A/B Variant)
[Different hook]
Character count: [N]/70
③ REWRITTEN DESCRIPTION (150-200 words)
[Keyword in sentence 1, hashtags on final line]
④ REWRITTEN TAGS (5-8)
[tags]
⑤ REWRITTEN HASHTAGS (3-5, #Shorts included)
#Shorts #Tag2 #Tag3
⑥ CROSS-POST CAPTION (if applicable)
[60-150 words, keyword in first 125 chars]
⑦ COVER/THUMBNAIL TEXT
"[3-5 word overlay]"
⑧ PINNED COMMENT
[Rewritten comment]
==================================================
SECTION 4 — ACTION PLAN
==================================================
Step 1 — Do immediately:
□ Replace title, description, hashtags, tags
□ Move hashtags out of title into description if needed
□ Update cover frame if flagged
Step 2 — Check in 7 days:
□ Monitor retention/completion rate
□ If impressions up but completion flat, fix hook first
==================================================
Build the output
Now assemble the output. Deliver only what the user asked for:
- Full package: Use your mode's template, fill every numbered section
- Single item (title/description/tags only): Deliver just that + anything naturally attached (e.g., description should include its hashtags and chapters; title should include its A/B variant)
- Only say what they need - don't dump sections they didn't request
Reference the rules by section:
- Title → Title Rules
- Description → Description Structure
- Tags → Tags Strategy
- Hashtags → Hashtag Rules
- Chapters → Chapters / Timestamps Rules
- Geo/Local → Geo / Local SEO Rules
Then run the Quality Checklist below.
Quality Checklist - run before sending
Completeness
- All numbered sections in the matched mode are present with real content
- Chapters: 6-10 markers, not more
Research
- Target keyword confirmed (or proposed + confirmed)
- Step 1 search batch run - secondary keywords from real results
- Current year from today's date
- No fabricated search-volume or view-count claims
- Superlative claims verified or marked
[VERIFY: ...]
Title
- 60-70 characters, counted exactly
- Target keyword in first 5 words
- One emotional hook; A/B variant uses a different angle
Description
- Target keyword in sentence 1
- All 3 blocks present; 700-900 words (video) / 800-1,000 (podcast)
- Chapters/timestamps pasted inside description
- Real links from Step 2 (or
[ADD: ...]markers) - Hashtags on final line only
Tags & Hashtags
- 14-19 tags, under 500 chars, all 7 types represented
- No hashtag symbols in the tags field
- 5-8 hashtags (3-5 for short-form), CamelCase, strongest 3 first
- Hashtag set differs from recent uploads
Chapters & Geo
- Starts at 0:00, 6-10 sections, keyword-aware titles
- Geo mentioned 2-3 times (if applicable)
Extras
- Thumbnail text, cards/end screen, playlist note, pinned comment all included
- Podcast episodes: guest placement, platform links, sponsor disclosure, episode numbering
- Short-form: 3-5 hashtags, #Shorts included, no chapters, cross-post caption if applicable
Failure Modes
| Mistake | Correct approach |
|---|---|
| Generating tags/keywords from memory | Run Step 1 research batch first |
| Inventing search-volume or view-count numbers | Never state unverified numbers; use directional language |
| Hardcoding a year from training data | Use today's actual date |
| Description full of placeholders | Run Step 2 for real links first |
| Title is 71+ characters | Count exactly; cut filler |
| Description under 400 words | Must hit 700-1,000 words |
| Hashtags in tags field | Tags = keywords; hashtags in description only |
| All tags are one-phrase variants | Use all 7 tag types |
| 0:00 chapter missing | YouTube ignores all chapters without it |
| Geo skipped for local content | Always include for location-specific content |
| A/B title is just reworded | Must test a genuinely different hook |
| Pinned comment is "Check out my video!" | Include keyword + value teaser |
| Podcast title omits searchable guest name | Lead with guest name if people search for it |
| More than 10 chapter markers | Merge adjacent topics |
| Unverified superlative stated as fact | Verify or mark [VERIFY: ...] |
| Assuming a specific tool name for search/fetch | Use whatever your host calls these |
Examples
Video, new upload: User says "uploading a video about how farmers in Nepal can use mobile apps to sell vegetables directly." → Confirm target keyword ("sell vegetables online Nepal"), run Step 1, produce Mode A package - title, A/B variant, 800-word description with geo signals, 18 tags, 7 hashtags, 8 chapters, thumbnail text, cards, playlist note, pinned comment, end-screen script.
Podcast, existing episode, underperforming: User says "My episode with [guest] has barely any views, here's the URL." → Fetch URL, confirm target keyword, produce Mode D audit - scorecard, detailed findings, rewritten metadata, action plan.
Short-form, new clip from a podcast: User says "Cut a Short from the Agentic Awesome Skills part of that episode." → Mode E: reuse episode's keyword and tags, 60-70 char title, 150-200 word description, 3-5 hashtags including #Shorts, cross-post caption.
Limitations
- Use this skill only when the task matches the scope described above
- Do not treat output as a substitute for platform-specific validation, testing, or expert review
- Stop and ask for clarification if required inputs, permissions, or success criteria are missing
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.