Documentation
README
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
- Strategy Brief —
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"