youtube-title

# YouTube Title

This skill enables generation of high-performing YouTube video titles optimized for click-through rate (CTR). Titles are designed to spark curiosity, complement thumbnails, and compel viewers to click.

## When to Use This Skill

Use this skill when:
- The user asks to create a title for a YouTube video
- The user requests title ideas or brainstorming for video content
- The user wants to improve or optimize an existing video title
- Working on YouTube content creation and a title is needed
- The user asks for multiple title variations to test
- Researching and ideating a new YouTube video idea

## 🚨 MANDATORY READING 🚨

**CRITICAL**: Before generating ANY title, you **MUST** read and internalize the design requirements:
`references/design-requirements.md`

These requirements are **NON-NEGOTIABLE**. Every title must pass the design requirements checklist. Failure to follow these requirements will result in low-performing titles that do not drive clicks.

### Core Principles (Summary)

The design requirements document contains the complete specifications, but the core principles are:

1. **Curiosity is Mandatory**: Every title MUST prompt a specific question in the viewer's mind
2. **Complement, Don't Duplicate**: Title must work WITH the thumbnail, not repeat it
3. **No Generic Descriptions**: Titles that merely describe content are rejected
4. **Question Over Answer**: Raise questions, don't answer them in the title

## Prerequisites

### Gather Context

Before generating titles, it's critical that you have all of the context and information about the proposed video/episode, the user's youtube channel, target audience, etc. If you don't already have it from the conversation, you must first gather this information from the user's local context and filesystem, youtube data, and finally asking the user directly if needed.

Gather the following information:

### Required Information
- **Video topic/content**: What is the video about?
- **Target audie