Communitygithub.com

digitaleflex/GitHub-Cyber-Scanner-Pro

Habilidade de produção de vídeo cinematográfico full-stack. Cria vídeos MP4 profissionais e narrativos em 1920x1080 para produtos, serviços, eventos, SaaS, empresas e marcas.

O que é GitHub-Cyber-Scanner-Pro?

Esta habilidade é um pipeline completo de produção de vídeo profissional, projetada para ser usada com agentes de IA como Claude Code, Cursor ou Codex. Ela permite que um agente crie vídeos MP4 de alta qualidade (1920x1080) com narração, legendas sincronizadas, animações ricas e transições de cena, sem necessidade de edição manual. O pipeline é alimentado por HyperFrames (para composição HTML e renderização), Kokoro (para síntese de voz profissional) e Whisper (para transcrição de legendas no nível da palavra). A habilidade é valiosa para qualquer desenvolvedor ou criador que precise gerar vídeos promocionais, demonstrações de produtos ou pitches sob demanda, diretamente de um prompt. Sua natureza estruturada garante resultados consistentes e de alta qualidade, seguindo uma sequência de briefing, roteiro, design visual, narração, transcrição, planejamento de cena, construção da composição, linting, validação e renderização final.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/digitaleflex/GitHub-Cyber-Scanner-Pro/tree/HEAD/.agents/skills/video-creator

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Criador de Vídeo

Produção profissional de vídeos cinematográficos para produtos, serviços, eventos e marcas. Cada saída é um MP4 1920×1080 com narração, legendas sincronizadas, animações ricas e múltiplas transições de cena.

Início Rápido (3 comandos)

# 1. Iniciar projeto
npx --yes [email protected] init meu-video

# 2. Gerar narração
python3 -c "from kokoro_onnx import Kokoro; import soundfile as sf; k=Kokoro('models/kokoro-v1.0.onnx','models/voices-v1.0.bin'); s,r=k.create(open('script.txt').read(),voice='bm_george',speed=0.92,lang='en-gb'); sf.write('narration.wav',s,r)"

# 3. Transcrever para legendas
npx --yes [email protected] transcribe narration.wav --model small.en

# 4. Renderizar
npx --yes [email protected] render

Pipeline de Produção

Sempre siga esta sequência — nunca pule etapas:

1. BRIEF      → público, plataforma, duração, tom
2. ROTEIRO    → escrever narração (~2.5 pps), gancho primeiro
3. design.md  → cores da marca, fontes, energia do movimento
4. NARRAÇÃO   → npx hyperframes tts OU python kokoro_onnx diretamente
5. TRANSCRIÇÃO → npx hyperframes transcribe → transcript.json
6. PLANO      → declaração do ritmo das cenas antes de qualquer HTML
7. CONSTRUÇÃO → layout primeiro → depois animação GSAP
8. LINT       → npx hyperframes lint (0 erros exigidos)
9. VALIDAÇÃO  → npx hyperframes validate --no-contrast
10. RENDER    → npx hyperframes render

Etapa 1 — Briefing da Produção

Pergunte (ou deduza do contexto):

  • Assunto: produto / serviço / evento / marca?
  • Público: empresa, desenvolvedor, consumidor, investidor?
  • Plataforma: rede social (15s), hero do site (30s), demo de produto (60s), apresentação?
  • Tom: autoritário, energético, caloroso, dramático, técnico?
  • Ativos: cores da marca, logotipo, capturas de tela, texto existente?

Leia references/brief-templates.md para pontos de partida específicos do público.

Etapa 2 — Escrita do Roteiro

Fórmula de ritmo: 2.5 palavras por segundo em velocidade natural

  • 15s → ~37 palavras
  • 30s → ~75 palavras
  • 60s → ~150 palavras

Estrutura: Gancho → Problema/História → Prova → CTA

Padrões de gancho (nunca use aberturas genéricas):

  • Afirmação ousada: "A infraestrutura financeira que impulsiona a engenharia moderna."
  • Contraste: "Seus agentes estão implantados. Ninguém está monitorando eles."
  • Pergunta: "E se toda a sua equipe — humana e IA — se movesse como uma só?"
  • Número impactante: "Quarenta por cento dos projetos de IA corporativos fracassam na governança."

Registro de voz por público:

  • Corporativo → declarativo, medido, voz bm_george
  • Desenvolvedor → direto, técnico, voz am_adam
  • Consumidor → caloroso, orientado a histórias, voz af_heart
  • Startup/energia → impactante, rápido, voz af_sky

Escreva números como palavras no roteiro (TTS lê literalmente): 10x → dez vezes, $2.3T → quase dois ponto três trilhões de dólares.

Leia references/script-patterns.md para exemplos completos de roteiros por tipo de vídeo.

Etapa 3 — Sistema de Design (design.md)

Sempre crie design.md antes de escrever qualquer HTML. Ele define o contrato da marca.

Campos obrigatórios:

colors:
  bg: "#0A0A0A"           # fundo principal (escuro ou claro)
  accent: "#E63946"       # cor de ação principal
  accent2: "#10b981"      # destaque secundário
  text: "#FFFFFF"
  muted: "#999999"
  border: "#141111"
typography:
  headline: { fontFamily: "Space Grotesk", fontWeight: 800 }
  label:    { fontFamily: "Space Mono", fontWeight: 700 }
motion:
  energy: high | medium | low
  transition: glitch | blur | push | cover

Seletor de estilo visual (leia references/visual-styles.md para tokens YAML completos):

EstiloMelhor paraMarca registrada
DeconstructedTech, SaaS, segurançaLinhas de varredura, bordas brutais, Space Grotesk/Mono
MaximalistLançamentos, anúnciosTipo gigante preenche o quadro, impactos de cor
Velvet StandardCorporativo, luxoEspaçamento de letras amplo, espaço generoso
Data DriftIA, ML, fintechCampos de partículas, futurista fino sem serifa
Shadow CutRevelações dramáticas, segurançaQuase monocromático + destaque em sangue
Folk FrequencyConsumidor, comunidadeCor ousada, salto, padrão

Etapa 4 — Geração de Narração

Via npx (preferido quando disponível)

npx --yes [email protected] tts script.txt --voice bm_george --output narration.wav --speed 0.92

Via Python direto (fallback se npx falhar)

# Primeira execução: baixar modelos (~340MB total, em cache)
curl -L -o models/kokoro-v1.0.onnx \
  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx
curl -L -o models/voices-v1.0.bin \
  https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin

# Gerar
python3 << 'EOF'
from kokoro_onnx import Kokoro
import soundfile as sf
k = Kokoro("models/kokoro-v1.0.onnx", "models/voices-v1.0.bin")
text = open("script.txt").read().strip()
samples, rate = k.create(text, voice="bm_george", speed=0.92, lang="en-gb")
sf.write("narration.wav", samples, rate)
print(f"Gerado: {len(samples)/rate:.1f}s")
EOF

Guia de vozes:

VozPersonagemUse para
bm_georgeBritânico autoritário masculinoCorporativo, B2B, keynote
bf_emmaBritânica clara femininaTutorial, documentação, premium
am_michaelAmericano confiante masculinoMarketing, promoção, SaaS
am_adamAmericano neutro masculinoFerramentas de desenvolvedor, explicadores
af_heartAmericana calorosa femininaConsumidor, bem-estar, pessoal
af_skyAmericana enérgica femininaAnúncios sociais, lançamentos, estilo de vida

Instalar dependências (uma vez):

pip install kokoro-onnx soundfile

Etapa 5 — Transcrição (Legendas no Nível da Palavra)

npx --yes [email protected] transcribe narration.wav --model small.en
# → produz transcript.json com timestamps no nível da palavra

Formato de saída:

[
  { "text": "Enterprise", "start": 0.03, "end": 0.82 },
  { "text": "teams", "start": 0.82, "end": 1.18 }
]

Use timestamps para:

  1. Ancorar transições de cena nos limites das frases faladas
  2. Conduzir animações de legenda palavra por palavra (aparecer palavra por palavra)
  3. Sincronizar ênfase visual (linhas de explosão, destaques) com substantivos-chave

Etapa 6 — Planejamento do Ritmo da Cena

Declare o ritmo antes de escrever qualquer HTML. Nomeie o padrão:

SLAM → respirar → CASCATA → GOLPE → CTA             (lançamento de produto)
DOR → VISLUMBRE → PROVA → CONVICÇÃO                  (problema/solução)
GANCHO → HISTÓRIA → PROVA → ESCALA → CTA             (pitch corporativo)
PROVOCAÇÃO → REVELAÇÃO → DETALHE → DETALHE → CTA     (demonstração de recurso)

Modelo de tempo de cena (30s corporativo):

Cena 1: Problema/Gancho      0–7s    (frase 1-2 da narração)
Cena 2: Introdução plataforma 7–10s  (frase 3)
Cena 3: Demo de recurso     10–17s   (frase 4-5)
Cena 4: Prova/estatísticas  17–21s   (frase 6)
Cena 5: Escalar             21–28s   (frase 7-8)
Cena 6: CTA                 28–32s   (frase 9)

Leia references/scene-timing.md para modelos de tempo por duração.

Etapa 7 — Construir a Composição

Estrutura HTML (obrigatória)

<!DOCTYPE html>
<html lang="pt">
<head>
<meta charset="UTF-8"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<style>
body { margin:0; width:1920px; height:1080px; overflow:hidden; background:#0A0A0A; }
.scene { position:absolute; top:0; left:0; width:1920px; height:1080px; overflow:hidden; }
#s1 { z-index:1; background:#0A0A0A; }        /* cena 1 — visível por padrão */
#s2 { z-index:2; background:#0A0A0A; opacity:0; }  /* todas as outras ocultas */
</style>
</head>
<body>
<div id="root" data-composition-id="main" data-width="1920" data-height="1080"
     data-start="0" data-duration="32">

  <!-- Áudio (separado do vídeo, sempre) -->
  <audio id="vo" data-start="0" data-duration="31.1" data-track-index="10"
         data-volume="1" src="narration.wav"></audio>

  <!-- Sobreposições de transição (sempre acima de todas as cenas) -->
  <div id="ov-r" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:80;background:#E63946;opacity:0;pointer-events:none"></div>

  <!-- Cenas -->
  <div id="s1" class="scene"><!-- conteúdo --></div>
  <div id="s2" class="scene"><!-- conteúdo --></div>
</div>

<script>
window.__timelines = window.__timelines || {};
var tl = gsap.timeline({ paused: true });
// ... animações ...
window.__timelines["main"] = tl;
</script>
</body>
</html>

Layout Antes da Animação (não negociável)

  1. Construa o estado final de cada cena em CSS puro primeiro
  2. Contêineres de conteúdo: display:flex; flex-direction:column; padding:120px 160px; width:100%; height:100%;
  3. Nunca use position:absolute; top:Npx no conteúdo — apenas em decorativos
  4. Adicione gsap.fromTo() após o layout ser confirmado
  5. Execute npx hyperframes inspect para verificar se não há transbordamento

Regras do GSAP

// SEMPRE use fromTo (não from) dentro das cenas para busca determinística
tl.fromTo("#el", { opacity:0, y:40 }, { opacity:1, y:0, duration:0.5, ease:"back.out(2)" }, 1.2);

// NUNCA use gsap.to() simples para movimento ambiente — deve estar em tl
tl.to("#glow", { scale:1.08, yoyo:true, repeat:4, duration:2, ease:"sine.inOut" }, 0);

// NUNCA repeat:-1 (quebra o mecanismo de captura) — calcule repetições finitas
// Para um batimento de 4s: Math.ceil(4 / 2) = 2 ciclos
tl.to("#pulse", { scale:1.1, yoyo:true, repeat:3, duration:2, ease:"sine.inOut" }, 0);

// Saídas de cena com corte forçado
tl.set("#s1", { opacity:0, visibility:"hidden" }, tempoSaida);

// Sempre registrar
window.__timelines["main"] = tl;

Requisitos de Densidade da Cena

Cada cena DEVE ter:

  • Camada de fundo: brilho radial + grade/padrão + texto fantasma + linha de varredura (2–5 elementos)
  • Camada de conteúdo: manchete + subtítulo + elemento de suporte (3–5 elementos)
  • Destaques de primeiro plano: marcas de canto + linha divisória + etiqueta/emblema (3+ elementos)
  • Total: mínimo de 8–10 elementos visuais

Leia references/scene-density.md para listas de verificação de elementos por cena.

Biblioteca de Transições

Leia references/transitions.md para o código completo. Escolhas rápidas:

EnergiaTransiçãoPadrão de código
Caos → ClarezaTransição de desfoquetl.to(old, {filter:"blur(14px)",scale:1.04,opacity:0,duration:0.5})
AvançoEmpurrão verticaltl.to(old,{y:-1080,duration:0.45,ease:"power3.inOut"}, T)
Próximo itemDeslize empurrando esquerdatl.to(old,{x:-1920,duration:0.45,ease:"power3.inOut"}, T)
Corte secoMergulho de cor para pretotl.to("#ov-k",{opacity:1,duration:0.25}) então tl.set(new,{opacity:1})
Grande momentoBlocos de cor escalonadosBloco vermelho então verde desliza pela tela, troca a cena por baixo
IndustrialGlitchOscilação de sobreposição RGB, 6 quadros em ±40px, 0.35s

Sem animações de saída antes das transições, exceto o fade para preto da cena final.

Biblioteca de Técnicas de Animação

1. Campo de Partículas Canvas 2D (ambiente de fundo)

<canvas id="bg-canvas" width="1920" height="1080" style="position:absolute;top:0;left:0;z-index:1"></canvas>
<script>
var c=document.getElementById("bg-canvas"),ctx=c.getContext("2d");
function h(x,y){var n=x*374761393+y*668265263;n=(n^(n>>13))*1274126177;return((n^(n>>16))&0x7fffffff)/0x7fffffff}
var N=120, pts=[];
for(var i=0;i<N;i++) pts.push({bx:h(i,0)*1920,by:h(i,1)*1080,vx:(h(i,3)-0.5)*0.3,vy:(h(i,4)-0.5)*0.2,r:1+h(i,2)*2.5});
var px={t:0};
tl.to(px,{t:DURACAO,duration:DURACAO,ease:"none",onUpdate:function(){
  var ti=px.t;
  ctx.clearRect(0,0,1920,1080);
  // grade
  ctx.strokeStyle="rgba(230,57,70,0.04)"; ctx.lineWidth=1;
  for(var gx=0;gx<1920;gx+=160){ctx.beginPath();ctx.moveTo(gx,0);ctx.lineTo(gx,1080);ctx.stroke()}
  for(var gy=0;gy<1080;gy+=120){ctx.beginPath();ctx.moveTo(0,gy);ctx.lineTo(1920,gy);ctx.stroke()}
  // partículas
  for(var i=0;i<N;i++){
    var p=pts[i],x=(p.bx+p.vx*ti*60)%1920,y=(p.by+p.vy*ti*60)%1080;
    if(x<0)x+=1920;if(y<0)y+=1080;
    ctx.fillStyle="rgba(230,57,70,"+(0.15+0.1*h(i,Math.floor(ti*6)))+")";
    ctx.fillRect(x-p.r/2,y-p.r/2,p.r,p.r);
  }
}},0);
</script>

2. Sublinhado Rabiscado SVG

<span style="position:relative;display:inline-block">
  frase chave
  <svg style="position:absolute;left:0;bottom:-8px;width:100%;height:20px" viewBox="0 0 500 20" preserveAspectRatio="none">
    <path id="scr" fill="none" stroke="#E63946" stroke-width="3" stroke-linecap="round"
      stroke-dasharray="800" stroke-dashoffset="800"
      d="M0,10 Q62,0 125,10 Q187,20 250,10 Q312,0 375,10 Q437,20 500,10"/>
  </svg>
</span>
<script>
// após o elemento de caminho existir no DOM:
var p=document.getElementById("scr"), l=p.getTotalLength();
gsap.set(p,{strokeDasharray:l,strokeDashoffset:l});
tl.to("#scr",{strokeDashoffset:0,duration:0.7,ease:"power1.inOut"}, INICIO);
</script>

3. Manchete Cinética Palavra por Palavra (sincronizada com a voz)

<div id="headline">
  <span class="w" id="w0">Ship</span>
  <span class="w" id="w1">faster.</span>
  <span class="w" id="w2">CyberAgent.</span>
</div>
<script>
// timestamps de transcript.json tempos de início das palavras
var times = [0.0, 0.3, 0.7];
var eases = ["back.out(2.5)", "expo.out", "back.out(3)"];
var dirs  = [{y:60,rotation:4}, {y:80,scale:0.7}, {scale:0.5,rotation:-5}];
times.forEach(function(t,i){
  tl.fromTo("#w"+i,
    Object.assign({opacity:0},dirs[i]),
    Object.assign({opacity:1,y:0,scale:1,rotation:0,duration:0.45,ease:eases[i]},{}),
    t);
});
</script>

4. Linhas de Explosão (revelação de estatística)

<div style="position:relative;display:inline-block">
  <div id="stat-num">10×</div>
  <div style="position:absolute;top:50%;left:50%;width:0;height:0" id="burst">
    <span style="position:absolute;display:block;width:3px;height:52px;background:#E63946;left:-1.5px;top:-52px;transform:rotate(0deg);transform-origin:bottom center;opacity:0"></span>
    <span style="position:absolute;display:block;width:3px;height:38px;background:#E63946;left:-1.5px;top:-38px;transform:rotate(36deg);transform-origin:bottom center;opacity:0"></span>
    <!-- repita para 8-12 linhas em incrementos de 30-45deg -->
  </div>
</div>

5. Tipografia Cinética (aparecer rastreado)

<div id="kt-text" style="visibility:hidden">
  <span>Seus</span> <span>dados,</span> <span>sua</span> <span>governança.</span>
</div>
<script>
var words = document.querySelectorAll("#kt-text span");
gsap.set("#kt-text", {visibility:"visible"});
gsap.set(words, {opacity:0, x:20, filter:"blur(8px)"});
words.forEach(function(w,i){
  tl.to(w, {opacity:1, x:0, filter:"blur(0px)", duration:0.2, ease:"power1.out"}, 0 + i*0.12);
});
</script>

6. Glide de Destaque com Onda

<div style="position:relative;display:inline-block;overflow:hidden" id="highlight-container">
  <span id="highlight-text" style="position:relative;z-index:2">nunca comprometa a segurança</span>
  <div id="highlight-wave" style="position:absolute;top:0;left:-100%;width:100%;height:100%;z-index:1;background:linear-gradient(90deg,transparent,rgba(16,185,129,0.3),transparent);transform:skewX(-20deg)"></div>
</div>
<script>
tl.fromTo("#highlight-wave", {left:"-100%"}, {left:"200%", duration:0.8, ease:"power2.inOut"}, 0.5);
</script>

7. Sobreposição de Varredura (granulação de filme)

<div id="scanlines" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:90;pointer-events:none;background:repeating-linear-gradient(0deg,transparent,transparent 2px,rgba(0,0,0,0.08) 2px,rgba(0,0,0,0.08) 4px);opacity:0.15"></div>

8. Cápsula de Citação Flutuante

<div id="quote-box" style="position:absolute;top:300px;right:100px;width:500px;padding:32px 40px;background:rgba(255,255,255,0.02);border-left:4px solid #E63946;backdrop-filter:blur(8px);opacity:0;transform:translateX(60px)">
  <div style="font-family:'Space Grotesk';font-size:28px;color:#FFFFFF;line-height:1.4">"A segurança não é um recurso. É um princípio de design."</div>
  <div style="font-family:'Space Mono';font-size:16px;color:#E63946;margin-top:20px">— CTO, Plataforma Fortune 500</div>
</div>
<script>
tl.fromTo("#quote-box", {opacity:0,x:60,rotate:2}, {opacity:1,x:0,rotate:0,duration:0.7,ease:"power2.out"}, TEMPO);
</script>

Etapa 8 — Linting

npx --yes [email protected] lint

Regras que são verificadas:

  • composition/data-start e composition/data-duration existem
  • composition/data-duration >= composition/data-start + 0.5
  • Nenhum <script> inline não encapsulado em funções
  • window.__timelines["main"] é atribuído
  • Nenhum gsap.to() solto — apenas declarações dentro de timeline
  • Nenhum repeat:-1 — deve ser finito
  • As cenas têm classe scene e z-index adequado
  • Nenhuma imagem externa quebrada (caminhos relativos ao ativo)
  • audio[src] aponta para um arquivo .wav que existe

Resolução: corrija até 0 erros.

Etapa 9 — Validação

npx --yes [email protected] validate --no-contrast

Etapa 10 — Renderização

npx --yes [email protected] render
# → produz MP4 em dist/video.mp4

Saída

dist/
├── video.mp4          # produto final 1920×1080
├── narration.wav      # arquivo de áudio usado
├── transcript.json    # legendas no nível da palavra
├── index.html         # composição de depuração
└── design.md          # sistema de design usado

Dependências: Node.js 18+, Python 3.10+, pip install kokoro-onnx soundfile

Atalho de linha de comando: npx [email protected] <comando>

Todas as referências em: references/ — leia as relevantes para o tipo de vídeo que está sendo produzido.

Habilidades Relacionadas