CommunityImagengithub.com

dataviz

Convierte filas de datos en un gráfico honesto. Elige el tipo de gráfico según la pregunta que se responde, lo construye como SVG o CSS en línea sin librerías de gráficos, y lo mantiene legible: un acento, cuadrícula suave, etiquetas mono tabulares, línea base cero, unidades reales y una comparación en cada figura. Úsalo cuando el usuario pida un gráfico, diagrama, trazado, sparkline, panel, KPI o mosaico estadístico, quiera visualizar datos, necesite una figura para un informe o diapositiva, o cuando una pantalla tenga ruido de gráficos provisionales que deban convertirse en reales.

¿Qué es dataviz?

Dataviz es una habilidad para agentes de IA (como Claude Code, Cursor, Codex) que transforma datos tabulares en gráficos honestos y accesibles, sin depender de librerías externas. El principio fundamental es que cada gráfico responde a una única pregunta explícita, lo que guía la selección del tipo de gráfico (línea, barra, apilado, sparkline, progreso, etc.) según la naturaleza de los datos (tendencia, comparación, proporción). La salida es SVG o CSS en línea, con un solo acento cromático, cuadrícula suave, etiquetas en monoespaciado tabular, línea base cero para áreas, y cada figura incluye unidades reales y una comparación. La habilidad proporciona un script Node.js (`chart.mjs`) para generar rápidamente gráficos independientes, así como recetas en Markdown para construcción manual. También incluye reglas estrictas de accesibilidad, como soporte para escala de grises, texto real (no trazado), etiquetas de título y descripción con `role="img"`, y adaptación al contenedor con `viewBox`. Está diseñada para evitar gráficos decorativos, datos falsos o paletas multicolor, priorizando la claridad y la honestidad visual.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace dataviz?

Un gráfico es la respuesta a una pregunta. Si no puedes expresar la pregunta en una oración, no puedes elegir el gráfico, y un gráfico que no responde nada es decoración con números.

Aspecto de un buen gráfico

  • Una pregunta por gráfico. El título es la pregunta, o su respuesta. "Carreras por mes", no "Analíticas".
  • El tipo sigue a la pregunta. Tendencia es una línea, comparación son barras, proporción es una barra apilada, un objetivo único es una barra de progreso, una clasificación es una lista con barras delgadas.
  • Un acento. La cosa importante lo recibe. Todo lo demás son pasos neutros de una misma rampa. Nunca un arcoíris dentro de una serie.
  • Línea base cero para todo lo que tenga área. Barras y barras apiladas siempre empiezan en cero. Una línea puede empezar en otro valor si el truncamiento es visible y está indicado.
  • Cromo suave. Cuadrícula, ejes y etiquetas son discretos. El único dato que resalta son los datos, y solo una serie de ellos es llamativa.
  • Números legibles. Unidades en la etiqueta, un formato, tabular-nums, sin decimales finales que mientan sobre la precisión.

Ejecútalo

  1. Escribe la pregunta. Una oración: ¿qué decisión ayuda a tomar este gráfico? Si es "muestra los datos", córtalo o conviértelo en una tabla.
  2. Elige el tipo de references/charts.md. También nombra el gráfico que parece correcto y está mal, que suele ser una dona.
  3. Da forma a las filas. Una tabla, una fila por categoría, una columna por serie, números ya en la unidad que se mostrará. CSV o JSON, nada pre-agregado dos veces.
  4. Constrúyelo.
    • Ruta rápida: node <carpeta de la habilidad>/scripts/chart.mjs data.csv --type line --title "Carreras por mes" --unit carreras --accent "#e0a458" --out chart.svg
    • Tipos: line, bar, stacked, sparkline, progress. Opciones: --width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max.
    • Escribe SVG independiente con role="img", un <title>, un <desc>, etiquetas mono tabulares y una cuadrícula suave. Insértalo en la página tal cual, o incrústalo en línea para estilizarlo con los tokens de la página.
    • Construcción manual cuando el gráfico deba vivir dentro de un componente: las recetas en references/charts.md son SVG y CSS simples, sin dependencias.
  5. Revísalo con la lista de verificación a continuación, al tamaño en que realmente se verá. Un gráfico legible a 720 de ancho no es legible a 280.

Reglas que no son cuestión de gusto

  • Sin librería de gráficos para un gráfico simple. Cuatro barras y una línea son 30 líneas de SVG. Una librería cuesta de 40 a 120 KB, trae estilos por defecto que hay que deshacer, y normalmente incluye un canvas que los lectores de pantalla no pueden leer.
  • No codifiques una serie en muchos colores. Un acento, una serie que lidera. Más de tres series en un gráfico significa dos gráficos, o una tabla.
  • El color nunca es la única señal. Etiquetas directas, posición o una diferencia de forma. Un gráfico que falla en escala de grises falla para uno de cada doce hombres.
  • El texto es texto real. SVG <text>, no trazados, para que escale con la configuración del lector. Sin etiquetas incrustadas en una imagen.
  • Respeta el contenedor. viewBox más width:100%, height:auto, un max-width, y un min-width donde las etiquetas dejen de caber. Menos marcas y menos barras a 375 de ancho, no un gráfico encogido.
  • Sin datos falsos. Si los números son provisionales, el gráfico lo indica junto al título y el informe lo lista. [necesita: recuento real de ejecuciones] es mejor que una ficción plausible.
  • Unidades y comparaciones. "47 carreras" o "$48,210", nunca "47". Un cambio siempre lleva con qué se compara: "+12% vs el mes pasado".
  • Los gráficos tienen jerarquía. Un gráfico principal por pantalla, claramente el más grande. Un segundo gráfico del mismo tamaño significa que ninguno es el punto.

Lista de verificación

  • El gráfico responde a una pregunta con nombre, y el título lo indica
  • El tipo coincide con la pregunta; sin dona, sin pastel con seis porciones, sin 3D, sin ejes duales
  • Las barras y barras apiladas empiezan en cero; cualquier línea truncada lo indica
  • Un acento en la serie o punto que importa; todo lo demás neutro
  • Más de tres series divididas en dos gráficos o una tabla
  • Cuadrícula y ejes suaves, sin borde del gráfico, sin sombra
  • Etiquetas en mono, cifras tabulares, un formato numérico, unidades presentes
  • Leyenda presente cuando hay más de una serie, y no necesaria cuando hay una
  • Cada figura tiene su comparación donde se muestra un cambio
  • role="img", <title> y <desc> dicen lo que muestra el gráfico, en palabras
  • Legible a 375 de ancho y al 200 por ciento de zoom; nada recortado, sin colisiones de etiquetas
  • Funciona en escala de grises; el color no es la única diferencia entre series
  • Los datos provisionales están marcados en la página y listados en el informe
  • Los números se remontan a una fuente que puedes nombrar

Tabla de tipos de gráfico, las opciones incorrectas pero comunes, y las recetas SVG y CSS hechas a mano: references/charts.md.

Individual skills in this repo

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

Skills relacionados