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()), resuelvevar(--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:
- 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).
- Escribe esos valores en
.kit/figma-tokens.csscomo variables CSS:color/texto/suavepasa a
--color-texto-suave (barras y espacios por guiones, en minúsculas, con el prefijo
--color-) dentro de :root { … }.
- 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.
- Corre el cálculo con
--tokens .kit/figma-tokens.css(y--paressi 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) yvar(--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.