CommunityProgramación y desarrollogithub.com

sk-react

Construye y repara componentes de React y TypeScript, cubriendo la ubicación del estado, dependencias de efectos, obtención de datos, renderizado de listas y las trampas de re-renderizado que causan UI obsoleta o bucles infinitos. Úsalo al escribir o modificar un componente o hook de React, depurar datos obsoletos, un bucle de renderizado infinito o una entrada perdida, o revisar código frontend.

¿Qué es sk-react?

El skill **sk-react** proporciona pautas detalladas para construir y depurar componentes de React y TypeScript, abordando problemas comunes como el estado mal ubicado, dependencias de efectos incorrectas, obtención de datos con condiciones de carrera y renderizado ineficiente de listas. Está diseñado para ser utilizado con asistentes de IA como Claude Code, Cursor o Codex, y ofrece reglas concretas para evitar los errores típicos que generan UI estancada, bucles infinitos o pérdida de entrada del usuario. El skill se basa en principios fundamentales como poner el estado en un solo lugar, derivar valores en lugar de almacenarlos, sincronizar efectos correctamente con React y manejar los cuatro estados de la obtención de datos (carga, vacío, error, éxito). También incluye buenas prácticas de TypeScript, como evitar `any` y validar datos en los límites del sistema.

Compatible con~Claude Code~Codex CLI~Cursor
Part ofReact
npx skills add https://github.com/vanhuydotcom/sk-skills/tree/HEAD/skills/sk-react

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

React y TypeScript

Pon el estado en un solo lugar

Cada valor debe tener exactamente un dueño. La mayoría de los errores en React son dos copias del mismo hecho que no coinciden.

Deriva en lugar de almacenar. Si un valor se puede calcular a partir de props y estado durante el renderizado, calcúlalo — no lo reflejes en useState, porque la copia se vuelve obsoleta en cuanto su fuente cambie. const total = items.reduce(...) no necesita estado y nunca puede estar equivocado.

El estado copiado de una prop es el mismo error con una mecha más larga: el valor inicial de useState se lee una vez y se ignora para siempre. Si el componente debe reiniciarse cuando una prop cambia, asígnale una key y deja que React lo remonte.

Eleva el estado solo hasta el padre común más cercano que lo necesite. Elevarlo más hace que cada hermano se re-renderice en cada pulsación de tecla.

Efectos

Un efecto sincroniza con algo fuera de React: una suscripción, un temporizador, el documento, una librería imperativa. No es el lugar para calcular valores ni para responder a un clic — eso es trabajo del manejador de eventos.

El array de dependencias debe listar todo lo que el efecto lee. Omitir un valor para detener un bucle lo congela en su primer valor y produce el error de clausura obsoleta. Si el efecto entra en bucle porque una dependencia es un objeto o función que se reconstruye en cada renderizado, arregla la dependencia — useCallback, useMemo, o muévela fuera del componente — en lugar de eliminarla del array.

Devuelve una función de limpieza cada vez que el efecto inicie algo que pueda sobrevivirlo. Las suscripciones, temporizadores y solicitudes en curso deben detenerse cuando el componente se desmonte o las dependencias cambien, y bajo StrictMode en desarrollo el efecto se ejecuta dos veces precisamente para exponer una limpieza faltante.

Una función async no puede ser el cuerpo de un efecto — devuelve una promesa, y React espera una función de limpieza. Declara el trabajo asíncrono dentro del efecto y llámalo.

Obtención de datos

Prefiere la librería de datos del proyecto sobre la obtención manual en un efecto; ya resuelve el caché, la deduplicación, los reintentos y la condición de carrera que estás a punto de escribir.

Al obtener datos manualmente, maneja los cuatro estados — carga, vacío, error, éxito — y cancela la solicitud en la limpieza. Dos solicitudes iniciadas en orden pueden resolverse fuera de orden, así que cancela la anterior o ignora una respuesta que ya no sea actual.

Nunca te tragues un rechazo. Un rechazo no manejado en un manejador o efecto falla silenciosamente y la interfaz simplemente deja de actualizarse.

Renderizado

Clave las listas por una identidad estable de los datos. Las claves de índice son correctas solo para una lista que nunca reordena, inserta o elimina; cuando lo hace, React reutiliza el nodo DOM incorrecto y las entradas mantienen el valor de la fila anterior.

Recurre a memo, useMemo y useCallback después de medir con el generador de perfiles. Aplicados por defecto en todas partes añaden asignación y arrays de dependencias que fallan, y no resuelven nada cuando el costo real es un padre que re-renderiza todo el árbol.

Nunca llames a un hook condicionalmente, en un bucle, o después de un retorno temprano. El orden debe ser idéntico en cada renderizado.

TypeScript

Trata any y una aserción de tipo como una pregunta no resuelta, no como una solución. Ambos silencian al compilador exactamente en el lugar donde tenía algo útil que decir. Cuando un tipo es genuinamente desconocido, usa unknown y reduce su ámbito.

Tipifica lo que cruza un límite: respuestas de API, valores de formularios, parámetros de URL. Los datos de la red no son del tipo que declaraste hasta que algo los verifica, así que valida en el borde y deja que el resto de la aplicación confíe en el resultado.

Verifica

Una compilación verde prueba menos de lo que parece. Muchos proyectos configuran el framework para ignorar los errores de lint y tipo durante la compilación, así que revisa la configuración antes de tratar la compilación como evidencia, y ejecuta la verificación de tipos y el linter explícitamente.

Luego usa el componente: el estado vacío, el estado de error, una red lenta y una segunda interacción rápida antes de que la primera termine.

Individual skills in this repo

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

sk-api

Design and change API contracts (REST, gRPC, protobuf, events) so existing callers keep working, covering resource and method shape, error models, pagination, versioning and the deploy order a breaking change requires. Use when adding or altering an endpoint, message or event, or when judging whether a proposed change breaks a consumer.

sk-code-review

Shows an agent how to design, debug, or review "sk code review" so the concrete output is a code change with a check. The procedure moves through Code review, Establish the diff first, What to look for, in priority order. Use it when a new assignment calls for this craft.

sk-go-service

Implement, extend or debug a handler, service or repository in a Go backend service, covering context propagation, error wrapping, transaction boundaries, tenancy scoping and table-driven tests. Use when writing or changing Go server code, adding an endpoint or gRPC method, touching a repository query, or diagnosing a panic, leak or flaky test in a Go service.

sk-python

Write and debug Python with attention to the traps that produce silent wrong behaviour — mutable defaults, late-binding closures, shallow copies, swallowed exceptions — plus typing, environment and packaging with uv or venv, and pytest structure. Use when writing a Python script, service or library, setting up a Python project, or debugging behaviour that looks impossible.

sk-system-design

Design or evaluate a distributed system from its constraints — service boundaries, synchronous versus event-driven communication, consistency, failure behaviour and capacity — and state the trade-off each choice buys. Use when splitting or merging services, choosing between a call and an event, deciding where data lives, reviewing an architecture proposal, or answering a system design question.

Skills relacionados