Communitygithub.com

voytas75/diseño-de-panel-operativo

Útil para diseñar paneles operativos. Sigue un flujo de datos de visión general → atención → detalle → acción, manteniendo la vista principal libre de oraciones explicativas.

¿Qué es diseño-de-panel-operativo?

Este skill proporciona una metodología estructurada para diseñar tableros operativos (dashboards) centrados en datos, orientados a la toma de decisiones y acciones definidas. Está diseñado para desarrolladores y agentes de IA que necesitan crear o refactorizar paneles, vistas de KPI o gráficos analíticos compactos. El flujo principal sigue la secuencia 'visión general → atención → detalle → acción', asegurando que la superficie de datos primaria permanezca libre de narrativa explicativa. Incluye pasos detallados para establecer un contrato de datos (definiendo umbrales, unidades y valores ausentes), definir jerarquías y acciones, elegir codificaciones visuales apropiadas (como mapas de calor clasificados, gráficos de bala, barras de participación segmentadas, sparklines y superficies de detalle consistentes), aplicar lenguaje escaso y accesibilidad, y construir el artefacto solicitado con verificación de calidad. El skill es compatible con cualquier plataforma (mockups, imágenes, HTML o dashboards funcionales) y no requiere bibliotecas específicas, solo herramientas para inspeccionar datos, construir y probar. Incluye una lista de verificación detallada para QA que cubre datos, saliencia visual, color, contraste, lenguaje, interacción, diseño e integridad. Es útil para diseñadores, desarrolladores frontend y agentes de IA que automatizan la creación de dashboards operativos con alta fidelidad y accesibilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/voytas75/skills/tree/HEAD/skills/operational-dashboard-design

Preguntar en tu IA favorita

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

Documentación

Diseño de Panel Operativo (Dashboard Operativo)

Construye un tablero centrado en los datos siguiendo el flujo visión general → atención → detalle → acción. Mantén la vista principal libre de oraciones explicativas sin ocultar la información necesaria para interpretar los datos u operar los controles.

Cuándo Usarlo

  • Diseñar o revisar un panel operativo, una vista de KPI o un gráfico analítico compacto.
  • Ayudar a los usuarios a identificar excepciones y tomar una acción definida a partir de los datos afectados.
  • Refactorizar un panel desordenado en un sistema visual consistente y escaneable.

No lo uses como regla universal para informes narrativos, gráficos educativos, incorporaciones (onboarding) o interfaces que necesiten instrucciones explícitas. Los gráficos estáticos no pueden depender de tooltips ni pretender proporcionar acciones interactivas.

Entradas y Prerrequisitos

Obtén el conjunto de datos o esquema preciso, la audiencia prevista, la decisión operativa, el formato de entrega (mockup, imagen, HTML o tablero funcional) y el dispositivo de destino. Identifica las unidades de las métricas, las ventanas de tiempo, las líneas base, los umbrales, la dirección deseada y las acciones permitidas.

No se requiere ninguna biblioteca, servicio o cliente de agente específico. Utiliza las herramientas disponibles para inspeccionar los datos, construir el artefacto solicitado y probarlo. Pregunta solo por la información faltante que sea crítica para la decisión; etiqueta las suposiciones provisionales. Nunca inventes mediciones, umbrales, acciones o resultados de control de calidad exitosos.

Procedimiento

1. Establecer el contrato de datos

  • Verifica los totales, la agregación, los denominadores, las unidades, las ventanas de tiempo y la comparabilidad de las líneas base con los cálculos reales.
  • Distingue entre valores cero, faltantes, obsoletos, no disponibles y no aplicables; nunca conviertas silenciosamente datos faltantes a cero.
  • Define si los valores más altos o más bajos son problemáticos para cada métrica. Para métricas neutrales como el gasto, utiliza un presupuesto o rango aprobado; si no hay uno, usa un estilo neutral y no impliques un problema.
  • Mantén visibles la incertidumbre estadística y la frescura de los datos cuando afecten las decisiones.

Completo cuando: cada métrica mostrada tiene una interpretación definida y limitaciones de datos conocidas.

2. Definir jerarquía y acción

  • Comienza con el estado general, luego las excepciones señaladas directamente en los datos, luego el detalle.
  • Establece la prioridad de atención a partir de la gravedad y la relevancia de la decisión, no de una decoración visual arbitraria.
  • Coloca la acción en o junto al dato afectado: por ejemplo, una celda de mapa de calor accionable abre su detalle o flujo de trabajo relevante.
  • Utiliza nombres accesibles significativos, enfoque visible y affordances interactivas claras. Nunca inventes una acción de remediación ni la ejecutes como parte del diseño de la vista.

Completo cuando: cada bandera tiene una razón definida y una acción real o un destino de detalle explícitamente no interactivo.

3. Elegir codificaciones visuales

Prefiere la posición en una escala común, luego la longitud, luego el ángulo/área, luego el color cuando se adapten a la tarea. Esta es una heurística de diseño, no una garantía de que una codificación se ajuste a cada conjunto de datos.

Vocabulario visual predeterminado:

  • Mapa de calor clasificado: umbrales discretos y etiquetados para el escaneo de excepciones.
  • Gráfico de bala: valor, objetivo comparable y rangos significativos en lugar de indicadores (gauges). Alinea las escalas cuando las comparaciones lo requieran.
  • Barra de participación segmentada: partes de un todo definido en lugar de gráficos circulares, incluidas las participaciones de dos categorías. Muestra el denominador y no impliques un todo para categorías superpuestas.
  • Sparkline: contexto temporal compacto con suficiente información de punto final, escala o rango para evitar comparaciones engañosas.
  • Superficie de detalle consistente: tooltips con un popover o panel de detalle equivalente accesible mediante enfoque/toque.

Si este vocabulario no puede representar honestamente la tarea solicitada, explica la discrepancia y propón una alternativa adecuada en lugar de forzar los datos en él.

Completo cuando: cada componente respalda una comparación o decisión y su escala es interpretable.

4. Aplicar lenguaje escaso y prominencia accesible

  • En la vista de datos principal, usa nombres de métricas concisos, valores, unidades, etiquetas de período, etiquetas de línea base y etiquetas de control/estado necesarias; sin información narrativa ni párrafos explicativos.
  • Una comparación compacta como ▼ 15% vs Sep debe identificar qué se compara y si el cambio es favorable. Una flecha sola no debe codificar la gravedad.
  • Coloca las explicaciones de apoyo en los detalles, pero nunca hagas que el significado esencial sea solo al pasar el ratón. Proporciona acceso por teclado y táctil, nombres accesibles y una representación de texto/datos equivalente cuando corresponda.
  • Usa escalas secuenciales para magnitudes ordenadas, escalas divergentes alrededor de un punto medio significativo o escalas clasificadas para umbrales definidos.
  • Aumenta la intensidad visual hacia un problema establecido. Cuando los valores bajos son malos, invierte el mapeo de gravedad; cuando ambos extremos son malos, usa umbrales de dos lados.
  • Combina el color con una señal no cromática como forma, icono, patrón, borde o etiqueta de estado corta explícita.
  • Apunta a una relación de contraste de al menos 4.5:1 para texto ordinario y 3:1 para texto grande y límites de gráficos/controles significativos. Prueba las combinaciones reales de primer plano/fondo y los estados de interacción; evita el texto de acento sobre un tinte de acento no verificado.
  • Elimina decoraciones, cuadrículas redundantes y fondos innecesarios. Mantén las leyendas, etiquetas y guías cuando sean necesarias para interpretar los datos.

Completo cuando: la vista sigue siendo comprensible sin color, hover ni oraciones explicativas en su superficie de datos principal.

5. Construir y verificar el artefacto solicitado

Entrega el formato solicitado, no solo una descripción de diseño. Para un tablero funcional, ejercita sus interacciones y estados de datos; para una imagen o mockup, identifica claramente los controles no funcionales.

Ejecuta la lista de verificación a continuación. Corrige los defectos confirmados y marca las comprobaciones no realizadas como no verificado. No llames especificación a un tablero implementado ni revisión estructural a una prueba de usabilidad.

Completo cuando: el artefacto se entrega con control de calidad respaldado por evidencia y limitaciones explícitas.

Verificación

  • Datos: los totales y las participaciones calculadas se reconcilian; las unidades, las ventanas de tiempo, los denominadores y las líneas base coinciden; se prueban los estados faltantes/obsoletos/neutrales.
  • Prominencia: inspecciona la vista renderizada y verifica si la excepción prevista es prominente. Distingue una revisión visual de una prueba de atención del usuario medida.
  • Color: inspecciona una simulación real de visión de color cuando las herramientas lo permitan; confirma de forma independiente que las señales no cromáticas transmitan la gravedad. La simulación por sí sola no establece la accesibilidad.
  • Contraste: mide los pares de color renderizados y los estados relevantes; informa el método y las fallas en lugar de afirmar el cumplimiento basado en nombres de paletas.
  • Lenguaje: inspecciona la superficie principal en busca de oraciones explicativas, conservando las palabras necesarias de control, estado y seguridad.
  • Interacción: ejercita la navegación por teclado, el enfoque visible, los detalles de enfoque/toque, el descarte y la ruta de acción prevista sin realizar acciones externas no aprobadas.
  • Diseño: verifica el viewport de destino, el recorte, el desbordamiento, las etiquetas largas y los estados representativos vacíos/de un solo elemento/de varios elementos.
  • Integridad: las leyendas y escalas son suficientes, las reglas de diseño no entran en conflicto y la salida no inventa datos ni implica acciones no admitidas.

Contrato de Salida

Devuelve:

  1. El artefacto solicitado o su ubicación verificada.
  2. Una breve descripción de la decisión principal y la ruta de acción.
  3. Un informe de control de calidad compacto que separe las comprobaciones aprobadas, fallidas y no verificadas, con métodos o evidencia.
  4. Suposiciones o bloqueadores restantes y un siguiente paso concreto si está incompleto.

La regla de no narrativa se aplica a la superficie de datos principal del tablero, no a este informe de entrega, al texto de accesibilidad ni a los mensajes esenciales de error/seguridad.

Errores Comunes (Pitfalls)

  • El minimalismo que elimina el contexto necesario es ambigüedad, no eficiencia.
  • Un valor rojo no es necesariamente un problema; la gravedad requiere una regla específica de la métrica.
  • Un tooltip no es un sustituto accesible de la información esencial visible o accesible mediante enfoque.
  • Los gráficos escasos aún pueden engañar mediante escalas incompatibles, rangos truncados o denominadores faltantes.
  • No reclames conformidad con WCAG solo a partir de una verificación de contraste.
  • No reclames seguimiento ocular, simulación de visión de color o interacciones probadas sin haberlas realizado realmente.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados