skills.rest
Seyamalam
SeyamalamCOMMUNITY
Explore all skills by this author →
Website𝕏@SeyamAlam1GitHub

argent-react-native-app-workflow

Guides starting, debugging, building, and testing React Native apps on iOS simulators and Android emulators.

Updated Aug 29, 2026
Search Tags:#debugging#mobile development#react native#build failure#metro#ios simulator#android emulator
One-click install
npx skills add https://github.com/Seyamalam/pstu_final --skill argent-react-native-app-workflow-seyamalam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: argent-react-native-app-workflow
Source: https://github.com/Seyamalam/pstu_final/tree/main/.agents/skills/argent-react-native-app-workflow
Command: npx skills add https://github.com/Seyamalam/pstu_final --skill argent-react-native-app-workflow-seyamalam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? React Native development involves many failure-prone steps: starting Metro on the right port, booting the correct simulator, resolving build errors like xcodebuild exit code 65, and diagnosing runtime crashes. This Skill provides a structured, checklist-driven workflow so an AI agent handles these steps in the correct order instead of guessing commands. ## Core Features & Use Cases - App Startup Workflow: Discovers custom package.json scripts before defaulting to react-native commands, checks node_modules and Pods, starts Metro, and runs the app on an explicitly selected device. - Build Failure Recovery: Provides an ordered escalation path from cleaning the build folder to full node_modules/Pods reinstallation, and instructs the agent to ask the user after 2-3 failed attempts. - Runtime Debugging: Routes JavaScript errors, component tree inspection, screenshots, and native crashes to the correct debugger tools and log files. - Use Case: When a run-ios build fails with exit code 65, the agent follows the ordered recovery steps—clean build folder, reset caches, reinstall pods—rather than retrying blindly. ## Quick Start Start my React Native app on an iOS simulator and help me debug why the build is failing.

Frequently Asked Questions about argent-react-native-app-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a React Native app on an iOS simulator or Android emulator?▼

First check package.json for custom start scripts, then start Metro with npx react-native start and run the app with npx react-native run-ios or run-android targeting an explicit device. For Android, run adb reverse tcp:8081 tcp:8081 so the device can reach Metro.

How do I fix React Native build failures like xcodebuild exit code 65?▼

Start by cleaning the build folder and retrying. If that fails, reset the Metro cache, remove node_modules and the lockfile, reinstall, then delete ios/build, Pods, and Podfile.lock and run pod install --repo-update. After 2-3 failed attempts, ask the user for project-specific guidance.

Why does Metro fail with a port already in use error?▼

Another process is occupying port 8081. Check with lsof -i :8081 and use the debugger-status tool to confirm whether the process is actually Metro. If it is a non-Metro process, ask the user before killing it.

When should I rebuild the app versus just reloading the JS bundle?▼

Reload the bundle with the debugger-reload-metro tool when only JavaScript or React code changed. Rebuild with run-ios or run-android when native code, pods, or project configuration changed, and reinstall dependencies when package.json changed.

How do I debug JavaScript errors and inspect the React component tree?▼

Use the debugger-log-registry tool to locate the log file and grep it for errors, and use debugger-component-tree or debugger-inspect-element to examine the component hierarchy. For native crashes, use npx react-native log-ios or adb logcat.

Related Skills

Explore More Software Engineering Skills→
s-iwasaki-bs-iwasaki-b

debug-run

Build and install debug builds on Android emulators and iOS simulators.

Community
Advanced
FilenCloudDiensteFilenCloudDienste
34

argent-react-native-profiler

Profile React commit timings and CPU hotspots in React Native Hermes apps.

Official
Advanced
softwarebyzesoftwarebyze

argent-metro-debugger

Debug React Native apps via Metro CDP for UI, logs, and JavaScript.

Community
Advanced
budgie-atbudgie-at
5

expo-dev-client

Build and distribute Expo development clients for React Native apps via EAS Build.

Official
Intermediate