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

frontend-dev-guidelines · bbeierle12 — скилл для Claude Code

Скилл frontend-dev-guidelines для Claude Code задаёт правила React-разработки на TypeScript: структуру папок, загрузку данных, стили и тесты. Включается, когда агент пишет фронтенд-код.

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Bbeierle12/Skill-MCP-Claude --skill frontend-dev-guidelines -a claude-code
Открыть на GitHub

Что делает frontend-dev-guidelines

Скилл задаёт правила для React-приложений на TypeScript: как раскладывать код по папкам features/, components/ui, hooks, types и api, как описывать пропсы компонента и как строить загрузку данных.

Внутри лежат готовые образцы кода: Suspense с useSuspenseQuery, ленивые маршруты через lazy, серверное состояние на TanStack Query (useQuery, useMutation с инвалидацией), глобальное на Zustand или Context, мемоизация, разбиение бандла, виртуальные списки на @tanstack/react-virtual. Стили — Tailwind, CSS Modules или styled-components. Отдельные разделы про типы, проверку на null, ErrorBoundary из react-error-boundary и тесты на @testing-library/react. Рядом четыре файла с подробностями: component-patterns.md, state-management.md, performance.md, testing.md.

Загрузка данных в примерах идёт через TanStack Query. Если в проекте за это отвечает другая библиотека, шаблоны с useSuspenseQuery и useMutation придётся переписывать под неё.

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

  • разложить новый React-проект по папкам features/
  • перевести загрузку данных на Suspense и useSuspenseQuery
  • настроить ленивую подгрузку маршрутов с заглушкой
  • обернуть страницу в ErrorBoundary с кнопкой повтора
  • написать тест на компонент через @testing-library/react

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

  • Создай страницу dashboard в src/features/dashboard по структуре из скилла
  • Переведи список задач на useSuspenseQuery и оберни в Suspense со скелетоном
  • Вынеси тяжёлый компонент графика в отдельный lazy-чанк

Как установить frontend-dev-guidelines

1Через Skills CLI (Vercel)

npx skills add Bbeierle12/Skill-MCP-Claude --skill frontend-dev-guidelines -a claude-code

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

~/.claude/skills/frontend-dev-guidelines/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/frontend-dev-guidelines/

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

Вопросы о frontend-dev-guidelines

Как установить frontend-dev-guidelines в Claude Code?

Выполни npx skills add Bbeierle12/Skill-MCP-Claude --skill frontend-dev-guidelines -a claude-code. Файл скилла окажется по пути ~/.claude/skills/frontend-dev-guidelines/SKILL.md.

Что делает frontend-dev-guidelines?

Даёт агенту свод правил по React и TypeScript: структура проекта, компоненты с типизированными пропсами, загрузка данных, стили, оптимизация и тесты. Работает как справка с примерами кода, а не как генератор приложения.

Какие библиотеки предполагает скилл?

TanStack Query для серверного состояния, Zustand или Context для глобального, Tailwind, CSS Modules или styled-components для стилей. В разделах про ошибки, длинные списки и тесты фигурируют react-error-boundary, @tanstack/react-virtual и @testing-library/react.

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

SKILL.md · MIT
---
name: frontend-dev-guidelines
description: Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspense, lazy loading, useSuspenseQuery, file organization with features directory, styling best practices, routing, performance optimization, and TypeScript best practices. Use when creating components, pages, features, fetching data, styling, routing, or working with frontend code.
---

# Frontend Development Guidelines

## Project Structure

```
src/
├── features/           # Feature-based organization
│   ├── auth/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── api/
│   │   └── index.ts
│   ├── dashboard/
│   └── settings/
├── components/         # Shared/common components
│   ├── ui/            # Base UI components
│   └── layout/        # Layout components
├── hooks/             # Shared hooks
├── utils/             # Utility functions
├── types/             # TypeScript types
├── api/               # API layer
└── styles/            # Global styles
```

## Component Patterns

### Functional Components with TypeScript

```tsx
interface Props {
  title: string;
  onAction: (id: string) => void;
  isLoading?: boolean;
}

export function MyComponent({ title, onAction, isLoading = false }: Props) {
  // Component logic
  return (
    <div>
      {isLoading ? <Spinner /> : <Content title={title} />}
    </div>
  );
}
```

### Suspense for Data Fetching

```tsx
import { Suspense } from 'react';

function ParentComponent() {
  return (
    <Suspense fallback={<LoadingSkeleton />}>
      <DataComponent />
    </Suspense>
  );
}

function DataComponent() {
  // useSuspenseQuery automatically suspends
  const { data } = useSuspenseQuery({
    queryKey: ['items'],
    queryFn: fetchItems,
  });
  
  return <ItemList items={data} />;
}
```

### Lazy Loading Routes

```tsx
import { lazy, Suspense } from 'react';

const Dashboard = lazy(() => import('./features/dashboard'));
const Settings = lazy(() => import('./features/settings'));

function App() {
  return (
    <Suspense fallback={<PageLoader />}>
      <Routes>
        <Route path="/dashboard" element={<Dashboard />} />
        <Route path="/settings" element={<Settings />} />
      </Routes>
    </Suspense>
  );
}
```

## State Management

### Local State
```tsx
const [value, setValue] = useState<string>('');
const [items, setItems] = useState<Item[]>([]);
```

### Server State (TanStack Query)
```tsx
// Queries
const { data, isLoading, error } = useQuery({
  queryKey: ['users', userId],
  queryFn: () => fetchUser(userId),
});

// Mutations
const mutation = useMutation({
  mutationFn: updateUser,
  onSuccess: () => {
    queryClient.invalidateQueries({ queryKey: ['users'] });
  },
});
```

### Global State (Zustand or Context)
```tsx
// Simple global state with Zustand
const useStore = create<Store>((set) => ({
  theme: 'light',
  setTheme: (theme) => set({ theme }),
}));
```

## Styling Best Practices

### Tailwind CSS
```tsx
<div className="flex items-center gap-4 p-4 bg-white rounded-lg shadow-md">
  <span className="text-lg font-semibold text-gray-900">
    {title}
  </span>
</div>
```

### CSS Modules (when needed)
```tsx
import styles from './Component.module.css';

<div className={styles.container}>
  <span className={styles.title}>{title}</span>
</div>
```

### Styled Components / Emotion (if used)
```tsx
const Container = styled.div`
  display: flex;
  align-items: center;
  padding: ${({ theme }) => theme.spacing.md};
`;
```

## Performance Optimization

### Memoization
```tsx
// Memoize expensive computations
const expensiveValue = useMemo(() => {
  return computeExpensiveValue(data);
}, [data]);

// Memoize callbacks
const handleClick = useCallback((id: string) => {
  onAction(id);
}, [onAction]);

// Memoize components
const MemoizedComponent = memo(function Component({ data }: Props) {
  return <div>{data.value}</div>;
});
```

### Code Splitting
```tsx
// Route-based splitting
const Page = lazy(() => import('./Page'));

// Component-based splitting
const HeavyComponent = lazy(() => import('./HeavyComponent'));
```

### Virtual Lists
```tsx
import { useVirtualizer } from '@tanstack/react-virtual';

function VirtualList({ items }: { items: Item[] }) {
  const parentRef = useRef<HTMLDivElement>(null);
  
  const virtualizer = useVirtualizer({
    count: items.length,
    getScrollElement: () => parentRef.current,
    estimateSize: () => 50,
  });
  
  return (
    <div ref={parentRef} style={{ height: '400px', overflow: 'auto' }}>
      <div style={{ height: virtualizer.getTotalSize() }}>
        {virtualizer.getVirtualItems().map((virtualItem) => (
          <div key={virtualItem.key} style={{
            position: 'absolute',
            top: virtualItem.start,
            height: virtualItem.size,
          }}>
            {items[virtualItem.index].name}
          </div>
        ))}
      </div>
    </div>
  );
}
```

## TypeScript Best Practices

### Type Definitions
```tsx
// Props interfaces
interface ButtonProps {
  variant: 'primary' | 'secondary' | 'danger';
  size?: 'sm' | 'md' | 'lg';
  onClick: () => void;
  children: React.ReactNode;
}

// API response types
interface ApiResponse<T> {
  data: T;
  meta: {
    page: number;
    total: number;
  };
}

// Utility types
type PartialUser = Partial<User>;
type RequiredUser = Required<User>;
type UserKeys = keyof User;
```

### Strict Null Checks
```tsx
// Handle potentially null values
const user = useUser();

if (!user) {
  return <NotFound />;
}

// Now TypeScript knows user is defined
return <UserProfile user={user} />;
```

## Error Handling

### Error Boundaries
```tsx
import { ErrorBoundary } from 'react-error-boundary';

function ErrorFallback({ error, resetErrorBoundary }: FallbackProps) {
  return (
    <div role="alert">
      <p>Something went wrong:</p>
      <pre>{error.message}</pre>
      <button onClick={resetErrorBoundary}>Try again</button>
    </div>
  );
}

<ErrorBoundary FallbackComponent={ErrorFallback}>
  <MyComponent />
</ErrorBoundary>
```

## Testing

### Component Tests
```tsx
import { render, screen, fireEvent } from '@testing-library/react';

describe('Button', () => {
  it('calls onClick when clicked', () => {
    const onClick = vi.fn();
    render(<Button onClick={onClick}>Click me</Button>);
    
    fireEvent.click(screen.getByRole('button'));
    
    expect(onClick).toHaveBeenCalledOnce();
  });
});
```

### Hook Tests
```tsx
import { renderHook, act } from '@testing-library/react';

describe('useCounter', () => {
  it('increments count', () => {
    const { result } = renderHook(() => useCounter());
    
    act(() => {
      result.current.increment();
    });
    
    expect(result.current.count).toBe(1);
  });
});
```

## Resource Files

For detailed patterns, see:
- [component-patterns.md](resources/component-patterns.md)
- [state-management.md](resources/state-management.md)
- [performance.md](resources/performance.md)
- [testing.md](resources/testing.md)

© Bbeierle12 · MIT · Bbeierle12/Skill-MCP-Claude

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

Все скиллы по теме «Фронтенд и UI» →

Сначала — frontend-dev-guidelines от других авторов.

frontend-dev-guidelines sickn33 Скилл frontend-dev-guidelines задаёт строгие правила для React и TypeScript: структура фич, Suspense-запросы, MUI и проверка влияния на производительность. CX Codex +1 1 500установок react-data-fetching patterns.dev Скилл react-data-fetching для Claude Code и ещё пяти платформ учит агента современным паттернам загрузки данных в React: кэширование, дедупликация, оптимистичные обновления, параллельная загрузка. CX Codex +1 1 100установок react-frontend-expert platform-team Скилл react-frontend-expert задаёт правила вёрстки React-компонентов на TypeScript, создания кастомных хуков и работы с TanStack Query. CX Codex +1 208установок Frontend Builder daffy0208 Скилл Frontend Builder задаёт ИИ-агенту правила вёрстки на React и Next.js: как дробить интерфейс на компоненты, где хранить состояние и когда тянуть данные через React Query. CX Codex +1 218установок oma-frontend First Fluke Субагент oma-frontend для фронтенда на React, Next.js и TypeScript с архитектурой FSD-lite, shadcn/ui и design-tokens. Ставь, когда работаешь с UI, компонентами, страницами, стилями и клиентской логикой. CX Codex +1 ★ 1 472звёзд репо senior-frontend borghei Скилл senior-frontend для Claude Code, Codex, Cursor и других IDE создаёт React-проекты, компоненты, тесты и Storybook-файлы. Проверяет зависимости и подсвечивает тяжёлые пакеты. CX Codex +1 357установок frontend-developer Community Субагент frontend-developer помогает проектировать компоненты на React, Vue или Angular, исправлять вёрстку и оптимизировать рендеринг веб-приложений. CX Codex ★ 2 003звёзд репо

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

Весь набор →
gsap-react Скилл gsap-react для Claude Code, Codex, Cursor и других агентов с паттернами интеграции GSAP в React-компоненты. Закрывает хук useGSAP, работу с рефами, очистку анимаций при размонтировании и управление контекстом. CX Codex +1 728установок gsap-scrolltrigger Привязка анимаций GSAP ScrollTrigger к прокрутке, пиннинг секций, параллакс и точки прилипания. CX Codex +1 612установок gsap-fundamentals Скилл gsap-fundamentals для Claude Code объясняет основы GSAP: твины, таймлайны, easing и свойства анимации. Помогает добавлять движение элементам интерфейса и разбираться с GSAP. CX Codex +1 286установок shader-effects Скилл shader-effects для Claude Code добавляет GLSL-примеры свечения, искажений, зерна, глитча и других эффектов для постобработки и стилизованного рендера. CX Codex +1 225установок d3js-visualization Скилл d3js-visualization для Claude Code учит агента создавать графики на D3.js: столбчатые, линейные и круговые диаграммы, тултипы и зум. CX Codex +1 189установок particles-gpu Скилл particles-gpu генерирует системы частиц на GPU через Three.js и React Three Fiber. Помогает рендерить эффекты от 10 тысяч до миллионов точек без просадки кадров. CX Codex +1 173установок shader-fundamentals Скилл shader-fundamentals объясняет основы GLSL: шейдеры вершин и фрагментов, типы данных, координаты и передачу значений. Нужен при создании и отладке эффектов. CX Codex +1 173установок gsap-sequencing Скилл gsap-sequencing для Claude Code помогает собирать сложные последовательности GSAP с метками, вложенными таймлайнами и колбэками для анимации интерфейса. CX Codex +1 163установок

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

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