expo-design-system
An agent skill by expo, from expo/skills. Tags: components, design, review, styleguide, tokens, ui-ux.
What it does
Framework (OSS). Build and maintain a design system inside an Expo app - a reusable theme of design tokens (color, spacing, typography, radius, shadow, motion), reusable component structure with variant/size/state prop conventions, and rules for when to extract a repeated view into a shared component. Use when creating or organizing theme files and design tokens (theme.ts / theme/), extending an existing theme or styling library (NativeWind, Tamagui, Restyle, Unistyles) in its own idiom, standardizing styles so screens (including AI-generated ones) look consistent and polished, fixing an app that looks AI-generated or generic instead of native (the named native-slop tells), building an in-app component library, or auditing an app for design-system drift (hardcoded colors, spacing, fonts). For platform styling specifics (semantic colors, HIG rules, native controls) use expo-native-ui; for folder layout of a new app use expo-project-structure.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add expo/skills --skill expo-design-system
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/expo/skills
cp -r skills/plugins/expo/skills/expo-design-system ~/.claude/skills/expo-design-system
Safety box score
Grade B, low risk: 11 of 100 risk points, rated 2026-09-22. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This is a documentation/workflow skill for organizing an Expo app’s design system: it guides token files, reusable components, and drift audits inside the project. The main risks are broad in-repo refactors under `src/theme/` and `src/components/`, plus one optional command that downloads and runs a registry package for feedback submission.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | The only explicit command that runs code is `npx --yes submit-expo-feedback@latest ...`, which downloads and executes a registry package; the rest are shell examples like `grep` and `find`. |
| Network access | 1 (low) | The optional feedback command sends data off-machine and depends on fetching a package from npm; the skill otherwise does not instruct remote downloads. |
| Filesystem reach | 1 (low) | The skill is meant to create and refactor app files such as `src/theme/`, `src/components/`, and screen code, but its edits are scoped to the project tree. |
| Secrets & credentials | 0 (none) | It does not ask for API keys, passwords, `.env` files, keychains, or browser sessions. |
| Privilege & persistence | 0 (none) | There is no `sudo`, global install, service registration, shell startup modification, or other privilege change. |
| Instruction hijack surface | 0 (none) | The skill does not tell the agent to ignore instructions, hide behavior, or follow untrusted remote prompts. |
| Irreversible actions | 0 (none) | It does not push, deploy, pay, book, or send messages automatically; the only outbound action is an optional feedback submission command. |
| Transparency | 0 (none) | All shipped files are plain markdown/YAML; there are no binaries, minified blobs, or decoded-at-runtime code. |
Before installing
- Decide whether you want the optional `npx --yes submit-expo-feedback@latest` command available at all.
- Check whether the repo already has a styling system (`package.json`, `theme.ts`, `src/theme/`, `global.css`) so the agent does not create a second one.
- Run the audit greps on a clean branch; the skill is designed to refactor many app files in place.
Rated 2026-09-22 by an automated review of 4 files from the skill's repository.
Source
- Repository
- expo/skills (all skills from this repository)
- Path
- plugins/expo/skills/expo-design-system/SKILL.md
- Branch
- main
- Collection
- expo
- Updated
- 2026-09-22
Related skills
- expo-native-ui — Framework (OSS). Build beautiful, native-feeling Expo screens.
- expo-ui — Framework (OSS). Build native UI with the @expo/ui package: real SwiftUI on iOS and Jetpack Compose on Android.
- antfu-design — antfu-style design conventions, broadened.
- design-review — Designer's eye QA: finds visual inconsistency, spacing issues, hierarchy problems, AI slop patterns, and slow interactions — then fixes them. (gstack)
- emil-design-eng — This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.
- ios-design-review — Visual design audit for iOS apps on real hardware. (gstack)