expo-router Skill for Claude: Build Expo Router Navigation the Official Way

Makes your assistant build Expo Router navigation with file-based routes, native stacks and tabs, modals and sheets.

Installs: 30K; on skills.sh
Stars: 4K; on GitHub
Files: 7; besides SKILL.md
Updated: Nov 2026; last repo commit

expo-router gives your assistant Expo's own rules for navigation. It covers file-based routes, groups and dynamic routes, links with previews and context menus, native stacks, page titles, modals, form sheets, native tabs, headers and search bars. It sets rules such as kebab-case file names and keeping only routes in the app folder.

It triggers when you work on navigation or routing in an Expo app. The skill points to expo-native-ui for screen styling and expo-animation for motion; those are separate skills. The folder holds 8 files including SKILL.md and bundles no scripts. The README says it comes from the Expo team.

Good for

React Native developers building apps with Expo Router
Teams moving to native tabs and native stack headers
Anyone starting a new Expo app who wants the official route layout

Install expo-router

Claude Code

Copy this prompt.

Install the expo-router skill in Claude Code. Run this command:

claude plugin install expo@claude-plugins-official

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Claude Code.

The README recommends the plugin for Claude Code and Codex. It installs all 23 skills in the expo plugin folder and also wires up the Expo MCP server (https://mcp.expo.dev/mcp) that the plugin bundles. To take only this skill, use the skills CLI command.

From the project README. Source.

What's in the skill

When it loads

Navigation and routing for Expo Router. Covers file-based routes, groups and dynamic routes, folder organization, Link with previews and context menus, native Stack, page titles, modals and form sheets, NativeTabs, headers and toolbars, and header search bars.

Sections in SKILL.md

References
Code Style
Routes
Library Preferences
Behavior
Link
Stack
Page Title
Context Menus
Link Previews
Modal
Sheet
Common route structure
Submitting Feedback

Key facts

Author: Expo (expo/skills)
Repo: expo/skills
License: MIT (SKILL.md frontmatter and README badge)
Installs on skills.sh: 30,033 (Nov 2, 2026)
GitHub stars (whole repo): 4,005 (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Skill folder: 8 files including SKILL.md: SKILL.md, agents/openai.yaml, 6 reference notes
Official: README: official AI agent skills from the Expo team
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Kebab-case file names, remove old route files when restructuring, use path aliases
Kebab-case file names, remove old route files when restructuring, no special characters, path aliases
Code style rules
Only routes in the app folder, no components or utilities there, always a route for '/'
Files · Routes rules
Native Color from expo-router; from SDK 56 import from expo-router/react-navigation
Color from expo-router for native colors; from SDK 56 import from expo-router/react-navigation
Library preferences
Use Link for navigation, with Link.Preview where it fits iOS conventions
Link
Define stacks in _layout.tsx files with Stack from expo-router/stack
Native stack
Set the page title with Stack.Title
Page titles
Long-press menus and previews on Link, including destructive actions
Context menus and previews
Present a screen as a modal with presentation: modal instead of a custom component
Modals
Present a screen as a form sheet with grabber and detents
Present a screen as a form sheet with grabber and detents; transparent background on iOS 26+
Form sheets
NativeTabs in the root layout with a shared group route so tabs push common screens
Tabs with stacks layout
Prefer Stack.SearchBar to add a search bar to a screen
Search bar
Six notes: route structure, tabs, headers, form sheets, search, zoom transitions
Six notes: route structure, tabs, toolbar and headers, form sheets, search, zoom transitions
Reference notes
Runs npx --yes @expo/agent-cli@latest feedback for specific errors in the skill
Runs code · Submit feedback to Expo

From the official docs

Permissions

Medium risk

This skill edits and removes route files in your Expo project, and can run a feedback command that reports to Expo. Use a clean git branch and review the diff.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It tells the assistant to delete old route files
SKILL.md says always remove old route files when moving or restructuring navigation. Work on a clean git branch so you can review the changes. github.com
It can send a report to Expo
SKILL.md tells the assistant to run npx --yes @expo/agent-cli@latest feedback for specific errors in the skill, or when it repeatedly fails an Expo task. The report describes the task and what went wrong, so check it first. github.com
The plugin route adds more than this skill
The plugin folder has 23 skills and a config for the Expo MCP server at mcp.expo.dev. The README says that server can read docs, install dependencies, trigger EAS builds and screenshot a simulator. Use the skills CLI command to take only this skill. github.com

Technical details

Talks to	Expo feedback service, only if the assistant submits feedback. Expo MCP server, only with the plugin route
Scopes	Your Expo project files

Questions

What does expo-router do?

It teaches your assistant Expo Router's conventions: routes, links, native stacks, tabs, modals, form sheets, headers and search. It also sets file naming and folder rules.

How do I install expo-router?

Use the install box at the top of this page. The README recommends the plugin for Claude Code and Codex, and the skills CLI for Cursor and other agents. Run the skills CLI from your project root and restart the agent session.

Does it work in Codex and Cursor?

The README documents a Codex plugin and a skills CLI route for Cursor and other agents.

Which Expo SDK does it target?

Some rules name SDK versions. For example, in SDK 56 and later it says to import from expo-router/react-navigation rather than @react-navigation/*.

Is expo-router safe to install?

The folder holds SKILL.md, an agent config file and six reference notes, and bundles no scripts. It does tell the assistant to delete old route files and can run a feedback command. Use a clean git branch and review the diff.

Should I also install expo-native-ui and expo-animation?

Optional. The skill points to expo-native-ui for screen styling and expo-animation for motion, and both live in the same repo.

Is expo-router official?

The README describes expo/skills as official AI agent skills from the Expo team.

Information

updated Nov 2, 2026

Repository: expo/skills
Folder: plugins/expo/skills/expo-router

expo/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

expo/skills README · github.com
expo-router on skills.sh · skills.sh
expo-router SKILL.md · github.com
expo plugin .mcp.json · github.com