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

react-router-code-review — скилл для Claude Code: ревью React Router

Скилл react-router-code-review для Claude Code проверяет код роутинга в React Router v6.4 и новее: лоадеры, экшены, границы ошибок и навигацию.

Apache-2.0 202 установок ★ 89 обновлён 2026-09-15

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

Что делает react-router-code-review

Скилл разбирает модули маршрутов на React Router v6.4 и новее. В основе чек-лист: данные приходят из loader, а не из useEffect; параметры маршрута проверяются до использования; мутации отправляются через <Form> или useFetcher; на маршруте стоит errorElement; переходы делаются через <Link>, а состояние загрузки видно по useNavigation() или fetcher.state.

Часть проверок зависит от контекста. Данные из localStorage или от window остаются в useEffect, потому что лоадеры выполняются на сервере. navigate() внутри обработчика — обычная практика. Такие случаи вынесены в список валидных паттернов, чтобы не попадать в отчёт как замечания.

Разбор по темам лежит в четырёх файлах: data-loading.md, mutations.md, error-handling.md, navigation.md. Нужный подгружается по типу кода. Перед выводом находок проходят четыре гейта, и последний требует скилл review-verification-protocol по пути ../review-verification-protocol/SKILL.md. Нет его рядом — финальная проверка остаётся незакрытой, а каждая находка должна нести путь и строку из кода.

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

  • найти useEffect, который тянет данные вместо loader
  • поймать маршрут без errorElement и без родительской границы ошибок
  • отсеять ложные замечания по списку валидных паттернов
  • проверить, что мутации идут через <Form> или useFetcher
  • разобрать навигацию: где <Link>, а где navigate()

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

  • Проверь app/routes/dashboard.tsx: данные грузятся через useEffect, посмотри, что тут не так с лоадерами.
  • Сделай ревью routes.ts — экшены, обработка ошибок и pending-состояния.
  • Прогони навигацию в src/routes/orders.tsx: где стоит navigate(), а где хватит <Link>.

Как установить react-router-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill react-router-code-review -a claude-code

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

~/.claude/skills/react-router-code-review/SKILL.md

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

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

Вопросы о react-router-code-review

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

Выполните npx skills add existential-birds/beagle --skill react-router-code-review -a claude-code. Скилл появится по пути ~/.claude/skills/react-router-code-review/SKILL.md.

Что делает react-router-code-review?

Проверяет код на React Router v6.4+ по чек-листу: лоадеры, мутации, errorElement, навигация. Каждая находка подкрепляется путём и строкой из кода.

Что нужно, чтобы скилл дошёл до отчёта?

Четвёртый гейт ссылается на скилл review-verification-protocol по пути ../review-verification-protocol/SKILL.md. Без него протокол проверки перед отчётом не выполнить.

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

SKILL.md · Apache-2.0
---
name: react-router-code-review
description: Reviews React Router code for proper data loading, mutations, error handling, and navigation patterns. Use when reviewing React Router v6.4+ code, loaders, actions, or navigation logic.
---

# React Router Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| useEffect for data, missing loaders, params | [references/data-loading.md](references/data-loading.md) |
| Form vs useFetcher, action patterns | [references/mutations.md](references/mutations.md) |
| Missing error boundaries, errorElement | [references/error-handling.md](references/error-handling.md) |
| navigate() vs Link, pending states | [references/navigation.md](references/navigation.md) |

## Review Checklist

- [ ] Data loaded via `loader` not `useEffect`
- [ ] Route params accessed type-safely with validation
- [ ] Using `defer()` for parallel data fetching when appropriate
- [ ] Mutations use `<Form>` or `useFetcher` not manual fetch
- [ ] Actions handle both success and error cases
- [ ] Error boundaries with `errorElement` on routes
- [ ] Using `isRouteErrorResponse()` to check error types
- [ ] Navigation uses `<Link>` over `navigate()` where possible
- [ ] Pending states shown via `useNavigation()` or `fetcher.state`
- [ ] No navigation in render (only in effects or handlers)

## Valid Patterns (Do NOT Flag)

These patterns are correct React Router usage - do not report as issues:

- **useEffect for client-only data** - Loaders run server-side; localStorage, window dimensions, and browser APIs must use useEffect
- **navigate() in event handlers** - Link is for declarative navigation; navigate() is correct for imperative navigation in callbacks/handlers
- **Type annotation on loader data** - `useLoaderData<typeof loader>()` is a type annotation, not a type assertion
- **Empty errorElement at route level** - Route may intentionally rely on parent error boundary
- **Form without action prop** - Posts to current URL by convention; explicit action is optional
- **loader returning null** - Valid when data may not exist; null is a legitimate loader return value
- **Using fetcher.data without checking fetcher.state** - May be intentional when stale data is acceptable during revalidation

## Context-Sensitive Rules

Only flag these issues when the specific context applies:

| Issue | Flag ONLY IF |
|-------|--------------|
| Missing loader | Data is available server-side (not client-only) |
| useEffect for data fetching | Data is NOT client-only (localStorage, browser APIs, window size) |
| Missing errorElement | No parent route in the hierarchy has an error boundary |
| navigate() instead of Link | Navigation is NOT triggered by an event handler or conditional logic |

## Gates (before reporting any finding)

Run in order. **Pass each gate with evidence** (paths, line refs, or a one-line quote from code)—not intuition alone.

### Gate 1 — Scope the route surface

**Pass when:** You have repo path(s) to the route module, `routes` config entry, or layout that owns the behavior under review (write them in your notes before flagging).

### Gate 2 — Context-sensitive match

**Pass when:** For every issue that maps to **Context-Sensitive Rules**, the **Flag ONLY IF** condition is satisfied with a one-line rationale tied to the code; for other checklist items, you have a concrete code citation (path + line or short excerpt).

### Gate 3 — Non-issue patterns

**Pass when:** The behavior is not covered by **Valid Patterns (Do NOT Flag)** for that category.

### Gate 4 — Verification protocol

Load and follow [review-verification-protocol](../review-verification-protocol/SKILL.md). **Pass when:** Its pre-report checklist (and any issue-type subsection that applies) is complete for each finding you will output.

## When to Load References

- Reviewing data fetching code → data-loading.md
- Reviewing forms or mutations → mutations.md
- Reviewing error handling → error-handling.md
- Reviewing navigation logic → navigation.md

## Review Questions

1. Is data loaded in loaders instead of effects?
2. Are mutations using Form/action patterns?
3. Are there error boundaries at appropriate route levels?
4. Is navigation declarative with Link components?
5. Are pending states properly handled?

© existential-birds · Apache-2.0 · existential-birds/beagle

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

Все скиллы по теме «Код-ревью и рефакторинг» →
clerk-react-router-patterns clerk Скилл clerk-react-router-patterns помогает настроить Clerk с React Router v7/v8: загрузчики, защищённые маршруты, SSR и выбор организации. Нужен при добавлении авторизации в роутер. CX Codex +1 16 300установок sentry-react-router-framework-sdk getsentry Скилл sentry-react-router-framework-sdk помогает настроить мониторинг ошибок и трейсинг в проектах на React Router v7 в режиме Framework mode. Пригодится при подключении пакета @sentry/react-router. CX Codex +1 2 000установок frontend-react-router-best-practices sergiodxa Скилл frontend-react-router-best-practices для Claude Code задаёт архитектурные правила React Router: переносит загрузку данных в loader и помогает писать параллельные запросы и безопасные формы. CX Codex +1 406установок integration-react-react-router-7-declarative PostHog Скилл integration-react-react-router-7-declarative для Claude Code пошагово подключает аналитику PostHog к приложениям на React Router v7 в декларативном режиме. CX Codex +1 102установок vite-react-best-practices ant-gravity Скилл vite-react-best-practices задаёт агенту правила архитектуры, кэширования и деплоя для SPA на React 19 и Vite 8. Включается при сборке проекта, настройке роутинга или рефакторинге компонентов. CX Codex +1 670установок react-router-v7 PatrickJS Задаёт стандарты React Router v7 для маршрутов, загрузчиков, мутаций и типизации в файлах TypeScript и конфигах проекта. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
pydantic-ai-agent-creation Скилл pydantic-ai-agent-creation помогает создавать типобезопасных агентов на PydanticAI: со структурированным выводом, зависимостями и настройками модели. Нужен при сборке AI-агентов и чат-систем. CX Codex +1 219установок ai-elements Скилл ai-elements для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode: помогает собирать интерфейсы чата, очереди задач, отображение инструментов и подтверждений. CX Codex +1 211установок go-code-review Скилл go-code-review проверяет Go-код на идиоматичность, обработку ошибок и гонки: сначала читает go.mod, потом разбирает функции целиком. CX Codex +1 206установок shadcn-code-review Скилл shadcn-code-review проверяет React-компоненты на базе shadcn/ui, Radix и Tailwind CSS на доступность, работу с CVA и шаблоны asChild. Помогает находить ошибки в кастомной вёрстке. CX Codex +1 206установок swift-testing-code-review Скилл swift-testing-code-review проверяет тесты Swift Testing: макросы, параметризованные и асинхронные сценарии, организацию наборов. Нужен при ревью .swift-файлов. CX Codex +1 196установок docs-style Скилл docs-style задаёт правила редполитики для технической документации: выбор формата по Diataxis, активный залог и структура для людей и нейросетей. CX Codex +1 180установок deepagents-architecture Скилл deepagents-architecture помогает выбрать архитектуру для приложений на Deep Agents, спланировать субагентов, настроить цепочки middleware и схему хранения данных. CX Codex +1 162установок pydantic-ai-tool-system Скилл pydantic-ai-tool-system помогает агенту корректно объявлять инструменты PydanticAI с нужными декораторами, докстрингами и типами контекста. CX Codex +1 161установок

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

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