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

generic-react-feature-developer — скилл для Claude Code

Скилл generic-react-feature-developer для Claude Code задаёт архитектуру React-компонентов: каталоги, Zustand и React Query, IndexedDB и ленивую загрузку.

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

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

Что делает generic-react-feature-developer

Скилл настраивает архитектурные правила разработки React-компонентов. Он предписывает чёткую структуру каталогов src/ с делением на ui, features, layout, хранилища stores/ и сервисы services/, чтобы агент не смешивал слои приложения.

Внутри описаны правила выбора стейт-менеджера: React Context остаётся для темы и локали, а Zustand с селекторами — для динамических данных и персистентности. Если объём данных превышает 5 МБ или нужно сохранять бинарные файлы, скилл требует создавать сервисную обёртку над IndexedDB вместо localStorage. Серверные запросы организуются через React Query с инвалидацией кеша при мутациях.

Скилл расширяет базовый generic-feature-developer, поэтому общие решения о границах фичи опираются на него. Все компоненты тяжелее 20 КБ по инструкции оборачиваются в React.lazy и Suspense.

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

  • Спроектировать структуру каталогов и интерфейсных слоёв в React-проекте
  • Выбрать между React Context, Zustand и IndexedDB под объём данных
  • Настроить работу с серверными данными через React Query с инвалидацией кеша
  • Изолировать тяжёлые интерфейсные блоки и маршруты через React.lazy

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

  • Спроектируй фичу корзины с сохранением состояния в IndexedDB по правилам generic-react-feature-developer
  • Помоги переписать стор фильтров каталога на Zustand с селекторами
  • Создай составной компонент табов Tabs с контекстом и поддержкой ленивой загрузки

Как установить generic-react-feature-developer

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/generic-react-feature-developer/SKILL.md

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

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

Вопросы о generic-react-feature-developer

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

Запустите команду npx skills add travisjneuman/.claude --skill generic-react-feature-developer -a claude-code. Файл скилла запишется в ~/.claude/skills/generic-react-feature-developer/SKILL.md.

Когда скилл рекомендует использовать IndexedDB вместо localStorage?

IndexedDB выбирается, когда объём данных превышает 5 МБ, при сохранении файлов или картинок, а также для сложных запросов по ключам. Меньшие объёмы сохраняются в localStorage через плагин персистентности Zustand.

Какие библиотеки управления состоянием поддерживает скилл?

Основной упор сделан на Zustand для клиентского состояния и React Query для серверного. Обычный React Context рекомендуется оставлять только для редко меняющихся параметров интерфейса.

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

SKILL.md · MIT
---
name: generic-react-feature-developer
description: Guide feature development for React applications with architecture focus. Covers Zustand/Redux patterns, IndexedDB usage, component systems, lazy loading strategies, and seamless integration. Use when adding new features, refactoring existing code, or planning major changes.
---

# React Feature Developer

Guide feature development with React architecture patterns.

**Extends:** [Generic Feature Developer](../generic-feature-developer/SKILL.md) - Read base skill for development workflow, scope assessment, and build vs integrate decisions.

## React Architecture

### Project Structure

```
src/
├── components/
│   ├── ui/          # Reusable primitives (Button, Input)
│   ├── features/    # Feature-specific components
│   └── layout/      # Layout components (Header, Sidebar)
├── hooks/           # Custom hooks (useAuth, useStore)
├── stores/          # Zustand stores
├── services/        # API clients, IndexedDB wrappers
├── types/           # TypeScript interfaces
└── lib/             # Utilities
```

## State Management Patterns

### Zustand Store (Preferred)

```typescript
// stores/useFeatureStore.ts
interface FeatureState {
  items: Item[];
  isLoading: boolean;
  // Actions
  addItem: (item: Item) => void;
  removeItem: (id: string) => void;
}

const useFeatureStore = create<FeatureState>()(
  persist(
    (set) => ({
      items: [],
      isLoading: false,
      addItem: (item) => set((s) => ({ items: [...s.items, item] })),
      removeItem: (id) =>
        set((s) => ({
          items: s.items.filter((i) => i.id !== id),
        })),
    }),
    {
      name: "feature-storage",
      version: 1,
      migrate: (state, version) => {
        // Handle migrations between versions
        return state as FeatureState;
      },
    },
  ),
);
```

### Zustand Selectors (Performance)

```typescript
// Avoid re-renders with selectors
const items = useFeatureStore((state) => state.items);
const addItem = useFeatureStore((state) => state.addItem);

// Shallow compare for objects
import { shallow } from "zustand/shallow";
const { items, isLoading } = useFeatureStore(
  (state) => ({ items: state.items, isLoading: state.isLoading }),
  shallow,
);
```

### Context vs Zustand Decision

| Use Context                    | Use Zustand                |
| ------------------------------ | -------------------------- |
| Theme, locale (rarely changes) | Frequently updated data    |
| Authentication state           | Complex state with actions |
| Provider already exists        | Need persistence           |
| Prop drilling 1-2 levels       | Cross-cutting concern      |

## Server State (React Query)

```typescript
// Server state - React Query
const { data, isLoading, error } = useQuery({
  queryKey: ["items", userId],
  queryFn: () => fetchItems(userId),
  staleTime: 5 * 60 * 1000, // 5 minutes
});

// Mutations
const mutation = useMutation({
  mutationFn: createItem,
  onSuccess: () => {
    queryClient.invalidateQueries({ queryKey: ["items"] });
  },
});
```

## IndexedDB Integration

### When to Use

| Scenario                    | Solution                         |
| --------------------------- | -------------------------------- |
| < 5MB total                 | localStorage via Zustand persist |
| > 5MB total                 | IndexedDB                        |
| Binary data (images, files) | IndexedDB                        |
| Simple key-value            | localStorage                     |
| Complex queries             | IndexedDB                        |

### Service Wrapper Pattern

```typescript
// services/indexedDBService.ts
class IndexedDBService {
  private db: IDBDatabase | null = null;

  async init() {
    return new Promise<void>((resolve, reject) => {
      const request = indexedDB.open("AppDB", 1);
      request.onerror = () => reject(request.error);
      request.onsuccess = () => {
        this.db = request.result;
        resolve();
      };
      request.onupgradeneeded = (event) => {
        const db = (event.target as IDBOpenDBRequest).result;
        db.createObjectStore("items", { keyPath: "id" });
      };
    });
  }

  async setItem<T>(store: string, value: T): Promise<void> {
    // Implementation
  }

  async getItem<T>(store: string, key: string): Promise<T | null> {
    // Implementation
  }
}

export const indexedDBService = new IndexedDBService();
```

## Lazy Loading

### Component Lazy Loading

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

// Pages
const SettingsPage = lazy(() => import('./pages/Settings'));

// Usage with Suspense
<Suspense fallback={<Skeleton />}>
  <HeavyChart data={data} />
</Suspense>
```

### Route-Level Code Splitting

```typescript
// React Router example
const routes = [
  {
    path: '/dashboard',
    element: <DashboardLayout />,
    children: [
      {
        path: 'settings',
        lazy: () => import('./pages/Settings'),
      },
    ],
  },
];
```

## Custom Hook Patterns

### Feature Hook

```typescript
// hooks/useItems.ts
function useItems() {
  const items = useFeatureStore((s) => s.items);
  const addItem = useFeatureStore((s) => s.addItem);

  const sortedItems = useMemo(
    () => [...items].sort((a, b) => b.createdAt - a.createdAt),
    [items],
  );

  return { items: sortedItems, addItem };
}
```

### Compound Hook (Combining Sources)

```typescript
// hooks/useDashboard.ts
function useDashboard() {
  // Local state
  const [filter, setFilter] = useState("all");

  // Server state
  const { data: items } = useQuery({ queryKey: ["items"] });

  // Client state
  const preferences = usePreferencesStore((s) => s.dashboard);

  // Derived
  const filteredItems = useMemo(
    () => items?.filter((i) => filter === "all" || i.status === filter),
    [items, filter],
  );

  return { filter, setFilter, items: filteredItems, preferences };
}
```

## Component Composition

### Compound Components

```tsx
// Usage: <Tabs><Tabs.List /><Tabs.Panel /></Tabs>
const TabsContext = createContext<TabsContextValue | null>(null);

function Tabs({ children, defaultValue }: TabsProps) {
  const [active, setActive] = useState(defaultValue);
  return (
    <TabsContext.Provider value={{ active, setActive }}>
      {children}
    </TabsContext.Provider>
  );
}

Tabs.List = function TabsList({ children }: { children: ReactNode }) {
  return <div role="tablist">{children}</div>;
};

Tabs.Panel = function TabsPanel({ value, children }: TabsPanelProps) {
  const { active } = useContext(TabsContext)!;
  if (value !== active) return null;
  return <div role="tabpanel">{children}</div>;
};
```

## React Feature Checklist

**Before Starting:**

- [ ] Read CLAUDE.md for project patterns
- [ ] Check existing components for reuse
- [ ] Plan state management approach
- [ ] Estimate bundle size impact

**During Development:**

- [ ] Follow project design system
- [ ] TypeScript strict mode
- [ ] Implement keyboard navigation
- [ ] Add ARIA labels
- [ ] Support dark mode

**Before Completion:**

- [ ] Unit tests only if the user asked for them
- [ ] Lazy load heavy components
- [ ] Review bundle impact of new imports and dependencies
- [ ] Review with code-reviewer skill

## See Also

- [Generic Feature Developer](../generic-feature-developer/SKILL.md) - Workflow, decisions
- [Code Review Standards](../_shared/CODE_REVIEW_STANDARDS.md) - Quality requirements
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - UI patterns

© travisjneuman · MIT · travisjneuman/.claude

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

Все скиллы по теме «Фронтенд и UI» →
react-state-management Seth Hobson Скилл react-state-management помогает выбрать и настроить управление состоянием в React: локальное, глобальное, серверное, URL и состояние форм. CX Codex +1 15 286установок react-native alinaqi Задаёт структуру проекта, паттерны компонентов и правила тестирования для React Native. Подключается автоматически при работе с .tsx-файлами или каталогами ios/ и android/. CX Codex +1 575установок state-management agent-skills Скилл state-management для Claude Code помогает настраивать загрузку данных, кэширование и клиентское состояние через React Query и Zustand. Активируется при работе с useQuery, useMutation и хранилищами Zustand. CX Codex +1 849установок react-query Mindrally Задаёт агенту правила работы с React Query: кэширование, фоновые обновления, инвалидация запросов и оптимистичные апдейты. CX Codex +1 1 500установок react-zustand-cursorrules-prompt-file PatrickJS Правило react-zustand-cursorrules-prompt-file для Cursor задаёт работу с Zustand в React и TypeScript: структуру сторов, селекторы против лишних ререндеров и отделение серверного кэша от клиентских данных. CX Codex +1 ★ 41 178звёзд репо react-web alinaqi Скилл react-web настраивает разработку веб-компонентов на React с обязательным подходом «сначала тесты». Срабатывает при создании и правке файлов в src/components, src/pages или с расширением .tsx. CX Codex +1 348установок

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

Весь набор →
generic-fullstack-design-system Скилл generic-fullstack-design-system для Claude Code помогает настраивать дизайн-систему во фулстек-проектах на Next.js и NestJS: тему, Tailwind, компоненты shadcn/ui и тёмную тему. CX Codex +1 142установок tdd-workflow Скилл tdd-workflow для Claude Code, Codex, Cursor и других платформ, который включает режим разработки через тесты: сначала пишется падающий тест (RED), потом минимальный код для прохода (GREEN), затем рефакторинг. CX Codex +1 141установок core-workflow Скилл core-workflow собирает рабочие протоколы для агента: правила Git, чек-листы безопасности и доступности, разбор задач по сложности. Загружается сам для сложных задач или по запросу конкретного паттерна. CX Codex +1 141установок newsletter-creator Скилл newsletter-creator собирает выпуск корпоративной рассылки по готовому каркасу: порядок разделов, отбор ссылок по баллам и правила вёрстки письма. CX Codex +1 140установок svelte-development Скилл svelte-development для Claude Code помогает писать приложения на Svelte 5 и SvelteKit. Включается при работе с реактивностью, маршрутизацией, серверными функциями и миграцией со Svelte 4. CX Codex +1 139установок llm-app-development Скилл llm-app-development для Claude Code помогает проектировать RAG-пайплайны, агентов и вызовы инструментов с валидацией через Zod. Включается при сборке чат-ботов, баз знаний и генеративных сервисов. CX Codex +1 139установок product-analytics Скилл product-analytics проектирует схемы событий, воронок, когорт и A/B-тестов с учётом согласия пользователей для PostHog, Amplitude, Mixpanel и Segment. CX Codex +1 139установок payment-integration Скилл payment-integration помогает подключать Stripe и RevenueCat, строить подписки и обрабатывать вебхуки. Нужен при интеграции платежей и проверке PCI-границ. CX Codex +1 139установок

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

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