Communitygithub.com

money-data

Habilidad de diseño. Muestra datos monetarios y financieros de forma correcta y atractiva. Cubre cantidades, monedas, deltas, identificadores de cuenta, color de ganancia/pérdida según la configuración regional, elección de gráficos (saldos, gastos, flujo de caja, carteras, proyecciones, KPI), líneas base, exploración y accesibilidad de gráficos, estado de progreso y pago (transferencias, tarjetas, pasos KYC, disputas, metas), listas de transacciones, recibos, estados de cuenta y paneles de control B2B y cuadrículas de datos. Úsala siempre que diseñes, construyas, critiques o crees prototipos de una pantalla o componente.

¿Qué es money-data?

Esta habilidad de diseño para agentes de IA (Claude Code, Cursor, Codex, etc.) proporciona reglas y referencias especializadas para presentar datos financieros de forma clara, precisa y accesible en aplicaciones de consumo y herramientas B2B densas. Se basa en estándares de tipografía y visualización de datos, así como en prácticas documentadas de empresas como Wise, Monzo, Stripe, Coinbase, Robinhood, Apple e IBM Carbon. La habilidad cubre desde el formato de cantidades y monedas (usando APIs de plataforma como `Intl.NumberFormat`) hasta la elección de gráficos, manejo de ganancias/pérdidas con tokens semánticos según la configuración regional, estados de progreso (cargando, pendiente, fallido) y accesibilidad (contraste 3:1, resumen de tabla). Incluye una lista de verificación previa a la entrega y referencias detalladas para áreas específicas como números, color, gráficos, estado y paneles de control. Es ideal para evitar errores comunes como usar colores rojo/verde fijos para ganancias/pérdidas o mostrar números sin formato, asegurando que la información financiera se entienda a la primera.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Sthitapragna-009/Critical_UX/tree/HEAD/skills/money-data

Preguntar en tu IA favorita

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

Documentación

¿Qué hace money-data?

Cómo mostrar el dinero para que la gente lo lea bien a la primera. Estas reglas se aplican tanto a aplicaciones de consumo como a herramientas B2B densas. Provienen de estándares de tipografía y visualización de datos aplicados estrictamente al dinero, además de prácticas documentadas en Wise, Monzo, Stripe, Coinbase, Robinhood, Apple e IBM Carbon.

Combina esta habilidad con critical-core (riesgo, emoción, lenguaje visual) y money-flows (las acciones que mueven el dinero).

Cómo usar esta habilidad

  1. Nombra el trabajo de cada número. ¿Es un saldo, una cantidad a pagar, un delta, una tasa, una proyección, una referencia? El trabajo decide el formato, la precisión, el color y la posición.
  2. Carga la referencia que necesites (a continuación) antes de escribir código o especificar un componente. Usa los valores exactos; no improvises formatos.
  3. Escribe los estados, no solo el camino feliz. Cada superficie de dinero tiene estados de carga, desactualizado, pendiente, fallido, vacío y oculto.
  4. Ejecuta la lista de verificación al final antes de entregar cualquier cosa.
ReferenciaCárgala para
references/numbers-and-identifiers.mdFormato de moneda, unidades menores, redondeo, notación compacta, números negativos, cifras tabulares, enmascaramiento de números de cuenta, unidades y dosis
references/color-and-gain-loss.mdColor positivo/negativo según la configuración regional, pares seguros para daltonismo, contraste para marcas, tokens semánticos
references/charts.mdSelector de gráficos, líneas base, rangos de tiempo, proyecciones e incertidumbre, sparklines, exploración, accesibilidad de gráficos, límites de gamificación
references/progress-and-status.mdUmbrales de carga, mapas de estado de pagos y transferencias, estado de tarjetas, disputas y KYC, metas de ahorro y medidores de crédito
references/records-and-dashboards.mdFilas de transacciones, limpieza de comercios, recibos, estados de cuenta, paneles de control B2B, cuadrículas de datos financieros, registros de auditoría, conciliación

Los tokens de diseño originales para todo lo anterior se encuentran en /tokens en la raíz del repositorio.

Las reglas que más importan

Cada regla lleva un tipo de fuente: [REG] ley o estándar, [RES] investigación publicada, [PRAC] práctica empresarial documentada, [INF] síntesis crítica de UX.

  1. Formatea con la plataforma, nunca a mano. Usa Intl.NumberFormat (web), NumberFormatter/FormatStyle (Apple), NumberFormat/DecimalFormat (Android). Manejan la posición del símbolo, los separadores y las unidades menores de cada moneda (JPY no tiene, KWD tiene tres). [PRAC]
  2. Cada cantidad lleva su moneda. No hay números desnudos en productos multimoneda. Usa el código ISO (USD) cuando el símbolo es ambiguo ($ solo puede significar USD, CAD, AUD, MXN y otros). [INF]
  3. Cifras tabulares para cualquier número que cambie o esté en una columna (font-variant-numeric: tabular-nums). Las cifras proporcionales tiemblan a medida que los valores cambian. [PRAC]
  4. Notación compacta solo en ejes y resúmenes de tarjetas. Nunca en un saldo, monto de pago, tarifa o cualquier cosa sobre la que la persona vaya a actuar. [INF]
  5. Las partes suman el total, o la pantalla dice que se aplica redondeo. [INF]
  6. Positivo y negativo son tokens semánticos resueltos por configuración regional o ajuste, no verde y rojo codificados. Rojo significa subida en los mercados de China continental, Japón y Taiwán. Siempre combina el color con un signo (+/−) y un glifo. [RES/PRAC]
  7. Las marcas de los gráficos alcanzan un contraste de 3:1 con los colores adyacentes (WCAG 1.4.11), y ningún significado depende solo del color (WCAG 1.4.1). [REG]
  8. Las barras comienzan en cero. Las líneas pueden no hacerlo. Las barras truncadas exageran las diferencias. [RES]
  9. Nunca muestres una sola línea para un futuro incierto. Las proyecciones de ahorros, jubilación, amortización de préstamos o pronósticos utilizan un gráfico de abanico o de bandas. Un estudio del Banco de Inglaterra de 2026 (n≈1600) encontró que los gráficos de abanico transmitían mejor la expectativa y la incertidumbre y protegían la confianza después de un error. [RES]
  10. Cada gráfico tiene una vista de tabla y un resumen en una línea de titular. La exploración tiene un equivalente de teclado y lector de pantalla. [PRAC]
  11. Indica la línea base de cada delta. "+2.4% hoy (desde el cierre de ayer)". [PRAC]
  12. El progreso es honesto. Asigna los estados del backend a 3–5 etapas simples con marcas de tiempo. "Enviado" no es "llegado". Las ETA se etiquetan como estimaciones. El dinero devuelto tiene su propio estado no final. [PRAC]
  13. Muestra que un toque se registró de inmediato. Las advertencias "No presiones dos veces" fallan; un estado instantáneo de "procesando" con el botón deshabilitado funciona. [RES]
  14. Enmascara los identificadores por defecto (•••• 4421), revélalos bajo demanda con reautenticación para números completos. [PRAC]
  15. Pendiente está etiquetado y explicado, y nunca se agrega o elimina silenciosamente del saldo disponible. [INF]
  16. No hay mecánicas de recompensa en gráficos de inversión, crédito o gasto (confeti en operaciones, revelaciones de rasca y gana, clasificaciones de popularidad). Robinhood pagó $7.5M a Massachusetts en 2024 por estas prácticas. [REG]

Especificaciones rápidas

Jerarquía de cantidades. En una pantalla de saldo o pago, la cantidad es el texto más grande, en cifras tabulares, con la moneda en el mismo peso visual o un paso más claro. Los dígitos decimales pueden ser más pequeños pero nunca con un contraste inferior a 4.5:1.

Etiqueta delta. +£12.40 (+0.8%) hoy → signo, absoluto, relativo, período. Token de color + glifo de flecha + signo. El cero se muestra como £0.00 (0.0%) sin signo y con color neutro (signDisplay: "exceptZero").

Chip de estado. Icono + palabra + color, nunca solo color. Usa verbos que la gente entienda: Pendiente, Pagado, Fallido, Reembolsado, Devuelto. Evita códigos internos (AUTHORISED, SETTLED).

Antes de entregar, verifica

  • Cada cantidad formateada por la API de la plataforma para la configuración regional del usuario, con moneda
  • Cifras tabulares en todos los números cambiantes o en columnas
  • Sin notación compacta en cantidades sobre las que se va a actuar
  • Ganancia/pérdida usa tokens semánticos + signo + glifo; probado con un simulador de daltonismo
  • Barras desde cero; proyecciones como bandas; líneas base indicadas
  • Cada gráfico tiene un titular, una vista de tabla y acceso por teclado
  • Cada estado tiene estados de carga, pendiente, fallido, devuelto y desactualizado con marcas de tiempo
  • Identificadores enmascarados; la revelación es deliberada
  • El modo de saldo oculto (privacidad) funciona en todas las superficies de dinero
  • El texto se escala al 200% sin truncar cantidades

Lee los enlaces de origen dentro de cada referencia antes de confiar en un punto regulatorio para un producto en producción.

Skills relacionados