Communitygithub.com

frontend

Úsalo al construir, revisar o corregir interfaces de navegador, como páginas, componentes, formularios, estado del cliente, gráficos, vistas de impresión o PDF, accesibilidad o rendimiento web (Core Web Vitals, tamaño del bundle, renderizados lentos). No para dirección visual, crítica de diseño o marca (usa `designer` o `visual-design`). No para aplicaciones nativas o React Native (usa `mobile`).

¿Qué es frontend?

La habilidad 'Frontend' define estándares estrictos para construir interfaces de navegador que funcionen para personas reales con teclados, lectores de pantalla, teléfonos lentos e impresoras. Es útil para desarrolladores que quieren asegurar que su UI no solo 'se vea terminada' sino que sea accesible, robusta y con buen rendimiento. Funciona en cualquier proyecto web (frameworks como React, Vue, Angular o HTML plano) y proporciona reglas clave sobre semántica HTML, gestión de estado, rendimiento (Core Web Vitals), accesibilidad, y pruebas. También incluye guías específicas para gráficos, vistas de impresión y modos simplificados. La habilidad se basa en su documentación SKILL.md, que detalla ocho reglas fundamentales, una tabla de dónde debe vivir cada tipo de estado, y una lista de verificación para pruebas y revisiones de código.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/frontend

Preguntar en tu IA favorita

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

Documentación

¿Qué hace frontend?

Estándares para interfaces de navegador que usan personas reales con teclados, lectores de pantalla, teléfonos lentos e impresoras. Las reglas a continuación son las que se pasan por alto cuando la interfaz "se ve terminada".

Reglas que más importan

  1. Usa el elemento que significa lo que hace. <button> para acciones, <a href> para navegación, <label> para cada campo, <table> para datos tabulares. Un <div> con un manejador de clic no es enfocable, no tiene rol y es invisible para la tecnología de asistencia. ARIA solo llena vacíos que un elemento nativo no puede cubrir.
  2. Toda vista asíncrona tiene cuatro estados: cargando, error, vacío y con datos. Escribe los cuatro antes de dar la vista por terminada. Una región en blanco es un error.
  3. Nunca inventes datos. Un período faltante es un vacío o una etiqueta "Sin datos", nunca cero y nunca una línea interpolada. Las previsiones siempre deben ser visiblemente distintas de los datos reales.
  4. Nunca uses solo color para señalar algo. Cada estado codificado por color también lleva texto o un icono con un nombre accesible. La impresión en escala de grises y los lectores daltónicos no obtendrían nada si no.
  5. El estado compartible vive en la URL. Filtros, pestañas, términos de búsqueda, IDs seleccionados. Atrás, actualizar y compartir debe mantenerlo. El estado efímero (hover, un tooltip abierto) no va en la URL.
  6. Un valor derivado de varias piezas de estado obtiene una función, llamada cada vez que alguna de ellas cambia. Nunca lo calcules dentro del callback que pertenece a una de ellas. Ejemplo: un enlace de descarga construido a partir de un límite de tiempo y un filtro de grupo solo se reconstruía en el callback de búsqueda del límite, así que después de un cambio de filtro, la exportación apuntaba silenciosamente a la lista completa.
  7. Reajusta desde 320 píxeles CSS hacia arriba. Sin desplazamiento horizontal de página, sin contenido recortado, texto redimensionable al 200%. Prueba tanto en un ancho de teléfono como en el ancho de escritorio para el que diseñaste.
  8. Iguala las herramientas a la necesidad. En un repositorio existente, sigue el framework y la herramienta de construcción ya presentes. Para una página nueva pequeña o herramienta interna, considera HTML, CSS y un poco de JavaScript antes de agregar un pipeline de construcción; recurre a un framework cuando el estado realmente lo requiera.

Cuándo no usar

  • Elegir una dirección visual, tipografía o paleta: las habilidades designer y visual-design.
  • iOS nativo, Android o React Native: la habilidad mobile (y swift para código Swift).
  • Forma de la API y endpoints del servidor: las habilidades api-design y backend-patterns.
  • Técnica de prueba en profundidad: las habilidades tdd y testing-strategy.

Dónde vive el estado

Decide antes de escribir el estado del componente. Empieza local y escala solo por una razón declarada.

EstadoHogarEjemplo
UI localEstado del componenteModal abierto, borrador de entrada, hover
Compartido por hermanosPadre común más cercanoPestaña activa leída por dos paneles
Datos del servidorBiblioteca de caché de servidor (TanStack Query, SWR) o el cargador del frameworkRespuestas de API, paginación, recarga
Estado de cliente de toda la appUna tienda pequeña, solo si es necesarioUsuario conectado, cola de notificaciones
Estado de vista compartibleConsulta o ruta de URLFiltros, búsqueda, ID seleccionado
Sobrevive a la recarga, por dispositivolocalStoragePreferencias, borradores no enviados

Escala solo cuando: dos componentes no relacionados necesitan el mismo estado (súbelo, o usa la caché del servidor); el estado debe sobrevivir a la recarga (URL o almacenamiento); los datos provienen de un servidor (caché del servidor, no una tienda global). Los datos del servidor copiados en una tienda global se vuelven obsoletos y duplican la lógica de carga y error.

Gráficos, impresión y vistas simplificadas

  • Gráficos: un mapa de color compartido por el front y back end, un estado vacío explícito, vacíos honestos, una leyenda HTML. Lee references/charts.md antes de construir o cambiar un gráfico.
  • Impresión o PDF: lee references/print.md antes de construir una vista imprimible. Los lienzos no se imprimen de manera confiable sin el paso de captura que describe.
  • Vistas simplificadas o de solo lectura para lectores no técnicos: sin controles de edición, texto generoso y tamaños de objetivo, estado como color y palabras, resúmenes en lenguaje sencillo calculados a partir de los datos, pocas pantallas, y números destacados con frases cortas en lugar de tablas en bruto.

Rendimiento

Arregla en orden de impacto: primero las cascadas de solicitudes, luego JavaScript enviado, luego tiempo de respuesta del servidor, luego trabajo del hilo principal durante la interacción y microoptimizaciones al final. Objetivos: LCP 2.5 s o menos, INP 200 ms o menos, CLS 0.1 o menos en el percentil 75 de visitas reales. Lee references/performance.md cuando una página sea lenta, antes de agregar una dependencia pesada o antes de un lanzamiento con objetivos de rendimiento.

Errores comunes

  • Las rutas de renderizado son bucles calientes. El cuerpo de un componente o un getter calculado se ejecuta en cada hover y cada cambio de estado no relacionado. Una derivación pesada allí agota el hilo principal, y el primer síntoma puede ser una prueba inestable en otro lugar. Desduplica, luego memoiza en las entradas ascendentes.
  • Una propiedad personalizada CSS no declarada falla silenciosamente. var(--mono) cuando el token es --font-mono hace que la declaración sea inválida en tiempo de valor calculado: la propiedad hereda, sin error. En una abreviatura (font: 400 10px/1 var(--mono)) el tamaño y la altura de línea también se pierden. Dale a var() un valor de respaldo o verifica los tokens declarados contra los referenciados en la hoja de estilo construida.
  • La altura de un gráfico va en su contenedor. Una altura en el canvas lucha contra la lógica de redimensionamiento de la biblioteca y el gráfico crece en cada redimensionamiento.
  • El foco es tu responsabilidad en widgets personalizados. Abrir un diálogo mueve el foco dentro de él; cerrarlo devuelve el foco al disparador; Escape cierra. Prefiere el elemento nativo <dialog>. Reconstruir el marcado con innerHTML pierde el foco.
  • outline: none sin reemplazo elimina la única pista que tienen los usuarios de teclado. Usa :focus-visible para estilizarlo en su lugar.
  • Los botones solo con icono necesitan un nombre (aria-label o texto oculto visualmente).
  • El contenido que solo existe después de una obtención de cliente es lento en dispositivos débiles, en blanco cuando JavaScript falla y más débil para los rastreadores. Renderiza contenido significativo en el servidor donde la pila lo permita.
  • Los medios sin tamaño desplazan el diseño. Establece width y height (o aspect-ratio) en imágenes, video y embebidos. Nunca cargues diferidamente la imagen que es el elemento más grande visible en la pantalla.
  • Los desplegables, pestañas y controles deslizantes hechos a mano necesitan el modelo de teclado completo de las Prácticas de Autoría WAI-ARIA. Un elemento nativo es casi siempre más barato.
  • Un DOM falso escrito a mano puede hacer que las pruebas sean inertes. Si el falso devuelve un objeto nuevo por búsqueda, cada propiedad escrita en él (href, disabled, value) se pierde y ninguna afirmación sobre ella puede fallar. Revierte la característica y exige que la prueba falle antes de confiar en ella.
  • Una versión fija de CDN, nunca una no fija. Un script no fijo cambia sin que hagas un commit.

Verificación

Pruébalo con lo que el proyecto ya tiene (su ejecutor de pruebas, linter, verificador de tipos, herramientas de accesibilidad) antes de agregar nuevas herramientas.

  • Las pruebas, el linter y la verificación de tipos pasan. Se vio que cualquier prueba nueva fallaba con la característica revertida.
  • La página se renderizó y se miró, en un ancho de teléfono y un ancho de escritorio. Cuando sea posible, da a los revisores una vista previa en ejecución además de capturas de pantalla.
  • Solo teclado: cada control es alcanzable, operable y visiblemente enfocado; el orden coincide con el orden visual; sin trampa.
  • Una auditoría de accesibilidad automatizada (axe, Lighthouse o la herramienta del proyecto) no tiene nuevas violaciones. Contraste verificado con una herramienta: 4.5:1 para texto del cuerpo, 3:1 para texto grande y bordes de componentes de IU (WCAG AA).
  • Estados de cargando, error, vacío y con datos mostrados cada uno, forzando cada uno.
  • El estado compartible sobrevive a la actualización y al botón atrás.
  • La consola tiene cero errores y cero advertencias al cargar y durante el uso.
  • Se verificó el presupuesto de rendimiento si el cambio agrega una dependencia o toca una vista pesada (analizador de bundle, un perfil limitado).
  • Se verificó la vista previa de impresión si la página es imprimible.

Para una revisión, informa hallazgos por archivo con la regla incumplida y la corrección, lo peor primero.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados