Agent Skills › involvex/youtube-music-cli › react-patterns

react-patterns

GitHub

提供现代React应用开发的最佳实践，涵盖组件设计、Hooks使用、状态管理选择、React 19新特性、组合模式、性能优化及TypeScript类型定义，助力构建高质量前端应用。

.agents/skills/react-patterns/SKILL.md involvex/youtube-music-cli

触发场景

需要设计React组件结构选择合适的前端状态管理方案优化React应用渲染性能遵循React Hooks规范

安装

npx skills add involvex/youtube-music-cli --skill react-patterns -g -y

更多选项

非标准路径

npx skills add https://github.com/involvex/youtube-music-cli/tree/main/.agents/skills/react-patterns -g -y

不安装直接使用

npx skills use involvex/youtube-music-cli@react-patterns

指定 Agent (Claude Code)

npx skills add involvex/youtube-music-cli --skill react-patterns -a claude-code -g -y

安装 repo 全部 skill

npx skills add involvex/youtube-music-cli --all -g -y

预览 repo 内 skill

npx skills add involvex/youtube-music-cli --list

SKILL.md

Frontmatter

{
    "name": "react-patterns",
    "risk": "unknown",
    "source": "community",
    "date_added": "2026-02-27",
    "description": "Modern React patterns and principles. Hooks, composition, performance, TypeScript best practices."
}

React Patterns

Principles for building production-ready React applications.

1. Component Design Principles

Component Types

Type	Use	State
Server	Data fetching, static	None
Client	Interactivity	useState, effects
Presentational	UI display	Props only
Container	Logic/state	Heavy state

Design Rules

One responsibility per component
Props down, events up
Composition over inheritance
Prefer small, focused components

2. Hook Patterns

When to Extract Hooks

Pattern	Extract When
useLocalStorage	Same storage logic needed
useDebounce	Multiple debounced values
useFetch	Repeated fetch patterns
useForm	Complex form state

Hook Rules

Hooks at top level only
Same order every render
Custom hooks start with "use"
Clean up effects on unmount

3. State Management Selection

Complexity	Solution
Simple	useState, useReducer
Shared local	Context
Server state	React Query, SWR
Complex global	Zustand, Redux Toolkit

State Placement

Scope	Where
Single component	useState
Parent-child	Lift state up
Subtree	Context
App-wide	Global store

4. React 19 Patterns

New Hooks

Hook	Purpose
useActionState	Form submission state
useOptimistic	Optimistic UI updates
use	Read resources in render

Compiler Benefits

Automatic memoization
Less manual useMemo/useCallback
Focus on pure components

5. Composition Patterns

Compound Components

Parent provides context
Children consume context
Flexible slot-based composition
Example: Tabs, Accordion, Dropdown

Render Props vs Hooks

Use Case	Prefer
Reusable logic	Custom hook
Render flexibility	Render props
Cross-cutting	Higher-order component

6. Performance Principles

When to Optimize

Signal	Action
Slow renders	Profile first
Large lists	Virtualize
Expensive calc	useMemo
Stable callbacks	useCallback

Optimization Order

Check if actually slow
Profile with DevTools
Identify bottleneck
Apply targeted fix

7. Error Handling

Error Boundary Usage

Scope	Placement
App-wide	Root level
Feature	Route/feature level
Component	Around risky component

Error Recovery

Show fallback UI
Log error
Offer retry option
Preserve user data

8. TypeScript Patterns

Props Typing

Pattern	Use
Interface	Component props
Type	Unions, complex
Generic	Reusable components

Common Types

Need	Type
Children	ReactNode
Event handler	MouseEventHandler
Ref	RefObject<Element>

9. Testing Principles

Level	Focus
Unit	Pure functions, hooks
Integration	Component behavior
E2E	User flows

Test Priorities

User-visible behavior
Edge cases
Error states
Accessibility

10. Anti-Patterns

❌ Don't	✅ Do
Prop drilling deep	Use context
Giant components	Split smaller
useEffect for everything	Server components
Premature optimization	Profile first
Index as key	Stable unique ID