Skip to content

BumpyClock/agent-templates / skills_archive/web-development

web-development

Unverified

Web apps: HTML, CSS, JS, TS, React, Next.js, shadcn/ui, accessibility, forms, motion, responsive, performance, react-doctor.

react/guide.md

View on GitHub
---
name: react
description: React and Next.js implementation, review, debugging, and performance guidance for modern web apps. Use when the request is clearly React-specific, including component architecture, hooks, rendering behavior, state flow, Server Components, or React-specific verification.
---

# React

## Workflow
- Confirm the request is React-specific before loading this guide. For framework-agnostic UI work, start with `../design-engineering/guide.md`.
- Audit the existing app structure first: framework version, router, state approach, styling system, and component boundaries.
- Prefer existing framework features and repo conventions over custom abstractions.
- Run `react-doctor` after meaningful React changes or during React-specific bug triage.

## Core Rules
- Keep components small, composable, and explicit about state ownership.
- Prefer derived state over duplicated state.
- Avoid render-loop bugs from effect-driven state syncing.
- Use semantic HTML and accessible state patterns before adding custom behavior.
- Treat performance as a correctness concern when UI jank is user-visible.

## Focus Areas
- Component boundaries, composition, and prop APIs
- Hook usage, effects, and state flow
- Rendering behavior, concurrency, and update frequency
- Forms, loading states, optimistic UI, and error handling
- Next.js server/client boundaries when applicable
- React-specific verification with `react-doctor`

## Companion References
- `react-doctor.md` for verification workflow
- `../design-engineering/guide.md` for language-agnostic UI guidance
- `../../programming/references/languages/typescript-frontend.md` for broader TypeScript/frontend implementation rules
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall