sk-react

Construa e corrija componentes React e TypeScript, abrangendo posicionamento de estado, dependências de efeitos, busca de dados, renderização de listas e as armadilhas de re-renderização que causam UI desatualizada ou em loop. Use ao escrever ou alterar um componente ou hook React, depurar dados desatualizados, um loop de renderização infinito ou uma entrada perdida, ou revisar código frontend.

O que é sk-react?

Esta habilidade fornece diretrizes práticas para desenvolvedores React e TypeScript, ajudando a evitar bugs comuns relacionados a estado, efeitos colaterais, renderização e tipos. Ela explica como centralizar o estado para evitar inconsistências, como usar efeitos corretamente com dependências e funções de limpeza, e como lidar com busca de dados de forma segura (incluindo tratamento de estados de carregamento, vazio, erro e sucesso). Também aborda a renderização de listas com chaves estáveis, o uso criterioso de `memo` e `useCallback`, e a interpretação correta de builds 'verdes'. Projetada para agentes de IA como Claude Code, Cursor ou Codex, a habilidade é útil ao escrever, modificar ou revisar componentes React e hooks, garantindo código mais robusto e previsível.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

React e TypeScript

Coloque o estado em um único lugar

Cada valor deve ter exatamente um dono. A maioria dos bugs do React são duas cópias do mesmo fato discordando.

Derive em vez de armazenar. Se um valor pode ser computado a partir de props e estado durante a renderização, compute-o — não o espelhe em useState, porque a cópia fica desatualizada no momento em que sua fonte muda. const total = items.reduce(...) não precisa de estado e nunca pode estar errado.

Estado copiado de uma prop é o mesmo bug com um fusível mais longo: o valor inicial de useState é lido uma vez e ignorado para sempre depois. Se o componente deve ser redefinido quando uma prop mudar, dê a ele uma key e deixe o React remontá-lo.

Eleve o estado apenas até o pai comum mais próximo que precisar dele. Elevar mais longe faz com que todos os irmãos sejam renderizados novamente a cada tecla.

Efeitos

Um efeito sincroniza com algo fora do React: uma assinatura, um timer, o documento, uma biblioteca imperativa. Não é o lugar para computar valores ou responder a um clique — o manipulador de eventos o é.

A lista de dependências deve listar tudo que o efeito lê. Omitir um valor para interromper um loop congela-o em seu primeiro valor e produz o bug de closure desatualizado. Se o efeito entrar em loop porque uma dependência é um objeto ou função reconstruída a cada renderização, corrija a dependência — useCallback, useMemo, ou mova-a para fora do componente — em vez de deletá-la da lista.

Retorne uma função de limpeza sempre que o efeito iniciar algo que possa sobreviver a ele. Assinaturas, timers e requisições em andamento precisam parar quando o componente desmontar ou as dependências mudarem, e sob o StrictMode em desenvolvimento o efeito é executado duas vezes especificamente para expor uma limpeza ausente.

Uma função async não pode ser o corpo de um efeito — ela retorna uma promise, e o React espera uma função de limpeza. Declare o trabalho assíncrono dentro e chame-o.

Busca de dados

Prefira a biblioteca de dados do projeto em vez de busca manual em um efeito; ela já resolve o cache, a desduplicação, a repetição e a condição de corrida que você está prestes a escrever.

Ao buscar manualmente, trate todos os quatro estados — carregando, vazio, erro, sucesso — e cancele a requisição na limpeza. Duas requisições iniciadas em ordem ainda podem resolver fora de ordem, então ou cancele a anterior ou ignore uma resposta que não é mais atual.

Nunca engula uma rejeição. Uma rejeição não tratada em um manipulador ou efeito falha silenciosamente e a UI simplesmente para de atualizar.

Renderização

Chaveie listas por uma identidade estável dos dados. Chaves de índice são corretas apenas para uma lista que nunca reordena, insere ou deleta; quando isso acontece, o React reutiliza o nó DOM errado e as entradas mantêm o valor da linha anterior.

Recorra a memo, useMemo e useCallback após medir com o profiler. Aplicados todo lugar por padrão, eles adicionam alocação e listas de dependências que dão errado, e não resolvem nada quando o custo real é um pai renderizando toda a árvore novamente.

Nunca chame um hook condicionalmente, em um loop, ou após um retorno antecipado. A ordem deve ser idêntica em toda renderização.

TypeScript

Trate any e uma asserção de tipo como uma pergunta não respondida, não uma correção. Ambos silenciam o compilador exatamente no lugar onde ele tinha algo útil a dizer. Quando um tipo é genuinamente desconhecido, use unknown e restrinja-o.

Tipifique o que cruza uma fronteira: respostas de API, valores de formulário, parâmetros de URL. Dados da rede não são do tipo que você declarou até que algo os verifique, então valide na borda e deixe o resto da aplicação confiar no resultado.

Verifique

Uma build verde prova menos do que parece. Muitos projetos configuram o framework para ignorar erros de lint e tipo durante a build, então verifique a configuração antes de tratar a build como evidência, e rode a verificação de tipo e o linter explicitamente.

Em seguida, use o componente: o estado vazio, o estado de erro, uma rede lenta e uma segunda interação rápida antes da primeira terminar.

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.

Habilidades Relacionadas