Colores OKLCH
OKLCH es un espacio de color perceptualmente uniforme donde la luminosidad, el croma y el matiz son controles de diseño útiles. Úsalo cuando el proyecto ya use OKLCH, al crear un nuevo sistema de color, o cuando el usuario solicite conversión o trabajo con paletas. En caso contrario, preserva los tokens y la notación establecidos del proyecto: un sistema consistente de tokens hex o RGB es mejor que introducir una segunda representación de color para una corrección aislada. Para explorar interactivamente, visita oklch.fyi.
Referencia rápida
| Categoría | Cuándo usarlo | Referencia |
|---|---|---|
| Conversión | Hex/rgb/hsl a oklch | color-conversion.md |
| Paletas | Generar escalas, multicromáticas, modo oscuro | palette-generation.md |
| Contraste | Verificaciones APCA/WCAG, reportar fallos, corregir bajo petición | accessibility-contrast.md |
| Gama y Tailwind | Fallbacks P3, escalas @theme, ajuste de gama | gamut-and-tailwind.md |
| Uso | Tokens semánticos, un significado por color, énfasis de acción primaria, variantes de apariencia | color-usage.md |
Principios fundamentales
1. Usa un espacio de color perceptual
- Respeta el sistema existente. No conviertas la notación solo porque este skill esté cargado. Reutiliza los tokens semánticos y el formato de autoría del proyecto a menos que la tarea incluya una migración del sistema de color.
- Uniformidad perceptual. Pasos iguales en L = igual brillo.
oklch(0.5 ...)es visualmente medio. Lalightness: 50%de HSL varía enormemente según el matiz. - Matiz estable. El azul HSL se desplaza hacia el púrpura a medida que cambia la luminosidad. El matiz OKLCH permanece constante en todo el rango de luminosidad.
- Croma independiente. El croma es una medida absoluta de colorido que no depende de la luminosidad. La saturación HSL sí depende.
- Gama finita. No todos los valores oklch se corresponden con un color sRGB visible. Los valores de alto croma en ciertos matices se recortarán; se requiere conciencia de gama.
2. Escribe y formatea OKLCH de manera consistente
oklch(L C H)
oklch(L C H / alpha)
| Canal | Rango | Descripción |
|---|---|---|
| L (Luminosidad) | 0–1 | 0 = negro, 1 = blanco. Perceptualmente uniforme. |
| C (Croma) | 0–~0.4 | Colorido. 0 = gris. El máximo depende de L y H. |
| H (Matiz) | 0–360 | Ángulo de matiz en grados. |
| alpha | 0–1 | Transparencia opcional. Sintaxis con barra. |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
Usa tres decimales para L y C y hasta tres para H. Omite ceros finales y formatea -0 como 0. OKLCH es Baseline 2023; cuando los requisitos de compatibilidad sean inusualmente amplios, verifica la matriz de navegadores del proyecto objetivo en lugar de confiar en un porcentaje fijo de cobertura global.
3. Mide contraste, gama y comportamiento de paleta
| Regla | Valor |
|---|---|
| Límite claro/oscuro | L > 0.73 = fondo claro → texto oscuro; por debajo, el texto claro aún obtiene mejor puntuación |
| Brecha de luminosidad (fondo claro) | Primer plano L < 0.35 cuando fondo L > 0.9 |
| Brecha de luminosidad (fondo oscuro) | Primer plano L > 0.9 cuando fondo L < 0.25 |
| Umbral de deriva de matiz | > 10° de dispersión entre pasos de paleta = deriva visible |
| APCA texto de cuerpo | |
| APCA texto no corporal | |
| WCAG 2 texto normal | 4.5:1 AA, 7:1 AAA |
| Corrección de contraste (solo cuando se pida) | Ajusta L primero; preserva C y H cuando sea posible, luego vuelve a medir el par renderizado |
Errores comunes
| Problema | Solución |
|---|---|
| El color en bruto ignora el sistema de tokens semánticos del proyecto | Reutiliza o añade el token de rol correcto en la notación existente del proyecto |
| Valor OKLCH aislado introducido en un código base hex/RGB | Preserva la notación establecida a menos que la tarea incluya una migración del sistema de color |
| Rampa HSL con deriva de matiz | Reconstruye con matiz oklch constante |
| Contraste insuficiente (verifica primer plano contra su fondo usando APCA) | Reporta el par, su Lc medido y el umbral que no alcanza; cambia los colores solo cuando se te pida (entonces ajusta L, mantén C y H) |
| Croma alto sin verificación de gama | Ajusta al croma máximo para la L/H en sRGB |
| Mismo C absoluto en diferentes matices | Usa el mismo % de C (porcentaje del máximo) para una viveza consistente |
| Color P3 sin fallback sRGB | Añade el patrón @media (color-gamut: p3) |
| Modo oscuro creado invirtiendo mecánicamente la paleta clara | Usa la paleta clara como punto de partida, luego ajusta croma y luminosidad y verifica cada par primer plano/fondo |
Hex en @theme de Tailwind v4 | Convierte a valores oklch |
| Alfa con sintaxis de coma | Usa barra: oklch(L C H / alpha) |
| Mismo matiz significa dos cosas diferentes (color de enlace reutilizado decorativamente) | Un color, un significado; asigna al segundo uso un color neutro |
| Token semántico usado fuera de su rol (separador como texto) | Añade un token para el rol faltante; nunca tomes prestado por valor |
| Varios fondos de control coloreados en una misma vista | Rellena solo la única acción primaria; las secundarias se quedan neutras |
| Paleta verificada solo en modo claro | Vuelve a verificar cada par primer plano/fondo en ambas apariencias |
Formato de salida de revisión
Usa este formato solo cuando el usuario solicite una revisión de color independiente. Cuando better-interface orqueste la revisión, proporciona evidencia de dominio y hallazgos a ese skill y deja que su formato de salida, escala de gravedad, reglas de consolidación, límite y veredicto tengan prioridad.
Presenta la revisión independiente en dos partes.
Hallazgos
Agrupa todos los hallazgos confirmados por principio. Usa una tabla markdown con las columnas Gravedad, Ubicación, Antes, Después y Por qué. Nunca uses líneas separadas "Antes:" / "Después:".
- Gravedad:
HIGHhace que el contenido sea ilegible o asigna un color semántico engañoso;MEDIUMcrea un fallo notable de tema, gama o consistencia;LOWes un pulido aislado. - Ubicación: cita
ruta/al/archivo:línea. Si el artefacto no tiene archivos fuente, cita la pantalla y el componente exactos. - Antes / Después: muestra el valor o token actual y el reemplazo exacto.
- Por qué: nombra el principio violado e incluye evidencia de contraste o gama medida cuando sea relevante.
Consolida un problema sistémico repetido en una sola fila y enumera todas las ubicaciones afectadas. Omite principios sin hallazgos.
| Gravedad | Ubicación | Antes | Después | Por qué |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | Los nuevos colores del proyecto usan tokens OKLCH |
| MEDIUM | src/palette.ts:31 | Mismo C absoluto entre matices | Mismo % de C del croma máximo de cada matiz | Valores de croma iguales no aparecen igualmente vívidos entre matices |
| HIGH | src/theme.css:52 | Color P3 sin fallback | Añadir un fallback sRGB antes de @media (color-gamut: p3) | El color falla en pantallas que no son P3 |
Verificación y veredicto
Después de los hallazgos:
- Verificación: enumera las verificaciones exactas realizadas y sus resultados observados, incluyendo mediciones de contraste, verificaciones de gama y ambas apariencias clara y oscura cuando sea aplicable. Si no se realizó una verificación, indica qué necesita aún verificación.
- Veredicto:
Bloqueantesi queda algún hallazgoHIGH,Requiere cambiossi solo quedan hallazgosMEDIUMoLOW, yAprobarsolo cuando no queden hallazgos accionables.
Cuando no haya hallazgos, omite la tabla, indica "Sin hallazgos de color accionables", reporta la verificación y termina con Aprobar.