React Native Skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementin...

Security Scan

This is an instruction-only React Native / Expo best-practices guide whose files and runtime instructions match its stated purpose, and it does not request credentials, install code, or reach out to external endpoints.

Purpose & Capability

The name/description (React Native / Expo best practices) matches the included files (AGENTS.md and rule docs). There are no unrelated requirements (no env vars, binaries, or install steps) that would be disproportionate to a documentation / guidance skill.

Instruction Scope

SKILL.md and the rule files are documentation for code generation/refactoring and reference concrete coding patterns and occasional developer commands (e.g., `npx expo prebuild` in the fonts rule). That is within scope for a coding-guidance skill, but the AGENTS.md explicitly says guidance is optimized for automation — if you allow an agent to act autonomously with this skill, it may use these recommendations to modify or run build commands in your codebase. No instructions reference secrets, system paths, or external endpoints beyond normal package/docs links.

Install Mechanism

No install spec and no code files with executable install steps. Instruction-only skills are lowest-risk for disk persistence or arbitrary code execution.

Credentials

The skill declares no required environment variables, credentials, or config paths. The content references normal developer dependencies (React Native, Expo, Reanimated, FlashList, etc.), which is expected and proportional to the stated purpose.

Persistence & Privilege

Flags show no forced persistence (always: false) and default agent invocation settings. The skill does not request to modify other skills or system-wide settings.

Assessment

This skill is essentially a documentation bundle of React Native / Expo best practices and appears coherent and proportionate. There are no requested secrets or install scripts, so the static risk is low. Things to consider before installing: 1) Source verification — the metadata lists no homepage and the package owner is an opaque ID; if you require provenance, confirm the origin (author claims 'vercel' in the docs but registry metadata doesn't provide a public homepage). 2) If you permit an autonomous agent to use this skill, be aware the AGENTS.md is optimized for automation and the agent could apply these rules to modify or run commands in your repository (e.g., running build or CLI commands). Limit the agent's write/run permissions or require human review of changes if you want to avoid unintended code modification. 3) The guidance references third-party libraries (FlashList, LegendList, Galeria, expo-image, etc.); auditing those dependencies in your project is recommended before adopting suggestions. Overall, the skill is consistent with its stated purpose and does not request privileged access.

Comprehensive best practices for React Native and Expo applications. Contains rules across multiple categories covering performance, animations, UI patterns, and platform-specific optimizations.

When to Apply

Reference these guidelines when:

• Building React Native or Expo apps
• Optimizing list and scroll performance
• Implementing animations with Reanimated
• Working with images and media
• Configuring native modules or fonts
• Structuring monorepo projects with native dependencies

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	List Performance	CRITICAL	list-performance-
2	Animation	HIGH	animation-
3	Navigation	HIGH	navigation-
4	UI Patterns	HIGH	ui-
5	State Management	MEDIUM	react-state-
6	Rendering	MEDIUM	rendering-
7	Monorepo	MEDIUM	monorepo-
8	Configuration	LOW	fonts-, imports-

Quick Reference

1. List Performance (CRITICAL)

• list-performance-virtualize - Use FlashList for large lists
• list-performance-item-memo - Memoize list item components
• list-performance-callbacks - Stabilize callback references
• list-performance-inline-objects - Avoid inline style objects
• list-performance-function-references - Extract functions outside render
• list-performance-images - Optimize images in lists
• list-performance-item-expensive - Move expensive work outside items
• list-performance-item-types - Use item types for heterogeneous lists

2. Animation (HIGH)

• animation-gpu-properties - Animate only transform and opacity
• animation-derived-value - Use useDerivedValue for computed animations
• animation-gesture-detector-press - Use Gesture.Tap instead of Pressable

3. Navigation (HIGH)

• navigation-native-navigators - Use native stack and native tabs over JS navigators

4. UI Patterns (HIGH)

• ui-expo-image - Use expo-image for all images
• ui-image-gallery - Use Galeria for image lightboxes
• ui-pressable - Use Pressable over TouchableOpacity
• ui-safe-area-scroll - Handle safe areas in ScrollViews
• ui-scrollview-content-inset - Use contentInset for headers
• ui-menus - Use native context menus
• ui-native-modals - Use native modals when possible
• ui-measure-views - Use onLayout, not measure()
• ui-styling - Use StyleSheet.create or Nativewind

5. State Management (MEDIUM)

• react-state-minimize - Minimize state subscriptions
• react-state-dispatcher - Use dispatcher pattern for callbacks
• react-state-fallback - Show fallback on first render
• react-compiler-destructure-functions - Destructure for React Compiler
• react-compiler-reanimated-shared-values - Handle shared values with compiler

6. Rendering (MEDIUM)

• rendering-text-in-text-component - Wrap text in Text components
• rendering-no-falsy-and - Avoid falsy && for conditional rendering

7. Monorepo (MEDIUM)

• monorepo-native-deps-in-app - Keep native dependencies in app package
• monorepo-single-dependency-versions - Use single versions across packages

8. Configuration (LOW)

• fonts-config-plugin - Use config plugins for custom fonts
• imports-design-system-folder - Organize design system imports
• js-hoist-intl - Hoist Intl object creation

How to Use

Read individual rule files for detailed explanations and code examples:

rules/list-performance-virtualize.md
rules/animation-gpu-properties.md

Each rule file contains:

• Brief explanation of why it matters
• Incorrect code example with explanation
• Correct code example with explanation
• Additional context and references

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md