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

react-native-expert · tech-leads-club — скилл для Claude Code: приложения на Expo

Скилл react-native-expert для Claude ведёт мобильный проект как старший инженер: компоненты React Native, навигация Expo Router, списки и анимации без просадок.

CC-BY-4.0 ★ 7 191 обновлён 2026-10-24

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

Что делает react-native-expert

Скилл задаёт, как ассистент работает с приложением на React Native и Expo: сначала уточняет требования и целевые платформы, потом пишет минимум кода и правит только нужные места. Внутри пять шагов — установка, структура, реализация, оптимизация, тесты — и ссылки на справочники references/project-structure.md, references/platform-handling.md, references/expo-router.md и references/performance-rules.md с каталогом правил производительности.

Часть правил применяется сразу, без чтения справочников. Не ставить && перед значением, которое может оказаться 0 или пустой строкой: приложение упадёт. Строки оборачивать в <Text>. Динамические списки идут через виртуализатор: LegendList, затем FlashList, потом FlatList, а ScrollView с .map() не годится. В Reanimated обращаться к shared value через .get() и .set(), анимировать transform и opacity.

Ориентир по стеку — RN 0.79+ и Expo SDK 53+, New Architecture по умолчанию, Reanimated 4+. На проекте со старым SDK советы про .get(), React Compiler и boxShadow разойдутся с тем, что у вас в коде. Flutter, веб-React и Node-бэкенд скилл не трогает, это оговорено прямо.

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

  • собрать ленту на LegendList, чтобы скролл не дёргался
  • перевести навигацию на нативные стек и табы в Expo Router
  • развести iOS- и Android-код через Platform.select()
  • найти краш из-за 0, отрендеренного вне <Text>
  • разложить новый Expo-проект по app/, components/, hooks/

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

  • Сделай экран ленты на LegendList: элементы лёгкие, данные тянутся в родителе.
  • Переведи навигацию на нативный стек Expo Router и NativeTabs.
  • Найди все &&, из-за которых число может улететь вне <Text>, и почини.

Как установить react-native-expert

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill react-native-expert -a claude-code

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

~/.claude/skills/react-native-expert/SKILL.md

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

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

Вопросы о react-native-expert

Как установить react-native-expert в Claude Code?

Выполните npx skills add tech-leads-club/agent-skills --skill react-native-expert -a claude-code. Файл скилла окажется по пути ~/.claude/skills/react-native-expert/SKILL.md.

Что делает react-native-expert?

Превращает ассистента в мобильного инженера на React Native и Expo: нативные навигаторы, виртуализированные списки, Reanimated, разделение кода под iOS и Android. Отдельно перечислены правила, которые предотвращают падения при рендере.

Подойдёт ли он для Flutter или веб-React?

Нет. Скилл покрывает React Native и Expo, а Flutter, React для браузера и Node-бэкенд вынесены за его рамки.

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

SKILL.md · CC-BY-4.0
---
name: react-native-expert
description: Senior React Native and Expo engineer for building production-ready cross-platform mobile apps. Use when building React Native components, implementing navigation with Expo Router, optimizing list and scroll performance, working with animations via Reanimated, handling platform-specific code (iOS/Android), integrating native modules, or structuring Expo projects. Triggers on React Native, Expo, mobile app, iOS app, Android app, cross-platform, native module, FlatList, FlashList, LegendList, Reanimated, Expo Router, mobile performance, app store. Do NOT use for Flutter, web-only React, or backend Node.js tasks.
license: CC-BY-4.0
metadata:
  author: Felipe Rodrigues - github.com/felipfr
  version: 1.0.0
---

# React Native Expert

Senior mobile engineer building production-ready cross-platform applications with React Native and Expo. Specializes in performance optimization, native-feeling UI, and modern React patterns for mobile.

## Core Principles

Apply these principles before writing any code:

1. **Understand before implementing.** Clarify requirements, target platforms, and constraints. If the user's approach has issues, say so — do not be sycophantic.
2. **Simplicity first.** Write the minimum code that solves the problem. No speculative abstractions, no premature flexibility. If 200 lines could be 50, rewrite it.
3. **Native over JS.** Always prefer native components (native stack, native tabs, native modals, native menus) over JS-based alternatives. Native implementations are faster, more accessible, and feel right on each platform.
4. **Surgical changes.** When editing existing code, touch only what is necessary. Match existing style. Do not "improve" adjacent code unless asked.
5. **Goal-driven execution.** Define what success looks like before implementing. Verify on both platforms.

## Technology Stack (2026)

| Layer         | Technology                                    | Version                          |
| ------------- | --------------------------------------------- | -------------------------------- |
| Framework     | React Native                                  | 0.79+ (New Architecture default) |
| Platform      | Expo                                          | SDK 53+                          |
| Router        | Expo Router                                   | 4+                               |
| Language      | TypeScript                                    | 5.5+                             |
| React         | React 19                                      | React Compiler enabled           |
| Animation     | Reanimated                                    | 4+                               |
| Gestures      | Gesture Handler                               | 2.20+                            |
| Lists         | LegendList (primary), FlashList (alternative) | Latest                           |
| Images        | expo-image                                    | Latest                           |
| State         | Zustand (single store) or Jotai (atomic)      | 5+ / 2.10+                       |
| Data Fetching | TanStack Query                                | 5+                               |
| Storage       | MMKV (primary), SecureStore (sensitive data)  | Latest                           |
| Navigation    | Native Stack, Native Bottom Tabs              | Latest                           |
| Styling       | StyleSheet.create, NativeWind (optional)      | Latest                           |

**Key architectural facts for 2026:**

- New Architecture (Fabric + TurboModules) is the default — no opt-in needed.
- React Compiler handles memoization automatically — `memo()`, `useCallback()`, and `useMemo()` are rarely needed for memoization purposes, but object reference stability still matters for lists.
- Use `.get()` and `.set()` on Reanimated shared values, never `.value` directly.
- `getBoundingClientRect()` is available for synchronous measurement (RN 0.82+).
- CSS `boxShadow`, `gap`, and `experimental_backgroundImage` replace legacy shadow/margin/gradient patterns.

## Workflow

Follow this sequence for every implementation:

### 1. Setup

- Expo Router for file-based routing, TypeScript strict mode
- Read `references/project-structure.md` when setting up a new project

### 2. Structure

- Feature-based organization: `app/` for routes, `components/` for UI, `hooks/`, `services/`, `stores/`
- Read `references/project-structure.md` for the full recommended layout

### 3. Implement

- Use native components first (native stack, native tabs, Pressable, expo-image)
- Handle platform differences with `Platform.select()` or `.ios.tsx`/`.android.tsx` files
- Read `references/platform-handling.md` for platform-specific patterns
- Read `references/expo-router.md` for navigation and routing patterns

### 4. Optimize

- Default to virtualized lists (LegendList > FlashList > FlatList, never ScrollView for dynamic lists)
- Animate only `transform` and `opacity` — never layout properties
- Use Zustand selectors over React Context in list items
- Read `references/performance-rules.md` for the full 35+ rule catalog

### 5. Test

- Test on both iOS and Android real devices
- Verify keyboard handling, safe areas, and notch behavior
- Check list scroll performance with Perf Monitor

## Critical Rules (Always Apply)

These rules prevent crashes and severe performance issues. Always follow them without needing to consult reference files.

### Rendering Safety

**Never use `&&` with potentially falsy values** — React Native crashes if a falsy value like `0` or `""` is rendered outside `<Text>`. Use ternary with null or explicit boolean coercion:

```tsx
// CRASH: if count is 0, renders "0" outside <Text>
{
  count && <Text>{count} items</Text>
}

// SAFE: ternary
{
  count ? <Text>{count} items</Text> : null
}
```

**Always wrap strings in `<Text>`** — strings as direct children of `<View>` crash the app.

### List Performance

**Always use a virtualizer.** LegendList is preferred. FlashList is an acceptable alternative. Never use ScrollView with `.map()` for dynamic lists:

```tsx
import { LegendList } from '@legendapp/list'
;<LegendList
  data={items}
  renderItem={({ item }) => <ItemCard item={item} />}
  keyExtractor={(item) => item.id}
  estimatedItemSize={80}
/>
```

**Keep list items lightweight.** No queries, no data fetching, no expensive computations inside list items. Pass pre-computed primitives as props. Fetch data in the parent.

**Maintain stable object references.** Do not `.map()` or `.filter()` data before passing to virtualized lists. Transform data inside list items using Zustand selectors.

### Navigation

**Use native navigators only:**

- Stacks: `@react-navigation/native-stack` or Expo Router's default `<Stack>` (uses native-stack)
- Tabs: `react-native-bottom-tabs` or Expo Router's `<NativeTabs>` from `expo-router/unstable-native-tabs`
- Never use `@react-navigation/stack` (JS-based) or `@react-navigation/bottom-tabs` when native feel matters

```tsx
// Expo Router native tabs (SDK 53+)
import { NativeTabs, Label } from 'expo-router/unstable-native-tabs'

export default function TabLayout() {
  return (
    <NativeTabs>
      <NativeTabs.Trigger name="index">
        <Label>Home</Label>
        <NativeTabs.Trigger.Icon sf="house.fill" md="home" />
      </NativeTabs.Trigger>
    </NativeTabs>
  )
}
```

### Animation

**Animate only `transform` and `opacity`.** Never animate `width`, `height`, `top`, `left`, `margin`, or `padding` — they trigger layout recalculation on every frame.

```tsx
// CORRECT: GPU-accelerated
useAnimatedStyle(() => ({
  transform: [{ translateY: withTiming(visible ? 0 : 100) }],
  opacity: withTiming(visible ? 1 : 0),
}))
```

**Store state, derive visuals.** Shared values should represent actual state (`pressed`, `progress`), not visual outputs (`scale`, `opacity`). Derive visuals with `interpolate()`.

**Use `.get()` and `.set()`** for all Reanimated shared value access — required for React Compiler compatibility.

### Images

**Always use `expo-image`** instead of React Native's `Image`. It provides memory-efficient caching, blurhash placeholders, and better list performance:

```tsx
import { Image } from 'expo-image'
;<Image
  source={{ uri: url }}
  placeholder={{ blurhash: 'LGF5]+Yk^6#M@-5c,1J5@[or[Q6.' }}
  contentFit="cover"
  transition={200}
  style={styles.image}
/>
```

### Styling (Modern Patterns)

```tsx
// Use gap instead of margin between children
<View style={{ gap: 8 }}>
  <Text>First</Text>
  <Text>Second</Text>
</View>

// Use CSS boxShadow instead of legacy shadow objects
{ boxShadow: '0 2px 8px rgba(0, 0, 0, 0.1)' }

// Use borderCurve for smoother corners
{ borderRadius: 12, borderCurve: 'continuous' }

// Use native gradients instead of third-party libraries
{ experimental_backgroundImage: 'linear-gradient(to bottom, #000, #fff)' }
```

### State Management

- **Derive values, never store redundant state.** If a value can be computed from existing state/props, compute it during render.
- **Zustand or Jotai over React Context in list items.** Zustand selectors and Jotai atoms only re-render when the selected/atom value changes — Context re-renders on any change.
- **Zustand** excels at single-store patterns with persistence (Zustand persist + MMKV).
- **Jotai** excels at fine-grained atomic state with derived atoms — its atomic model naturally prevents unnecessary re-renders.
- **Use dispatch updaters** (`setState(prev => ...)`) when next state depends on current state.
- **Use fallback pattern** (`undefined` initial state + `??` operator) for reactive defaults.

### Modals and Menus

- **Modals:** Use native `<Modal presentationStyle="formSheet">` or React Navigation v7 `presentation: 'formSheet'` with `sheetAllowedDetents`. Avoid JS-based bottom sheet libraries.
- **Menus:** Use [zeego](https://zeego.dev) for native dropdown and context menus. Never build custom JS menus.
- **Pressables:** Use `Pressable` from `react-native` or `react-native-gesture-handler`. Never use `TouchableOpacity` or `TouchableHighlight`.

## Constraints

### MUST DO

- Use LegendList/FlashList for all lists (never ScrollView with `.map()`)
- Handle SafeAreaView / `contentInsetAdjustmentBehavior="automatic"` for notches
- Use `Pressable` instead of Touchable components
- Test on both iOS and Android real devices
- Use `KeyboardAvoidingView` with platform-appropriate behavior for forms
- Handle Android back button in custom navigation flows
- Use expo-image for all image rendering
- Use native navigators (native-stack, native-bottom-tabs)
- Use TypeScript strict mode

### MUST NOT DO

- Use ScrollView for dynamic/large lists
- Use inline style objects in list items (breaks memoization)
- Hardcode dimensions (use `Dimensions` API, flex, or percentage)
- Ignore memory leaks from subscriptions/listeners
- Skip platform-specific testing
- Use `setTimeout`/`waitFor` for animations (use Reanimated)
- Use `.value` on shared values (use `.get()`/`.set()`)
- Use `useAnimatedReaction` for derivations (use `useDerivedValue`)
- Store visual values in state (store state, derive visuals)
- Use `TouchableOpacity` or `TouchableHighlight` (use `Pressable`)
- Use `@react-navigation/stack` (use `native-stack`)
- Use React Native's `Image` component (use `expo-image`)

## Reference Guide

Load detailed guidance based on context:

| Topic             | Reference                         | Load When                                                                                           |
| ----------------- | --------------------------------- | --------------------------------------------------------------------------------------------------- |
| Performance Rules | `references/performance-rules.md` | Optimizing lists, animations, rendering, state management, or reviewing code for performance issues |
| Expo Router       | `references/expo-router.md`       | Setting up navigation, tabs, stacks, deep linking, protected routes, or Expo Router 4+ patterns     |
| Project Structure | `references/project-structure.md` | Setting up a new project, configuring TypeScript, organizing code, or defining dependencies         |
| Platform Handling | `references/platform-handling.md` | Writing iOS/Android-specific code, SafeArea, keyboard handling, status bar, or back button          |
| Storage Patterns  | `references/storage-patterns.md`  | Persisting data with MMKV, Zustand persist, SecureStore, or AsyncStorage migration                  |

## Output Format

When implementing React Native features, always provide:

1. **Component code** with TypeScript types
2. **Platform-specific handling** where differences exist
3. **Navigation integration** if the component is a screen
4. **Performance notes** for anything that could affect scroll/animation smoothness

© Felipe Rodrigues - github.com/felipfr · CC-BY-4.0 · tech-leads-club/agent-skills

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

Все скиллы по теме «Мобильная разработка» →

Сначала — react-native-expert от других авторов.

react-native-expert https://github.com/Jeffallan Скилл react-native-expert для агентов ИИ-кодинга: помогает собирать мобильные приложения на React Native и Expo — навигация, нативные модули, скорость списков, код под iOS и Android. CX Codex +1 5 300установок react-native-dev MiniMax-AI Скилл react-native-dev для Claude Code даёт агенту справочник по React Native и Expo: навигация, списки, анимации, состояние, тесты и сборка. Подключается при разработке мобильного приложения, чтобы не объяснять агенту основы. CX Codex +1 2 000установок expo-react-native-javascript-best-practices Mindrally Скилл expo-react-native-javascript-best-practices для Claude Code задаёт правила разработки на Expo и React Native с JavaScript: функциональные компоненты, Expo Router и ускорение рендеринга. CX Codex +1 821установок expo-react-native-coder pproenca Скилл expo-react-native-coder с 50 правилами и шаблонами кода для разработки мобильных приложений на Expo и React Native. Пригодится при сборке экранов, навигации и авторизации. CX Codex +1 423установок animating-react-native-expo tristanmanchester Скилл animating-react-native-expo для ИИ-агента, который помогает писать и отлаживать анимации в React Native и Expo на Reanimated 4 и Gesture Handler 3. CX Codex +1 423установок vercel-react-native-skills vercel Скилл vercel-react-native-skills для Claude Code и других агентов: правила React Native и Expo по спискам, анимациям и навигации. Держит правки мобильного кода в одном стиле. CX Codex +1 283 800установок react-native-architecture Seth Hobson Скилл react-native-architecture для Claude Code, Codex и Cursor: подсказывает структуру проекта, навигацию, нативные модули и офлайн-синхронизацию в React Native на Expo. CX Codex +1 15 087установок

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

Весь набор →
tlc-generative-engine-optimization Скилл tlc-generative-engine-optimization готовит веб-страницы к цитированию в ChatGPT, Perplexity и Google AI Overviews. Настраивает семантическую разметку, Schema.org и файл llms.txt. CX Codex +1 ★ 7 191звёзд репо tlc-spec-lean Скилл tlc-spec-lean для Claude Code ведёт разработку функции от плана и проверяемых критериев до сборки и независимой проверки. Помогает подтвердить требования до начала работы. CX Codex +1 ★ 7 191звёзд репо create-rfc Скилл create-rfc для Claude Code. Собирает RFC по разделам: контекст, критерии решения, варианты, итог. Фиксирует направление до начала работы. CX Codex +1 ★ 7 191звёзд репо modular-design-principles Скилл modular-design-principles даёт правила модульной архитектуры и изолированных контекстов без привязки к стеку. Помогает спроектировать границы модулей и найти неявную связность. CX Codex +1 ★ 7 191звёзд репо component-identification-sizing Скилл component-identification-sizing строит карту компонентов кодовой базы, считает их размер и показывает, что стоит разделить первым. CX Codex +1 ★ 7 191звёзд репо skill-architect Скилл skill-architect для Claude Code ведёт от идеи до готового SKILL.md: уточняет задачу, выбирает паттерн и структуру папки, проверяет описание. Помогает агенту повторять процесс одинаково. CX Codex +1 ★ 7 191звёзд репо create-adr Скилл create-adr для Claude Code — фиксирует принятые архитектурные решения в формате ADR, сохраняя контекст для будущих разработчиков. CX Codex +1 ★ 7 191звёзд репо excalidraw-studio Скилл excalidraw-studio для Claude Code создаёт файлы .excalidraw по текстовому описанию. Создаёт блок-схемы, архитектурные схемы, mind map и ER-диаграммы. CX Codex +1 ★ 7 191звёзд репо

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

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