plugins/expo/skills/expo-skill-feedback/SKILL.md
Submit feedback on an Expo skill—or Expo itself—and control bundled anonymous usage telemetry (off by default / opt-in). Submit feedback with: npx --yes submit-expo-feedback@latest "ACTIONABLE_FEEDBACK". Optionally add either or both: --category "CATEGORY" and --subject "SUBJECT". Replace the uppercase placeholders before running. Use when a skill was useful, confusing, broken, missing context, or worth improving; when Expo, Expo CLI, EAS CLI, docs, or MCP worked well or fell short; or when the user explicitly asks to enable or disable telemetry, check its status, or understand what it collects.
npx skillsauth add expo/skills expo-skill-feedbackInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help Expo improve by sharing specific feedback about what worked well or what fell short. Feedback submission is independent of usage telemetry and does not require enabling it.
npx --yes submit-expo-feedback@latest "<ACTIONABLE_FEEDBACK>"
Add either optional flag independently when it provides useful context:
npx --yes submit-expo-feedback@latest --category "<CATEGORY>" --subject "<SUBJECT>" "<ACTIONABLE_FEEDBACK>"
--category defaults to unknown, and --subject may be omitted when there is no specific target.
When including them, choose the values that most precisely identify what the feedback is about:
| Category | Subject |
| --- | --- |
| skills | Exact skill name from its frontmatter, such as expo-router |
| docs | Full Expo documentation URL |
| mcp | Exact MCP tool name used |
| expo-cli | Full Expo CLI command, such as npx expo install |
| eas-cli | Full EAS CLI command, such as eas build |
| unknown | Concise Expo product, package, feature, or other topic |
In the final argument, say what helped and why, or provide the relevant context, expected behavior, and what happened instead. Do not include secrets, source code, personal data, long prompts, or stack traces.
Automatic skill usage telemetry is separate from feedback and off by default. Never enable it
without an explicit user request. Use the following script with --on, --off, or --status:
node "${CLAUDE_PLUGIN_ROOT}/skills/expo-skill-feedback/scripts/telemetry.cjs" --status
Environment equivalents are EXPO_SKILLS_TELEMETRY=1 to enable and
EXPO_SKILLS_TELEMETRY=0 or DO_NOT_TRACK=1 to disable. CI never sends telemetry.
If you encounter errors, misleading or outdated information in this skill, report it so Expo can improve:
npx --yes submit-expo-feedback@latest --category skills --subject "expo-skill-feedback" "<actionable feedback>"
Only submit when you have something specific and actionable to report. Include as much relevant context as possible.
development
Framework (OSS). Migrate an existing Apple/Swift Expo native module from the Expo Modules API 1.0 definition DSL to the 2.0 macro API (sometimes called v2) while preserving its JavaScript and TypeScript contract. Use when converting or incrementally adopting @ExpoModule, @JS, @Event, @SharedObject, or @Record in an existing module. Do not use for creating a new module, general Expo SDK upgrades, or Android/Kotlin migrations.
development
Framework (OSS). Folder structure for a new Expo app. Use when scaffolding or laying out a new Expo project with Expo Router, or deciding where a file should live in one. For new projects only — never restructure an existing app to match.
development
Framework (OSS). Migrate an existing web React app to a native iOS/Android app with Expo. Use when the user wants to turn a website into a mobile app, port a Next.js/Vite/CRA React codebase to React Native, reuse web code on native incrementally, or asks how web idioms (the DOM, CSS, React Router, localStorage, window) map to native. This is the end-to-end migration guide; use the `expo-dom` skill for the DOM-component mechanism itself.
development
Framework (OSS). Guidelines for upgrading Expo SDK versions and fixing dependency issues