Communitygithub.com

visual-story

Narrativa visual para mostrar coisas complexas às pessoas: um filme explicativo animado em uma grande tela com câmera, cenas e legendas; um mapa interativo de um processo ou sistema; um pitch deck com microanimações, transições e um PDF estático; suas versões para celular, exportação MP4 quadro a quadro, publicação em um subdomínio e um QR Code. Use quando o usuário pedir um filme explicativo, uma demonstração animada de um processo, "animar como nosso sistema funciona", um mapa interativo de sistema para navegar, um pitch deck com transições e um PDF, "fazer um vídeo a partir desta animação" ou "fazer funcionar em celulares" — mesmo que eles não digam "animação" ou "deck". NÃO use para apresentações simples de slides sem cenas ou câmera, um único diagrama estático, páginas de destino e propostas de vendas, ou vídeo gerado por IA.

O que é visual-story?

O skill `visual-story` é um conjunto de diretrizes e runbooks para criar narrativas visuais explicativas e interativas, como filmes explicativos animados, mapas de sistemas e pitch decks. Ele é projetado para agentes de IA (como Claude Code) que precisam gerar conteúdo visual complexo em um único canvas, com suporte a cenas, câmera, animações de transição, legendas e exportação para MP4 ou PDF. O skill enfatiza um fluxo de trabalho iterativo: primeiro, entender o objetivo do usuário em uma só rodada de perguntas; depois, escrever um roteiro em tabela; em seguida, criar um piloto de uma cena para validar o estilo antes de prosseguir em lotes de 2-3 cenas; por fim, montar tudo com navegação, versões responsivas e publicação. Ele também inclui checklists de qualidade, regras de bom gosto visual e prevenção de erros comuns, como trabalhar tudo de uma vez sem validação. O skill suporta as plataformas Claude Code, Cursor e Codex, e é acionado quando o usuário solicita demonstrações animadas de processos, pitch decks com transições ou mapas interativos, mas não para slides simples ou diagramas estáticos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Visual story

Mostre coisas complexas como imagens: cena por cena, grandes, com movimento que explica em vez de decorar. A legenda diz o que está acontecendo; a tela mostra. Cada lote de trabalho termina com um quadro mostrado ao usuário e seu "sim".

O que você está fazendo → qual runbook abrir

TarefaRunbook
Filme explicativo: cenas em um canvas, câmera, legendas, mapa "esquema completo"references/motion-film.md
Mapa interativo de um processo ou sistema com saltos entre nósreferences/scheme.md
Pitch deck com microanimações, transições e um PDFreferences/deck.md
Palestra simples sem cenas ou câmerause um fluxo de trabalho de apresentação comum; pegue emprestadas as regras de legibilidade de deck.md
Exportar um filme ou mapa para MP4references/video-export.md
Versões para celular e tabletreferences/responsive.md
Publicação, subdomínio, senha, QRreferences/publish.md
Verificação visual: quadros por URL, folhas de contato, checklistreferences/qa.md
Regras de bom gosto: cor, tipografia, movimento, densidadereferences/taste.md
Trabalhos de referência para copiar um esqueletoreferences/examples.md

Abra taste.md, examples.md e o runbook correspondente antes da primeira linha de código. Abra qa.md antes da primeira exibição.

Filme ou mapa? Um filme é uma história que se desenrola no tempo, onde um apresentador guia o espectador cena por cena. Um mapa é uma imagem grande que o espectador explora por conta própria. "Anime nosso processo para um webinar" é um filme; "um mapa do sistema para olhar ao redor" é um mapa. Se não tiver certeza, faça uma pergunta.

Ordem de trabalho para cada tipo

  1. Objetivo nas palavras do usuário, depois perguntas. Faça tudo de uma vez, com a opção recomendada primeiro, e apenas o que ainda não foi respondido: qual referência ("como da última vez"), como será mostrado (apresentador clica / reprodução automática / vídeo / PDF), estilo (o site do produto), idioma, dados (fictícios ou do usuário), prazo e tela.
  2. Roteiro como tabela — cenas ou slides: número, título, uma linha de significado. Aguarde o "sim".
  3. Piloto. Uma cena ou um ou dois slides, completamente finalizados: imagem, movimento, legendas. Quadros → mostre → aguarde o "sim". Por quê: um estilo encontrado no piloto se aplica a todo o resto; um estilo encontrado na cena doze significa refazer doze cenas.
  4. Lotes de 2–3 cenas ou slides; mostre cada lote e aguarde.
  5. Monte o todo: navegação, mapa de esquema completo ou visão geral, layouts para celular, publicação, QR, PDF ou vídeo — o que foi encomendado.

Prazo inferior a um dia: um piloto e um "sim", o restante em um lote; verifique os quadros apenas nos tamanhos em que serão mostrados (a tela de transmissão, além de celulares se os espectadores receberem um link).

Antes de dizer "pronto"

  • Os quadros nos tamanhos de exibição de qa.md foram capturados e revisados; defeitos corrigidos em um lote.
  • Se a publicação foi encomendada: o endereço ativo serve a nova versão (?v=NN), e zbarimg lê o QR.
  • Se um PDF ou vídeo foi encomendado: o arquivo foi aberto e revisado página por página ou quadro a quadro.
  • O usuário viu o resultado e respondeu.
  • Suas próprias capturas de tela, sessões de navegador e processos de servidor foram limpos (pare os servidores pelo pid deles).

Erros comuns

  • Construir tudo e mostrar no final → o usuário muda o estilo e você refaz tudo. Trabalhe em lotes.
  • Fazer as coisas pequenas: dez rótulos minúsculos no canvas em vez de uma ideia grande. Imagem grande, código pequeno.
  • Proteger-se com texto: "Escaneie com seu celular" abaixo de um QR, "ainda crescendo", "você pode…", dicas de gestos. O que estiver claro sem palavras fica sem palavras.
  • Decorar: listras coloridas de destaque nas bordas dos cartões, piscando, "apenas bonito". Movimento explica uma transição ou não existe.
  • Um número sem um substantivo e um momento ("8 cartões") → o espectador não sabe o que está olhando.
  • Verificar "lendo o código" sem um quadro no tamanho certo → no celular tudo desmorona.

Habilidades Relacionadas