Joel Stafford

Posted on Mar 30

How I Built a YouTube Title-Writing Skill for Claude (With Real Data)

#ai #tutorial #productivity #beginners

I collected a list of 587 viral YouTube videos from 2025–2026 and analyzed them for patterns. Then I turned those findings into a single [.md] file that makes any AI dramatically better at writing YouTube titles and descriptions — on demand, every time.

🤔 The Problem With Asking AI to "Write a Good YouTube Title"

Ask Claude or Gemini to write a YouTube title cold and you get... fine titles.

"Top 10 Ways to Save Money in 2025"

"How to Build a Morning Routine"

They're grammatically correct. They're forgettable. They could have been written in 2018.

The AI isn't being lazy — it simply lacks current, niche-specific data. It doesn't know that 71% of viral titles use a specific number, that 48% include the year, or that the highest-performing titles in 2025 follow a very specific money-stakes-survival formula.

That's the gap a skill file closes.

🔬 The Methodology: Scraping 587 Viral Videos

I used yt-dlp (a free command-line tool) to search YouTube across 100+ query categories — challenges, tech/AI, finance, travel, gaming, fitness, comedy, documentary, and more — and pulled metadata for every result:

Title
Description (full text)
Upload date
View count
Channel name

Filters applied:

English only (>75% ASCII characters in the text)
Upload date: January 2025 – March 2026
No live streams

After deduplication by video ID, I ended up with 587 unique videos. Then I wrote a second Python script that ran statistical analysis across all of them and generated knowledge.md — a structured reference file covering everything the AI needs to know.

The entire scrape took about 2 days. The analysis ran in under 50 minutes.

📊 What the Data Actually Revealed

A few findings that surprised me:

71% of viral titles contain a number. Not "most" or "several" — a specific
number. $500,000. 100 Days. 30 Celebrities. Specificity is the mechanism,
not decoration.

48% include the year (2025 or 2026). Recency signals are everywhere. Readers
want to know the content is current — putting the year in the title is the
fastest way to communicate that.

The top 20 most-viewed titles follow one dominant formula:

Survive [X Days/Event] [Extreme Condition], Win $ Amount (typical Mr.Beast title)

Examples from the actual dataset:

"Survive 100 Days In Prison, Win $500,000"
"Last to Leave Their Circle Wins $500,000"
"$1 vs $1,000,000,000 Nuclear Bunker!"

These aren't coincidences. They're a formula.

Descriptions average 1,335 characters. 81% include external links. 61% open
with a short hook line (under 120 chars) before expanding into detail. 51% use
hashtags — but only 3–5 of them.

All of this went into knowledge.md (link).

🛠️ How to Use This Skill File With Claude or Gemini

Option A — Claude Desktop (drag and drop)

Open Claude Desktop
Start a new conversation
Drag knowledge.md into the chat (or use the paperclip attachment button)
Prefix your request:

Using the YouTube patterns in this file, write 5 title options for a video about
[YOUR TOPIC]. Apply the formulas from Part 4 and the psychological triggers from
Part 6.

Claude will now generate titles grounded in 587 real data points instead of
generic intuition.

Option B — Gemini (Google AI Studio or Gemini Advanced)

Open aistudio.google.com
In the System Instructions box, paste the full contents of knowledge.md
In the user turn, write your request as normal

Setting it as a System Instruction means every message in that session
benefits from the knowledge — you don't have to re-attach it.

Option C — Reusable System Prompt

If you use an AI API directly (Claude API, Gemini API, OpenAI), add knowledge.md
as a system message at the start of every call. Your YouTube title tool now has
persistent expert context baked in.

⚡ The Real-World Difference: With vs. Without the Skill

Here's a direct comparison. The topic: a video about building a morning routine.

❌ Without the skill file

Prompt: "Write 5 YouTube title options for a video about morning routines."

Claude's output:

How to Build the Perfect Morning Routine
7 Morning Habits That Will Change Your Life
The Ultimate Morning Routine for Productivity
Start Your Day Right: Morning Routine Tips
Why Your Morning Routine Matters

These are safe. Inoffensive. Completely average.

✅ With the skill file attached

Prompt: "Using the YouTube patterns in knowledge.md, write 5 title options for
a video about morning routines. Apply Formula 2 (personal challenge), Formula 6
(transformation), and the psychological triggers from Part 6."