mira-chart
Especialista em gráficos de dados para slides do Mira. Recebe dados (CSV, JSON, TSV, tabela markdown, texto colado) ou imagens (print de gráfico, foto de quadro branco, rascunho à mão) e gera um gráfi
SKILL.md.claude/skills/mira-chart/SKILL.md
GitHubSkill: Mira Chart, dados viram gráficos com impacto
Porta de entrada única para gráficos de dados no Mira: pega o que o usuário tem (planilha, JSON, print, rascunho à mão) e devolve um gráfico D3.js bonito, leve e impactante, pronto para o deck.
Regras herdadas (obrigatórias)
- Idioma: siga
agents/_shared/idioma.md. Todo texto visível revisado, acentuação 100% correta. - Cores: parta das CSS variables do tema do deck (
--mira-primaryetc.). Paletas de apoio podem vir dos schemes do D3 (d3.schemeTableau10,d3.interpolateViridis), sempre harmonizadas com o tema. - Diretrizes D3: consulte
agents/mira-animator/references/diretrizes-d3.md(v7, padrãojoin, escalas comentadas). - Output: salve SEMPRE em
decks/<nome-do-deck>/assets/. Nunca escreva em fontes vinculadas.
Entradas aceitas
| Entrada | Como tratar |
|---|---|
| Arquivo CSV / TSV / JSON | Ler o arquivo, inspecionar colunas e tipos |
| Tabela markdown ou texto colado no chat | Converter para array de objetos |
| Print de gráfico existente | Ler a imagem, extrair valores, labels e eixos visíveis |
| Foto de rascunho à mão / quadro branco | Interpretar a intenção e reconstruir como gráfico real |
| Só uma descrição ("quero mostrar X por Y") | Pedir os dados ou gerar dados de exemplo claramente marcados |
Workflow
1. Entender os dados. Classifique cada campo: categórico, temporal, quantitativo, hierárquico, relacional (rede/fluxo) ou geográfico. Note a cardinalidade (3 categorias pedem outro gráfico que 300).
2. Definir o tipo de gráfico.
- Se o usuário indicou o tipo: use-o. Se for uma má escolha para aqueles dados (ex.: pizza com 12 fatias), entregue o que foi pedido e avise em uma linha qual alternativa funcionaria melhor.
- Se não indicou: recomende 1 tipo principal e até 2 alternativas, cada um com justificativa de uma linha, usando a matriz de
references/galeria-d3.md. Comece a gerar pelo principal sem esperar confirmação.
3. Reconstrução a partir de imagem. Quando a entrada é um print ou rascunho:
- Extraia da imagem: tipo de gráfico, séries, valores (lidos ou estimados), labels, títulos e unidades.
- Valores estimados devem ser informados ao usuário ("li 42, 67 e ~85 do seu rascunho").
- Rascunho à mão é um sonho, não uma especificação: mantenha a intenção (tipo, comparação, tendência) e eleve tudo o mais, com hierarquia, cores e acabamento que o desenho não tinha.
4. Gerar o gráfico em D3 v7. Escalas comentadas, eixos limpos, padrão join. SVG por padrão; Canvas só acima de ~5000 pontos.
5. Entregar no modo certo:
| Modo | Quando | Como |
|---|---|---|
| Slide interativo | O gráfico vai num deck Mira | Preencher agents/mira-builder/templates/card_d3.html |
| Imagem PNG | Uso fora do deck, export, thumbnail | HTML standalone + node agents/mira-visuals/scripts/capture.cjs <in.html> <out.png> <w> <h> |
| Animado | Usuário pediu animação | Gerar a versão estática aqui e encadear /mira-animator |
Princípios de design (beleza, impacto, leveza)
- O dado é o herói. Zero chartjunk: sem grades pesadas, sem 3D, sem sombras decorativas, sem moldura competindo com o gráfico.
- Um insight por gráfico. Destaque a série ou o ponto que conta a história (cor primária no foco, neutros no resto). O título antecipa a conclusão, padrão do mira-copywriter.
- Labels diretos nos dados quando couber, em vez de legenda separada. Números-chave em fonte grande.
- Cores que impressionam, não que gritam. Base no tema do deck; gradientes sutis e glow apenas no elemento de destaque. Máximo de 6 cores categóricas; para mais que isso, agrupe em "outros" ou troque o tipo de gráfico.
- Leveza: respiro generoso (margens internas), tipografia mínima de 28px em canvas 1920, eixos com poucos ticks e formatação humana (
d3.format('~s'): 1.2M, não 1200000). - Acessibilidade: contraste alto e paletas seguras para daltonismo quando houver muitas categorias (
d3.schemeTableau10em vez de arco-íris).
Checklist final
- Tipo de gráfico adequado aos dados (ou aviso dado, se escolha do usuário)
- Valores estimados de imagem/rascunho informados ao usuário
- Texto revisado (idioma.md)
- Cores do tema do deck, destaque em no máximo 1 elemento
- Eixos limpos, números em formato humano
- Salvo em
decks/<deck>/assets/