Maagpi Youtube Workflow Skill

Automatiza el pipeline de producción de YouTube de principio a fin para canales sin rostro.

Documentación

YouTube Content Workflow Skill

YouTube Content Workflow es una habilidad de Claude Code que convierte un calendario de contenido de Notion en videos de YouTube programados de principio a fin: elige un canal, genera títulos con el marco SUCCESS, ejecuta investigación profunda de NotebookLM, genera un video explicativo en el idioma del canal, lo transcribe, redacta la descripción, crea la miniatura (prefiriendo Nano Banana Pro), genera etiquetas y programa la subida — nunca público.

Este repositorio es la fuente de la habilidad. Después de la instalación, reside en ~/.claude/skills/youtube-content-workflow/ y se invoca mediante el comando de barra /youtube-content-workflow.

Primeros pasos

El camino más rápido de cero a una subida programada:

Instala Claude Code e inicia sesión.
Configura los MCP enumerados en Requisitos previos — Notion, NotebookLM, YouTube, un MCP de generación de imágenes (Nano Banana Pro preferido) y una fuente de transcripción. La fase 0 de la habilidad prueba cada uno y se detiene con el nombre de la herramienta faltante si alguno está ausente.
Configura las bases de datos de Notion descritas en schemas/notion-databases.md (YouTube Channels + Content Calendar) y agrega al menos un tema próximo con un Publish Date.
Instala la habilidad:
```
npx youtube-content-workflow install
```
Vuelve a ejecutarlo después de obtener actualizaciones: es idempotente.
Ejecútalo desde Claude Code:
```
/youtube-content-workflow
```
Elige el canal, aprueba los títulos, revisa los activos generados, elige private o unlisted, y la habilidad programa las subidas.

Consulta la Referencia de fases para ver qué sucede en cada paso y el Ejemplo para una ejecución completa anotada.

Habilidad

Disparador: /youtube-content-workflow
Ruta de instalación: ~/.claude/skills/youtube-content-workflow/
Estado: caché JSON local (por canal + por ejecución) + Notion (canónico)
Documentación completa: consulta SKILL.md para el contrato completo fase por fase

Requisitos previos

La habilidad orquesta MCP externos en tiempo de ejecución. Instala estos en tu entorno de Claude antes del primer uso — La fase 0 de la habilidad prueba cada uno y se detiene con el nombre exacto de la herramienta faltante si alguno está ausente.

Notion MCP — leer el calendario de contenido, escribir contexto por canal
NotebookLM MCP — notebook_create, research_start (modo profundo), studio_create, download_artifact · instalar: https://mcpservers.org/servers/roomi-fields/notebooklm-mcp
YouTube MCP — listar los canales del usuario, obtener títulos de videos recientes, programar subidas con privacidad private / unlisted · instalar: https://github.com/vamsi-kodimela/maagpi-youtube-mcp
MCP de generación de imágenes — Nano Banana Pro preferido; recurre a otras herramientas de Gemini/Imagen en tiempo de ejecución · instalar: https://github.com/vamsi-kodimela/maagpi-images-mcp
Transcripción — MCP dedicado, campo de transcripción studio_status de NotebookLM, o whisper local (auto-detectado, en ese orden)

¿Aún no tienes estos MCP? Los enlaces anteriores apuntan a servidores listos para instalar. La fase 0.1 los imprime en el mensaje de detención si falta algo.

Nunca publiques público. La habilidad aplica privacy != public con una aserción previa al vuelo antes de cada llamada de subida. No hay opción de exclusión.

Instalación rápida

npx (recomendado — sin clonar)

npx youtube-content-workflow install

Si el paquete aún no está en npm, instala directamente desde GitHub:

npx github:vamsi-kodimela/maagpi-youtube-workflow-skill install

Subcomandos:

npx youtube-content-workflow install              # idempotent; safe to re-run
npx youtube-content-workflow uninstall            # KEEPS state/
npx youtube-content-workflow uninstall --purge    # also delete state/ (irreversible)
npx youtube-content-workflow uninstall --yes      # skip confirmation
npx youtube-content-workflow --help

Requiere Node ≥ 18. La CLI es multiplataforma (macOS, Linux, Windows) y hace el mismo trabajo que los instaladores de shell a continuación.

macOS / Linux (clonar + shell)

git clone https://github.com/vamsi-kodimela/maagpi-youtube-workflow-skill.git
cd maagpi-youtube-workflow-skill
chmod +x install.sh
./install.sh

Windows (PowerShell, clonar)

git clone https://github.com/vamsi-kodimela/maagpi-youtube-workflow-skill.git
cd maagpi-youtube-workflow-skill
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
./install.ps1

Windows (Git Bash / WSL, clonar)

cd maagpi-youtube-workflow-skill
./install.sh

Manual

mkdir -p ~/.claude/skills/youtube-content-workflow/{schemas,state/channels,state/runs}
cp SKILL.md ~/.claude/skills/youtube-content-workflow/
cp schemas/* ~/.claude/skills/youtube-content-workflow/schemas/

Luego agrega el bloque de registro a ~/.claude/CLAUDE.md para que el comando de barra se ejecute:

# youtube-content-workflow
- **youtube-content-workflow** (`~/.claude/skills/youtube-content-workflow/SKILL.md`) - End-to-end YouTube production pipeline. Trigger: `/youtube-content-workflow`
When the user types `/youtube-content-workflow`, invoke the Skill tool with `skill: "youtube-content-workflow"` before doing anything else.

Todos los instaladores son idempotentes: vuelve a ejecutarlos después de editar SKILL.md para enviar la nueva copia.

Referencia de fases

La habilidad ejecuta cinco fases. Las fases 2 y 3 se ramifican como subagentes paralelos Agent (uno por tema). Las puertas de usuario se procesan secuencialmente.

Fase	Qué hace	MCPs llamados
`0. Channel + context`	Probar MCPs. Elegir canal. Cargar (caché → Notion) o capturar (primera vez) tono, audiencia, idioma, base de datos de calendario.	YouTube, Notion
`1. Calendar read`	Consultar el calendario de contenido de Notion para temas cuyo `Publish Date` caiga en tu rango elegido.	Notion
`2. Title gen`	Por tema: 5 títulos de SEO + marco SUCCESS (Heath, Made to Stick). El usuario elige uno.	(solo LLM)
`3. Heavy pipeline`	Por tema: notebook → investigación profunda → video explicativo → descargar → transcribir → descripción → especificación de miniatura → generación de imágenes → etiquetas → guardar.	NotebookLM, generación de imágenes, transcripción
`4. Review`	Mostrar los activos de cada tema + miniatura. Aprobar / regenerar / omitir. Elegir privacidad: `private` (predeterminado) o `unlisted`.	(puerta de UI)
`5. Upload`	Aserción previa al vuelo (`privacy != public`, archivos existen, fecha futura). Programar subida. Actualizar Notion.	YouTube, Notion

Ejemplo

Una ejecución típica para tres temas en los próximos 7 días:

> /youtube-content-workflow

[Phase 0]   channel = Main Channel (UCxxxxxxxx) — cache hit
[Phase 1]   3 topics found in date range 2026-04-30..2026-05-07
[Phase 2]   spawned 3 parallel title gens
            topic 1: 5 candidates → user picked #2
            topic 2: 5 candidates → user picked #4
            topic 3: 5 candidates → user picked #1
[Phase 3]   spawned 3 parallel pipelines
            topic 1: notebook ✓ deep research (8m 12s) ✓ video (3m 4s) ✓
                     transcript ✓ description ✓ thumbnail ✓ tags ✓
            topic 2: ...
            topic 3: ...
[Phase 4]   review topic 1: approved
            review topic 2: regen thumbnail → approved
            review topic 3: approved
            privacy: private
[Phase 5]   pre-flight pass · uploaded 3 · all scheduled as private

✅ run complete: ~/.claude/skills/youtube-content-workflow/state/runs/run-2026-04-30-a1b2c3/

Diseño de estado

~/.claude/skills/youtube-content-workflow/
├── SKILL.md
├── schemas/
└── state/
    ├── channels/
    │   └── UCxxxxxxxx.json      # cached channel metadata (mirrors Notion)
    └── runs/
        └── run-2026-04-30-a1b2c3/
            └── <topic_slug>/
                ├── metadata.json
                ├── video.mp4
                ├── thumbnail.png
                ├── transcript.txt
                ├── description.txt
                ├── tags.json
                └── titles.json

El estado del canal es canónico en Notion y se almacena en caché localmente para mayor velocidad. Consulta schemas/notion-databases.md para el esquema requerido de Notion (YouTube Channels + Content Calendar).

Actualizar / Reimplementar

Edita SKILL.md en este repositorio y luego vuelve a ejecutar cualquier instalador (npx youtube-content-workflow install, ./install.sh o ./install.ps1). Los instaladores sobrescriben la copia implementada y omiten el anexo de CLAUDE.md si el bloque de registro ya está presente.

Desinstalar

npx

npx youtube-content-workflow uninstall            # KEEPS state/
npx youtube-content-workflow uninstall --purge    # also delete state/ (irreversible)
npx youtube-content-workflow uninstall --yes      # skip confirmation

macOS / Linux / Git Bash / WSL (clonar)

./uninstall.sh             # remove SKILL.md + schemas + CLAUDE.md block; KEEP state/
./uninstall.sh --purge     # also delete state/ (irreversible)
./uninstall.sh --yes       # skip confirmation

Windows (PowerShell, clonar)

./uninstall.ps1             # preserves state/
./uninstall.ps1 -Purge      # also delete state/
./uninstall.ps1 -Yes        # skip confirmation

Por qué esta habilidad 🎯

Anti-alucinación por construcción. Solo hechos provenientes de herramientas, verificación de salida por paso, preservación del idioma. Nunca inventa temas, entradas de calendario ni transcripciones.
Paralelo por defecto. La generación de títulos y el pesado pipeline por tema se ramifican como equipos de subagentes; las puertas de usuario (selección de título, revisión, privacidad) se procesan secuencialmente.
Nunca público. La privacidad predeterminada es private. unlisted requiere aceptación explícita. Una aserción previa al vuelo lo aplica antes de cada llamada de subida.

Enlaces

Cuerpo de la habilidad: SKILL.md
Esquemas de BD de Notion: schemas/notion-databases.md
Esquema de caché de canal: schemas/channel-state.example.json
Referencia: marco SUCCESS — hermanos Heath, Made to Stick

Relación con habilidades existentes

Las habilidades heredadas youtube-content-creator y youtube-notebooklm en ~/.claude/skills/ se dejan intactas. Esta habilidad es un reemplazo unificado y centrado en MCP. Para retirar las antiguas, elimina sus directorios y quita sus entradas de CLAUDE.md manualmente: ningún instalador las toca.