// Intelligent environment reset for React Native projects — diagnoses stale caches before cleaning instead of blindly nuking everything. Triggers on "clean build", "reset caches", "fresh start", "metro won't start", "build is broken", "nuclear clean", "clear derived data".
| name | clean |
| description | Intelligent environment reset for React Native projects — diagnoses stale caches before cleaning instead of blindly nuking everything. Triggers on "clean build", "reset caches", "fresh start", "metro won't start", "build is broken", "nuclear clean", "clear derived data". |
| allowed-tools | Bash, Read, Grep |
On load: Read ../../.claude-plugin/plugin.json from this skill's base directory. Display clean v{version} before proceeding.
Diagnose-first environment reset for React Native projects. Checks what is actually stale before cleaning, then executes only the necessary steps.
Run the diagnosis script to check environment state:
bash ${CLAUDE_SKILL_DIR}/scripts/diagnose.sh
This outputs a JSON report covering all cache/state checks. Review the report and summarize findings for the user.
Based on the diagnosis, recommend targeted clean steps. Present only what is needed — do not suggest cleaning things that are healthy.
Run the clean script with flags for the necessary targets:
bash ${CLAUDE_SKILL_DIR}/scripts/clean.sh [flags]
WARNING: Always confirm with the user before running destructive clean operations.
Do not run --all or --node-modules without explicit user approval.
After cleaning, optionally verify the environment works:
npx react-native startios-sim skill if available| Flag | What it removes | When to use |
|---|---|---|
--metro | /tmp/metro-*, /tmp/haste-*, React Native temp caches | Metro bundling errors, stale module resolution |
--watchman | Watchman watches and internal state | File change detection broken, phantom "file not found" errors |
--node-modules | node_modules/ + reinstall | Dependency corruption, version mismatch after branch switch |
--pods | ios/Pods/, ios/Podfile.lock re-install | iOS build errors after native dependency changes |
--derived-data | ~/Library/Developer/Xcode/DerivedData | Xcode build failures, stale Swift/ObjC caches |
--gradle | android/.gradle/, android/app/build/ | Android build failures, stale Gradle caches |
--all | All of the above | True nuclear option — last resort |
| Check | How | Indicates |
|---|---|---|
| Port 8081 | lsof -i :8081 | Metro already running / port conflict |
| Watchman | watchman watch-list | Stale or broken file watches |
| node_modules integrity | Compare .package-lock.json mtime vs package-lock.json | Modules out of sync with lockfile |
| Pods staleness | Compare ios/Pods mtime vs ios/Podfile mtime | Pods need reinstall |
| DerivedData size | du -sh ~/Library/Developer/Xcode/DerivedData | Large DerivedData may cause issues |
| Android build state | Check android/.gradle, android/app/build existence | Stale Android build artifacts |
| Metro cache | Check /tmp/metro-* existence | Stale Metro bundler cache |
--pods will run pod install after removing Pods--node-modules will run npm install (or yarn) after removing node_modulesdocs skill for API/config guidanceReact Native coding guidance — consults official docs before writing code and suggests verification after. Use when writing components, implementing features, building screens, fixing queries, or adding views. Triggers on "write a component", "implement this feature", "build this screen", "add a view", "React Native code", "fix this query", "use best practices".
Audit accessibility of the running React Native app. Captures the accessibility tree from the iOS Simulator and checks it against React Native best practices. Triggers on "audit accessibility", "check a11y", "VoiceOver check", "accessibility issues", "screen reader test", "are labels correct".
Debug React Native apps — view console logs, JS errors, Metro status, evaluate expressions, inspect React component tree, monitor network requests. Use for runtime debugging of JavaScript and React layers. Triggers on "console logs", "JS errors", "Metro status", "evaluate expression", "React component tree", "network requests", "debug".
Test deep links and URL schemes in the iOS Simulator. Reads navigation/linking config, constructs test URLs, fires them via xcrun simctl, and verifies the resulting screen. Triggers on "test deep link", "test this URL scheme", "verify navigation to", "does deeplink work", "open URL in simulator", "test universal link".
Diagnose React Native errors by cross-referencing error text against docs, error pattern database, and project config. Use for build failures, red screens, runtime crashes, and dependency issues. Triggers on "diagnose this error", "why is my build failing", "what does this red screen mean", "Unable to resolve module", "null is not an object", "Invariant Violation", "pod install failed", "gradlew failed", "EACCES", "metro error".
Search React Native official documentation. Use when answering questions about React Native APIs, components, hooks, layout, navigation, native modules, or platform-specific behavior. Triggers on "React Native", "RN docs", "how does View work", "FlatList props", "native module", "new architecture".