reactive-dashboard-performance — скилл для Claude Code: установка
Скилл reactive-dashboard-performance настраивает быстрый рендеринг дашбордов на React и ускоряет асинхронные тесты. Помогает внедрить скелетоны, настроить React Query и убрать таймауты в тестах.
MIT 220 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a claude-codeЧто делает reactive-dashboard-performance
Скилл содержит паттерны оптимизации интерфейсов уровня Linear и Notion. Он предписывает выводить скелетон за первые 16 мс вместо спиннеров на коротких загрузках, настраивать кэширование в React Query со staleTime на 5 минут и применять оптимистичные обновления данных. Для тяжёлых виджетов используется отложенная загрузка через React.lazy().
Вторая часть инструкций посвящена асинхронному тестированию. Скилл запрещает мокать компоненты интерфейса целиком, требуя изоляции только на границах сервисов вроде сетевых вызовов через MSW. При таймаутах интеграционных проверок алгоритм заставляет вызвать screen.debug() и переходить на асинхронный поиск через findBy* вместо синхронного getBy*.
Если в проекте нет обёртки QueryClientProvider в тестовом окружении, асинхронные тесты дашборда начнут падать с ошибками контекста.
Какие задачи решает
- настроить скелетон-рендеринг для быстрой отрисовки интерфейса
- устранить таймауты в асинхронных интеграционных тестах
- сконфигурировать кэширование и предварительную загрузку в React Query
- оптимизировать вычисления и повторные рендеры через useMemo и React.memo
Примеры запросов агенту
- Почему в интеграционных тестах дашборда возникает таймаут?
- Настрой параметры кэширования React Query для панели аналитики
- Переведи загрузку виджетов дашборда на скелетоны вместо спиннеров
Как установить reactive-dashboard-performance
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a claude-code2Вручную: положить файлы
~/.claude/skills/reactive-dashboard-performance/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/reactive-dashboard-performance/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a codex2Вручную: положить файлы
.agents/skills/reactive-dashboard-performance/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a cursor2Вручную: положить файлы
.cursor/skills/reactive-dashboard-performance/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/reactive-dashboard-performance2Вручную: положить файлы
.github/skills/reactive-dashboard-performance/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/reactive-dashboard-performanceВручную: положить файлы
.devin/skills/reactive-dashboard-performance/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о reactive-dashboard-performance
Как установить reactive-dashboard-performance в Claude Code?
Выполните в терминале команду npx skills add curiositech/some_claude_skills --skill reactive-dashboard-performance -a claude-code. Файл навыка появится по пути ~/.claude/skills/reactive-dashboard-performance/SKILL.md.
Что делает reactive-dashboard-performance?
Навык передаёт агенту набор правил для профилирования интерфейсов на React и починки медленных тестов. Он задаёт бюджеты отрисовки и шаблоны настройки React Query.
Как скилл предлагает искать причину зависания тестов?
Диагностика начинается с вызова screen.debug(), чтобы увидеть фактическое состояние DOM. Далее агент проверяет консоль на ошибки немоканных вызовов и заменяет синхронные селекторы на асинхронные findBy*.
Исходный текст
SKILL.md · MIT
---
name: reactive-dashboard-performance
description: Expert in building blazing-fast reactive dashboards with comprehensive testing. Masters React performance patterns, testing strategies for async components, and real-world patterns from Linear,
Vercel, Notion.
allowed-tools:
- Read
- Write
- Edit
- Bash
- Grep
- Glob
version: 1.0.0
triggers:
- dashboard performance
- slow tests
- reactive testing
- integration tests timeout
- dashboard optimization
metadata:
category: Frontend Development
tags:
- react
- performance
- testing
- dashboard
- optimization
pairs-with:
- skill: react-performance-optimizer
reason: Dashboard performance depends on React memoization, virtualization, and state management
- skill: admin-dashboard
reason: Admin dashboards are the primary consumer of reactive dashboard performance patterns
- skill: data-viz-2025
reason: Dashboard charts and graphs require performant data visualization rendering
---
# Reactive Dashboard Performance
Expert in building production-grade reactive dashboards that load in <100ms and have comprehensive test coverage.
## Core Expertise
### Performance Patterns (Linear, Vercel, Notion-grade)
1. **Skeleton-First Loading**
- Render skeleton immediately (0ms perceived load)
- Stream in data progressively
- Never show spinners for <200ms loads
2. **Aggressive Caching**
- React Query with staleTime: 5min, cacheTime: 30min
- Optimistic updates for mutations
- Prefetch on hover/mount
3. **Code Splitting**
- Route-based splitting (Next.js automatic)
- Component-level lazy() for heavy widgets
- Preload critical paths
4. **Memoization Strategy**
- useMemo for expensive computations
- React.memo for pure components
- useCallback for stable references
### Testing Reactive Dashboards
1. **Mock Strategy**
- Mock at service boundary (React Query, analytics)
- Never mock UI components (test real DOM)
- Use MSW for API mocking when possible
2. **Async Handling**
```typescript
// WRONG - races with React
render(<Dashboard />);
const element = screen.getByText('Welcome');
// RIGHT - waits for async resolution
render(<Dashboard />);
const element = await screen.findByText('Welcome');
```
3. **Timeout Debugging**
- Timeouts mean: missing mock, wrong query, or component not rendering
- Use screen.debug() to see actual DOM
- Check console for unmocked errors
4. **Test Wrapper Pattern**
```typescript
const TestProviders = ({ children }) => (
<QueryClientProvider client={testQueryClient}>
<AuthProvider>
{children}
</AuthProvider>
</QueryClientProvider>
);
```
### Real-World Examples
- **Linear Dashboard**: Skeleton → Stale data → Fresh data (perceived <50ms)
- **Vercel Dashboard**: Prefetch on nav hover, optimistic deploys
- **Notion Pages**: Infinite cache, local-first, sync in background
## Diagnostic Protocol
### Integration Test Timeouts
1. **Check what's actually rendering**
```typescript
render(<Component />);
screen.debug(); // See actual DOM
```
2. **Find unmocked dependencies**
- Check console for "not a function" errors
- Look for network requests in test output
- Verify all contexts are provided
3. **Fix async queries**
- Use findBy* instead of getBy*
- Increase timeout if needed: `waitFor(() => {...}, { timeout: 3000 })`
- Mock React Query properly
4. **Simplify component tree**
- Test widgets individually first
- Add full integration tests last
- Use data-testid for complex queries
## Performance Optimization
### Dashboard Load Budget
| Phase | Target |
|-------|--------|
| Skeleton render | 0-16ms (1 frame) |
| First data paint | <100ms |
| Full interactive | <200ms |
| Lazy widgets | <500ms |
### React Query Config
```typescript
const queryClient = new QueryClient({
defaultOptions: {
queries: {
staleTime: 5 * 60 * 1000, // 5min
cacheTime: 30 * 60 * 1000, // 30min
refetchOnWindowFocus: false,
refetchOnMount: false,
retry: 1,
},
},
});
```
### Skeleton Pattern
```typescript
function Dashboard() {
const { data, isLoading } = useQuery('dashboard', fetchDashboard);
// Show skeleton immediately, no loading check
return (
<div>
{data ? <RealWidget data={data} /> : <SkeletonWidget />}
</div>
);
}
```
## Common Pitfalls
1. **Spinners for fast loads** - Use skeletons instead
2. **Unmemoized expensive computations** - Wrap in useMemo
3. **Testing implementation details** - Test user behavior
4. **Mocking too much** - Mock at boundaries only
5. **Synchronous test expectations** - Everything is async
When debugging test timeouts, ALWAYS start with `screen.debug()` to see what actually rendered.
© curiositech · MIT · curiositech/some_claude_skills