Maagpi Youtube Workflow Skill

Skill de Fluxo de Trabalho de Conteúdo do YouTube

O YouTube Content Workflow é uma skill do Claude Code que transforma um calendário de conteúdo do Notion em vídeos do YouTube agendados de ponta a ponta: escolha um canal, gere títulos com a estrutura SUCCESS, execute pesquisa aprofundada no NotebookLM, gere um vídeo explicativo no idioma do canal, transcreva-o, rascunhe a descrição, crie a miniatura (preferindo Nano Banana Pro), gere tags e agende o upload — nunca público.

Este repositório é a fonte da skill. Após a instalação, ela fica em ~/.claude/skills/youtube-content-workflow/ e é invocada pelo comando de barra /youtube-content-workflow.

Primeiros passos

O caminho mais rápido do zero até um upload agendado:

1. Instale o Claude Code e faça login.
2. Configure os MCPs listados em Pré-requisitos — Notion, NotebookLM, YouTube, um MCP de geração de imagens (Nano Banana Pro preferido) e uma fonte de transcrição. A Fase 0 da skill testa cada um e interrompe com o nome da ferramenta ausente se algum não estiver presente.
3. Configure os bancos de dados do Notion descritos em schemas/notion-databases.md (YouTube Channels + Content Calendar) e adicione pelo menos um tópico futuro com um Publish Date.
4. Instale a skill:

   npx youtube-content-workflow install
   

   Execute novamente após puxar atualizações — é idempotente.
5. Execute-a no Claude Code:

   /youtube-content-workflow
   

   Escolha o canal, aprove os títulos, revise os ativos gerados, escolha private ou unlisted, e a skill agenda os uploads.

Consulte a Referência de Fases para saber o que acontece em cada etapa e o Exemplo para uma execução completa anotada.

Skill

• Gatilho: /youtube-content-workflow
• Caminho de instalação: ~/.claude/skills/youtube-content-workflow/
• Estado: cache JSON local (por canal + por execução) + Notion (canônico)
• Documentação completa: veja SKILL.md para o contrato completo fase por fase

Pré-requisitos

A skill orquestra MCPs externos em tempo de execução. Instale-os no seu ambiente Claude antes do primeiro uso — a Fase 0 da skill testa cada um e interrompe com o nome exato da ferramenta ausente se algum não estiver presente.

• Notion MCP — ler o calendário de conteúdo, escrever contexto por canal
• NotebookLM MCP — notebook_create, research_start (modo aprofundado), studio_create, download_artifact · instalação: https://mcpservers.org/servers/roomi-fields/notebooklm-mcp
• YouTube MCP — listar canais do usuário, buscar títulos recentes de vídeos, agendar uploads com privacidade private / unlisted · instalação: https://github.com/vamsi-kodimela/maagpi-youtube-mcp
• MCP de geração de imagens — Nano Banana Pro preferido; usa outras ferramentas Gemini/Imagen como fallback em tempo de execução · instalação: https://github.com/vamsi-kodimela/maagpi-images-mcp
• Transcrição — MCP dedicado, campo de transcrição studio_status do NotebookLM, ou whisper local (detecção automática, nessa ordem)

Ainda não tem esses MCPs? Os links acima apontam para servidores prontos para instalar. A Fase 0.1 os imprime na mensagem de interrupção se algo estiver faltando.

Nunca publique como público. A skill impõe privacy != public com uma verificação pré-execução antes de cada chamada de upload. Não há opção de desativar.

Instalação rápida

npx (recomendado — sem clone)

npx youtube-content-workflow install

Se o pacote ainda não estiver no npm, instale direto do 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

Requer Node ≥ 18. A CLI é multiplataforma (macOS, Linux, Windows) e faz o mesmo trabalho que os instaladores de shell abaixo.

macOS / Linux (clone + 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, clone)

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, clone)

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/

Em seguida, anexe o bloco de registro ao ~/.claude/CLAUDE.md para que o comando de barra seja despachado:

# 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 os instaladores são idempotentes — execute novamente após editar SKILL.md para enviar a nova cópia.

Referência de Fases

A skill executa cinco fases. As fases 2 e 3 se ramificam como subagentes Agent paralelos (um por tópico). Os portões de usuário são processados em lote sequencialmente.

Fase	O que faz	MCPs chamados
0. Channel + context	Testa MCPs. Escolhe canal. Carrega (cache → Notion) ou captura (primeira vez) tom, público, idioma, banco de dados do calendário.	YouTube, Notion
1. Calendar read	Consulta o calendário de conteúdo do Notion para tópicos cujo Publish Date esteja no intervalo escolhido.	Notion
2. Title gen	Por tópico: 5 títulos com SEO + estrutura SUCCESS (Heath, Made to Stick). O usuário escolhe um.	(Somente LLM)
3. Heavy pipeline	Por tópico: notebook → pesquisa aprofundada → vídeo explicativo → download → transcrição → descrição → especificação da miniatura → geração de imagem → tags → salvar.	NotebookLM, geração de imagens, transcrição
4. Review	Mostra os ativos + miniatura de cada tópico. Aprovar / regenerar / pular. Escolher privacidade: private (padrão) ou unlisted.	(Portão de interface)
5. Upload	Verificação pré-execução (privacy != public, arquivos existem, data no futuro). Agenda upload. Atualiza Notion.	YouTube, Notion

Exemplo

Uma execução típica para três tópicos nos próximos 7 dias:

> /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/

Estrutura 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

O estado do canal é canônico no Notion e armazenado em cache local para velocidade. Veja schemas/notion-databases.md para o esquema obrigatório do Notion (YouTube Channels + Content Calendar).

Atualizar / Reimplantar

Edite SKILL.md neste repositório e execute novamente qualquer instalador (npx youtube-content-workflow install, ./install.sh ou ./install.ps1). Os instaladores sobrescrevem a cópia implantada e pulam o anexo do CLAUDE.md se o bloco de registro já estiver 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 (clone)

./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, clone)

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

Por que esta skill 🎯

• Anti-alucinação por construção. Apenas fatos de fontes de ferramentas, verificação de saída a cada etapa, preservação de idioma. Nunca inventa tópicos, entradas de calendário ou transcrições.
• Paralela por padrão. A geração de títulos e o pipeline pesado por tópico se ramificam como equipes de subagentes; os portões de usuário (escolha de título, revisão, privacidade) são processados em lote sequencialmente.
• Nunca público. A privacidade padrão é private. unlisted exige aceitação explícita. Uma verificação pré-execução impõe isso antes de cada chamada de upload.

Links

• Corpo da skill: SKILL.md
• Esquemas do banco de dados Notion: schemas/notion-databases.md
• Esquema de cache do canal: schemas/channel-state.example.json
• Referência: estrutura SUCCESS — irmãos Heath, Made to Stick

Relação com skills existentes

As skills legadas youtube-content-creator e youtube-notebooklm em ~/.claude/skills/ são mantidas intactas. Esta skill é uma substituição unificada e centrada em MCP. Para aposentar as antigas, exclua seus diretórios e remova suas entradas do CLAUDE.md manualmente — nenhum dos instaladores as toca.