Communitygithub.com

notivn/AIEV

Criador de vídeos completo e amigável para iniciantes usando HyperFrames. Use quando o usuário disser 'faça um vídeo', 'crie um vídeo', 'novo vídeo', 'construa um vídeo', 'vídeo do zero', 'quero fazer um vídeo', 'me ajude a criar um vídeo', ou quando alguém que nunca usou HyperFrames antes chegar com um conceito, roteiro ou ideia inicial e quiser um MP4 finalizado. Entrevista o usuário em uma única passada, depois constrói o vídeo completo com portões obrigatórios de pré-visualização e verificação visual.

O que é AIEV?

Esta skill (notivn/AIEV) fornece um fluxo de trabalho completo e estruturado para criar vídeos do zero até o MP4 final usando HyperFrames, ideal para iniciantes. Ela opera em duas fases principais: a Fase 1 (Entrevista) coleta todos os requisitos do usuário em uma única conversa, incluindo intenção, formato, roteiro, voz, estilo e ativos. A Fase 2 (Construção) executa a criação do vídeo em portões sequenciais: scaffolding do projeto, storyboard, construção de composições, linting, pré-visualização no Studio, renderização de rascunho, verificação visual obrigatória quadro a quadro, pré-visualização do MP4 e renderização final. A skill impõe 'portões de aprovação' (gates) rígidos: o usuário deve aprovar o BRIEF.md antes da construção, aprovar o storyboard, aprovar a pré-visualização no Studio e aprovar o MP4 de rascunho antes da renderização final. Ela também gerencia transferências para skills especializadas (como `/short-form-video` para vídeos verticais 9:16 com rosto) e segue rigorosamente as regras de não-negociáveis, como nunca pular portões de pré-visualização, nunca gerar ativos aleatórios e nunca impor uma marca ao usuário sem permissão.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

Perguntar na sua IA favorita

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

Documentação

Criar um Vídeo - A Skill do Iniciante ao MP4 Finalizado

Duas fases, oito portões sequenciais. Cada portão produz um artefato concreto que o próximo portão consome. Não pule portões.

Quando usar esta skill - e quando transferir

Use esta skill quando:

  • O usuário é novo no HyperFrames e está começando a partir de um conceito, roteiro ou esboço
  • Eles querem um passo a passo completo, não material de referência do framework
  • Eles ainda não decidiram o formato

Transfira quando:

  • O usuário colar uma URL e quiser um vídeo daquele site → invocar /website-to-hyperframes
  • O usuário quiser explicitamente um vídeo vertical 9:16 com rosto (talking-head) + sobreposições de cena → execute os Portões 1–4 aqui, depois invoque /short-form-video a partir do Portão 5
  • O usuário perguntar sobre regras do framework, não sobre um vídeo → invocar /hyperframes

Nota de roteamento (pipeline AI Edit Video): quando esta skill for executada a partir de um resumo de projeto, as seções STYLE DESIGN e PHONG CÁCH DỰNG (estilo de vídeo) do prompt de edição substituem os padrões da entrevista abaixo - não refaça perguntas de estilo que o resumo já responde.

As duas fases

  • Fase 1 - ENTREVISTA (Portões 1–4): uma passada conversacional para coletar tudo antes de tocar em código. Intenção, formato, roteiro, voz, estilo, ativos, ritmo. Sintetize em um BRIEF.md e aguarde aprovação explícita.
  • Fase 2 - CONSTRUÇÃO (Portões 5–8): scaffolding → storyboard → composições → lint → pré-visualização no Studio → renderização de rascunho → verificação visual → pré-visualização do MP4 → renderização final.

Portão 1 · Intenção e formato

Faça uma pergunta de cada vez via AskUserQuestion, de múltipla escolha quando possível.

  1. Para que serve este vídeo? (promo · anúncio social · teaser de lançamento · demonstração de produto · tutorial · explicativo · cartão de intro/outro · outro)
  2. Quem é o público? (aberta)
  3. Duração alvo? (curto 10–20s · promo 20–45s · explicativo 45–90s · lição 1,5–3 min · personalizado)
  4. Proporção de tela? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. Taxa de quadros? (30 padrão · 60 para UI nítida · 24 cinematográfica)
  6. Restrições de plataforma/entrega? (tamanho do arquivo · prazo · onde será reproduzido)

Portão: todos os seis capturados. Se a resposta for 9:16 + rosto (face-cam), planeje transferir para /short-form-video no Portão 5.

Banco de perguntas completo: Read: references/interview-questions.md


Portão 2 · Roteiro e voz

  1. Fonte do roteiro? (colar · esboço → eu redijo · eu gravo · TTS a partir de texto · sem narração)
  2. Se TTS: preferência de voz. Ofereça opções de npx hyperframes tts --help. Capture também o ritmo. hyperframes tts (Kokoro) é apenas inglês - narração em vietnamita passa pelo /api/tts (Gemini TTS ou VieNeu) do sistema.
  3. Se rosto (face-cam): caminho da gravação · posicionamento em tela cheia ou canto · precisa de transcrição? (npx hyperframes transcribe <file> --model small.en --json - apenas inglês; para vietnamita use faster-whisper conforme a skill noti-tiktok-vn)
  4. Legendas? (desligado · hype · corporativo · karaokê-palavra-por-palavra · minimalista)

Portão: roteiro capturado (ou redigido), plano de áudio capturado, plano de legendas capturado.


Portão 3 · Coleta de estilo

Antes de perguntar qualquer coisa ao usuário, faça um inventário dos ativos existentes. Verifique <workspace-root>/assets/ e qualquer pasta assets/ do projeto. Não pergunte pelo que já está lá.

Depois pergunte progressivamente - eles não precisam de respostas para tudo:

  1. Guia de estilo ou documento de marca? (colar/caminho · não)
  2. Paleta de cores? (códigos hex · nenhum - usar padrões do MOTION_PHILOSOPHY)
  3. Fontes? (nome(s) do Google Fonts · caminhos de arquivo · nenhum - usar padrões Inter + JetBrains Mono)
  4. Arquivo de logotipo? (caminho · nenhum). Se uma marca for nomeada, mas nenhum arquivo for fornecido: procure em assets/brand-logos/, ou busque com POST /api/brand-logos {"name":"..."} - uma marca de texto (wordmark) é permitida SOMENTE após um 404 BRAND_LOGO_NOT_FOUND. Nunca desenhe ou gere um logotipo.
  5. Vídeos de referência para o estilo? (URLs/caminhos · nenhum)
  6. Outros ativos? (capturas de tela · fotos do produto · b-roll · música - liste os caminhos)
  7. Estética MOTION_PHILOSOPHY (tela preta · texto cromado · grade de perspectiva · transições de whip) ou um estilo diferente?
  8. Ritmo? (cinético 1–2s · equilibrado 2–3s · relaxado 3–5s)
  9. Música? (nenhuma · pad ambiente 0.15 · base musical 0.4 · completa 0.8 - caminho do arquivo se eles tiverem um)
  10. Texto de encerramento / call-to-action?

Nunca imponha uma marca ao usuário. Recorra aos padrões do MOTION_PHILOSOPHY apenas quando eles declinarem explicitamente fornecer um estilo.

Fluxo de estilo completo + padrões MOTION_PHILOSOPHY: Read: references/style-intake.md


Portão 4 · Síntese do resumo (PORTÃO DURO antes da construção)

  1. Leia MOTION_PHILOSOPHY.md se existir na raiz do workspace - obrigatório se presente. Se estiver faltando, prossiga com os padrões em references/style-intake.md e anote a ausência no resumo.
  2. Pergunte onde os projetos ficam se não for óbvio:
    • Se video-projects/ existir → use video-projects/<slug>/
    • Caso contrário → pergunte ao usuário
  3. Escreva <project-folder>/BRIEF.md:
    • slug · intenção · público · dimensões · fps · duração
    • roteiro (completo ou esboço)
    • escolha de voz · plano de legendas · plano de rosto (face-cam)
    • perfil de estilo: paleta (hex), fontes, caminho do logotipo, vídeos de referência
    • ritmo
    • inventário de ativos com caminhos
    • texto de encerramento / CTA
  4. Mostre o resumo. AGUARDE aprovação explícita. Não prossiga para o Portão 5 sem um claro "sim, construa."

Portão 5 · Scaffolding e storyboard

Verificação de transferência primeiro

Se o resumo descrever um vídeo vertical 9:16 com rosto (talking-head) + sobreposições de cena, invoque /short-form-video AGORA e entregue o resumo. O scaffolding de 4 camadas dele é feito sob medida para esse formato.

Caso contrário, continue:

Scaffolding

  1. mkdir <project-folder>
  2. Se existir um projeto irmão com formato semelhante, ofereça copiar o hyperframes.json + meta.json dele como modelo. Caso contrário, de dentro da pasta: npx hyperframes init
  3. Edite meta.json com o slug, dimensões e fps do usuário.
  4. Copie os ativos fornecidos para <project-folder>/assets/.
  5. Crie <project-folder>/assets/style-profile.md a partir do Portão 3 - fonte única da verdade para paleta/fontes/logotipo.

Storyboard

Gere <project-folder>/STORYBOARD.md usando o modelo em references/storyboard-template.md. Cada batida recebe:

Batida N - TÍTULO (início–fim, duração) - Conceito em uma frase
Elementos visuais: [cada elemento, tamanho, animação, temporização]
Linguagem de movimento: [tipo de movimento]
Eases usados: [3–4 eases GSAP distintos]
Saída: [transição para a próxima batida]
Áudio: [linha de VO / SFX / camada de música]

Topo do arquivo: uma tabela de temporização com cena · início · duração · arquivo de composição.

Proponha uma estrutura de regra de três:

  • Ato 1 (gancho) ≈ 20% da duração
  • Ato 2 (corpo) ≈ 55%
  • Ato 3 (recompensa + encerramento com pausa de 4–6 segundos) ≈ 25%

(MOTION_PHILOSOPHY §0 Lei 9, §1.)

Mapeie intenções do usuário para blocos do catálogo: Read: references/catalog-intent-map.md

Portão: mostre o storyboard + tabela de temporização. Itere até o usuário aprovar.


Portão 6 · Construir composições

Invoque /hyperframes para regras do framework. Esta skill é dona do scaffolding e da disciplina; /hyperframes aplica as regras.

Scaffolding de cada sub-composição

<div data-composition-id="scene-name" data-start="..." data-duration="...">
  <style>[data-composition-id="scene-name"] { /* escopado */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... tweens ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // âncora - MOTION_PHILOSOPHY Lei 11
      window.__timelines["scene-name"] = tl;
    })();
  </script>
</div>

Boilerplate completo + padrão de legendas + padrão de fundo ambiente: Read: references/composition-scaffold.md

Regras de construção

  • Fundo ambiente em data-track-index="0" durante toda a duração da composição.
  • Aberturas de texto cinético: espaçamento por palavra de 0.06–0.10s.
  • Legendas como irmãos de nível de corpo da composição raiz em index.html, cada uma com data-track-index ≥ 20. Nunca dentro das linhas do tempo das cenas (MOTION_PHILOSOPHY §3.13).
  • Blocos do catálogo instalados via npx hyperframes add <name>. Imediatamente escope o CSS do bloco para [data-composition-id="..."] - blocos do catálogo vêm com regras html, body { ... } que vazam para o documento pai quando carregados como sub-composições.
  • Vertical + rosto (face-cam): envolva o rosto nativo 1920×1080 em uma transformação (translate + scale) para modo metade inferior ou tela cheia. (Se você acabar aqui em vez de /short-form-video, considere fortemente a transferência.)
  • Aplique SOMENTE o que o usuário forneceu. A paleta deles, as fontes deles, o logotipo deles. Não injete mais nada. Se eles escolheram os padrões do MOTION_PHILOSOPHY, pegue a paleta + par de fontes de references/style-intake.md.

Determinismo

Sem Math.random(), sem Date.now(), sem fetch() em tempo de renderização. Use PRNGs com semente ou hashes harmônicos seno (MOTION_PHILOSOPHY §3.10).


Portão 7 · Lint → Pré-visualização no Studio (PORTÃO DE PRÉ-VISUALIZAÇÃO 1 - OBRIGATÓRIO)

  1. npx hyperframes lint - corrija todos os erros, trie os avisos.
  2. npx hyperframes preview em segundo plano.
  3. Aguarde "Studio running" em http://localhost:3002.
  4. Entregue ao usuário a URL mais as URLs de composição individuais (http://localhost:3002/?comp=<id>). Se o projeto tiver blocos de shader WebGL, comece com as URLs individuais - a fallback de software WebGL pode travar a composição mestre.
  5. AGUARDE explícito "parece bom, renderize um rascunho" antes de prosseguir. Silêncio não é aprovação.

Hot reload está ligado - as edições aparecem ao vivo.


Portão 8 · Renderização de rascunho → Verificação visual → Pré-visualização MP4 → Final

Renderização de rascunho

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

Verificação visual (OBRIGATÓRIA antes da entrega)

Lint passando ≠ design funcionando. Extraia quadros e veja-os.

  1. mkdir -p renders/frames
  2. Para cada momento herói de batida E cada transição:
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. Chame a ferramenta Read em cada PNG. A ferramenta Read carrega a imagem no contexto - não apenas liste nomes de arquivos.
  4. Confirme por quadro: sem rostos cortados, modo de rosto correto por cena, texto legível e na paleta, sem estouro, transições aterrissam nas palavras pretendidas, sem quadros em branco.
  5. Se algo estiver errado: corrija → re-renderize → re-verifique. Nunca envie um rascunho quebrado.

Pré-visualização MP4 (PORTÃO DE PRÉ-VISUALIZAÇÃO 2 - OBRIGATÓRIO)

npx serve renders -p 8080 -n

NÃO use o http.server do Python - ele não suporta requisições HTTP Range, então o scrub (avanço/retrocesso) quebra.

Entregue ao usuário http://localhost:8080/<slug>-draft.mp4. AGUARDE autorização explícita sobre a reprodução e sincronia de áudio.

Renderização final

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

No pipeline AI Edit Video este NÃO é o fim: continue com a skill video-pipeline (QC → montar final via fila de renderização → outputs/<id>-v<N>.mp4 → atualizar meta.json → miniatura/publicar). Uso independente fora do pipeline: reporte o caminho de saída. Pronto.

Lista de verificação completa de pré-voo e pré-entrega: Read: references/build-checklist.md


Inegociáveis (estruturais - não amenize)

  • NÃO pule o PORTÃO DE PRÉ-VISUALIZAÇÃO 1 (Studio) ou o PORTÃO DE PRÉ-VISUALIZAÇÃO 2 (MP4 renderizado). Dois portões por construção, sempre.
  • NÃO afirme que uma renderização está concluída até que os quadros tenham sido extraídos E lidos via a ferramenta Read.
  • NÃO construa em nenhum outro lugar que não seja uma pasta de projeto dedicada. Nunca coloque index.html na raiz do workspace.
  • NÃO peça ativos ao usuário antes de inventariar o workspace dele.
  • NÃO pule o tween âncora tl.to({}, { duration: SLOT_DURATION }, 0) no final de cada linha do tempo de sub-composição. MOTION_PHILOSOPHY Lei 11.
  • NÃO use Math.random() / Date.now() dentro da lógica de renderização. Apenas hashes com semente.
  • NÃO adicione class="clip" a tags <video>. Isso as quebra.
  • NÃO imponha uma marca ao usuário. Pergunte primeiro; recorra aos padrões do MOTION_PHILOSOPHY apenas quando eles declinarem explicitamente.

Referências

  • references/interview-questions.md - banco de perguntas completo por Portão
  • references/style-intake.md - entrevista de estilo + padrões MOTION_PHILOSOPHY
  • references/catalog-intent-map.md - "usuário diz X → instale Y"
  • references/storyboard-template.md - modelo batida por batida + exemplo prático
  • references/composition-scaffold.md - estilos escopados + boilerplate GSAP IIFE
  • references/build-checklist.md - portões de pré-voo e pré-entrega

Externas (nível de workspace):

  • MOTION_PHILOSOPHY.md - a única referência externa que esta skill assume que existe. Linha de base estética. A fallback reside em references/style-intake.md se o arquivo estiver faltando.

Skills relacionadas

  • /hyperframes - regras do framework, invocar no Portão 6
  • /hyperframes-cli - init · lint · preview · render · transcribe · tts
  • /hyperframes-registry - instalando blocos do catálogo
  • /gsap - referência de animação GSAP
  • /short-form-video - transferir no Portão 5 para formato 9:16 com rosto (talking-head)
  • /website-to-hyperframes - transferir no Portão 1 se a entrada inicial for uma URL

Habilidades Relacionadas