CommunityImagemgithub.com

dataviz

Transforma linhas de dados em um gráfico honesto. Escolhe o tipo de gráfico a partir da pergunta que está sendo respondida, constrói-o como SVG inline ou CSS sem nenhuma biblioteca de gráficos e mantém a legibilidade: um acento, grade suave, rótulos mono tabulares, linha de base zero, unidades reais e uma comparação em cada figura.

O que é dataviz?

Este skill permite que agentes de IA (como Claude Code, Cursor, Codex) gerem visualizações de dados precisas e semanticamente corretas diretamente no código, sem dependências de bibliotecas de gráficos. Ele determina o tipo de gráfico com base na pergunta que o usuário deseja responder (tendência vira linha, comparação vira barras, etc.) e produz SVG inline ou CSS puro, garantindo acessibilidade, responsividade e boas práticas de visualização. Suporta os tipos: linha, barra, empilhado, sparkline e progresso, com um script Node.js rápido ou receitas manuais de SVG/CSS. O skill impõe regras rígidas de design: um único acento de cor, grade suave, linha de base zero para áreas, rótulos mono tabulares, unidades e comparações sempre presentes, e sem gráficos decorativos ou dados falsos. É ideal para dashboards, relatórios, KPIs ou qualquer tela que precise transformar ruído de placeholder em uma visualização real e honesta.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsdanylol/claude-sitecraft/tree/HEAD/skills/dataviz

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 dataviz faz?

Um gráfico é a resposta para uma pergunta. Se você não consegue formular a pergunta em uma frase, não consegue escolher o gráfico, e um gráfico que não responde nada é decoração com números.

Como é um bom gráfico

  • Uma pergunta por gráfico. O título é a pergunta, ou sua resposta. "Execuções por mês", não "Analytics".
  • O tipo segue a pergunta. Tendência é linha, comparação é barras, participação é uma barra empilhada, uma única meta é uma barra de progresso, uma classificação é uma lista com barras finas.
  • Um acento. A coisa que importa ganha destaque. Todo o resto são tons neutros de uma mesma rampa. Nunca um arco-íris dentro de uma série.
  • Linha de base zero para tudo que tem área. Barras e barras empilhadas começam em zero, sempre. Uma linha pode começar em outro lugar se o truncamento for visível e declarado.
  • Cromática suave. Grade, eixos e rótulos são discretos. O dado é a única coisa que se destaca, e apenas uma série dele se destaca.
  • Números legíveis. Unidades no rótulo, um formato, tabular-nums, sem decimais extras que mentem sobre a precisão.

Como executar

  1. Escreva a pergunta. Uma frase: que decisão este gráfico ajuda alguém a tomar? Se for "mostrar os dados", corte ou transforme em tabela.
  2. Escolha o tipo em references/charts.md. Lá também está nomeado o gráfico que parece certo mas está errado, geralmente um donut.
  3. Modele as linhas. Uma tabela, uma linha por categoria, uma coluna por série, números já na unidade a ser exibida. CSV ou JSON, nada pré-agregado duas vezes.
  4. Construa.
    • Caminho rápido: node <pasta do skill>/scripts/chart.mjs data.csv --type line --title "Execuções por mês" --unit execuções --accent "#e0a458" --out chart.svg
    • Tipos: line, bar, stacked, sparkline, progress. Opções: --width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max.
    • Ele escreve SVG autônomo com role="img", um <title>, um <desc>, rótulos mono tabulares e uma grade suave. Insira na página como está, ou faça inline para estilizar com os tokens da página.
    • Construção manual quando o gráfico precisa viver dentro de um componente: as receitas em references/charts.md são SVG e CSS puros, sem dependência.
  5. Verifique conforme a lista de verificação abaixo, no tamanho em que será realmente visto. Um gráfico legível a 720 de largura não é legível a 280.

Regras que não são questão de gosto

  • Nenhuma biblioteca de gráficos para um gráfico simples. Quatro barras e uma linha são 30 linhas de SVG. Uma biblioteca custa 40 a 120 KB, traz estilos padrão que precisam ser desfeitos e geralmente usa um canvas que leitores de tela não conseguem ler.
  • Não codifique uma série em muitas cores. Um acento, uma série que lidera. Mais de três séries em um gráfico significa dois gráficos, ou uma tabela.
  • Cor nunca é o único sinal. Rótulos diretos, posição ou diferença de forma. Um gráfico que falha em escala de cinza falha para um em cada doze homens.
  • Texto é texto real. <text> SVG, não caminhos, para que escale com as configurações do leitor. Sem rótulos embutidos em uma imagem.
  • Respeite o contêiner. viewBox mais width:100%, height:auto, um max-width e um min-width onde os rótulos param de caber. Menos marcas e menos barras a 375 de largura, não um gráfico encolhido.
  • Sem dados falsos. Se os números são placeholders, o gráfico avisa ao lado do título e o relatório lista. [precisa: contagem real de execuções] vence uma ficção plausível.
  • Unidades e comparações. "47 execuções" ou "$48.210", nunca "47". Uma mudança sempre carrega com o que compara: "+12% vs mês passado".
  • Gráficos têm hierarquia. Um gráfico principal por tela, claramente o maior. Um segundo gráfico do mesmo tamanho significa que nenhum deles é o ponto central.

Lista de verificação

  • O gráfico responde a uma pergunta nomeada, e o título diz isso
  • O tipo corresponde à pergunta; sem donut, sem pizza com seis fatias, sem 3D, sem eixos duplos
  • Barras e barras empilhadas começam em zero; qualquer linha truncada diz isso
  • Um acento na série ou ponto que importa; todo o resto neutro
  • Mais de três séries divididas em dois gráficos ou uma tabela
  • Grade e eixo suaves, sem borda do gráfico, sem sombra projetada
  • Rótulos em mono, figuras tabulares, um formato de número, unidades presentes
  • Legenda presente quando há mais de uma série, e não necessária quando há apenas uma
  • Cada figura tem sua comparação onde uma mudança é exibida
  • role="img", <title> e <desc> dizem o que o gráfico mostra, em palavras
  • Legível a 375 de largura e a 200 por cento de zoom; nada cortado, sem colisões de rótulos
  • Funciona em escala de cinza; cor não é a única diferença entre séries
  • Dados placeholder estão marcados na página e listados no relatório
  • Os números rastreiam para uma fonte que você pode nomear

Tabela de tipos de gráfico, as escolhas erradas mas comuns, e as receitas de SVG e CSS manuais: references/charts.md.

Individual skills in this repo

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

Habilidades Relacionadas