Communitygithub.com

gerador-de-reels

A entrevista antes de qualquer vídeo ser construído. Lê o material existente e faz perguntas em rodadas numeradas, encerrando com um brief de uma tela e um storyboard, sem construir nada até a pessoa dizer 'sim'.

O que é gerador-de-reels?

Este skill transforma a criação de vídeos em um processo estruturado de entrevista, evitando erros comuns como escolher a proporção errada ou um visual que o cliente considera barato. Ele começa analisando o material já disponível — texto, links, CV, arquivos de marca — e, em seguida, conduz o usuário por até 5 rodadas de perguntas numeradas, cada uma com uma resposta recomendada marcada com ★ e uma breve justificativa. As perguntas cobrem propósito, formato (plataforma, proporção, layout, duração, som), material e história, e o visual final, guardrails e método de revisão. Ao final, gera um brief em uma única tela, dividido entre 'Você disse' e 'Eu presumi', junto com um storyboard em tabela, e só constrói o vídeo após confirmação explícita. Ideal para uso com agentes como Claude Code, Cursor ou Codex, este skill reduz retrabalho e garante que o vídeo final atenda exatamente às necessidades do cliente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thativanng/reels-maker/tree/HEAD/skills/reel-intake

Perguntar na sua IA favorita

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

Documentação

reel-intake: pergunte antes de construir

Onde o kit vive: execute todos os comandos deste skill na pasta reels-maker (o clone de github.com/thativanng/reels-maker que contém template/ e tools/). Se o projeto não tiver uma, configure-a primeiro seguindo o SETUP.md desse repositório.

A regra: nada é construído (sem visual, sem quadro) até que a pessoa diga sim ao brief e ao seu storyboard. Os erros caros em um vídeo construído por código raramente são de tempo; são respostas que ninguém pediu. O verdadeiro propósito só aparece depois que o roteiro está escrito. A proporção acaba sendo errada para a plataforma. O visual acaba sendo um que a pessoa considera barato. Cada um desses custa uma reconstrução; uma pergunta custa uma linha.

0 · Olhe antes de perguntar

Leia tudo que já está em mãos e nunca pergunte o que você pode consultar:

  • o pedido em si, qualquer texto-fonte, links, um CV, o site ou perfil da pessoa
  • arquivos de marca (cores, fontes, logotipo) no projeto
  • .reels/looks-log.md, se existir (a memória de looks passados do reel-style)

Um campo que o material responde é preenchido e marcado como "do seu CV", "do seu site" etc. Um palpite não é uma resposta: um palpite vai para o brief em "Eu presumi", onde a pessoa pode vê-lo e corrigi-lo.

1 · Como perguntar

  • Rodadas, não um formulário nem um gotejamento. Uma rodada = um bloco abaixo, em uma mensagem. Numere cada pergunta. Marque a resposta recomendada com ★ e dê um motivo de uma linha.
  • Fatos ganham opções (plataforma, duração, som). Campos criativos ganham uma sugestão redigida para editar, nunca um campo em branco: "A única coisa que o espectador deve lembrar: ★ 'Uma previsão é um palpite; o estoque de segurança cobre as surpresas.' Mantenha, edite ou substitua?"
  • Uma pergunta que depende de uma resposta anterior vem pré-preenchida a partir dela (a proporção segue a plataforma), ou espera a próxima rodada.
  • Atalhos que a pessoa pode digitar: defaults aceita cada ★ na rodada. just build it encerra a entrevista: todo campo aberto se torna uma decisão declarada no brief, com seu motivo.
  • Quatro rodadas é o normal, cinco é o limite. Pare assim que todos os campos obrigatórios forem respondidos ou assumidos como padrão.

2 · As rodadas (o banco completo de perguntas, com opções e padrões, está em references/rounds.md)

Rodada 1 · Propósito (obrigatório)

  1. Sobre o que é? (apenas se nenhuma fonte foi fornecida)
  2. A única coisa que o espectador deve lembrar (redigida para eles; para um pedido vago, ofereça 2–3 redações)
  3. Quem é o ÚNICO espectador? (um recrutador, um cliente, colegas da área, estranhos de fora)
  4. O que esse espectador deve fazer depois de assistir? (seguir · comentar · tocar no link · salvar ou enviar · apenas lembrar)

Rodada 2 · Formato (obrigatório, todos os seis, nesta ordem; fatos e zonas de segurança estão em references/platforms.md)

  1. Onde é postado primeiro? A primeira plataforma é a principal; as demais se tornam versões reduzidas.
  2. Reel ou vídeo? Pergunte apenas onde a plataforma tem ambos (LinkedIn, X, YouTube, Facebook).
  3. Proporção, padronizada a partir da plataforma: Reels, TikTok e Shorts → 9:16; LinkedIn → 4:5; YouTube → 16:9.
  4. Layout: ★ deixe o reel-style mostrar três, ou nomeie um se eles já souberem (isso então vincula os três looks). Informe a zona de segurança; não pergunte sobre ela. Em Reels, TikTok e Shorts orgânicos, as palavras ficam na faixa central (prática interna, não um número da plataforma): o app cobre o quarto inferior e a barra de botões à direita. Um reel impulsionado ou pago mantém os 35% inferiores limpos (guia de anúncios do Meta); use as chaves de plataforma -ads.
  5. Duração: um limite rígido, ou segue o conteúdo? Mostre os limites oficiais da plataforma ao lado.
  6. Som: funciona mudo e melhor com som (★ padrão) · liderado pelo som · seguro para mudo. Depois, narração, música e estilo de legenda.

Rodada 3 · Material e história (pergunte o que se aplica)

  • O que já existe: capturas de tela, gravações, fotos, filmagens deles, logotipo, dados, ou nada. Material faltante se torna um marcador rotulado, nunca algo falso.
  • Cada número: medido, uma meta, ou ilustrativo, e de onde vem. Nunca invente um.
  • Quem escreve as palavras na tela? (★ Eu rascunho, suas edições são finais · suas palavras exatas) Qual idioma, e ortografia do Reino Unido ou EUA?
  • Único ou uma série? (uma série trava um look em todos os episódios; o reel-style cuida disso)
  • Uma história de jornada ou carreira adiciona o bloco de jornada (references/journey.md): cada cargo e cada função, nomeie/descreva/oculte cada empregador, as afirmações que um colega chamaria de exagero.

Rodada 4 · Visual, limites, revisão (obrigatório)

  1. 1–3 vídeos que eles gostam, e o que parece barato para eles. Esta é a pergunta mais cara de pular.
  2. Cores e fontes da marca (consultadas primeiro; perguntadas apenas se nenhuma for encontrada).
  3. Qualquer coisa que NÃO deve aparecer (números, nomes, rostos, logotipos), e qualquer coisa que DEVE aparecer (handle, cartão final, aviso legal).
  4. A capa, a imagem que as pessoas veem antes de apertar play (grade do perfil, miniatura do LinkedIn): ★ a linha do gancho, grande, sobre o look de abertura. Sem uma, a plataforma escolhe um quadro para você (no LinkedIn, dizem que é o primeiro; não verificado), que raramente é o melhor.
  5. Como eles querem revisar: ★ stills → uma tira de 10 segundos → o filme completo após a verificação independente → uma prévia no celular.

3 · O fechamento

  1. Verificação de conflitos. Leia as respostas umas contra as outras antes de escrever o brief:
    • 9:16 no LinkedIn → sugira 4:5
    • liderado por som no LinkedIn → legendas embutidas são obrigatórias
    • um roteiro longo na faixa central de um reel 9:16 (o quarto inferior limpo; 35% se pago) → corte palavras, não o tamanho da fonte
    • mais de 3 minutos no Instagram → não será recomendado para novos públicos
  2. O brief, em uma tela (template em references/brief.md), salvo como reels/<nome-curto>/brief.md: cada reel tem sua própria pasta. Divida-o em Você disse e Eu presumi (e por quê). Inclua a linha de formato: plataforma → reel ou vídeo → proporção e tamanho → layout e zona de segurança → duração → som.
  3. A tabela do storyboard: tempo · palavras na tela, exatamente como aparecerão · som e legenda · por que este batimento. O gancho chega em até 3 s, e a duração de cada batimento totaliza a duração.
  4. Peça "sim". Uma correção gera uma nova leitura completa. Nunca construa na mesma mensagem do brief.

Em seguida, passe adiante: reel-style escolhe o look (3 stills), e film-engine constrói dentro dele, com a página dimensionada pelo formato do brief.

Nunca

  • Pergunte o que o material já responde.
  • Invente um número, uma citação, um cliente ou um resultado.
  • Troque as palavras da pessoa pelas suas. Revise-as (gramática, fluência), não as reescreva.
  • Pule a rodada de formato, mesmo quando a plataforma parecer óbvia.
  • Escolha o look dentro da entrevista. Esse é o trabalho do reel-style, mostrado como stills, nunca nomeado a partir de uma lista.

Créditos

A postura da entrevista (o agente pergunta antes de agir, com uma resposta recomendada para cada pergunta) vem do grill-me de Matt Pocock (mattpocock/skills, MIT). As regras de perguntar uma vez (opção recomendada primeiro, pule o que já foi respondido, disse vs presumido, uma verificação de conflitos antes do resumo) são adaptadas da entrevista de intenção do HyperFrames (heygen-com/hyperframes, Apache-2.0). Os campos do brief seguem briefs comuns de agências de vídeo. Os fatos da plataforma foram verificados em 2026-10-06 nas próprias páginas das plataformas onde puderam ser lidos; os que não puderam (X) estão marcados como não verificados em references/platforms.md.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

thativanng/reels-maker

The gates every code-rendered film passes before anyone sees it. A 40 fps collision pass (no mover touches a solid or another mover), pixel probes (nothing sits over or behind a face, a head, a subtitle or the frame edge), then an independent auditor (a fresh agent) who reads frame sheets at ≥2 fps and signs off. The builder never signs off their own film. Use it before sending ANY render, after every fix round, and whenever someone says "check the film", "audit this", "is it ready", or "why does this frame look wrong".

thativanng/reels-maker

Build and render a film, reel or animation as code. One HTML page draws any frame on demand with window.seek(t), and a headless browser renders every frame at 2x into an MP4 with sound. Use it whenever someone wants a video made with code rather than a video generator, says "make a film / reel / animated explainer / career video", "render this to MP4", "turn this page into a video", or needs the finishing steps (audio cues, loudness, colour-safe encode, phone preview). It is style-agnostic and renders 9:16, 4:5, 1:1 or 16:9. It runs after reel-intake (the brief) and reel-style (the look), builds on template/starter.html or a style pack such as voxel-walk, and passes film-audit before anything is shown to anyone.

thativanng/reels-maker

Picks the look of a reel or film before it is built. It shows three genuinely different looks as stills of the same opening frame with the same words, so the person judges the look and not the content. It keeps a log of every look ever shown, so no look comes back unless asked for, and it locks one look on purpose for a series. Use it after reel-intake's brief is signed and before any test strip, whenever someone says "what should it look like", "give me options", "make it look different from last time", "it looks cheap", or starts a new reel or a new series.

thativanng/reels-maker

The voxel career-film style. A blocky 3D version of the person walks, without ever vanishing, through one scene per role. Their outfit changes as they walk, each scene rises out of the floor ahead of them, and a dark banner tracks year, company and role. Use it when someone wants their career, a journey or a "how I got here" told as a short 3D film for LinkedIn or a portfolio, says "make my career film", "turn my CV into a video", "voxel film", or wants a new chapter added to an existing one. It runs on film-engine (render, audio, finish) and must pass film-audit before anything is sent.

Habilidades Relacionadas