Videoskill

Videoskill — edição de vídeo de ponta a ponta (marca branca)

Skill marca branca: nada de nomes, logos nem cores fixas no código. Tudo vem de marca/ (marca.json identidade e cores, canal.json canal e redes, projeto.json equipe e pastas). Idioma de trabalho: português.

Contrato de Ativação

Use quando o usuário pedir para editar um vídeo ou seus brutos, extrair shorts / reels / TikTok, montar um episódio do YouTube, criar um anúncio animado com locução, uma miniatura ou o carrossel do LinkedIn. Também quando trouxer roteiros para gravar (videos/_shared/plantillas/roteiros.md) ou quiser executar o fluxo completo de um projeto (projeto01, promo01, anuncio01).

Regras duras

1. Não publicar nada, não gastar créditos nem enviar arquivos para nenhum serviço sem perguntar (exceção SEMPRE: copiar as entregas para o Drive final/<id>/). Ao gastar créditos, informar quanto e quanto resta.
2. Links públicos: SEMPRE https://suamarca.com (nunca o domínio longo). Redes em marca/canal.json.
3. Câmera real sempre; um gêmeo digital (ex. HeyGen) apenas como plano B.
4. Antes de mexer em qualquer coisa, ler references/regras-tecnicas.md. Quando algo falhar e for corrigido, anotar lá: o sistema aprende a cada vídeo.
5. Antes de projetar cenas, fundos, fichas, miniaturas ou outros, consultar references/design.md (fontes de inspiração verificadas e mapeadas ao pipeline).
6. npx tsc --noEmit antes de cada render; QA de quadros SEMPRE (node remotion/scripts/qa.mjs …) e OLHAR para eles antes do render completo.
7. Processar sempre a partir do disco local; no <DRIVE> só se COPIA, nunca se processa (pipeline/brutos.py trazer|entregar <id>).

Estrutura

marca/            identidade (único local com nomes, cores, logos, redes)
pipeline/         scripts Python (numerados na ordem do fluxo) + comun.py
remotion/         composições: Intro|Disclaimer|Catalogo (Parte), Grosso/GrossoGraficos,
                  Short, Linkedin, Lamina, Miniatura · cenas em src/cenas · scripts/qa.mjs
videos/           publicDir do Remotion: SÓ o que o Remotion lê (cortes, JSON, broll, música, logos)
  _shared/        music/, logos/, fx/, marca/, obj/, descricoes/, modelos/
  <id>/           plano.md, guia_gravacao.md, partes.json, <parte>.json, shorts.json, …
references/       manuais de apoio (ver Gates de Decisão)
raw/<id>/         brutos copiados do Drive + intermediários pesados (fora do git)
out/              renders, qa/, miniatura/, entregas/<id>/ (fora do git)

Fluxo (resumo)

Passo	O quê	Comando chave
0	Roteiro e guia de gravação	modelos em videos/_shared/modelos/
1	Trazer brutos e revisar (ffprobe, espelho, rotação)	python pipeline/brutos.py trazer <id> …
2	Partes da câmera: sincronizar por voz → transcrever → tomadas → cortar silêncios	05_sync → 02 → 03 → 01 (+ alinear.py apenas)
3	Conceito e cenas ancoradas na voz	leitura.py → historial.py → <parte>.json → qa.mjs
4	Bloco de tela (grosso): prep, pixelado, zooms, render híbrido	04_grosso → 06_zooms → render_grosso
5	B-roll, miniatura (Higgsfield + Remotion) e renders por parte	out/lote_<id>.cmd
6	Montagem final a −14 LUFS com capítulos e descrição	07_final.py
7	Vertical + LinkedIn (Shorts/Reels/TikTok/4:5, carrossel PDF)	09_shorts.py → 10_linkedin.py
8	Fechar: registrar histórico e relatório	historial.py registrar <id> → README_<id>.md

Variantes: anúncio curto (promo01, vertical denso com cola) e anúncio animado com locução (anuncio01, sem câmera, painéis 3D). Detalhe comando a comando: references/fluxo.md.

Gates de Decisão

Você precisa…	Leia
Executar o fluxo completo ou um passo específico com seus comandos	references/fluxo.md
Escolher cenas do catálogo (type), camadas, fundos, estilo e SFX	references/cenas.md
Projetar: abertura/gancho, CTA, fechamento, fichas de vidro, ícones 3D, fundos animados	references/design.md
Miniatura, Higgsfield, voz ElevenLabs, logos, modelos locais, ambiente	references/ferramentas.md
Depurar uma falha conhecida ou evitar um erro já enfrentado	references/regras-tecnicas.md

Contrato de Saída

Cada projeto termina com:

1. YouTube horizontal (1920×1080, −14 LUFS): partes montadas, capítulos válidos, descrição com fontes e miniatura.
2. Vertical → 3 versões com textos diferentes: YouTube Shorts (com música), Instagram Reels e TikTok (sem música; o usuário coloca ao publicar).
3. LinkedIn: vídeo 4:5, carrossel PDF, imagem avulsa e texto do post.
4. Tudo em <DRIVE>/final/<id>/ (shorts/, linkedin/) e relatório out/entregas/<id>/README_<id>.md: o que contém, o que revisar, créditos gastos e textos prontos para colar. A publicação é manual.