frontend-best-practices
Skill0 starsChanged 4 days agoMITView on GitHub
Revisa y mejora código frontend (React/Next.js y afines) con buenas prácticas verificables: estado y efectos, datos remotos, formularios, accesibilidad, rendimiento y seguridad. Prioriza hallazgos por impacto y corrige solo lo que duele. Úsala al revisar o escribir componentes, hooks y páginas.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- Wade-DevCode/awesome-coding-skills-cntheir own version, first seen Nov 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- Wade-DevCode/awesome-coding-skills-cn★ 7same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- git-cleanupSkill
- skill-creatorSkill
- astro-architectureSkill
- monorepo-architectureSkill
- nestjs-architectureSkill
- nextjs-architectureSkill
- react-native-architectureSkill
- gh-cliSkill
- git-cleanupSkill
- backend-best-practicesSkill
- clean-codeSkill
- code-quality-reviewSkill
- design-patternsSkill
- solid-principlesSkill
- tdd-workflowSkill
- ssh-connectSkill
- ts-import-organizerSkill
- idd-applySkill
- idd-exploreSkill
- idd-planSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 82
No inventes métricas: no afirmes mejoras de rendimiento sin medirlas.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Frontend Best Practices
🎯 Propósito
Revisar y mejorar código de interfaz con criterios verificables y priorizados, no con listas genéricas. Cada hallazgo cita evidencia (archivo:línea), su impacto (usuario, seguridad, mantenimiento) y una corrección proporcionada. Lo que ya está bien se deja como está.
Cubre seis áreas: estado y efectos, datos remotos, formularios, accesibilidad, rendimiento y seguridad. No decide la estructura de carpetas (skills de arquitectura: nextjs-architecture, react-native-architecture, astro-architecture), ni la legibilidad interna de funciones (clean-code), ni responsabilidades de clases (solid-principles), ni los patrones (design-patterns). Para tests usa tdd-workflow.
⚡ Cuándo Activar esta Skill
- El usuario pide revisar, endurecer o "aplicar buenas prácticas" a componentes, hooks o páginas.
- Se escribe un componente nuevo con datos remotos, formularios o HTML de contenido externo.
- Hay síntomas: re-renders de más, parpadeos, datos desactualizados, bucles de
useEffect, fallos de accesibilidad o de Lighthouse.
📋 Flujo de Trabajo Paso a Paso
1. Leer el contexto
Identifica framework y versión (React 18/19, Next App Router o Pages, Vite…), librería de datos (TanStack Query, SWR, RTK Query), de formularios (React Hook Form, Zod…), de estilos y de tests. Usa lo que el proyecto ya tiene; no introduzcas librerías sin confirmar. Distingue componentes de servidor y de cliente si el framework los tiene.
2. Revisar por áreas, con la lista de comprobación
| Área | Comprobaciones clave | Detalle |
| Estado y efectos | Estado derivado calculado en el render, no copiado con useEffect; efectos solo para sincronizar con sistemas externos; dependencias correctas; limpieza de suscripciones y peticiones; claves estables en listas | react-state-effects |
| Datos remotos | Estado de servidor separado del de UI; carga, error y vacío tratados; sin fetch en useEffect si hay librería de datos; cancelación o ignorar respuestas obsoletas | react-state-effects |
| Formularios | Validación en cliente y servidor; errores asociados a su campo; estado de envío y doble envío; no perder datos al fallar | forms-and-data |
| Accesibilidad | HTML semántico antes que ARIA; todo interactivo con teclado y foco visible; nombres accesibles; alt, etiquetas, contraste; foco tras diálogos y rutas | accessibility |
| Rendimiento | Medir antes de optimizar; no renderizar listas enormes sin virtualizar; imágenes dimensionadas y diferidas; código dividido por ruta; memo/useMemo solo con evidencia | performance |
| Seguridad | Sin HTML sin sanear (dangerouslySetInnerHTML); tokens fuera de localStorage si hay alternativa; sin secretos en el bundle; URLs de usuario validadas; enlaces target=_blank con rel | security-frontend |
Limítate a las áreas relevantes para el alcance pedido y a los archivos que se pidieron.
3. Priorizar
Clasifica cada hallazgo y ordénalos:
- Crítico: seguridad explotable (XSS), pérdida de datos, bloqueo de usuarios (teclado/lector de pantalla imposible).
- Importante: bugs de estado o datos (carreras, estados sin manejar), problemas medibles de rendimiento, accesibilidad parcial.
- Menor: consistencia, nombres, micro-optimizaciones. Menciónalos sin corregir si no se pidió.
4. Corregir con red de seguridad
Con tests existentes, ejecútalos antes y después. Sin tests de la zona, describe el cambio de comportamiento esperado y, si es un bug, escribe primero un test que lo reproduzca (flujo de tdd-workflow). Un cambio por hallazgo; mantén props y exports públicos salvo que se pida lo contrario.
5. Verificar y reportar
Ejecuta tests, typecheck y lint si existen. Para accesibilidad y rendimiento, indica qué no pudiste verificar sin navegador (lector de pantalla, Lighthouse, rendimiento real) y cómo comprobarlo. Reporta con el formato de abajo.
🚫 Cuándo NO sobre-optimizar
useMemo/useCallback/memoen todas partes sin un problema medido: añaden ruido y a veces coste.- Reescribir un componente que funciona para adoptar otra librería o estilo.
- Accesibilidad con ARIA añadida a mano cuando un
<button>o<label>lo resuelve. - Componentes pequeños y correctos: si no hay hallazgos reales, dilo; "sin cambios necesarios" es un resultado válido.
⚠️ Reglas Críticas
- Evidencia primero: cada hallazgo con
archivo:líneay su efecto concreto; nada de "podría ser más limpio". - Seguridad no se aplaza: un
dangerouslySetInnerHTMLcon datos no confiables se reporta como crítico aunque no lo hayan pedido; saneamiento con la librería que ya use el proyecto o, si no hay, propón una y pide confirmación. - No cambies comportamiento visible (textos, estilos, flujos) sin avisarlo.
- No inventes métricas: no afirmes mejoras de rendimiento sin medirlas.
- No instales dependencias sin confirmación.
- Respeta las convenciones del proyecto (estilos, estructura, librerías) y las skills de arquitectura si están presentes.
- No toques lo que no se pidió: lo demás va a "Fuera de alcance".
📤 Reporte
### Resumen
<estado general y los 1–3 hallazgos de más impacto>
### Hallazgos
| # | Severidad | Área | Ubicación | Problema y efecto | Acción |
|---|---|---|---|---|---|
| 1 | Crítico | Seguridad | UserCard.tsx:42 | `dangerouslySetInnerHTML` con `bio` del usuario: XSS almacenado | Corregido (sanear / renderizar texto) |
| 2 | Importante | Datos | UserList.tsx:15 | `fetch` en efecto sin cancelación: respuesta antigua pisa la nueva | Corregido |
| 3 | Menor | Estilo | — | Nombres inconsistentes | Solo mencionado |
### Cambios aplicados
1. <cambio> — tests: ✅ N/N
### No verificado / fuera de alcance
- <qué requiere navegador, medición o decisión del usuario>📚 Referencias
- Estado, efectos y datos remotos
- Formularios y validación
- Accesibilidad
- Rendimiento
- Seguridad en el frontend
- Ejemplo de revisión completa
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

