YouTube Production — Full Video Content Production Pipeline
An agent team collaborates to produce YouTube video content through the pipeline of strategy → script → thumbnail → SEO, all at once.
Execution Mode
Agent Team — 5 members communicate directly via SendMessage and cross-validate each other's work.
Agent Roster
| Agent |
File |
Role |
Type |
| content-strategist |
.claude/agents/content-strategist.md |
Topic analysis, competitive benchmarking, concept design |
general-purpose |
| scriptwriter |
.claude/agents/scriptwriter.md |
Script writing, visual cue insertion |
general-purpose |
| thumbnail-designer |
.claude/agents/thumbnail-designer.md |
Thumbnail concept + image generation |
general-purpose |
| seo-optimizer |
.claude/agents/seo-optimizer.md |
Title/description/tags/chapters/subtitles |
general-purpose |
| production-reviewer |
.claude/agents/production-reviewer.md |
Cross-validation, consistency checks |
general-purpose |
Workflow
Phase 1: Preparation (Performed directly by the orchestrator)
- Extract from user input:
- Topic/Keywords: The subject the video will cover
- Channel Info (optional): Channel tone, subscriber count, existing content direction
- Constraints (optional): Video length, specific requirements
- Existing Files (optional): Scripts, briefs, or other materials provided by the user
- Create the
_workspace/ directory at the project root
- Organize the input and save it as
_workspace/00_input.md
- If existing files are provided, copy them to
_workspace/ and skip the corresponding phase
- Determine the execution mode based on request scope (see "Scope-Based Modes" below)
Phase 2: Team Assembly and Execution
Assemble the team and assign tasks. Task dependencies are as follows:
| Order |
Task |
Owner |
Depends On |
Deliverable |
| 1 |
Content strategy |
strategist |
None |
_workspace/01_strategist_brief.md |
| 2a |
Script writing |
writer |
Task 1 |
_workspace/02_scriptwriter_script.md |
| 2b |
Thumbnail design & generation |
designer |
Task 1 |
_workspace/03_thumbnail_concept.md |
| 3 |
SEO package |
seo |
Tasks 1, 2a |
_workspace/04_seo_package.md, _workspace/subtitle.srt |
| 4 |
Production review |
reviewer |
Tasks 2a, 2b, 3 |
_workspace/05_review_report.md |
Tasks 2a (script) and 2b (thumbnail) run in parallel. Both depend only on Task 1 (strategy), so they can start simultaneously.
Inter-agent communication flow:
- strategist complete → deliver core angle & tone to writer, title candidates & emotional triggers to designer, keyword map to seo
- writer complete → deliver hook core message to designer (thumbnail-hook consistency), deliver script to seo
- seo complete → deliver title-thumbnail combination feedback to designer
- reviewer cross-validates all deliverables. On 🔴 Must Fix: request revision from the responsible agent → rework → re-validate (up to 2 rounds)
Phase 3: Integration and Final Deliverables
Compile the final deliverables based on the reviewer's report:
- Verify all files in
_workspace/
- Confirm all 🔴 Must Fix items from the review report have been addressed
- Report the final summary to the user:
- Strategy Brief —
01_strategist_brief.md
- Video Script —
02_scriptwriter_script.md
- Thumbnail Concept + Images —
03_thumbnail_concept.md
- SEO Package —
04_seo_package.md
- Review Report —
05_review_report.md
- Subtitle File —
subtitle.srt
Scope-Based Modes
Adjust the agents deployed based on the scope of the user's request:
| User Request Pattern |
Execution Mode |
Agents Deployed |
| "Plan a YouTube video," "full production" |
Full Pipeline |
All 5 |
| "Just write the script," "script only" |
Script Mode |
strategist + writer + reviewer |
| "Optimize SEO for this script" (existing file) |
SEO Mode |
seo + reviewer |
| "Create a thumbnail for this video" (existing brief) |
Thumbnail Mode |
designer + reviewer |
| "Review this script" |
Review Mode |
reviewer only |
Using Existing Files: If the user provides a script, brief, or other existing file, copy it to the appropriate numbered position in _workspace/ and skip that phase's agent. Example: existing script provided → copy to _workspace/02_scriptwriter_script.md → skip writer, deploy only seo, designer, and reviewer.
Data Transfer Protocol
| Strategy |
Method |
Purpose |
| File-based |
_workspace/ directory |
Primary deliverable storage and sharing |
| Message-based |
SendMessage |
Real-time key information transfer, revision requests |
| Task-based |
TaskCreate/TaskUpdate |
Progress tracking, dependency management |
File naming convention: {order}_{agent}_{deliverable}.{extension}
Error Handling
| Error Type |
Strategy |
| Web search failure |
Strategist works from general knowledge, report notes "data limitation" |
| Thumbnail image generation failure |
Proceed with text concept only, include Gemini prompt for user retry |
| Agent failure |
Retry once → if still failing, proceed without that deliverable, note omission in review report |
| 🔴 found in review |
Request revision from responsible agent → rework → re-validate (up to 2 rounds) |
Agent Extension Skills
| Skill |
Path |
Target Agent |
Purpose |
| hook-writing |
skills/hook-writing/skill.md |
scriptwriter |
15 hook patterns, retention psychology, hook-thumbnail-title triangle alignment |
| thumbnail-psychology |
skills/thumbnail-psychology/skill.md |
thumbnail-designer |
Color psychology, 7 composition patterns, text readability, 3-second test |
Agents reference their respective extension skills during task execution to enhance domain expertise.
Test Scenarios
Happy Path
Prompt: "Plan a 10-minute YouTube video as a beginner's guide to AI prompt engineering"
Expected Results:
- Strategy brief: 3+ competitive analyses, keyword map, 3 title candidates
- Script: 10-minute length (~1,500 words in English), hook + 3–4 segments + closing
- Thumbnail: A/B concept options + image generation attempt
- SEO: Title/description/tags/chapters/SRT
- Review: All consistency matrix items verified
Existing File Flow
Prompt: "Create SEO optimization and a thumbnail for this script" + script file attached
Expected Results:
- Existing script copied to
_workspace/02_scriptwriter_script.md
- SEO Mode + Thumbnail Mode merged: seo + designer + reviewer deployed
- strategist, writer skipped
Error Flow
Prompt: "Just write a YouTube script quickly, any topic"
Expected Results:
- Switch to Script Mode (strategist + writer + reviewer)
- Topic is unclear, so strategist proposes 3 trending topics before proceeding
- Review report notes "thumbnail/SEO not generated"
1---2name: youtube-production3description: A full production pipeline where an agent team collaborates to generate YouTube video content — strategy, script, thumbnail, and SEO metadata — all at once. Use this skill for requests like 'plan a YouTube video,' 'write a video script,' 'video scriptwriting,' 'YouTube content strategy,' 'video scenario,' 'YouTube Shorts planning,' 'create a YouTube thumbnail,' 'video SEO optimization,' 'YouTube channel content,' and other YouTube video production tasks. Also supports SEO optimization or thumbnail creation when an existing script is provided. Note: actual video editing (Premiere, DaVinci), YouTube Analytics API integration, and channel operations dashboard setup are outside this skill's scope.4---56# YouTube Production — Full Video Content Production Pipeline78An agent team collaborates to produce YouTube video content through the pipeline of strategy → script → thumbnail → SEO, all at once.910## Execution Mode1112**Agent Team** — 5 members communicate directly via SendMessage and cross-validate each other's work.1314## Agent Roster1516| Agent | File | Role | Type |17|-------|------|------|------|18| content-strategist | `.claude/agents/content-strategist.md` | Topic analysis, competitive benchmarking, concept design | general-purpose |19| scriptwriter | `.claude/agents/scriptwriter.md` | Script writing, visual cue insertion | general-purpose |20| thumbnail-designer | `.claude/agents/thumbnail-designer.md` | Thumbnail concept + image generation | general-purpose |21| seo-optimizer | `.claude/agents/seo-optimizer.md` | Title/description/tags/chapters/subtitles | general-purpose |22| production-reviewer | `.claude/agents/production-reviewer.md` | Cross-validation, consistency checks | general-purpose |2324## Workflow2526### Phase 1: Preparation (Performed directly by the orchestrator)27281. Extract from user input:29 - **Topic/Keywords**: The subject the video will cover30 - **Channel Info** (optional): Channel tone, subscriber count, existing content direction31 - **Constraints** (optional): Video length, specific requirements32 - **Existing Files** (optional): Scripts, briefs, or other materials provided by the user332. Create the `_workspace/` directory at the project root343. Organize the input and save it as `_workspace/00_input.md`354. If existing files are provided, copy them to `_workspace/` and skip the corresponding phase365. Determine the **execution mode** based on request scope (see "Scope-Based Modes" below)3738### Phase 2: Team Assembly and Execution3940Assemble the team and assign tasks. Task dependencies are as follows:4142| Order | Task | Owner | Depends On | Deliverable |43|-------|------|-------|------------|-------------|44| 1 | Content strategy | strategist | None | `_workspace/01_strategist_brief.md` |45| 2a | Script writing | writer | Task 1 | `_workspace/02_scriptwriter_script.md` |46| 2b | Thumbnail design & generation | designer | Task 1 | `_workspace/03_thumbnail_concept.md` |47| 3 | SEO package | seo | Tasks 1, 2a | `_workspace/04_seo_package.md`, `_workspace/subtitle.srt` |48| 4 | Production review | reviewer | Tasks 2a, 2b, 3 | `_workspace/05_review_report.md` |4950Tasks 2a (script) and 2b (thumbnail) run **in parallel**. Both depend only on Task 1 (strategy), so they can start simultaneously.5152**Inter-agent communication flow:**53- strategist complete → deliver core angle & tone to writer, title candidates & emotional triggers to designer, keyword map to seo54- writer complete → deliver hook core message to designer (thumbnail-hook consistency), deliver script to seo55- seo complete → deliver title-thumbnail combination feedback to designer56- reviewer cross-validates all deliverables. On 🔴 Must Fix: request revision from the responsible agent → rework → re-validate (up to 2 rounds)5758### Phase 3: Integration and Final Deliverables5960Compile the final deliverables based on the reviewer's report:61621. Verify all files in `_workspace/`632. Confirm all 🔴 Must Fix items from the review report have been addressed643. Report the final summary to the user:65 - Strategy Brief — `01_strategist_brief.md`66 - Video Script — `02_scriptwriter_script.md`67 - Thumbnail Concept + Images — `03_thumbnail_concept.md`68 - SEO Package — `04_seo_package.md`69 - Review Report — `05_review_report.md`70 - Subtitle File — `subtitle.srt`7172## Scope-Based Modes7374Adjust the agents deployed based on the scope of the user's request:7576| User Request Pattern | Execution Mode | Agents Deployed |77|---------------------|----------------|-----------------|78| "Plan a YouTube video," "full production" | **Full Pipeline** | All 5 |79| "Just write the script," "script only" | **Script Mode** | strategist + writer + reviewer |80| "Optimize SEO for this script" (existing file) | **SEO Mode** | seo + reviewer |81| "Create a thumbnail for this video" (existing brief) | **Thumbnail Mode** | designer + reviewer |82| "Review this script" | **Review Mode** | reviewer only |8384**Using Existing Files**: If the user provides a script, brief, or other existing file, copy it to the appropriate numbered position in `_workspace/` and skip that phase's agent. Example: existing script provided → copy to `_workspace/02_scriptwriter_script.md` → skip writer, deploy only seo, designer, and reviewer.8586## Data Transfer Protocol8788| Strategy | Method | Purpose |89|----------|--------|---------|90| File-based | `_workspace/` directory | Primary deliverable storage and sharing |91| Message-based | SendMessage | Real-time key information transfer, revision requests |92| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |9394File naming convention: `{order}_{agent}_{deliverable}.{extension}`9596## Error Handling9798| Error Type | Strategy |99|-----------|----------|100| Web search failure | Strategist works from general knowledge, report notes "data limitation" |101| Thumbnail image generation failure | Proceed with text concept only, include Gemini prompt for user retry |102| Agent failure | Retry once → if still failing, proceed without that deliverable, note omission in review report |103| 🔴 found in review | Request revision from responsible agent → rework → re-validate (up to 2 rounds) |104105## Agent Extension Skills106107| Skill | Path | Target Agent | Purpose |108|-------|------|-------------|---------|109| hook-writing | `skills/hook-writing/skill.md` | scriptwriter | 15 hook patterns, retention psychology, hook-thumbnail-title triangle alignment |110| thumbnail-psychology | `skills/thumbnail-psychology/skill.md` | thumbnail-designer | Color psychology, 7 composition patterns, text readability, 3-second test |111112Agents reference their respective extension skills during task execution to enhance domain expertise.113114## Test Scenarios115116### Happy Path117**Prompt**: "Plan a 10-minute YouTube video as a beginner's guide to AI prompt engineering"118**Expected Results**:119- Strategy brief: 3+ competitive analyses, keyword map, 3 title candidates120- Script: 10-minute length (~1,500 words in English), hook + 3–4 segments + closing121- Thumbnail: A/B concept options + image generation attempt122- SEO: Title/description/tags/chapters/SRT123- Review: All consistency matrix items verified124125### Existing File Flow126**Prompt**: "Create SEO optimization and a thumbnail for this script" + script file attached127**Expected Results**:128- Existing script copied to `_workspace/02_scriptwriter_script.md`129- SEO Mode + Thumbnail Mode merged: seo + designer + reviewer deployed130- strategist, writer skipped131132### Error Flow133**Prompt**: "Just write a YouTube script quickly, any topic"134**Expected Results**:135- Switch to Script Mode (strategist + writer + reviewer)136- Topic is unclear, so strategist proposes 3 trending topics before proceeding137- Review report notes "thumbnail/SEO not generated"
revfactory