aguspranyoto/2d-animation-hyperframes

---

name: 2d-animation-hyperframes description: Transforme um roteiro de narração com marcações emocionais (script.txt com tags como [animado], [curioso]) e sua narração em uma animação educacional 2D consistente no HyperFrames, usando as referências visuais do projeto. Estilo: 2D plano, fundo branco dominante com linhas de esboço desbotadas, apenas o assunto principal e o texto em cores vivas. Não redija narração a menos que solicitado explicitamente. Também abrange efeitos sonoros: onde colocá-los, como recuperá-los ou sintetizá-los e como conectá-los à linha do tempo.

Animação 2D HyperFrames

Use esta skill para criar um vídeo animado a partir do roteiro de narração aprovado e da fonte de tempo fornecidos pelo usuário. A entrada normal é vo.mp3 mais script.txt (narração com marcações emocionais), com referências visuais em references/visual-style/overall/.

Exemplo de gatilho:

/2d-animation-hyperframes Crie um vídeo animado 2D usando vo.mp3 e script.txt. Siga as referências visuais em references/visual-style/overall/.

O roteiro e o áudio do usuário são a fonte da verdade. Não gaste tokens redigindo um novo roteiro, reescrevendo a narração ou gerando uma narração substituta, a menos que o usuário peça explicitamente. As tags emocionais são instruções de entrega, não palavras faladas: mantenha-as exatamente como estão e nunca as leia ou coloque legendas. Se os arquivos solicitados estiverem ausentes ou ambíguos, pergunte pela localização deles; não substitua por um roteiro recém-escrito.

O público padrão são crianças indonésias do jardim de infância (TK) ao ensino fundamental (SD). Mantenha a narrativa visual clara, acolhedora e adequada à idade. Mantenha toda a animação em 2D.

Entradas, formato do roteiro e temporização

Encontre os arquivos anexados à solicitação ou no projeto ativo. Use os caminhos fornecidos quando especificados. Se os arquivos não estiverem no projeto, pergunte onde encontrá-los antes de iniciar a produção. As fontes residem no layout do espaço de trabalho descrito em references/multi-video.md: a narração e a locução estão em inputs/<slug>/, o projeto HyperFrames é gerado em videos/<slug>/ e as referências visuais compartilhadas estão na raiz do espaço de trabalho (references/visual-style/overall/).

Formato de script.txt: uma linha contendo apenas uma tag emocional entre colchetes (por exemplo [animado], [curioso], [brincalhão]) define a entrega para o bloco de narração que se segue, até a próxima tag. Linhas em branco separam blocos apenas para legibilidade; elas não implicam pausas. Exemplo:

[animado]
Adik-adik, pernah nggak sih kalian melihat jerapah?

[curioso]
Wah, lehernya panjang sekali, ya!

Regras para as tags:

• Uma tag se aplica a todo o bloco de narração subsequente. Use-a para conduzir a batida da cena, expressão do personagem, ritmo e ênfase visual.
• Nunca fale, coloque legendas ou renderize as tags. Remova-as antes de produzir texto na tela.
• Mantenha as tags exatamente como foram escritas. Se a narração foi gerada pelo ElevenLabs, as mesmas tags foram as instruções de entrega; não normalize nem invente novas.
• Tags não reconhecidas ainda são dicas de entrega; passe adiante em vez de descartá-las.

Fonte de temporização, em ordem de prioridade:

1. Se o usuário também fornecer uma exportação de timestamps de palavras/segmentos (JSON do ElevenLabs) para o mesmo áudio, use-a; é opcional, não obrigatória.
2. Caso contrário, derive a temporização no nível da palavra a partir de vo.mp3: transcreva/alinhe o áudio fornecido com o texto de script.txt (por exemplo, timestamps de palavras do ElevenLabs Scribe ou o payload de timestamp retornado quando o TTS produziu o áudio).
3. Se vo.mp3 estiver faltando, peça-o. Não sintetize uma narração substituta a menos que o usuário peça.

Antes de animar:

1. Verifique se cada bloco do roteiro corresponde a um segmento no áudio e se a fonte de temporização cobre toda a duração de vo.mp3, incluindo qualquer deslocamento inicial ou pausas.
2. Confirme se o texto do roteiro corresponde ao áudio fornecido. Não edite a narração. Se texto, áudio e temporizações entrarem em conflito, explique a incompatibilidade e peça arquivos corrigidos.
3. Use blocos de tags emocionais (e limites de segmento se uma exportação de timestamp for fornecida) para batidas da história e mudanças de cena. Use timestamps de palavras para legendas, ênfase e pequenas dicas visuais. Agrupe palavras em frases significativas em vez de transformar cada palavra em uma cena separada.

Construa o estilo visual 2D

Palavra-chave de estilo padrão para cada cena:

2D plano, fundo branco dominante com linhas de esboço desbotadas. Apenas o assunto principal e o texto estão em cores vivas.

Inspecione todas as imagens utilizáveis em references/visual-style/overall/ juntas antes de projetar as cenas. Trate-as como a fonte da verdade para a identidade visual deste projeto. Extraia um guia de estilo compacto cobrindo:

• paleta, saturação, contraste, iluminação e brilho;
• linguagem das formas, espessura de linha, textura e densidade de detalhes;
• proporções de personagens, expressões e características de design recorrentes;
• composição e como a arte 2D plana sugere profundidade;
• tipografia, animação de texto, ritmo, transições e motivos visuais.

Aplique um guia de estilo consistente a cada cena e novo ativo. Se as referências entrarem em conflito, siga a direção mais repetida ou aprovada mais recentemente; pergunte apenas se o conflito alteraria materialmente o resultado. Mantenha o resultado em 2D: use camadas, paralaxe, sobreposição, escala, sombras e gradientes para profundidade. Não transforme em modelos 3D ou aparência renderizada em 3D, a menos que o usuário peça.

Fluxo de produção no HyperFrames

1. Use o HyperFrames como framework de animação e renderização. Trabalhe na pasta do projeto de vídeo ativo do usuário e preserve seus ativos e referências.
2. Planeje as cenas em torno da narração aprovada, blocos de tags emocionais e temporizações de palavras. Mantenha a narração inalterada; alinhe as ações visuais e legendas à linha do tempo do áudio. Coloque música e efeitos sonoros em pausas ou em níveis que não mascarem a fala.
3. Construa uma curta cena de teste 2D usando o vo.mp3, script.txt e referências visuais reais. Visualize-a e verifique a consistência do estilo, legibilidade e sincronização no início da fala, pausas, transições e final.
4. Faça revisões direcionadas com base na visualização e, em seguida, estenda a linguagem visual aprovada para todo o vídeo. Não crie a animação completa antes que a cena de teste seja revisada.
5. Execute a visualização do HyperFrames a partir da pasta do projeto (npx hyperframes preview). Isso abre o HyperFrames Studio baseado em navegador e recarrega automaticamente as alterações de arquivo. O aplicativo separado do Studio para desktop é opcional para este fluxo de trabalho CLI.
6. Renderize o projeto aprovado para MP4 com o fluxo de trabalho CLI atual do HyperFrames. Relate o caminho de saída e quaisquer limitações de produção. Não afirme que uma visualização é um vídeo final renderizado.

Use as instruções de criação do HyperFrames instaladas, se disponíveis. Se a configuração ou dependências estiverem faltando, explique a etapa exata que está faltando. Não instale software nem altere configurações globais sem a autorização do usuário.

Iniciando um novo vídeo

Gere o projeto HyperFrames a partir da raiz do espaço de trabalho em vez de criar o esqueleto manualmente; um projeto por vídeo.

python tools/new-video.py <slug>                    # criar esqueleto + transcrever + mapeamento de blocos
python tools/new-video.py <slug> --force            # reconstruir um videos/<slug> existente
python tools/new-video.py <slug> --no-transcribe    # apenas criar esqueleto

Isso lê inputs/<slug>/ (vo.mp3 + script.txt) e escreve videos/<slug>/, em seguida, imprime uma linha por bloco marcado com duração de início e fim absolutas e locais. O layout completo, saídas e etapas pós-geração estão em references/multi-video.md.

Efeitos sonoros

Efeitos sonoros (SFX) ficam sob a narração, nunca sobre ela. Coloque um acento em cada batida visual (aparecimento de elemento, corte, punchline, revelação) — não em toda legenda. Deixe silêncio entre as dicas.

• Rota padrão: recupere efeitos CC0/CC BY através da skill media-use (Openverse, ou sua biblioteca integrada de 21 arquivos em audio/assets/sfx/ dessa skill). Nunca gere quando um efeito pronto corresponder.
• Rota personalizada: sintetize uma família consistente com Python (numpy + stdlib wave, 44.1 kHz mono 16-bit, pico normalizado 0.7, ruído com semente). Receitas para pop, boing, whoosh, chime, stamp e sparkle estão em references/sfx.md.
• Conecte cada dica como um <audio> temporizado na composição raiz: id único, data-start em segundos absolutos, data-duration igual ao comprimento do arquivo, data-volume 0.22–0.38 e um data-track-index que não se sobreponha a outro clipe audível.
• npm run check deve relatar 0 erros e nenhum aviso de clip_ends_past_root_duration ou duplicate_audio_track antes de renderizar.

Escopo

Esta skill cria a animação a partir da mídia fornecida; ela normalmente não cria ou revisa narração. Se o usuário pedir apenas um storyboard ou plano visual, forneça isso com base no mesmo áudio e script.txt sem redigir um roteiro. Se o usuário pedir explicitamente por escrita de roteiro, trate essa solicitação separadamente e obtenha aprovação antes de gerar uma nova narração ou substituir o áudio existente.