clagoss

contraste-colores Skill

计算项目设计 token 颜色(支持 hex、rgb、hsl、oklch)之间的 WCAG 对比度,当某组颜色在文本上达不到 4.5:1 或在界面上达不到 3:1 时,给出保持色相的最小亮度调整建议。当用户更换配色、新增颜色、询问文本是否易读,或在确认明暗主题前使用。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

Contraste de colores

Mides los tokens, no pantallas: así un problema se arregla una vez y se arregla en todo el
sitio. Mínimos de WCAG 2.2 AA:

  • Texto normal: 4,5:1 (1.4.3).
  • Texto grande (24 px, o 18,66 px en negrita): 3:1.
  • Componentes de interfaz y gráficos (bordes de campos, íconos, indicador de foco): 3:1

(1.4.11).

1. Corre el cálculo

node ${CLAUDE_SKILL_DIR}/scripts/contraste.mjs --tokens <archivo>

Si no das archivo, busca src/styles/tokens.css y otros lugares comunes. El script:

  • Lee las variables --color-* (hex, rgb(), hsl(), oklch()), resuelve var(--otro) y

separa tema claro y modo oscuro (prefers-color-scheme: dark, .dark o [data-theme=dark]).

  • Arma los pares por nombre: tokens de texto (texto, text, foreground, contraste, foco,

enlace…) sobre tokens de fondo (fondo, background, superficie, tarjeta…), y
--color-X-contraste sobre --color-X.

  • Para cada par que falla, sugiere un color con la misma tonalidad y la luminosidad más

cercana que cumple (en oklch() y hex), y además un solo valor por token que pasa contra
todos los fondos con que se mide (ese es el que conviene proponer: un token, un cambio).

Si los nombres no siguen ese patrón, crea .kit/contraste.json con los pares reales:

[{"texto": "--color-gris-500", "fondo": "--color-blanco", "tipo": "texto"},
 {"texto": "--color-borde-campo", "fondo": "--color-blanco", "tipo": "ui"}]

y corre con --pares .kit/contraste.json. Para explorar una paleta nueva: --todos.

Si los colores están en Figma

Con el servidor MCP de Figma conectado, mide las variables del archivo de diseño antes de que
lleguen al código:

  1. Pide el link de un frame (o que la persona lo seleccione en Figma) y llama a

get_variable_defs sobre ese nodo. Según la documentación de Figma, devuelve las variables y
estilos usados en la selección (colores, espaciado, tipografía); quédate con los colores, con
su nombre y su valor (por ejemplo color/texto/suave: #9CA3AF).

  1. Escribe esos valores en .kit/figma-tokens.css como variables CSS: color/texto/suave pasa a

--color-texto-suave (barras y espacios por guiones, en minúsculas, con el prefijo
--color-) dentro de :root { … }.

  1. Si el diseño tiene modo oscuro, pide también un frame que lo use y llama otra vez a

get_variable_defs. Si los valores cambian, ponlos dentro de .dark { … } en el mismo
archivo; si salen iguales a los del modo claro, pídele a la persona los valores del modo
oscuro en vez de suponerlos.

  1. Corre el cálculo con --tokens .kit/figma-tokens.css (y --pares si los nombres no siguen el

patrón de arriba).

Para ver texto sobre fotos o degradados del diseño, usa get_screenshot del mismo nodo (paso 2).
Solo lees: la propuesta va en el informe y el cambio de la variable lo hace la persona en Figma.

2. Revisa lo que el script no ve

  • Texto sobre imágenes o degradados: captura la sección y mira el peor punto.
  • Texto con opacidad o colores puestos a mano fuera de los tokens (búscalos con Grep:

#[0-9a-fA-F]{3,8}, rgb(, text-[#).

  • Estados: hover, disabled (los deshabilitados están exentos, pero deben distinguirse),

placeholder (sí debe cumplir si da información).

3. Informe y propuesta

| Par | Ahora | Mínimo | Sugerencia | Dónde se usa |
|---|---|---|---|---|

  • Para «dónde se usa», busca con Grep las clases (text-texto-suave) y var(--color-...).
  • No cambies colores de marca sin preguntar. Ofrece opciones: oscurecer el token, usar el

color solo para texto grande, o crear un token nuevo (--color-acento-texto) para texto
pequeño y dejar el original para fondos y bordes.

  • Si la persona aprueba, cambia el token (un solo lugar), corre de nuevo el script y muestra que

pasa.