How horatiumol/youtube-agents works
This repository supports a YouTube content-production workflow: a user uploads a Word brief to a watched Drive folder; the watcher extracts its text and invokes Claude Code, which is prompted to run research, scriptwriting, title/description, and thumbnail stages and save three versioned outputs. The watcher and its orchestration are excerpted; the skill files, context documents, and agent definitions are present in the tree but unsampled, so their internal behavior is not inferred. Edges between stages reflect the explicit sequence in the watcher’s prompt.
Main entry points: watch_drive_folder.py Drive watcher · trend-research.md Trend research · script-writer.md Script writing · title-generator.md Title generation
Components 15
Brief intake
- Drive brief folder
- Drive watcher
watch_drive_folder.py - Extracted brief
watch_drive_folder.py
Content production
- Claude Code
- Trend research
skills/trend-research.md - Script writing
skills/script-writer.md - Title generation
skills/title-generator.md - Thumbnail concepts
skills/thumbnail-creator.md
Brand context
- Audience context
contexto/audience.md - Top video references
contexto/top-videos.md - Brand voice
contexto/brand-voice.md
Video deliverables
- Generated scripts
outputs/guiones - Titles and descriptions
outputs/titulos - Thumbnail prompts
outputs/miniaturas
Other components
- Content creator
Connections 14
- Content creator → Drive brief folder: uploads brief
- Drive brief folder → Drive watcher: triggers on .docx
watch_drive_folder.py - Drive watcher → Extracted brief: extracts text
watch_drive_folder.py - Drive watcher → Claude Code: invokes with prompt
watch_drive_folder.py - Claude Code → Trend research: runs first
- Trend research → Script writing: then drafts
- Script writing → Title generation: then generates
- Title generation → Thumbnail concepts: then designs
- Claude Code → Audience context: uses context
- Claude Code → Top video references: uses context
- Claude Code → Brand voice: uses context
- Claude Code → Generated scripts: writes script
- Claude Code → Titles and descriptions: writes titles
- Claude Code → Thumbnail prompts: writes prompts