Communitygithub.com

Fresh Eyes (Ojos Nuevos)

Diseña y revisa pantallas de producto web (aplicaciones, paneles, configuraciones, tablas, formularios, estados vacíos y de error, páginas de aterrizaje, inicio y precios) para que parezcan hechas por una persona reflexiva, no por una plantilla.

¿Qué es Fresh Eyes (Ojos Nuevos)?

Fresh Eyes es una habilidad para agentes de IA (como Claude Code, Cursor, Codex) que guía el diseño y revisión de interfaces de producto web centrándose en la tarea del usuario, el contenido real y una verificación rigurosa. El proceso sigue un ciclo de siete pasos: comprender al usuario y el contexto, decidir la intención antes de estilizar, escribir el contenido primero, construir con estructura y tesauro del proyecto, renderizar y capturar pantallas automatizadas (con Playwright), someter el resultado a una revisión de "ojos nuevos" (un subagente independiente o autoevaluación), y corregir iterativamente. Se apoya en referencias (estructura, jerarquía, claridad, estados, palabras, artesanía, modernidad, pistas de máquina, accesibilidad WCAG 2.2 AA) para asegurar que cada pantalla sea funcional, accesible, y libre de marcas de haber sido generada por IA. Es útil para construir, rediseñar, auditar o mejorar cualquier pantalla o componente de una aplicación web SaaS o su sitio web, incluso si la solicitud no menciona explícitamente "diseño". No aplica a logotipos, presentaciones ni aplicaciones móviles nativas.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bernardoo-soares/fresh-eyes/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Fresh Eyes (Ojos Nuevos)?

Diseña la pantalla para la persona que la usará, a partir del trabajo que vino a hacer y del contenido que verá. El juicio guía; las referencias lo afinan y los scripts lo verifican. Nada aquí está por encima del sentido común: si una pantalla es confusa y ninguna regla nombra por qué, sigue siendo confusa.

<skill> es el directorio de esta habilidad: ${CLAUDE_SKILL_DIR} (si eso aparece como una variable literal, usa la carpeta desde la que se leyó este archivo).

Configuración

Los scripts necesitan Node 20 o posterior. Cuando un script diga que necesita configuración, ejecuta lo que imprima: uno o ambos de npm --prefix "<skill>" install y node "<skill>/node_modules/playwright/cli.js" install chromium, que funcionan desde cualquier carpeta y en cualquier terminal.

Si los scripts no pueden ejecutarse aquí (sin terminal, sin Node, sin red para la descarga del navegador), no te detengas: toma capturas de pantalla con cualquier herramienta de navegador que tenga la sesión, o revisa el código contra references/floor.md línea por línea, y di en el informe que la verificación de renderizado no se ejecutó. Nunca reportes una verificación visual hecha solo desde el código.

El ciclo

Úsalo para crear y para revisar. Para una revisión, lee references/review.md primero: sus pasos reemplazan los pasos 1 al 4, y la versión mejorada es una copia junto al original a menos que la persona haya pedido cambiar sus archivos.

  1. Comprende. Quién usa esta pantalla, para qué trabajo, con qué frecuencia, en qué dispositivo, con qué contenido real. Lee el DESIGN-CONTEXT.md del proyecto si existe (references/design-context.md). Si no, infiérelo a partir del código, la copia y la solicitud, y anota tus suposiciones. No te detengas a entrevistar al usuario primero.
  2. Decide antes de estilizar. Escribe, brevemente, en tus notas de trabajo o en la respuesta, antes de construir: la única cosa para la que sirve esta pantalla; en qué debería posarse la vista primero; qué debe contener la primera pantalla para la decisión principal, en escritorio y en móvil; el orden de todo lo demás; la única acción principal; qué estás dejando fuera. Nombra dos o tres productos que a los usuarios de esta categoría ya les gusten, cuyas estructuras sigues, y el movimiento característico que posee este producto (references/modern.md). Esta es tu intención, y el paso 6 la prueba.
  3. Escribe las palabras primero. Encabezados, etiquetas, botones, estados vacíos y de error, en las palabras de la persona, a partir de los datos reales (references/words.md). Nunca inventes cifras, nombres, testimonios o tendencias; sin datos reales, usa un marcador de posición visible.
  4. Construye en orden: estructura, luego jerarquía, luego artesanía, con los componentes y tokens del proyecto cuando los tenga (para React con shadcn/ui, lee references/stacks/react-shadcn.md). Un nuevo sistema visual comienza desde node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir>, que verifica cada par de colores.
  5. Renderiza y mira. Para una aplicación, inicia su servidor de desarrollo y pasa la URL. Escribe --out en una carpeta temporal fuera del proyecto: node "<skill>/scripts/render.mjs" <page.html | url> --out <dir> (si pide configuración o no puede ejecutarse, consulta Configuración); detrás de un inicio de sesión, añade --storage-state <file>. Guarda capturas de escritorio y móvil, modo claro y oscuro, imprime los problemas que puede medir (contraste, foco, desplazamiento lateral, objetivos pequeños, botones primarios en competencia, bordes de color, guiones largos), luego una lista de "verificación visual". Corrige cada problema, o nombra en el informe por qué uno se mantiene; una revisión corrige problemas de base, bordes de color y guiones largos, y ofrece los otros indicios medidos como hallazgos. Si advierte que el modo claro y oscuro se ven idénticos, vuélvelo a ejecutar con --theme-mode class. Mira las capturas, las cuatro -first.png primero, y cada elemento de "verificación visual": una lista vacía significa que la base está limpia, no que la pantalla es buena. Renderiza una vez con contenido de estrés: el nombre real más largo, la cantidad más grande, la cuenta vacía.
  6. Ojos nuevos. Inicia un nuevo subagente que no tenga nada de esta conversación (no una bifurcación de ella); usa el tipo de agente first-look si aparece listado. Su mensaje completo: Lee <skill>/agents/first-look.md y síguelo. El trabajo: <una oración>. Imágenes: <rutas absolutas, las de la primera pantalla primero>. No abras ningún otro archivo. No añadas nada sobre tu intención ni sobre lo que construiste o cambiaste. Compara sus respuestas con el paso 2: un "qué es esto" equivocado, un primer clic equivocado, una vacilación o un "se siente extraño" son una corrección; en una revisión de una página que ya funciona, una vacilación que ni bloquea ni desvía el trabajo es una sugerencia opcional, no una corrección. Sin subagentes, responde tú mismo las preguntas de "primer vistazo" solo a partir de las imágenes de la primera pantalla, antes de releer tu código.
  7. Corrige y detente. Corrige cada vacilación con estructura primero (una etiqueta, una lista, un visual, una reagrupación); añade una oración solo cuando nada más pueda transmitirlo. Una duda sobre un nombre se corrige con un mejor nombre, nunca con una línea de explicación debajo, y nunca se explica nada dentro de un menú. Como máximo dos rondas más de los pasos 5 y 6, luego nombra lo que aún está abierto. Responde las tres preguntas de la prueba en references/modern.md (qué producto de esta categoría llamaría a esto actual; dónde está la característica distintiva; podría esto pertenecer a cualquier startup), e informa.

El camino más simple primero. La acción principal funciona desde el momento en que la pantalla se abre; la capacidad extra (editar cada fila, herramientas masivas) está un nivel más abajo, nunca en el camino de la primera pantalla (references/structure.md).

Terminado, no desnudo. Evitar las pistas de máquina no es el objetivo. Una pantalla debe verse como un producto terminado: unidades en las que la persona actúa dentro de sus propios contenedores, iconos y pequeños visuales donde tienen significado, toda la decisión en la primera pantalla. Una columna ancha de oraciones grises también es un fracaso (references/hierarchy.md).

Escálalo a la solicitud. Solo palabras (etiquetas, un mensaje de error): pasos 1 a 3. Un componente o una corrección pequeña: pasos 1 a 5. Una pantalla completa o una revisión: los siete.

Las preguntas que deciden la mayoría de las pantallas

PreguntaLee
¿Quién viene aquí, con qué frecuencia, para qué trabajo? ¿Qué tan denso debería ser (postura)? ¿Cómo se agrupan, nombran y alcanzan las cosas?references/structure.md
¿En qué debería posarse la vista primero? ¿Hay exactamente una acción principal? ¿Cada número tiene su comparación, unidad y fecha?references/hierarchy.md
¿Puede un principiante saber qué es esto, dónde está y qué hacer a continuación?references/clarity.md
¿En qué estado está cada región, y es exactamente uno? Cuando alguien se equivoca, ¿deshacer o confirmar?references/states.md
¿Las palabras nombran las cosas como lo hace la persona? ¿Cada error dice la solución?references/words.md
¿La tipografía, el espaciado, el color, el modo oscuro y la animación son deliberados?references/craft.md
¿Se ve terminado, o como un documento? ¿La primera pantalla contiene la decisión?references/hierarchy.md
¿Se ve actual sin parecer generado? ¿Cuál es su sello distintivo?references/modern.md
¿Podría esta pantalla pertenecer a cualquier producto? ¿Qué puede dejarla?references/tells.md
¿Es una página de aterrizaje, inicio o precios? ¿Qué debe decidir un visitante?references/landing.md
¿Teclado, contraste, reflujo, nombres, objetivos, en ambos temas?references/floor.md

Lee una referencia cuando su pregunta esté abierta en la pantalla que tienes delante, no todas de una vez. Cada tarjeta en ellas tiene una Decisión, un Haz, el Por qué con su fuente, qué Buscar, y cuándo no aplica (A menos que). Las excepciones importan tanto como las reglas.

Líneas que no se mueven

  • Solo contenido real: nada de números, personas, citas o historias inventadas.
  • El piso de accesibilidad (references/floor.md) se mantiene en modo claro y oscuro.
  • Sin borde de color en un borde de un elemento como acento, y sin guiones largos en el texto (references/tells.md).
  • En una revisión, mantén cada dato y cada acción que tenía la página; muévelo o degrada, no lo elimines.
  • "No se necesita cambio" es una revisión completa cuando nada le cuesta nada a la persona. Nunca cambies solo por gusto.

Informe

Palabras llanas, breves:

  • qué construiste o cambiaste, cada uno vinculado al trabajo de la persona y a lo que le ahorra; en una revisión, cada cambio, por pequeño que sea (un tamaño, un espacio, un color), por ejemplo como una tabla breve de era, ahora y qué le ahorra a la persona: un cambio que no nombres es una promesa rota;
  • qué supusiste, como máximo tres elementos, y qué cambiaría si una suposición es incorrecta;
  • qué verificaste: los problemas de renderizado antes y después, y cómo el primer vistazo se comparó con tu intención;
  • qué no probaste (gestos, un teléfono real, Safari, un lector de pantalla), y si el renderizado se ejecutó.

Sin puntuaciones, IDs ni números de regla. Si el proyecto no tiene DESIGN-CONTEXT.md, ofrécete a escribir uno a partir de tus suposiciones.

Skills relacionados