About expo-observe
A skill for Expo developers integrating EAS Observe and inspecting production performance data. It covers setup, navigation and custom events, CLI queries, and metric interpretation.
Key features
- 01Integrate EAS Observe
- 02Track startup and navigation metrics
- 03Record custom events
- 04Query performance data with the CLI
- 05Interpret metrics and diagnostic patterns
Use cases
- 01Set up production performance monitoring for an Expo app
- 02Inspect metrics, routes, and events from the terminal
- 03Identify slow startup or main-thread contention from metrics
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ expo/ skills --skill expo-observeAfter installing, type/expo-observein Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/metrics.mdqueries.mdsetup.mdDetails
From the project READMEEAS Observe
EAS Observe tracks startup, navigation, and custom-event performance from production Expo apps.
Source of truth: https://docs.expo.dev/eas/observe/ — always consult the canonical docs when API details matter, especially get-started, configuration, integrations, and the metrics reference. EAS Observe is evolving; this skill's references are written to stay accurate but may lag the docs.
Which reference to read
The three reference files in ./references/ cover the three things people typically need this skill for:
- Adding EAS Observe to a project →
./references/setup.md. Install, wrap the root layout (AppMetricsRooton SDK 55,ObserveRooton SDK 56+), callmarkInteractive()(global on SDK 55, via theuseObserve()hook on SDK 56+), optional per-route navigation metrics through the Expo Router / React Navigation integrations, and user-defined events viaObserve.logEvent(SDK 56+). - Querying metrics from the terminal →
./references/queries.md. The fiveeas observe:*commands —metrics-summary,metrics,routes,events,versions— with flags, table layouts, JSON shapes, and common workflows. - Reading a dashboard or CLI output →
./references/metrics.md. Target thresholds per metric, what the TTIframeRate.*params mean, and diagnostic patterns for telling slow-but-smooth startup apart from main-thread contention or hard blocks.
Quick links to the docs
- Get started: https://docs.expo.dev/eas/observe/get-started/
- Dashboard guide: https://docs.expo.dev/eas/observe/dashboard/
- Metrics reference: https://docs.expo.dev/eas/observe/reference/metrics/
- Expo Router integration: https://docs.expo.dev/eas/observe/integrations/expo-router/
- React Navigation integration: https://docs.expo.dev/eas/observe/integrations/react-navigation/
- User-defined events: https://docs.expo.dev/eas/observe/events/
- Configuration: https://docs.expo.dev/eas/observe/configuration/