Communitygithub.com

aktsmm/Agent-Skills

Crie GIFs infográficos animados e reproduzíveis a partir de dados estruturados ou resultados medidos, com rótulos no idioma do público, semântica de tempo explícita, verificação de quadro representativo e uma alternativa estática. Use quando solicitado a criar GIF, infográfico animado, gráfico em movimento de resultados, benchmark animado ou uma animação para blog/SNS cujas métricas exibidas possam ser rastreadas até os dados de origem.

O que é Agent-Skills?

Esta skill permite que agentes de IA (como Claude Code, Cursor ou Codex) criem infográficos animados em formato GIF a partir de dados estruturados (JSON, CSV) ou resultados de medições. O foco principal é garantir a rastreabilidade entre os dados de origem e os valores exibidos na animação, além de oferecer controle explícito sobre a semântica temporal (se os quadros representam tempos reais de medição ou são apenas ilustrativos). A skill suporta múltiplos modos de temporização (ilustrativo, medido ou misto) e gera automaticamente uma versão estática de fallback. Ela também inclui um fluxo de validação mecânica (via script Python) e inspeção visual para garantir que o GIF atenda às dimensões especificadas, não tenha sobreposição de texto, e que os rótulos estejam no idioma do público-alvo. É útil para criar animações de benchmark, comparações de desempenho, rankings, transições de estado e outros gráficos dinâmicos para artigos técnicos, posts em redes sociais ou slides.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktsmm/Agent-Skills/tree/HEAD/animated-infographic

Perguntar na sua IA favorita

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

Documentação

Infográfico Animado

Quando Usar

  • Criar GIFs ou gráficos animados a partir de dados de JSON / CSV / benchmark.
  • Mostrar movimentação de cartas, rankings, barras comparativas ou transições de estado com animação.
  • Criar artigos / ativos para SNS onde a precisão numérica e a distinção entre tempo de apresentação e tempo medido sejam importantes.

Se for necessário apenas uma imagem PNG estática, use visualize-as-infographic; para análise de vídeos existentes, use video-watch; para diagramas editáveis, use o workflow baseado em draw.io.

Entradas

  • Artefato de origem: JSON / CSV / texto. Se houver valores medidos, use isso como a Fonte Única da Verdade (SSOT).
  • Idioma do público e meio alvo: blog japonês, X, slide, etc.
  • Modo de temporização:
    • illustrative: O movimento é encenado. Não representa velocidade de processamento.
    • measured: A temporização dos quadros é baseada em timestamps reais medidos.
    • mixed: Os valores numéricos são medidos; o movimento de cartas e barras é encenado.
  • Tamanho de saída. O padrão para blog/X é 1200x675. Se necessário, crie também um fallback estático.

Fluxo de Trabalho

  1. Congelar a evidência
    • Fixe o artefato de origem, data e hora da coleta, número de itens e limites da medição.
    • Determine o que está sendo medido: latência por 1 request, serial total, fim a fim do processo fresco, etc.
    • Ao processar mídia externa, registre a URL original, data de coleta, caminho relativo da fonte e SHA-256 em um manifesto; verifique o hash antes da geração.
  2. Projetar a história
    • Cada GIF deve se concentrar em um único ponto principal. Deixe explicações longas para o texto do artigo.
    • Fixe a ordem de leitura: entrada → decisão → próximo processamento, antes → depois, comparação → conclusão, etc.
    • Se o tema for uma porta de decisão estreita, destaque-a visualmente com cor de destaque, contorno grosso, posicionamento central ou chamada. Coloque a entrada e a saída em ambos os lados e escreva o valor decidido pela porta dentro da caixa.
    • Não afirme termos oficiais e camadas/classificações próprias do autor com a mesma aparência. Para modelos próprios, indique o escopo dentro do ativo (ex.: organização deste artigo) e evite setas ou aninhamentos que possam sugerir inclusão no produto ou maturidade.
  3. Localizar antes da renderização
    • A UI explicativa, status e legendas devem estar no idioma do leitor. Não deixe UI genérica em inglês em artigos em japonês.
    • Nomes de produtos, campos de API, IDs de modelo e outros nomes próprios devem manter a grafia oficial.
    • Evite traduções literais. Exemplo: em vez de pontuação por estágio, use quão próximo está de cada etapa dos critérios definidos.
  4. Tornar a temporização explícita dentro do ativo
    • illustrative: Exiba Movimento das cartas é encenado (não representa velocidade real).
    • measured: Exiba os limites da medição e a unidade; crie a duração dos quadros a partir dos valores medidos.
    • mixed: Escreva ambas as mensagens: Valores exibidos são medidos / Movimento de barras e cartas é encenado.
  5. Gerar de forma reproduzível
    • Mantenha o script gerador, o GIF, o fallback estático e, se necessário, um instantâneo da fonte.
    • Leia os valores do artefato de origem, sem entrada manual.
    • Para vídeos de terceiros, limite-se aos quadros mínimos necessários para o argumento (ex.: antes / operação / depois) e remova elementos irrelevantes do navegador. Diferencie no ativo a origem e informações que evitem interpretações erradas (ex.: dados fictícios, não enviados, notas adicionais do autor).
  6. Validar mecanicamente
    python scripts/validate_animation.py output.gif `
      --expected-width 1200 --expected-height 675 `
      --timing-mode illustrative `
      --contact-sheet output-contact.jpg `
      --report output-validation.json
    
  7. Inspecionar visualmente
    • Verifique os quadros inicial, intermediário e final no tamanho original e na largura de incorporação alvo (para mobile, aproximadamente 360px).
    • Corrija e regenere para evitar: sobreposição de texto, corte, ordem incorreta, espaços em branco, anotações ilegíveis ou UI em inglês remanescente.

Regras de Temporização

  • O tempo total de reprodução do GIF não necessariamente corresponde à latência da API. Não os trate automaticamente como equivalentes.
  • Para a soma de múltiplas requisições, indique se elas são paralelas ou seriais.
  • Se os limites de medição dos itens comparados forem diferentes, trate como tempo observado fim a fim, não como velocidade do modelo.
  • Compare também o custo estimado, a taxa de acertos e o número de tokens com o artefato de origem e inclua anotações no ativo para evitar interpretações erradas.

Critérios de Conclusão

  • O GIF está animado e atende às dimensões esperadas e ao número mínimo de quadros.
  • O modo de temporização e os limites da medição estão visíveis no ativo.
  • Os valores do artefato de origem correspondem aos valores exibidos.
  • Se houver mídia externa, a URL de origem / data de coleta / SHA-256 correspondem ao manifesto.
  • A UI explicativa está uniformemente no idioma do leitor.
  • A porta de decisão principal é visível primeiro e é possível ler o que ela recebe e o que retorna.
  • Definições oficiais e organização própria do autor podem ser distinguidas mesmo no ativo isolado.
  • Os quadros inicial, intermediário e final e a reprodução em loop foram verificados.
  • O texto é legível na largura de incorporação alvo.
  • O local do gerador, GIF, fallback estático e relatório de validação foi informado.

Individual skills in this repo

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

Habilidades Relacionadas