Communitygithub.com

Visual Explainer Shorts

Use ao planejar e produzir vídeos explicativos visuais, tanto no formato curto (menos de 60 segundos) quanto no formato longo (8–12 minutos), incluindo roteiros, estrutura de história pesquisada, prompts visuais de IA, direções de motion graphics, narração, instruções de edição e auditorias de qualidade.

O que é Visual Explainer Shorts?

Este skill é um estúdio de produção completo para criar pacotes de vídeos explicativos visuais prontos para o editor, suportando dois modos distintos: formato curto (vertical, 48–59 segundos) e formato longo (16:9, 8–12 minutos). Ele não é um gerador de vídeo autônomo, mas sim um planejador que integra pesquisa de fatos, estrutura narrativa, design visual, compilação de prompts de IA e instruções de edição em um único pacote coeso. O skill garante que cada alegação factual seja verificada por fontes confiáveis, que a estrutura da história seja definida antes dos visuais, e que uma combinação híbrida de mídias (como motion graphics, imagens de IA, filmagens de arquivo e capturas de tela) seja usada para explicar cada ideia da maneira mais clara possível. A entrega final inclui um pacote de prompts consolidado, uma nota do diretor para o editor e metadados estruturados, garantindo que o editor possa montar o vídeo sem precisar inferir a intenção criativa a partir de prompts dispersos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/koyawel0694/Ultra-Prompting/tree/main/skills/visual-explainer-shorts

Perguntar na sua IA favorita

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

Documentação

Visual Explainer Production Studio — Shorts + Long Form

Propósito

Transformar um tópico em um pacote de vídeo explicativo visual com embasamento em pesquisa e pronto para o editor. Este skill oferece suporte a dois modos de produção distintos:

  • Formato curto: um explicator vertical com tempo apertado, geralmente entre 48 e 59 segundos.
  • Formato longo: um explicator de 8 a 12 minutos, geralmente em 16:9, que combina deliberadamente vídeo gerado por IA com motion graphics, diagramas animados, gráficos, tipografia cinética, mapas, filmagens de arquivo/stock, gravações de tela, imagens estáticas e pausas visuais cuidadosamente escolhidas.

O skill não é apenas um gerador de vídeo. Ele é o planejador da história, design visual, compilação de prompts e instruções de edição. Ele deve entregar um único pacote consolidado de prompts, além de uma Nota do Diretor separada, que um skill de edição possa seguir sem precisar inferir a intenção criativa a partir de prompts dispersos.

Regras de Compilação em Arquivo Único e Entrega no Telegram

  1. Compilação de Texto Unificado: Quando solicitado a compilar prompts de gancho ou um pacote de episódio em um arquivo de texto, compile TANTO a locução mestre com carimbos de data/hora exatos QUANTO os prompts de vídeo cena por cena completos (incluindo prompt mestre, progressão da linha do tempo segundo a segundo, especificações técnicas de câmera/iluminação e prompts negativos) em UM arquivo .txt dedicado no vault (/home/john/kos-obsidian-omni/<slug>.txt).
  2. Proteção de Mensagem do Telegram (<3.000 caracteres): Nunca despeje milhares de linhas de prompts brutos diretamente no Telegram quando um arquivo .txt foi escrito. Em vez disso, produza o roteiro de locução completo com carimbos de data/hora em um bloco ```text limpo, resuma os títulos/pontos focais das cenas e aponte diretamente para o caminho do arquivo .txt salvo. Isso preserva a formatação markdown e o botão de cópia com um toque.

Para The Pop-Up Ledger (papercraft / pop-up 3D de macroeconomia e história), consulte references/the_pop_up_ledger.md. Para ritmo de formato longo e fluxo de trabalho de mídia mista, leia references/long-form-explainer.md e references/directors-note-template.md antes da produção.

Roteamento de Modo — Decida Isso Primeiro

  1. Se o usuário solicitar explicitamente um formato, obedeça.
  2. Caso contrário, um vídeo com menos de 60 segundos é formato curto; um alvo de 8–12 minutos é formato longo.
  3. Nunca aplique limites apenas de Shorts (cenas de 6 segundos, narração de 115–130 palavras, enquadramento vertical) ao trabalho de formato longo.
  4. Nunca estique um Short para formato longo adicionando preenchimento. O formato longo precisa de uma pergunta mais profunda, múltiplas etapas explicativas, evidências, um reengajamento no meio e uma síntese significativa.
  5. Se o usuário solicitar um vídeo de formato longo sem um tópico, faça uma pergunta concisa sobre o tópico. Não peça detalhes que possam ser razoavelmente padronizados.

Regras de Produção Não Negociáveis

1. Pesquise antes de afirmar

  • Verifique fatos materiais, datas, nomes, quantidades, mecanismos, comparações e alegações causais usando fontes confiáveis; prefira fontes primárias e instituições especializadas quando adequado.
  • Mantenha um registro de fatos com cada alegação, URL/título da fonte, data de publicação ou acesso quando relevante, confiança, ressalvas e qual visual poderia demonstrá-la honestamente.
  • Separe fato estabelecido, estimativa, interpretação contestada e metáfora ilustrativa. Nunca deixe um visual cinematográfico implicar mais certeza do que as evidências suportam.
  • Não invente fontes, estatísticas, citações, proveniência de filmagens ou dados visuais exatos. Se uma alegação não puder ser verificada, diga isso no pacote de produção e remova-a ou rotule-a adequadamente.

2. História antes das tomadas

  • Declare a pergunta central, resposta/tese central, público-alvo, conclusão pretendida e por que o espectador deveria se importar.
  • Construa a cadeia causal ou espinha narrativa primeiro. Cada capítulo e batida visual deve explicar, provar, comparar, contextualizar ou reforçar emocionalmente algo específico.
  • Mapeie cada batida principal da narração para uma abordagem visual primária. Não gere visuais apenas para decorar a narração.

3. Visuais híbridos por padrão para formato longo

  • Não faça o vídeo inteiro de formato longo ser gerado por IA. Escolha o meio que melhor explica cada ideia. O vídeo de IA é uma ferramenta entre várias, não a resposta padrão para cada linha.
  • Use motion graphics para rótulos legíveis, setas, contadores, linhas do tempo, chamadas, diagramas e revelações de conceitos encenados. Use gráficos determinísticos para números exatos, gráficos vinculados a fontes, mapas e rótulos técnicos.
  • Use filmagens geradas por IA para atmosfera, reconstrução ilustrativa, metáfora visual, movimentos de câmera impossíveis ou cenas caras/impossíveis de filmar. Distinga claramente a reconstrução ilustrativa de evidências autênticas.
  • Use filmagens reais de arquivo/stock, capturas de tela, filmagens de produtos ou gravações de tela quando autenticidade, prova, detalhes de UI ou contexto do mundo real forem importantes. Registre informações de origem/licença/atribuição quando aplicável.
  • Use tipografia cinética seletivamente para frases-chave, contraste, viradas de capítulo e resumos memoráveis — não como um substituto para explicar ideias complexas.
  • Evite depender de vídeo generativo para renderizar texto crítico legível, equações, cópia de UI, valores de gráficos, bordas exatas, mapas, rótulos ou dados de origem. Componha estes na pós-produção.
  • Sem porcentagens fixas de mídia visual. Escolha o meio para clareza, confiança, custo, tempo de produção e variedade visual. Declare por que cada tomada ou gráfico principal usa seu tipo de ativo selecionado.

4. Áudio é planejado separadamente

  • Nunca coloque o roteiro de locução dentro de um prompt de geração de vídeo de IA.
  • A menos que o usuário solicite explicitamente diálogo gerado, os prompts de vídeo devem especificar apenas ação visual, câmera, continuidade e som diegético / Foley / ambiente, terminando com: Sound effects: [ambiente/Foley específico]. No voice over, no talking, no intelligible dialogue.
  • Locução, música, efeitos sonoros e sincronismo de gráficos devem ser campos separados na especificação e explícitos na Nota do Diretor.
  • Não presuma que o áudio gerado por um clipe de IA será usado na edição final. Trate-o como referência opcional, a menos que o editor o selecione deliberadamente.

5. Continuidade e verdade

  • Trave assuntos recorrentes, material, geografia da câmera, iluminação, paleta e tratamento visual quando as tomadas precisarem combinar.
  • Para cenas contínuas segmentadas (Google Flow / Omni ou outra ferramenta que suporte quadros de referência), use o último quadro utilizável exato da tomada N como referência para a tomada N+1 e especifique o vetor de câmera e a ação continuados. Esta regra é opcional para edições baseadas em cortes.
  • Rotule diagramas/mapas como esquemáticos quando a geometria exata não for proveniente. Nunca apresente um mapa gerado, gráfico, imagem de arquivo ou reconstrução como evidência autêntica.

6. A entrega deve incluir uma instrução de edição

  • Sempre compile todos os prompts de vídeo de IA e prompts de geração visual em um arquivo <slug>_prompts.txt limpo, agrupado por cena/ID de ativo e pronto para cópia.
  • Sempre crie <slug>_directors_note.md, uma instrução de edição independente com um briefing criativo geral, mapa de história/capítulo, linha do tempo provisória ou travada, pistas de sincronização de narração, instruções de construção de motion graphics, design de transição e som, referências de ativos, regras de continuidade e verificações finais. Esta é uma saída obrigatória, não um resumo opcional.
  • Inclua <slug>_production_spec.yaml como a fonte de verdade estruturada e <slug>_voiceover.txt como uma cópia de narração limpa. Inclua <slug>_research_ledger.md quando o projeto fizer afirmações factuais; inclua um manifesto de ativos quando o rastreamento de origem/licença for útil.
  • Use um local de projeto/vault configurado quando ele estiver realmente disponível. Caso contrário, crie uma pasta de projeto dentro do espaço de trabalho gravável atual (por exemplo visual-explainer-output/<slug>/). Não presuma que um diretório inicial específico da máquina existe. Nunca relate um arquivo como salvo a menos que ele tenha sido realmente escrito e verificado.

7. Respeite os limites reais do renderizador

  • Verifique a duração disponível, proporção de aspecto, imagem de referência e controles de áudio do modelo de IA escolhido antes de finalizar os prompts.
  • Não escreva uma duração solicitada em um prompt como se o modelo a suportasse quando não suporta. Gere segmentos suportados e planeje corte, extensão ou composição na pós-produção.
  • A linha do tempo de edição planejada é provisória até que a duração final da locução/áudio seja conhecida. Marque as temporizações provisórias honestamente; atualize a linha do tempo final após o áudio ser medido sempre que esse ativo estiver disponível.

Modo de Formato Curto — Menos de 60 Segundos

Regras de duração e cena

  • Alvo padrão: 48–54 segundos, normalmente 8–9 batidas visuais.
  • Unidade de cena gerada preferida: 6 segundos quando o modelo escolhido a suporta. Se não suportar, use uma duração suportada e planeje o corte/trim na pós; não solicite falsamente uma duração não suportada.
  • Mantenha o vídeo final abaixo de 60 segundos, a menos que a plataforma/alvo do usuário seja diferente.
  • Um alvo inicial de narração para 48–54 segundos é de cerca de 115–130 palavras a aproximadamente 130–145 palavras por minuto. Conte as palavras e, quando a narração gerada estiver disponível, meça o áudio real antes de travar os tempos das cenas.

Receita de história de formato curto

  1. 0–2 segundos: gancho visual. Comece com um paradoxo, fato marcante, tensão, contraste de escala ou prova de aparência impossível — não uma saudação genérica.
  2. 2–8 segundos: prometa a resposta. Torne a pergunta específica óbvia.
  3. Meio: explique uma cadeia causal. Cada tomada deve adicionar uma etapa distinta, comparação, consequência ou peça de evidência.
  4. Conclusão: resolva a pergunta de abertura. Não termine com um resumo vago.
  5. Fechamento: use um prompt conciso para o público apenas se encaixar naturalmente; nunca sacrifique a resposta por um CTA.

Verificações visuais/áudio de formato curto

  • Mantenha uma ideia visual dominante por tomada e texto curto na tela.
  • Planeje o gancho, legendas, posicionamento da área segura, design de som e conclusão final para visualização em dispositivos móveis.
  • Mantenha rótulos/dados exatos como sobreposições de pós-produção, não texto renderizado por IA.
  • Para mapas e explicadores de cena contínua, preserve o caminho de cena/câmera persistente e amarre cada sobreposição aos gatilhos de narração.
  • Para um trecho reaproveitado de formato longo, reconstrua o gancho e a conclusão para que funcione de forma independente; não apenas corte uma seção aleatória do meio.

Modo de Formato Longo — 8–12 Minutos

Leia references/long-form-explainer.md na íntegra. O modo de formato longo é uma mistura deliberada de visuais cinematográficos, diagramas, tipografia cinética, visuais de evidência, gráficos/mapas, ativos reais e pausas contidas.

Planejamento de duração e narração

  • Alvo padrão: 8–12 minutos, normalmente 16:9. Use a proporção de aspecto/plataforma solicitada pelo usuário se for diferente.
  • Estimativa inicial de narração: aproximadamente 1.150–1.600 palavras em um ritmo natural de documentário de cerca de 130–145 palavras por minuto, dependendo de pausas, ênfase e momentos apenas visuais. Esta é uma faixa de planejamento, não uma regra cega; estime a duração a partir da taxa de entrega selecionada e, em seguida, use a duração real da locução antes de travar a edição.
  • Não encha para atingir uma contagem de palavras. Um vídeo forte de 8 minutos é melhor do que um de 12 minutos diluído.
  • Divida a narração em capítulos e unidades de significado curtas. Mantenha um arquivo de narração limpo separado, preservando IDs de parágrafo/batida que mapeiam para a linha do tempo.

Estrutura de história de formato longo

  • Abra com uma forte pergunta visual, resultado surpreendente, contradição, mistério ou exemplo consequente.
  • Diga ao espectador qual pergunta o vídeo responderá e por que ela importa, sem uma longa introdução do canal.
  • Estabeleça um modelo mental útil antes de introduzir muitos termos.
  • Construa através de capítulos distintos: contexto, mecanismo/evidência, complicação ou contraponto, implicações e síntese. Adapte a ordem ao tópico.
  • Inclua um reset de atenção no meio — como uma nova escala, estudo de caso, comparação inesperada, transformação de diagrama ou revelação — aproximadamente na metade do caminho. Não invente uma reviravolta se as evidências não a suportarem.
  • Feche respondendo à pergunta de abertura, conectando as partes, nomeando a incerteza quando relevante e oferecendo uma conclusão memorável.
  • Veja o guia de referência para um mapa de capítulo sugerido de 8–12 minutos. Trate-o como um andaime, não um mandato de carimbo de data/hora rígido.

Planejamento visual de formato longo

Para cada capítulo, especifique:

  • A pergunta do espectador neste momento.
  • A batida de narração / afirmação-chave.
  • O meio visual primário e por que é a melhor opção.
  • A prova visual, mecanismo, comparação ou metáfora.
  • A ação editorial: segurar, revelar, rotular, rastrear, comparar, ampliar, pausar ou fazer transição.
  • Ativos/dados exatos necessários e seu status de fonte.
  • Se o visual é filmagem autêntica, filmagem com fonte, um esquema, uma reconstrução de IA ou uma metáfora.

Use durações flexíveis de tomada/gráfico. Inserts ilustrativos simples podem ser curtos; um diagrama bem ritmado pode permanecer na tela por 10–25 segundos enquanto camadas são construídas em resposta à narração. Mude o visual quando a ideia mudar, não apenas para forçar cortes constantes. Evite papel de parede longo e imutável, mas permita que evidências e diagramas complexos tenham tempo suficiente para serem compreendidos.

Nota do Diretor de Formato Longo é obrigatória

A Nota do Diretor é o guia operacional principal do skill de edição. Ela deve explicar a experiência de visualização pretendida e como montar o vídeo inteiro. Deve referenciar IDs de prompts/ativos em vez de duplicar seu texto de prompt completo. Cada evento da linha do tempo deve apontar para IDs de narração/batida, e cada ativo gerado/com fonte deve mapear para uma tomada ou gráfico. Se as temporizações exatas dependerem de locução não gerada, marque-as como PROVISIONAL — sync to final VO.

Modos Visuais

Escolha o modo visual a partir do assunto. Misture modos deliberadamente quando melhorar a explicação.

  • Geologia / Globo Contínuo: Trajetórias contínuas de órbita ao solo, limites de placas com fonte, seções transversais, destaques de terreno e chamadas no espaço mundial.
  • Stop-Motion Papercraft / Diorama Pop-Up Tátil: Cartolina em camadas, desdobráveis, abas deslizantes, livros-razão recortados, sombra tátil, movimento sutil e escalonado e Foley diegético de papel/papelão.
  • Linha do Tempo / Flashpoints Históricos: Estados de linha do tempo, mapas, objetos de período, evidências de arquivo, rotas de migração/comércio e reconstruções claramente rotuladas.
  • Processo / Como Funciona: Entradas → mecanismo → saídas; vistas explodidas, diagramas de fluxo, animações de causa e efeito e estágios de produção.
  • Dados / Gráficos Estatísticos: Gráficos animados, tabelas com fonte,

[truncado para tradução]

Individual skills in this repo

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

Habilidades Relacionadas