Agent skill

Expo Design System

by pproenca in pproenca/dot-skills

Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList.

MITAuto-check passedMobile

Install Expo Design System

skills CLI
$ npx skills add pproenca/dot-skills --skill expo-design-system -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pproenca/dot-skills expo-design-system --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/expo-design-system .claude/skills/expo-design-system && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
expo-design-system
GitHub stars
214
Token cost
~3.5k tokens
SKILL.md length
1,159 words
Files
68 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList.

  • Works in 11 steps: Token Architecture (CRITICAL) → Theming & Adaptivity (CRITICAL) → Component API Contracts (CRITICAL) → …
  • Refactoring shared UI — design tokens
  • SKILL.md covers Mandated Architecture Alignment, Scope & Relationship to…, Clinic Architecture Contract… and When to Apply, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Expo Design System is an agent skill from pproenca/dot-skills. Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList. Use whenever building, reviewing, or refactoring shared UI — design tokens, theming, variant-driven component APIs, typography, spacing, cross-platform web/iOS parity, native-feel performance, or complex surfaces like calendars and drawing canvases (examples use a clinic app). Covers token architecture, theming, component API contracts (variants over…

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 70 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).

It sits in Mobile, covering Cross-platform mobile apps and Design systems. It works with Expo, React Native and iOS. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Refactoring shared UI — design tokens
  • Variant-driven component APIs
  • Cross-platform web/iOS parity
  • Native-feel performance

Example prompts

  • “design system”
  • “/expo-design-system”

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Token Architecture (CRITICAL)
  2. Theming & Adaptivity (CRITICAL)
  3. Component API Contracts (CRITICAL)
  4. Cross-Platform Parity (CRITICAL)
  5. Reuse & System Fit (HIGH)
  6. Styling Engine (Unistyles) (HIGH)
  7. Typography & Iconography (HIGH)
  8. Spacing, Layout & Safe Areas (HIGH)
  9. Native-Feel & Performance (HIGH)
  10. Complex Domain Components (MEDIUM-HIGH)
  11. Governance & Consistency (MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Expo Design System loads about 3.5k tokens when it runs, and up to ~30k if it reads all its reference files. Until then it costs about 254 tokens; SKILL.md has 1,159 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~254
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~30k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 1,159 words, ~3,547 tokens.

Download SKILL.mdSave it as .claude/skills/expo-design-system/SKILL.md (or your agent's skills folder). This skill also uses 67 other files; get the full folder from GitHub.
name
expo-design-system
description
Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList. Use whenever building, reviewing, or refactoring shared UI — design tokens, theming, variant-driven component APIs, typography, spacing, cross-platform web/iOS parity, native-feel performance, or complex surfaces like calendars and drawing canvases (examples use a clinic app). Covers token architecture, theming, component API contracts (variants over style props), web/iOS parity (Unistyles `_web` hover/focus/cursor, Platform splits, one shared theme), the Unistyles styling engine, and governance. Trigger even when the user does not say "design system" but is creating or changing reusable React Native components, tokens, theme code, or making a component behave natively on both web and iOS. Teaches how to BUILD the design system; pair with expo-react-native-coder for features and expo-ios-hig for iOS native-feel decisions.

Airbnb DLS Expo React Native Design System Best Practices

Opinionated, strict design system engineering for Expo / React Native apps on the New Architecture, targeting both web and native iOS. Contains 63 rules across 11 categories, prioritized by impact. Derived from Airbnb's Design Language System (DLS), the Unistyles v3 documentation, and the React Native ecosystem (Reanimated, Gesture Handler, Skia, FlashList, Expo SDK). The styling engine is Unistyles v3; the component API follows the Airbnb DLS pattern of variant props over style escape hatches.

Mandated Architecture Alignment

This skill is the infrastructure layer — it teaches how to BUILD the design system itself, the React Native counterpart to ios-design-system. All code examples follow the same non-negotiable constraints:

  • Feature modules import @clinic/design-system + domain; never another feature's internals
  • The design system owns the Unistyles theme (tokens, breakpoints) and exports a curated public surface
  • Reuse before you build: read the index, extend a variant, promote on the second use — never a parallel local component
  • Components expose variant and slot props (Airbnb DLS); no raw style escape hatch
  • Animation and gestures run on the UI thread (Reanimated worklets + Gesture Handler)
  • Lists use FlashList; the body-chart drawing surface uses React Native Skia
  • One source feels native on both web and iOS: Unistyles _web pseudo-states and Platform splits, never a forked web stylesheet
  • Targets the New Architecture (Fabric/JSI), Expo SDK 53+ / React Native 0.81+

Scope & Relationship to Sibling Skills

Sibling SkillIts FocusThis Skill's Focus
ios-design-systemThe SwiftUI design system for the same clinic appThe Expo / React Native counterpart
expo-react-native-coderFeature development (screens, navigation, data fetching)Design system infrastructure (tokens, components, theming)
expo-react-native-performanceApp-wide performance optimizationNative-feel performance inside the design system
reactGeneral React patternsExpo / React Native design system specifics
expo-ios-higiOS native-feel decisions (navigation, system controls, Liquid Glass)Cross-platform token/component architecture + web/iOS parity

Clinic Architecture Contract (Expo / React Native)

All guidance in this skill assumes the clinic modular architecture:

  • Feature modules depend on @clinic/design-system + domain only; the app target wires navigation (Expo Router) and dependency injection
  • The design system is a local package with a single public entry; raw token layers stay private
  • Token source of truth is the Unistyles theme; features never define local tokens
  • Server state uses TanStack Query: reads default to stale-while-revalidate, writes are optimistic and queued for offline sync
  • The New Architecture is required for Unistyles v3, Reanimated worklets, Skia, and FlashList v2

When to Apply

Reference these guidelines when:

  • Setting up a design system for a new Expo / React Native app
  • Building token architecture (colors, typography, spacing, radius, elevation) in the Unistyles theme
  • Designing component APIs — variants, slots, controlled/uncontrolled state, refs, accessibility
  • Authoring component styles with Unistyles StyleSheet, variants, and dynamic functions
  • Building the calendar, treatment-note editor, or Skia body-chart drawing surfaces
  • Migrating ad-hoc styles to a governed token system
  • Reviewing PRs for raw colors, inline styles, leaked style props, or feature-local tokens
  • Tuning native feel — list virtualization, UI-thread animation, gestures, haptics, safe areas
  • Making a component render and feel native on both web and iOS — hover/focus/cursor, Platform splits, and safe-area/haptics divergences
  • Deciding whether to build new or reuse — checking the design system index, extending vs forking, or using a native/@expo/ui control instead of reimplementing one

Rule Categories by Priority

PriorityCategoryImpactPrefixRules
1Token ArchitectureCRITICALtoken-6
2Theming & AdaptivityCRITICALtheme-5
3Component API ContractsCRITICALapi-8
4Cross-Platform ParityCRITICALplatform-5
5Reuse & System FitHIGHreuse-4
6Styling Engine (Unistyles)HIGHstyle-6
7Typography & IconographyHIGHtype-5
8Spacing, Layout & Safe AreasHIGHspace-5
9Native-Feel & PerformanceHIGHperf-7
10Complex Domain ComponentsMEDIUM-HIGHdomain-6
11Governance & ConsistencyMEDIUMgovern-6

Quick Reference

1. Token Architecture (CRITICAL)
2. Theming & Adaptivity (CRITICAL)
Show full SKILL.md (454 more words)Show less
3. Component API Contracts (CRITICAL)
4. Cross-Platform Parity (CRITICAL)
5. Reuse & System Fit (HIGH)
6. Styling Engine (Unistyles) (HIGH)
7. Typography & Iconography (HIGH)
8. Spacing, Layout & Safe Areas (HIGH)
9. Native-Feel & Performance (HIGH)
10. Complex Domain Components (MEDIUM-HIGH)
11. Governance & Consistency (MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and ordering
assets/templates/_template.mdTemplate for new rules
metadata.jsonVersion and reference information

© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 67 other files (references, assets) in skills/.experimental/expo-design-system of pproenca/dot-skills.

  • SKILL.md
  • AGENTS.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/api-accessibility-in-contract.md
  • references/api-aschild-polymorphism.md
  • references/api-compound-variants.md
  • references/api-controlled-uncontrolled.md
  • references/api-forward-ref.md
  • references/api-no-style-escape-hatch.md
  • references/api-slots-for-composition.md
  • references/api-variants-over-style-prop.md
  • references/domain-bodychart-gesture-paths.md
  • references/domain-bodychart-skia-canvas.md
  • references/domain-calendar-virtualization.md
  • references/domain-compose-from-primitives.md
  • references/domain-note-editor-autosave.md
  • … and 50 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

Expo Design System next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Expo Design System compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Expo Design System this skillpproenca/dot-skills214—~3.5kAutomated safety check: PassMIT
Cometchat React Native Corecometchat/cometchat-skills129—~4.6kAutomated safety check: NotesMIT
Cometchat React Native V5 SDKcometchat/cometchat-skills129—~5.2kAutomated safety check: PassMIT
ThemingCode-with-Beto/skills141—~2.5kAutomated safety check: PassNone
Mobile AccessibilityCommunity-Access/accessibility-agents421—~1.1kAutomated safety check: PassMIT
Kb Mobile AccessibilityCommunity-Access/accessibility-agents421—~3.8kAutomated safety check: PassMIT

Similar skills

  • Cometchat React Native Core

    cometchat/cometchat-skills

    Foundational rules for the CometChat React Native UI Kit v5 — install and the exact native peer deps, the provider chain, init → login → render ordering, the component map, and the production-ready…

    129 GitHub stars~4.6k tokensUpdated 2 days ago
    MobileAuto-check: notes
  • Cometchat React Native V5 SDK

    cometchat/cometchat-skills

    Add voice & video calling to a React Native app FROM SCRATCH with the headless CometChat Calls SDK v5 (@cometchat/calls-sdk-react-native@5) — no prebuilt UI Kit.

    129 GitHub stars~5.2k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Theming

    Code-with-Beto/skills

    Scaffold a unified, cross-platform color theme system into an Expo Router app.

    141 GitHub stars~2.5k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Mobile Accessibility

    Community-Access/accessibility-agents

    React Native, Expo, iOS and Android: labels, roles and touch targets.

    421 GitHub stars~1.1k tokensUpdated 14 days ago
    MobileAuto-check passed
  • Kb Mobile Accessibility

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    421 GitHub stars~3.8k tokensUpdated 14 days ago
    MobileAuto-check passed
  • App Store Review

    safaiyeh/app-store-review-skill

    Evaluates code against Apple's App Store Review Guidelines. An agent skill from safaiyeh/app-store-review-skill.

    361 GitHub starsUsed in 1 repo~3.4k tokens
    MobileAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Expo Design System

What does Expo Design System do?

Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList. Expo Design System is an agent skill from pproenca/dot-skills. Airbnb-DLS-aligned design system engineering for Expo / React Native apps targeting both web and native iOS, built on Unistyles v3, Reanimated, Skia, and FlashList.

When should I use Expo Design System?

Expo Design System fits situations like: refactoring shared UI — design tokens; variant-driven component APIs; cross-platform web/iOS parity; native-feel performance.

How do I install Expo Design System in Claude Code?

Run `npx skills add pproenca/dot-skills --skill expo-design-system -a claude-code`. Or copy the skill folder (skills/.experimental/expo-design-system in pproenca/dot-skills) into .claude/skills/expo-design-system in your project. Claude Code loads it when a task matches its description.

How do I install Expo Design System in Codex?

Run `npx skills add pproenca/dot-skills --skill expo-design-system -a codex`. Or copy the skill folder (skills/.experimental/expo-design-system in pproenca/dot-skills) into .agents/skills/expo-design-system in your project. Codex loads it when a task matches its description.

Can I use Expo Design System in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill expo-design-system -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/expo-design-system, .gemini/skills/expo-design-system, .github/skills/expo-design-system and .opencode/skills/expo-design-system in your project.

What does Expo Design System need to run?

SKILL.md names no scripts, command-line tools or credentials: Expo Design System is instructions for the agent only.

Does Expo Design System access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Expo Design System safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Expo Design System use?

Expo Design System is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Expo Design System use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 27k tokens, read only when the agent opens those files.

What are the alternatives to Expo Design System?

Skills that share tags, products or a category with Expo Design System: Cometchat React Native Core (cometchat/cometchat-skills, 129 stars), Cometchat React Native V5 SDK (cometchat/cometchat-skills, 129 stars), Theming (Code-with-Beto/skills, 141 stars) and Mobile Accessibility (Community-Access/accessibility-agents, 421 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Expo Design System?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.