CommunityImagemgithub.com

imagen-infographic

Projete e renderize infográficos no estilo NotebookLM e ilustrações planas de pessoas trabalhando com uma ideia, como PNGs, usando a CLI imagen.

O que é imagen-infographic?

Este skill transforma a criação de infográficos em um processo repetível e controlado, ideal para desenvolvedores e criadores de conteúdo que precisam de resumos visuais impactantes. Ele valida as especificações do infográfico antes de gastar qualquer recurso de imagem, verificando regras como mensagem única, dados com fontes, restrição visual e contraste WCAG. Após a renderização, o skill lê o texto gerado para garantir que todos os rótulos estejam escritos corretamente. Suporta temas do plugin imagen-diagrams e oferece um workflow claro: definir a mensagem, escrever a especificação, executar lint, renderizar e verificar. Também permite criar ilustrações de cenas (pessoas em situações de frustração ou alívio) que tornam artigos técnicos mais pessoais, sem texto próprio. O skill é adequado para infográficos, pôsteres explicativos, resumos visuais para artigos, blogs, slides ou newsletters, e não para fluxogramas, diagramas de arquitetura (que usam imagen-diagrams) ou fotos e capas (que usam image-gen).

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/SpillwaveSolutions/imagen-infographic/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que imagen-infographic faz?

Um bom infográfico transforma informações complexas em algo claro, memorável e escaneável em segundos. Ele coloca a compreensão à frente da decoração. Este skill transforma isso em um processo repetível: escreva uma especificação, faça o lint, renderize e verifique o texto que voltou.

As regras de design (leia antes de escrever uma especificação)

  1. Uma mensagem clara. Você deve ser capaz de dizer toda a peça em uma frase. Escreva essa frase primeiro, como message. O headline afirma a conclusão, para que o leitor entenda o ponto em cerca de cinco segundos. Duas ideias concorrentes geram dois infográficos, ou uma seção de artigo.

  2. Dados precisos e confiáveis. Use apenas fatos do material de origem. Cada número carrega uma fonte, e o rodapé lista as fontes. Uma escala enganosa ou um número selecionado destrói a confiança mais rápido do que nenhum gráfico.

  3. Um público nomeado. Combine a complexidade e o vocabulário com o que esse leitor já sabe. Uma visão geral genérica não ajuda ninguém.

  4. Hierarquia e fluxo. Tamanho, contraste e posicionamento dizem ao olho para onde ir: título, depois rótulos dos painéis, depois frases curtas. Use uma sequência de cima para baixo ou uma grade modular clara.

  5. O visual certo para os dados.

    • bar para comparações.
    • line para tendências ao longo do tempo.
    • timeline ou process para sequências.
    • diagram para relacionamentos.
    • comparison para lado a lado.
    • stat para um grande número.
    • icons ou checklist para uma lista curta.

    Sem 3D, sem tortas com muitas fatias, sem decoração que não carrega significado. O lint rejeita pie, donut, radar e 3d.

  6. Simplicidade e contenção. Mantenha os rótulos curtos e as frases ainda mais curtas. Use 2 ou 3 fontes e 2 a 4 cores, com bastante espaço em branco. Se uma seção precisar de um parágrafo, ela pertence ao artigo, não ao infográfico.

  7. Acessibilidade. O contraste do texto deve ser de pelo menos 4,5:1, e o script o verifica. Nunca use a cor como única maneira de distinguir itens: rotule-os. A imagem deve permanecer legível em um telefone.

  8. Consistência. Use um estilo de ícone, um sistema de tipos e espaçamento uniforme. O prompt solicita isso, então não o prejudique com instruções mistas.

Modos de falha. Verifique a especificação para estes antes de renderizar:

  • sobrecarga de informações ou muitos tópicos
  • decoração bonita, mas sem significado
  • hierarquia fraca que faz o leitor procurar o ponto
  • gráficos errados ou distorcidos
  • fontes ausentes
  • texto ilegível

Fluxo de trabalho

  1. Encontre a mensagem. Leia a fonte (uma seção de artigo, um relatório, anotações). Escreva a message de uma frase e escolha o audience. Se você não conseguir escrever uma frase, o material não está pronto para um infográfico.
  2. Escreva a especificação, um arquivo Markdown com frontmatter YAML. O formato e um exemplo completo estão em references/spec-format.md. Use 3 a 6 painéis, cada um com um rótulo curto, um tipo visual e no máximo 3 frases ou alguns pontos de dados.
  3. Faça o lint dela:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox
    
    O lint aplica os limites nas regras 1, 2, 5, 6 e 7, e imprime uma linha por problema. Corrija a especificação, não os limites: cada limite existe porque infográficos passados falharam sem ele.
  4. Renderize:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox
    
    • --theme aceita qualquer id de tema do imagen-diagrams e preenche a paleta e o estilo. Você também pode definir palette: na especificação.
    • A proporção padrão é 3:4, um pôster retrato. Defina aspect: "16:9" para um slide.
    • O script escreve out.prompt.txt ao lado da imagem para que você veja o que foi solicitado. Use --dry-run para imprimir o prompt e não gastar nada.
  5. O portão. O script lê a imagem de volta com imagen analyze. O título, cada rótulo do painel e o rodapé das fontes devem aparecer, escritos corretamente. O script tenta até 3 vezes (--attempts) e exclui uma imagem que falha, então uma falha é uma lacuna visível, não uma imagem quebrada.
  6. Veja o resultado você mesmo. Abra o PNG e verifique-o em relação às oito regras. O portão verifica apenas a ortografia. Ele não pode dizer que a hierarquia está fraca ou que um gráfico está fora de escala. Se a imagem falhar em uma regra, altere a especificação (menos palavras, um visual diferente) e renderize novamente.

Ao incorporar a imagem em um artigo, forneça uma legenda e um parágrafo curto que diga o que ela mostra. Um leitor que não pode ver a imagem ainda deve receber a mensagem.

Cenas: uma pessoa trabalhando com a ideia

Uma cena é uma ilustração plana de uma pessoa no momento que o artigo descreve: um desenvolvedor coçando a cabeça em um longo registro de chat, aliviado quando um teste passa, esboçando um plano em um quadro branco. Cenas tornam uma peça técnica pessoal. Uma cena pode mostrar um dos diagramas do artigo em um monitor ou quadro branco, o que liga a pessoa ao conceito. Use cerca de uma cena por artigo, em um momento de frustração ou alívio.

python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox

Uma especificação de cena é um bloco curto de frontmatter (veja references/spec-format.md): person (quem, fazendo o quê, sentindo o quê), setting, um diagram opcional (um caminho PNG relativo à especificação, enviado como imagem de referência), theme ou palette, e aspect (padrão 16:9). As cenas não carregam texto próprio, então não têm portão de texto. Olhe para cada uma: a emoção deve ser lida de relance, e a imagem não deve ter título, legenda ou balão de fala.

Requisitos

  • A CLI imagen (gemini-imagen) no PATH, com uma chave funcional.
  • O plugin imagen-diagrams, para --theme e a falha de mecanismo em seu generate.py. Sem o plugin, o script chama imagen generate diretamente, e você deve definir palette: na especificação.
  • Python 3 com PyYAML.

Execute infographic.py --self-test após alterar o script. Ele verifica as regras de lint e contraste sem fazer nenhuma chamada de imagem.

Habilidades Relacionadas