How pedromeloofficial/youtube-agent-matrix works
YouTube Agent Matrix is a Claude Code pre-production system: creators request work through the orchestrator, which routes to specialized agents and produces creator-facing plans and assets. Its documented full-video workflow moves through research, ideation and approval, SEO, scripting and approval, then recording-document generation and parallel thumbnail, metadata, and Shorts work. Other major branches cover channel strategy, audits, competitors, calendars, repurposing, monetization, and analytics. Optional execution scripts fetch YouTube data and transcripts or transcribe voice recordings. The README documents agent routing; source excerpts show execution-script internals, not how agents invoke them.
Main entry points: SKILL.md Orchestrator · script-agent.md Script Agent · search_competitor_videos.py Competitor Video Search · fetch_channel_data.py Channel Data Fetch
Components 28
Orchestration
- Orchestrator
skills/orchestrator/SKILL.md - Request Commands
commands/yt.md
Strategy and Research
- Channel Strategist
agents/channel-strategist.md - Channel Auditor
agents/channel-auditor.md - Competitor Analyst
agents/competitor-analyst.md - Research Agent
agents/research-agent.md - Research Report
agents/research-report-agent.md
Content Production
- Ideation Agent
agents/ideation-agent.md - Script Agent
agents/script-agent.md - Voice Agent
agents/voice-agent.md
Publishing and Growth
- Calendar Agent
agents/calendar-agent.md - Thumbnail Agent
agents/thumbnail-agent.md - Metadata Agent
agents/metadata-agent.md - SEO Agent
agents/seo-agent.md - Shorts Agent
agents/shorts-agent.md - Repurpose Agent
agents/repurpose-agent.md - Monetization Agent
agents/monetization-agent.md - Analytics Agent
agents/analytics-agent.md
Optional Data Tools
- Voice Transcription
execution/transcribe_audio.py - Recording Document
execution/build_reader_doc.py - Channel Data Fetch
execution/fetch_channel_data.py - Video Analytics Fetch
execution/fetch_video_analytics.py - Transcript Fetch
execution/fetch_transcript.py - Competitor Video Search
execution/search_competitor_videos.py - Quota Ledger
execution/utils/quota_tracker.py - YouTube Authentication
execution/utils/youtube_auth.py
Other components
- Creator
- YouTube APIs
Connections 40
- Creator → Orchestrator: requests work
README.md - Orchestrator → Request Commands: recognizes phrases
README.md - Orchestrator → Channel Strategist: routes setup
README.md - Orchestrator → Channel Auditor: routes audits
README.md - Orchestrator → Competitor Analyst: routes analysis
README.md - Orchestrator → Research Agent: routes research
README.md - Orchestrator → Research Report: routes reports
README.md - Orchestrator → Calendar Agent: routes calendars
README.md - Orchestrator → Script Agent: routes scripts
README.md - Orchestrator → Voice Agent: routes voice work
README.md - Orchestrator → Thumbnail Agent: routes thumbnails
README.md - Orchestrator → Metadata Agent: routes metadata
README.md - Orchestrator → SEO Agent: routes SEO
README.md - Orchestrator → Shorts Agent: routes Shorts
README.md - Orchestrator → Repurpose Agent: routes repurposing
README.md - Orchestrator → Monetization Agent: routes monetization
README.md - Orchestrator → Analytics Agent: routes analytics
README.md - Research Agent → Ideation Agent: provides research
README.md - Ideation Agent → Creator: presents idea choices
README.md - Creator → SEO Agent: approves idea
README.md - SEO Agent → Script Agent: sets title direction
README.md - Script Agent → Creator: presents variants
README.md - Creator → Script Agent: chooses variant
README.md - Script Agent → Recording Document: renders recording script
- Script Agent → Thumbnail Agent: feeds video package
README.md - Script Agent → Metadata Agent: feeds video package
README.md - Script Agent → Shorts Agent: feeds video package
README.md - Voice Agent → Voice Transcription: transcribes voice samples
- Channel Data Fetch → YouTube Authentication: uses credentials
execution/fetch_channel_data.py - Channel Data Fetch → Quota Ledger: checks quota
execution/fetch_channel_data.py - Video Analytics Fetch → YouTube Authentication: uses credentials
execution/fetch_video_analytics.py - Transcript Fetch → YouTube Authentication: uses credentials
execution/fetch_transcript.py - Transcript Fetch → Quota Ledger: checks quota
execution/fetch_transcript.py - Competitor Video Search → YouTube Authentication: uses credentials
execution/search_competitor_videos.py - Competitor Video Search → Quota Ledger: checks quota
execution/search_competitor_videos.py - Competitor Video Search → Channel Data Fetch: imports duration parser
execution/search_competitor_videos.py - Channel Data Fetch → YouTube APIs: fetches public data
- Video Analytics Fetch → YouTube APIs: queries private analytics
- Transcript Fetch → YouTube APIs: fetches captions
- Competitor Video Search → YouTube APIs: searches videos