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)
-
Uma mensagem clara. Você deve ser capaz de dizer toda a peça em uma frase. Escreva essa frase primeiro, como
message. Oheadlineafirma 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. -
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.
-
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.
-
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.
-
O visual certo para os dados.
barpara comparações.linepara tendências ao longo do tempo.timelineouprocesspara sequências.diagrampara relacionamentos.comparisonpara lado a lado.statpara um grande número.iconsouchecklistpara uma lista curta.
Sem 3D, sem tortas com muitas fatias, sem decoração que não carrega significado. O lint rejeita
pie,donut,radare3d. -
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.
-
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.
-
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
- Encontre a mensagem. Leia a fonte (uma seção de artigo, um relatório, anotações). Escreva a
messagede uma frase e escolha oaudience. Se você não conseguir escrever uma frase, o material não está pronto para um infográfico. - 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. - Faça o lint dela:
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.python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - Renderize:
python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox--themeaceita qualquer id de tema do imagen-diagrams e preenche a paleta e o estilo. Você também pode definirpalette: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.txtao lado da imagem para que você veja o que foi solicitado. Use--dry-runpara imprimir o prompt e não gastar nada.
- 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. - 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
--themee a falha de mecanismo em seugenerate.py. Sem o plugin, o script chamaimagen generatediretamente, e você deve definirpalette: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.