react-native-skills
byvercel-labs· 154 skills
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
How to install react-native-skills?
vercel-labs/agent-skills/react-native-skills
$npx -y skills add vercel-labs/agent-skills --skill react-native-skillsInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/vercel-labs/agent-skills" --skill "vercel-labs/agent-skills/react-native-skills"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/vercel-labs/agent-skills" that are relevant to the current task. Run `npx skills add "https://github.com/vercel-labs/agent-skills"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | # React Native Skills |
| 2 | |
| 3 | Comprehensive best practices for React Native and Expo applications. Contains |
| 4 | rules across multiple categories covering performance, animations, UI patterns, |
| 5 | and platform-specific optimizations. |
| 6 | |
| 7 | ## When to Apply |
| 8 | |
| 9 | Reference these guidelines when: |
| 10 | |
| 11 | - Building React Native or Expo apps |
| 12 | - Optimizing list and scroll performance |
| 13 | - Implementing animations with Reanimated |
| 14 | - Working with images and media |
| 15 | - Configuring native modules or fonts |
| 16 | - Structuring monorepo projects with native dependencies |
| 17 | |
| 18 | ## Rule Categories by Priority |
| 19 | |
| 20 | | Priority | Category | Impact | Prefix | |
| 21 | | -------- | ---------------- | -------- | -------------------- | |
| 22 | | 1 | List Performance | CRITICAL | `list-performance-` | |
| 23 | | 2 | Animation | HIGH | `animation-` | |
| 24 | | 3 | Navigation | HIGH | `navigation-` | |
| 25 | | 4 | UI Patterns | HIGH | `ui-` | |
| 26 | | 5 | State Management | MEDIUM | `react-state-` | |
| 27 | | 6 | Rendering | MEDIUM | `rendering-` | |
| 28 | | 7 | Monorepo | MEDIUM | `monorepo-` | |
| 29 | | 8 | Configuration | LOW | `fonts-`, `imports-` | |
| 30 | |
| 31 | ## Quick Reference |
| 32 | |
| 33 | ### 1. List Performance (CRITICAL) |
| 34 | |
| 35 | - `list-performance-virtualize` - Use FlashList for large lists |
| 36 | - `list-performance-item-memo` - Memoize list item components |
| 37 | - `list-performance-callbacks` - Stabilize callback references |
| 38 | - `list-performance-inline-objects` - Avoid inline style objects |
| 39 | - `list-performance-function-references` - Extract functions outside render |
| 40 | - `list-performance-images` - Optimize images in lists |
| 41 | - `list-performance-item-expensive` - Move expensive work outside items |
| 42 | - `list-performance-item-types` - Use item types for heterogeneous lists |
| 43 | |
| 44 | ### 2. Animation (HIGH) |
| 45 | |
| 46 | - `animation-gpu-properties` - Animate only transform and opacity |
| 47 | - `animation-derived-value` - Use useDerivedValue for computed animations |
| 48 | - `animation-gesture-detector-press` - Use Gesture.Tap instead of Pressable |
| 49 | |
| 50 | ### 3. Navigation (HIGH) |
| 51 | |
| 52 | - `navigation-native-navigators` - Use native stack and native tabs over JS navigators |
| 53 | |
| 54 | ### 4. UI Patterns (HIGH) |
| 55 | |
| 56 | - `ui-expo-image` - Use expo-image for all images |
| 57 | - `ui-image-gallery` - Use Galeria for image lightboxes |
| 58 | - `ui-pressable` - Use Pressable over TouchableOpacity |
| 59 | - `ui-safe-area-scroll` - Handle safe areas in ScrollViews |
| 60 | - `ui-scrollview-content-inset` - Use contentInset for headers |
| 61 | - `ui-menus` - Use native context menus |
| 62 | - `ui-native-modals` - Use native modals when possible |
| 63 | - `ui-measure-views` - Use onLayout, not measure() |
| 64 | - `ui-styling` - Use StyleSheet.create or Nativewind |
| 65 | |
| 66 | ### 5. State Management (MEDIUM) |
| 67 | |
| 68 | - `react-state-minimize` - Minimize state subscriptions |
| 69 | - `react-state-dispatcher` - Use dispatcher pattern for callbacks |
| 70 | - `react-state-fallback` - Show fallback on first render |
| 71 | - `react-compiler-destructure-functions` - Destructure for React Compiler |
| 72 | - `react-compiler-reanimated-shared-values` - Handle shared values with compiler |
| 73 | |
| 74 | ### 6. Rendering (MEDIUM) |
| 75 | |
| 76 | - `rendering-text-in-text-component` - Wrap text in Text components |
| 77 | - `rendering-no-falsy-and` - Avoid falsy && for conditional rendering |
| 78 | |
| 79 | ### 7. Monorepo (MEDIUM) |
| 80 | |
| 81 | - `monorepo-native-deps-in-app` - Keep native dependencies in app package |
| 82 | - `monorepo-single-dependency-versions` - Use single versions across packages |
| 83 | |
| 84 | ### 8. Configuration (LOW) |
| 85 | |
| 86 | - `fonts-config-plugin` - Use config plugins for custom fonts |
| 87 | - `imports-design-system-folder` - Organize design system imports |
| 88 | - `js-hoist-intl` - Hoist Intl object creation |
| 89 | |
| 90 | ## How to Use |
| 91 | |
| 92 | Read individual rule files for detailed explanations and code examples: |
| 93 | |
| 94 | ``` |
| 95 | rules/list-performance-virtualize.md |
| 96 | rules/animation-gpu-properties.md |
| 97 | ``` |
| 98 | |
| 99 | Each rule file contains: |
| 100 | |
| 101 | - Brief explanation of why it matters |
| 102 | - Incorrect code example with explanation |
| 103 | - Correct code example with explanation |
| 104 | - Additional context and references |
| 105 | |
| 106 | ## Full Compiled Document |
| 107 | |
| 108 | For the complete guide with all rules expanded: `AGENTS.md` |
Related
6 picksType
- imagegen-frontend-mobileElite mobile app image-generation skill for creating premium, app-native screen concepts and flows.Jul 2026
- firebase-crashlyticsComprehensive guide for Firebase Crashlytics, including provisioning and SDK usage.Jul 2026
- xcode-project-setupSafely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g.Jul 2026
- expo-tailwind-setupFramework (OSS). Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal stylingJul 2026
- expo-dev-clientFramework (OSS). Build and distribute Expo development clients locally or via TestFlight for internal testing.Jul 2026
- expo-moduleFramework (OSS). Guide for creating and writing Expo native modules and views using the Expo Modules API (Swift, Kotlin, TypeScript).Jul 2026
