Skip to main content
skill CX Codex

youtube-content · manojbajaj95 — Claude Code skill for YouTube video planning

youtube-content is a Claude Code skill that creates or reviews video hooks, compares title and thumbnail ideas, and builds research-based YouTube plans.

MIT 218 installs ★ 114 updated 2026-09-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-content -a claude-code
Open on GitHub

What youtube-content does

The skill has two modes: hook creation and video planning. For an opening, it suggests extending the promise made by the title and thumbnail instead of restating it. It also checks that the hook connects to that promise and that the main content starts within 30 seconds.

For a full plan, it reads research from ./youtube/episode/[episode_number]_[topic_short_name]/research.md and writes to plan.md in the same folder. The workflow produces title options, thumbnail concepts, hook strategies, and a high-level outline. It can also prepare thumbnail briefs for A/B testing; producing actual images depends on an available image-generation tool.

Planning requires a research file or a prior run of youtube-research in Topic Research mode. Without one of those, the planning workflow cannot start.

What it helps with

  • draft title options for a YouTube video
  • match thumbnail concepts to video titles
  • write an opening hook that builds on the title
  • outline a video using research findings
  • prepare thumbnail briefs for A/B testing

Example prompts for the agent

  • Plan a YouTube episode using the research in ./youtube/episode/[episode_number]_[topic_short_name]/research.md.
  • Suggest video titles and matching thumbnail concepts based on my research.
  • Review this opening and make it connect to the title without repeating it.

How to install youtube-content

1Skills CLI (Vercel)

npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-content -a claude-code

2Manually: put the files in place

~/.claude/skills/youtube-content/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/youtube-content/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about youtube-content

How do I install youtube-content in Claude Code?

Run npx skills add manojbajaj95/claude-gtm-plugin --skill youtube-content -a claude-code. The skill file will be at ~/.claude/skills/youtube-content/SKILL.md.

What does youtube-content do?

It creates or reviews video hooks and builds YouTube plans with title options, thumbnail concepts, and a high-level outline.

What is required before planning a video?

Provide ./youtube/episode/[episode_number]_[topic_short_name]/research.md or run youtube-research in Topic Research mode first. The plan must draw on research findings.

Source text

SKILL.md · MIT
---
name: youtube-content
description: Plan new YouTube videos with optimized titles, thumbnails, and hooks. Use when planning a video, writing or reviewing opening hooks, generating title and thumbnail concepts, or creating a production-ready video plan backed by research.
---

# YouTube Content Planning

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.



Two modes in one skill:

1. **Hook Creation** — Design or review the opening 5–30 seconds for maximum retention
2. **Video Planning** — Orchestrate title, thumbnail, and hook into a complete production-ready plan

---

## When to Use

- Planning a new YouTube video (title, thumbnail, hook, outline)
- Writing or reviewing an opening hook for retention
- Generating multiple title/thumbnail options for a user to choose from
- Creating a complete video plan after research is done

---

## Mode 1: Hook Creation

The opening seconds are the highest-leverage part of any YouTube video. Design them with precision.

### Core Principle

**The opening MUST extend the curiosity from the title/thumbnail — never repeat it.**

The viewer already clicked based on the promise. The opening must add new intrigue and make them MORE interested, not restate what they know.

### Forbidden Patterns (Instant Failure)

These cause immediate abandonment and must never appear before the hook:

**1. Repeating the title**
- ❌ Title: "5 Photography Mistakes" → Opening: "Today I'm showing you 5 photography mistakes"
- Why: The viewer already has this info. Repetition drains attention.

**2. Welcoming the viewer first**
- ❌ "Hi guys, welcome back to the channel! Thanks for being here..."
- Why: Friendly but not engaging. Doesn't build on title/thumbnail momentum.
- Exception: Greetings are fine AFTER the hook (after first 15 seconds).

**3. Starting with unrelated content**
- ❌ Title: "Cat Tricks Tutorial" → Opening: 90-second story about a new car
- Why: Viewer confusion → abandonment → YouTube suppresses the video.

### Proven Hook Patterns

**Pattern A: Preview/Teaser** — Show a brief glimpse of the payoff
> Quick montage of the 5 cat tricks in action → "I need to know how to do that!"

**Pattern B: Intrigue Escalation** — Add surprising context that makes the promise MORE compelling
> "What I'm about to show you took professionals years to discover, but you'll learn it in 60 seconds"

**Pattern C: Problem Amplification** — Immediately validate why the viewer needs this
> "If you're still doing X, you're losing Y every single day"

**Pattern D: Immediate Value Demonstration** — Jump straight into delivering on the promise
> No preamble, just start teaching/showing results

### Timing Requirements

- Hook must land within **5–15 seconds** (optimal: 3–8s)
- After hook: brief intro acceptable (5–10s max)
- Main promised content must begin **within 30 seconds**

### Hook Checklist

Before finalizing any opening hook:

- [ ] Non-Repetition: Does NOT repeat the title
- [ ] Curiosity Extension: Makes viewers MORE curious than the title alone
- [ ] Direct Connection: Immediately related to what title/thumbnail promised
- [ ] No Welcome First: Avoids greetings before the hook
- [ ] Attention Increase: Increases attention, doesn't drain it
- [ ] Hook Timing: Occurs within 5–15 seconds

### Content Type Guidance

**Educational/How-To:** Open with result preview or immediate demonstration. Never "In this tutorial I'm going to teach you..."

**Entertainment/Vlogs:** Open with the most exciting/surprising moment. Start in the middle of the action.

**List Videos:** Tease the most interesting items without naming them. Create urgency: "Wait until you see number 3..."

---

## Mode 2: Video Planning

Generate a complete, production-ready video plan: titles, thumbnail concepts, hook strategies, and a high-level outline.

**MANDATORY prerequisite:** Research must be completed first. Either:
- Research file exists at `./youtube/episode/[episode_number]_[topic_short_name]/research.md`, OR
- Run `youtube-research` skill (Topic Research mode) first

### Planning Workflow

**Step 0: Load research**

Read `./youtube/episode/[episode_number]_[topic_short_name]/research.md`. All planning decisions must be grounded in research findings.

**Step 1: Create plan file**

Create `./youtube/episode/[episode_number]_[topic_short_name]/plan.md`. If it exists, read it and continue from where it left off.

**Step 2: Generate 3 title options**

Generate title options manually from the research findings. For each title include:
- Title text
- Rationale (why it's predicted to perform, how it uses research insights)
- Star rating ⭐ to ⭐⭐⭐ (⭐⭐⭐ = top pick)

**Step 3: Generate thumbnail concepts**

For each title, create 2 thumbnail concepts. Each concept includes:
- Which title it pairs with
- Visual description
- Rationale (CTR prediction, research alignment, title complement)
- Star rating for your top 3 across all concepts

**Step 4: Present options and get user selection**

Present all title + thumbnail combinations. Highlight your top 3 pairings. Ask the user to select one to proceed with. Mark their selection with ✅ User Selection in the plan file.

**Step 5: Generate hook strategies**

For the user's selected title + thumbnail, generate 3 hook options using Hook Creation mode (above). Each includes:
- Hook script (actual wording)
- Hook type/pattern used
- Rationale for why it works with the selected title + thumbnail
- Star rating

Ask user to select. Mark with ✅ User Selection.

**Step 6: High-level content outline**

Structure the video into sections (Hook, Intro, Main Content, Outro). List key points and estimated durations. Keep it strategic — structure and key points only, no detailed scripts. Do not assume what specific content to demonstrate; that's the creator's job.

**Step 7: Finalize with AB testing thumbnails**

Generate 3 thumbnail image briefs for AB testing, or actual images if an image-generation tool is available:
- Thumbnail A: Based on user's selected concept
- Thumbnails B & C: Visual style variations of A

Embed in the plan file:
```markdown
- Thumbnail A: [description or image path]
- Thumbnail B: [description or image path]
- Thumbnail C: [description or image path]
```

### Plan File Template

```markdown
# [Episode]: [Topic] - Video Plan

## Research Summary
[Key insights from research that informed decisions]

## Titles
[3 options with rationale and ⭐ ratings]

## Thumbnails
[2 concepts per title with rationale and ⭐ ratings for top 3]

## Hooks
[3 options for selected title+thumbnail with scripts and ⭐ ratings]

## High-Level Content Outline
[Sections, key points, estimated durations]

## Final Plan
**Title**: [Selected]
**Thumbnails**: [3 AB test image briefs or embedded image paths]
**Hook**: [Selected strategy]
**Rationale**: [Why this combination works]
```

### Quality Checklist

- [ ] Research loaded and decisions grounded in findings
- [ ] 3 title options with rationale and ratings
- [ ] 2 thumbnail concepts per title
- [ ] User-selected title + thumbnail marked ✅
- [ ] 3 hook options generated for selected pairing
- [ ] User-selected hook marked ✅
- [ ] High-level outline complete
- [ ] 3 AB-test thumbnails generated and embedded

### Critical Rules

- **Always provide all options** — never pick one and present only that
- **Never generate hooks that repeat the title** — see Hook Creation mode
- **Back every recommendation with research** — cite specific content gaps and competitor insights
- **Verify complementarity** — title, thumbnail, and hook must work together as a system

© manojbajaj95 · MIT · manojbajaj95/claude-gtm-plugin

Similar skills

All skills for Marketing and content →

youtube-content by other authors comes first.

youtube-content Teknium (teknium1), Hermes Agent youtube-content is a Claude Code skill that fetches YouTube transcripts and turns them into chapters, summaries, threads, or blog posts. CX Codex +1 546installs analyzing-competitor-youtube-content-strategy apidojo analyzing-competitor-youtube-content-strategy audits a competitor’s YouTube strategy by topic, format, publishing cadence, views, and engagement. Use it to compare two channels or find content gaps. CX Codex +1 926installs thumbnail-design social-media-skills The thumbnail-design skill writes the thumbnail brief and the A/B test plan: one focal point, mobile-legible text, an honest promise instead of clickbait. CX Codex +1 1,500installs yt-audit Jakeschincariol yt-audit is a Claude Code skill that reviews a YouTube channel through titles, thumbnails, the first fifteen seconds, and retention. It starts from an audit request or a pasted channel URL. CX Codex +1 1,300installs viral-video-long-form JosiahSiegel The viral-video-long-form Claude Code skill supports planning long YouTube videos and improving their SEO, audience retention, and thumbnails. It activates for video strategy, content planning, and analytics interpretation. CX Codex +1 114installs youtube-scriptwriting cdeistopened youtube-scriptwriting converts rough notes and brain dumps into structured YouTube scripts focused on viewer retention. Guides you through hooks, core structures, and editing audits. CX Codex +1 833installs packaging-team TubeLab The packaging-team Claude Code subagent creates YouTube title ideas and thumbnail concepts from examples that are already getting clicks. Request titles, thumbnails, or both for one video. CX Codex ★ 288repo stars

From the same set41

The whole set →
user-onboarding user-onboarding maps product first-time user experiences, pins down the aha moment, and drafts activation plans. Built for growth teams fixing signup drop-offs. CX Codex +1 227installs pr-specialist A skill for Claude Code, Codex, Cursor, GitHub Copilot, and other AI agents that gives the agent a PR specialist role. Covers press release writing, journalist pitches, crisis communication, and earned media strategy. CX Codex +1 226installs challenge-funnel Builds multi-day challenge funnels: five-day bootcamps, launches with live sessions, daily tasks, and a flagship offer pitch at the end. CX Codex +1 224installs x-impact-checker x-impact-checker scores X (Twitter) drafts across 19 engagement factors and suggests edits before you post. CX Codex +1 219installs free-tool-strategy free-tool-strategy is a skill for planning a free calculator, generator, or other tool to attract leads and organic traffic, from idea validation through launch planning. CX Codex +1 217installs referral-program The referral-program skill helps you design and optimize referral and affiliate programs: selecting the right type, structuring incentives, identifying share moments, and defining success metrics. CX Codex +1 215installs crm-integration crm-integration is a Claude Code skill with integration patterns for Close CRM, HubSpot, and Salesforce, covering lead sync, deal creation, and webhook handlers. CX Codex +1 211installs ph-content-recycling ph-content-recycling repurposes Product Hunt launch assets into blog posts, documentation, social threads, and emails. Saves drafts directly to your workspace. CX Codex +1 208installs

Project sponsors

Companies that keep this analytics open