yt-pipeline

name	yt-pipeline
description	Run the full YouTube content production pipeline
argument-hint	["topic-or-channel-urls"]
allowed-tools	Read, Write, Edit, Bash, Grep, Glob, Task, WebSearch, AskUserQuestion
model	sonnet

Run the complete YouTube content production pipeline. This is a five-phase workflow that takes a topic or niche focus and produces a fully developed video outline ready for demo prep and filming.

You are the orchestrator. Your job is coordination, sub-agent spawning, data merging, and user communication. Never do batch processing yourself - delegate ALL batch work to sub-agents.

Phase 0: Context

Before doing anything, collect inputs from the user using AskUserQuestion:

1. Niche/Tool Focus: What tool, feature, or topic area are we researching? (e.g., "AI writing tools for professionals", "new software features", "productivity automation")

2. Competitor Channels (optional): Any specific YouTube channels to analyze?

3. Specific Feature/Update (optional): Is there a specific feature drop or update to cover? If so, this is likely an Update Video with fast turnaround.

Do NOT proceed until the focus is confirmed.

Phase 1: Research

1.1 Launch Research

Use web research and optional sub-agents for parallel execution:

• yt-scraper agent for YouTube channel data collection (if Apify MCP available)
• channel-analyzer agents in batches of 3 channels each for competitive analysis

1.2 Merge and Report

After all research completes, merge results into:

• niche-analysis.json - structured data
• niche-report.md - human-readable summary

Report to user:

Research complete.
- Channels analyzed: [N]
- Videos scraped: [N]
- Content gaps identified: [N]
- Outlier videos found: [N]

Present the niche report and ask: "Here's what I found. Ready to move to ideation, or want to research more channels?"

• Move to ideation
• Research additional channels
• Dig deeper into a specific channel
• Adjust the niche focus

This is a mandatory human checkpoint. Do NOT proceed without approval.

Phase 2: Ideation

2.1 Generate Ideas

Using research findings, generate 15-20 video ideas. Each idea must include:

• Title concept (working title)
• Content tier (Tier 1 or Tier 2)
• Content type (Full Tutorial, Feature Tutorial, Update Video, Use Case Video, etc.)
• Angle (1 sentence: what makes this video unique)
• Why now (timeliness signal or evergreen justification)

Prioritize Tier 1 ideas. Include a mix of content types.

2.2 Validate Ideas

Spawn idea-validator sub-agents in a single message. Each validates a batch of 5 ideas.

2.3 Present Validated Ideas

Merge validation results and present a ranked list:

Here are the validated ideas, ranked by opportunity score:

[Table: Rank | Title | Tier | Type | Search Demand | Competition | Score]

Which ideas do you want to develop into briefs?

• Pick 1-3 ideas
• Generate more ideas
• Adjust the focus area
• Go back to research

This is a mandatory human checkpoint.

Phase 3: Brief (per selected idea)

For each idea the user selects:

1. Read skills/yt-brief/SKILL.md
2. Define: angle, key points, value proposition, CTA asset, audience segment, content tier
3. Output: video-brief-{slug}.md
4. Present to user for review

"Here's the brief for '{idea title}'. Review and approve?"

• Approve and move to packaging
• Adjust the angle
• Change key points
• Start over with a different idea

This is a mandatory human checkpoint.

Phase 4: Packaging

For each approved brief:

1. Read skills/yt-packaging/SKILL.md
2. Generate: 5-10 title options, 3-5 thumbnail concepts
3. Output: packaging-{slug}.md

"Here are the title and thumbnail options. Pick your favorites."

• Pick title + thumbnail direction
• Request more options
• Adjust the angle

This is a mandatory human checkpoint.

Phase 5: Outline

For each packaged video:

1. Read skills/yt-outline/SKILL.md
2. Build: step-by-step outline with demo prep, screen-share sequences, visuals
3. Output: video-outline-{slug}.md + demo-prep-checklist-{slug}.md

"Here's the outline and demo prep checklist. Ready for the team to prep and film."

---

Final Report

Pipeline Complete.
- Ideas generated: [N]
- Ideas validated: [N]
- Briefs created: [N]
- Videos fully packaged and outlined: [N]
- Output files: [list]

---

Agent Identifiers

Agent	subagent_type
YouTube Scraper	youtube-strategy:yt-scraper
Channel Analyzer	youtube-strategy:channel-analyzer
Idea Validator	youtube-strategy:idea-validator

Parallelism Rules

ALL sub-agents in a phase MUST be spawned in ONE message using the Task tool. This is the only way to trigger parallel execution.