Communitygithub.com

remotion-shorts-skill

Mostra a um agente como planejar, construir ou editar um 'remotion shorts skill' para que o resultado concreto seja um vídeo finalizado. O procedimento percorre a habilidade Remotion Shorts, 0. Configuração (uma vez por máquina), 1. Pergunte o que você precisa (uma mensagem, pule o que já é conhecido). Use-a quando uma nova tarefa exigir essa arte.

O que é remotion-shorts-skill?

Esta skill capacita um agente de IA a criar vídeos curtos no formato Shorts (TikTok, Reels, YouTube Shorts) usando um modelo Remotion predefinido, sem exigir que o agente escreva código Remotion para cada vídeo. O agente escreve um script em JSON definindo cenas, cada uma com um tipo (gancho, estatística, lista, final) e opções de texto, tema, áudio e destino. A skill lida com a configuração única do projeto, verificação visual via stills, renderização do MP4 e postagem via WoopSocial, incluindo tratamento de bordas como texto longo, fontes ausentes para RTL/CJK, e conformidade com licenças. O processo prioriza informações factuais, com fontes citadas, e garante que cada vídeo tenha um foco claro, evitando conteúdo inautêntico. Suporta macOS, Windows e Linux, requer Node 20+ e cerca de 400 MB de downloads iniciais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SadiTLM/agentic-reels-studio/tree/HEAD/skills/remotion-shorts-skill

Perguntar na sua IA favorita

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

Documentação

Habilidade Remotion Shorts

Você escreve um short como um arquivo JSON de cenas. O projeto Remotion empacotado organiza as palavras, cronometra cada cena com base na velocidade de leitura, mantém o texto dentro da área que nenhum botão do aplicativo cobre, renderiza uma folha de revisão, uma capa e o MP4, e o usuário pode publicá-lo com o WoopSocial.

Você não escreve código Remotion para cada vídeo. Os modelos são fixos e testados; seu trabalho é o roteiro: o que cada tela diz, em que ordem e com que velocidade.

0. Configuração (uma vez por máquina)

Requer Node 20 ou mais recente. Verifique com node -v; se estiver faltando, envie o usuário para https://nodejs.org. O Remotion suporta macOS 15 ou mais recente, Windows x64 e Linux com glibc 2.35+ (Ubuntu 22.04, Debian 12 ou mais recente).

node <skill-dir>/scripts/setup.mjs remotion-shorts

Isso copia o projeto para ./remotion-shorts, instala pacotes fixados (cerca de 260 MB) e baixa o navegador headless com o qual o Remotion renderiza (100 a 150 MB). Leva de 1 a 3 minutos na primeira vez. Execute novamente após a skill ser atualizada: ele atualiza os arquivos de modelo (quaisquer que o usuário tenha alterado são mantidos como .bak) e nunca toca nos scripts, ativos ou saída do usuário.

Licença. O Remotion é gratuito para indivíduos e para empresas de até 3 pessoas. Empresas de 4 ou mais pessoas precisam de uma licença empresarial do Remotion, e renderizar a partir de scripts conta como automação (remotion.pro/license). Se o usuário estiver renderizando para uma empresa maior, avise-o uma vez, claramente, antes da primeira renderização.

1. Pergunte o que você precisa (uma mensagem, pule o que já é conhecido)

  • O material. Um tópico, artigo, URL, anotações, dados, changelog ou lista. Você só escreve fatos aos quais pode se referir. Se o usuário fornecer um tópico sem fonte, encontre uma fonte primária (estatísticas oficiais, documentação, o changelog do próprio produto) e nomeie-a.
  • Para quem é e o único aprendizado. Um short diz uma coisa.
  • Aparência. Um tema (ink, paper, volt, ocean, clean) ou as cores da marca do usuário, e um handle para a tela final.
  • Áudio. Efeitos sonoros embutidos estão ativados por padrão (um impacto no gancho, um whoosh em cada corte, um pop nos destaques, ticks em contagens); eles são feitos para este modelo e são seguros em todos os apps. Música apenas de um arquivo para o qual o usuário tenha os direitos de uso (veja references/writing-shorts.md para saber por que nenhuma biblioteca gratuita é segura em todos os três apps).
  • Onde será publicado. TikTok, Reels, Shorts ou todos os três.

2. Escreva o roteiro

Leia references/writing-shorts.md antes do primeiro roteiro de uma sessão. A versão resumida:

  • A cena 1 é um gancho que declara o benefício em cerca de 10 palavras ou menos: um número, uma afirmação ou a promessa de uma lista ("5 ferramentas gratuitas que substituem..."). Ela aparece completamente na tela a partir do quadro 0. Se o gancho tiver um número, coloque-o em big para que seja a primeira coisa que o olho veja.
  • Uma ideia por cena. Uma cena é um batimento, não um parágrafo. Cenas de estatística carregam um número e o que ele significa. Itens de lista contam para baixo ou para cima; diga qual no gancho.
  • Informação real em cada cena. Um vídeo de texto modelado sem nada de novo é o que o YouTube chama de conteúdo inautêntico e o Instagram chama de não original. Nunca enrole.
  • Os números são exatos e com fonte. Coloque a fonte no footer ("Dados: USGS"). Nunca arredonde um número para uma afirmação diferente.
  • Termine com uma ação ou uma linha que leve de volta ao gancho para que o loop pareça contínuo. Nem "obrigado por assistir".
  • Duração: 15 a 45 segundos é o alvo; o renderizador avisa após 59.

Escreva short.json na pasta do projeto. O formato completo, cada tipo de cena e cada opção está em references/short-json.md. Um roteiro mínimo:

{
  "theme": "ink",
  "footer": "Dados: USGS",
  "handle": "@seudousuario",
  "scenes": [
    { "type": "hook", "big": "2,5%", "text": "da água da Terra é doce" },
    { "type": "stat", "value": "96,5", "suffix": "%", "label": "é água salgada nos oceanos" },
    { "type": "stat", "value": "68,7", "suffix": "%", "label": "da água doce é gelo e geleiras", "highlight": "gelo e geleiras" },
    { "type": "end", "text": "Salve isso para a noite de trivia", "highlight": "Salve isso" }
  ]
}

3. Verifique antes de renderizar o vídeo

cd remotion-shorts
node render.mjs short.json --stills

Em poucos segundos, isso imprime o plano (segundos e tamanho da fonte por cena) e escreve:

  • out/short/sheet.jpg: o último quadro de cada cena (tudo na tela), com as áreas da zona segura marcadas com uma linha tracejada fina (o texto deve ficar dentro dela).
  • out/short/cuts.jpg: quadro 0 e os quadros ao redor de cada corte, para verificar o movimento.
  • out/short/cover.jpg: o gancho depois de totalmente exibido (faça upload como capa do Reels).
  • out/short/report.json: tempos, quebras de linha e avisos.

Abra ambas as folhas e examine-as. Verifique: cada cena é legível no tamanho de um celular, cada uma diz uma coisa, os destaques estão nas palavras que importam, algo parece apertado, a ordem está correta e o quadro 0 mostra o gancho completo. Corrija o JSON e execute --stills novamente até que você o publicaria.

Avisos interrompem a renderização do vídeo (código de saída 2): texto muito longo para uma tela, um gancho muito longo, um destaque que não está no texto, uma cena muito rápida para ler, um ritmo fora de 0,85 a 1,25 ou um short com mais de 59 segundos. Corrija o roteiro; use --force apenas quando o usuário tiver visto o aviso e quiser ignorá-lo. Alguns problemas são erros que --force não pode substituir, como uma palavra muito larga para a tela em qualquer tamanho: esses colocariam o texto fora da tela.

4. Renderize

node render.mjs short.json

Escreve out/short/short.mp4: 1080x1920, 30 qps, H.264, yuv420p, AAC (uma faixa silenciosa quando não há música), que TikTok, Reels e Shorts aceitam. Um short de 30 segundos renderiza em cerca de um minuto em um laptop recente. Máquinas com 8 GB de memória renderizam 2 quadros por vez; se uma renderização ainda for morta por falta de memória, execute-a novamente com --concurrency 1.

Antes de mostrá-lo, capture três quadros e examine-os (início, meio, fim) ou reproduza-o se seu cliente puder. Em seguida, mostre ao usuário a capa, a folha e o caminho do MP4.

Várias contas: nunca publique o mesmo arquivo em muitas contas. Faça uma variante por conta (um gancho, tema ou ordem de cena diferentes, salvo como seu próprio JSON) para que não haja duas contas publicando um quase-duplicado.

5. Publique (WoopSocial, com confirmação)

Leia references/woopsocial.md. Em resumo:

  1. social_accounts_list para encontrar as contas (conecte-as primeiro, se necessário).
  2. Para TikTok, social_accounts_get_platform_inputs para a conta: as opções de privacidade e o vídeo mais longo que ela permite. O usuário escolhe a privacidade; não há padrão.
  3. Upload: media_uploads_create_session com o tamanho exato em bytes de report.json, salve a resposta como session.json, execute node upload.mjs session.json out/short/short.mp4, depois media_uploads_complete_session até que esteja READY.
  4. Escreva a legenda por plataforma (TikTok e Reels: uma linha que complemente o vídeo mais 3 a 5 hashtags específicas; YouTube: um título com menos de 100 caracteres mais uma descrição). Use contentOverride para texto por plataforma.
  5. posts_validate, depois mostre ao usuário: contas, legenda por plataforma, privacidade, horário agendado com fuso horário, a capa. Aguarde um sim claro. Depois posts_create e posts_get.

Campos de divulgação: isYourBrand: true no TikTok quando o short promove o produto do próprio usuário; isAiGeneratedContent apenas para imagens, vídeo ou voz realistas de IA (texto cinético não precisa disso). madeForKids do YouTube é uma declaração legal: pergunte, nunca adivinhe.

6. Relate de volta

Mostre: o caminho do MP4, duração, a folha, onde foi publicado (links de posts_get) ou o agendamento, e tudo que você não pôde fazer. Nunca invente visualizações ou resultados; leia-os posteriormente com social_account_posts_list e relate a data em que foram coletados.

Editando a aparência

  • Cores da marca: passe theme como um objeto (bg, fg, accent, accentText, font, uppercase). Mantenha o contraste do texto em 7:1 ou melhor; verifique o destaque no fundo também.
  • Fotos ou vídeo atrás das cenas: image por cena ou background para o short inteiro. Eles são escurecidos sob a cor do tema para que o texto permaneça legível. Use arquivos que o usuário possui ou tem uma licença e dê os créditos na legenda quando a licença exigir.
  • Fontes incluídas: Anton (condensada, maiúscula, chamativa), Poppins, Inter. Todas OFL.
  • Para alterar os próprios modelos, edite src/Short.tsx e visualize com npm run studio.

Casos extremos

  • Sem fonte para um número: não o use. Diga o que está faltando.
  • Texto que não cabe: divida a cena; não reduza a fonte abaixo do mínimo (o renderizador não permitirá).
  • Texto RTL ou CJK, ou emoji: as fontes incluídas não os cobrem e eles podem aparecer como caixas vazias. Avise isso e deixe-os de fora (emoji pode ir na legenda).
  • Usuário quer um som trending: postagens de API não podem adicionar um. Publique no TikTok com postMode: MEDIA_UPLOAD para que ele caia na caixa de entrada do TikTok do usuário para ser finalizado no aplicativo.
  • Renderização falha no Linux com bibliotecas ausentes: instale os pacotes listados em references/platform-specs.md.
  • Windows: sempre passe propriedades no arquivo JSON, nunca inline na linha de comando.

Barra de qualidade

Antes de considerar concluído, deve atender a todos estes:

  • O quadro 0 mostra o gancho completo (verifique cuts.jpg); cerca de 10 palavras ou menos, declarando o benefício.
  • Cada cena diz uma coisa; nenhuma cena com mais de cerca de 14 palavras.
  • Cada número corresponde à sua fonte; a fonte está na tela ou na legenda.
  • Nenhum aviso, ou o usuário os viu e escolheu --force.
  • Ambas as folhas verificadas: nenhum texto fora da linha tracejada segura, destaques nas palavras certas.
  • 15 a 59 segundos.
  • Uma versão distinta para cada conta.
  • O usuário confirmou antes de qualquer coisa ser publicada.

Habilidades Relacionadas