К основному содержанию
скилл CX Codex

generic-react-code-reviewer — скилл для Claude Code: ревью React-кода

Скилл generic-react-code-reviewer проверяет React/TypeScript-код на баги, дыры в безопасности, просадки производительности и доступность, читая диф. Пригодится перед коммитом и на ревью пул-реквеста.

MIT 148 установок ★ 114 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add travisjneuman/.claude --skill generic-react-code-reviewer -a claude-code
Открыть на GitHub

Что делает generic-react-code-reviewer

Скилл смотрит на изменения в диффе, а не гоняет тесты, линт и сборку. Проверяет типизацию: any не должно быть в пропсах, ответах API и обработчиках событий, внешние данные сначала идут как unknown, потом через type guard. Отдельно смотрит зависимости хуков и типизацию стейта в Zustand или Redux, мемоизацию дорогих вычислений.

Производительность и доступность идут вторым проходом. Пороги бандла заданы числами: начальный меньше 100KB gzip, ленивые чанки меньше 50KB, весь JS меньше 300KB. Компоненты тяжелее 20KB должны грузиться через lazy и Suspense. Анимировать разрешено transform и opacity, а width, height и margin — нет. В модалках проверяется ловушка фокуса и закрытие по Escape, у кнопок-иконок aria-label.

Скилл расширяет generic-code-reviewer, и это не формальность: методика ревью и приоритеты P0/P1/P2 лежат в базовом скилле, так что ставить нужно оба.

Какие задачи решает

  • поймать пропущенную зависимость в useEffect до коммита
  • вычистить any из пропсов и ответов API
  • уложить начальный бандл в бюджет и вынести тяжёлые компоненты в ленивую загрузку
  • проверить ловушку фокуса и aria-label в модалках
  • перевести анимации с width и margin на transform и opacity

Примеры запросов агенту

  • Отревьюй изменения в src/components/Checkout.tsx как перед коммитом: типы, зависимости хуков, доступность.
  • Проверь диф ветки на просадки производительности и размер бандла.
  • Прогони ревью нового компонента по стандартам скилла: strict mode, ленивые чанки, фокус в модалке.

Как установить generic-react-code-reviewer

1Через Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill generic-react-code-reviewer -a claude-code

2Вручную: положить файлы

~/.claude/skills/generic-react-code-reviewer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/generic-react-code-reviewer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о generic-react-code-reviewer

Как установить generic-react-code-reviewer в Claude Code?

Выполните npx skills add travisjneuman/.claude --skill generic-react-code-reviewer -a claude-code. Файл скилла появится по пути ~/.claude/skills/generic-react-code-reviewer/SKILL.md.

Что делает generic-react-code-reviewer?

Проходит по диффу React/TypeScript-кода и ищет баги, проблемы безопасности, лишние перерисовки, провалы по доступности и отступления от стандартов проекта.

Нужен ли базовый generic-code-reviewer?

Да. Этот скилл расширяет generic-code-reviewer: методика ревью и разбивка замечаний на P0/P1/P2 описаны там, без него останется только React-часть чек-листа.

Исходный текст

SKILL.md · MIT
---
name: generic-react-code-reviewer
description: Review React/TypeScript code for bugs, security vulnerabilities, performance issues, accessibility gaps, and CLAUDE.md workflow compliance. Enforces TypeScript strict mode, GPU-accelerated animations, WCAG AA accessibility, bundle size limits, and surgical simplicity. Use when completing features, before commits, or reviewing pull requests.
---

# React Code Reviewer

Review React/TypeScript code against production quality standards.

**Extends:** [Generic Code Reviewer](../generic-code-reviewer/SKILL.md) - Read base skill for full code review methodology, P0/P1/P2 priority system, and judgment calls.

## Pre-Commit Validation

Validate by reading the diff, not by running a test/lint/build ladder; the checks below are what to look for.

## React-Specific Checks

### TypeScript Strict Mode

```typescript
// Required tsconfig.json settings
{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true
  }
}
```

- No `any` types for user input or API responses
- Validate external data with `unknown` first, then type guard
- Generic types over `any` in reusable utilities

### Component Patterns

| Pattern | Check                       |
| ------- | --------------------------- |
| Props   | Interface defined, no `any` |
| State   | Typed with Zustand/useState |
| Events  | Typed event handlers        |
| Refs    | `useRef<ElementType>(null)` |

### Hook Dependency Arrays

```typescript
// P1 Issue: Missing dependencies
useEffect(() => {
  fetchData(userId); // userId missing from deps
}, []); // ❌

// Correct
useEffect(() => {
  fetchData(userId);
}, [userId]); // ✓
```

**Rule:** Enable `react-hooks/exhaustive-deps` ESLint rule.

### State Management (Zustand/Redux)

- Store slices properly typed
- Actions return void (update state directly)
- Selectors memoized for derived state
- Large data (>1MB) in IndexedDB, not localStorage

### React Query/SWR Patterns

```typescript
// Proper typing
const { data } = useQuery<User>({
  queryKey: ["user", id],
  queryFn: () => fetchUser(id),
});

// Check: staleTime, cacheTime configured
// Check: error boundaries for query failures
```

## Performance (P1)

### Bundle Size Targets

| Target             | Threshold       |
| ------------------ | --------------- |
| Initial bundle     | < 100KB gzipped |
| Lazy-loaded chunks | < 50KB each     |
| Total JS           | < 300KB         |

### Lazy Loading

```typescript
// Heavy components (>20KB) MUST be lazy loaded
const HeavyChart = lazy(() => import('./HeavyChart'));
const RichTextEditor = lazy(() => import('./RichTextEditor'));

// Wrap in Suspense
<Suspense fallback={<Skeleton />}>
  <HeavyChart />
</Suspense>
```

### Memoization

```typescript
// Expensive calculations
const sortedItems = useMemo(() =>
  items.sort((a, b) => a.date - b.date),
  [items]
);

// Callback stability for child components
const handleClick = useCallback(() => {
  doSomething(id);
}, [id]);

// Component memoization (when props are stable)
export const Item = memo(function Item({ data }: Props) {
  return <div>{data.name}</div>;
});
```

### Animation (GPU-Accelerated Only)

```css
/* ✓ DO animate */
transform: translateY(-4px);
opacity: 0.5;

/* ❌ NEVER animate */
width, height, margin, padding, top, left
```

## Accessibility (P1)

### Focus Management

```typescript
// Modal focus trapping
useEffect(() => {
  if (isOpen) {
    const firstFocusable = modalRef.current?.querySelector("button, input");
    firstFocusable?.focus();
  }
}, [isOpen]);

// Escape to close
useEffect(() => {
  const handleEscape = (e: KeyboardEvent) => {
    if (e.key === "Escape") onClose();
  };
  window.addEventListener("keydown", handleEscape);
  return () => window.removeEventListener("keydown", handleEscape);
}, [onClose]);
```

### ARIA in JSX

```tsx
// Icon-only buttons require labels
<button aria-label="Close modal">
  <X className="w-5 h-5" />
</button>

// Dialogs
<div role="dialog" aria-modal="true" aria-labelledby="title">
  <h2 id="title">Confirm Action</h2>
</div>
```

## Quick Review Checklist

**React-Specific (add to base checklist):**

- [ ] Hook dependencies correct
- [ ] Heavy components lazy loaded
- [ ] State management typed
- [ ] Memoization where beneficial
- [ ] Focus management in modals

## See Also

- [Generic Code Reviewer](../generic-code-reviewer/SKILL.md) - Base review methodology
- [Code Review Standards](../_shared/CODE_REVIEW_STANDARDS.md) - Full security/performance/accessibility
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - UI consistency

© travisjneuman · MIT · travisjneuman/.claude

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
react-doctor millionco Скилл react-doctor проверяет кодовую базу на React: находит проблемы архитектуры, доступности и рендеринга. Рассчитывает общую оценку здоровья проекта от 0 до 100. CX Codex +1 22 800установок typescript-react-reviewer dotneet Скилл typescript-react-reviewer для ревью кода на TypeScript и React 19: находит антипаттерны, ошибки хуков и проблемы типизации. Пригодится перед мержем PR. CX Codex +1 9 000установок react-best-practices mastra-ai Скилл react-best-practices для Claude Code, Cursor, Codex, GitHub Copilot и других агентов: 27 правил по 9 категориям оптимизации React. Подключается при написании, ревью или рефакторинге компонентов. CX Codex +1 2 900установок react-code-review giuseppe-trisciuoglio Скилл react-code-review проверяет React-компоненты и хуки перед мержем: архитектура, зависимости в useEffect, доступность, типы. Полезен, когда правки уже готовы и нужен разбор по серьёзности. CX Codex +1 4 600установок react-flow-code-review existential-birds Скилл react-flow-code-review для Claude Code и Codex проверяет код на @xyflow/react по чек-листу: антипаттерны, лишние ре-рендеры, типы. Фиксирует тормоза графа и пересоздание нод. CX Codex +1 329установок react-performance affaan-m Скилл react-performance для аудита и ускорения приложений на React 18/19 и Next.js. Помогает находить сетевые водопады, сокращать размер бандла и настраивать Server Components во время код-ревью. CX Codex +1 6 700установок

Из того же набора117

Весь набор →
onboarding-guide-creator Скилл onboarding-guide-creator для Claude Code собирает план адаптации сотрудника с этапами, задачами и контрольными точками. Создаёт welcome-гайд или программу обучения. CX Codex +1 150установок customer-persona-builder Скилл customer-persona-builder собирает ICP, персону покупателя и персону пользователя по шаблонам, со скоринг-матрицей и банком вопросов для интервью. CX Codex +1 149установок generic-static-code-reviewer Скилл generic-static-code-reviewer проверяет HTML, CSS и JS статического сайта: баги, безопасность, вес, доступность. Сборку вроде Sass или бандлера считает нарушением. CX Codex +1 149установок podcast-producer Скилл podcast-producer для Claude Code помогает спланировать запуск подкаста, подготовить выпуск и оформить заметки к нему. Собирает рабочий процесс от идеи эпизода до публикации. CX Codex +1 148установок security Скилл security для Claude Code помогает проектировать меры защиты, разбирать инциденты и оценивать уязвимости. Подключается к задачам по NIST, ISO 27001, архитектуре безопасности и облачной защите. CX Codex +1 148установок generic-code-reviewer Скилл generic-code-reviewer проверяет код перед коммитом или мержем пуллреквеста. Находит уязвимости, проблемы с типами, ошибки доступности и сверяет правила с файлом CLAUDE.md. CX Codex +1 147установок monitoring-observability Скилл monitoring-observability помогает внедрить OpenTelemetry, структурированные логи и трейсинг в микросервисах. Он пригодится при настройке алертов по SLO и отладке распределённых систем. CX Codex +1 146установок codebase-documenter Скилл codebase-documenter для Claude Code пишет документацию по репозиторию: README, описание архитектуры, гайд для новичков, API и комментарии в коде. Помогает объяснить проект новому разработчику. CX Codex +1 145установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой