argent-react-native-app-workflow

Orchestrate React Native development and debugging workflows across iOS simulators and Android emulators.

1.9k|65|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/software-mansion/argent --skill argent-react-native-app-workflow-software-mansion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argent-react-native-app-workflow
Source: https://github.com/software-mansion/argent/tree/main/packages/skills/skills/argent-react-native-app-workflow
Command: npx skills add https://github.com/software-mansion/argent --skill argent-react-native-app-workflow-software-mansion

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you develop, run, and debug React Native apps on iOS simulators and Android emulators by turning common setup and failure scenarios into a repeatable, step-by-step workflow.

Core Features & Use Cases

  • Deterministic app start workflow: Finds and follows the project’s custom build/run and Metro start scripts instead of assuming default React Native commands.
  • Metro reliability & debugging: Checks for existing Metro on the correct port, verifies connectivity, and reloads or restarts cleanly to ensure the app uses the latest bundle.
  • Build/install troubleshooting: Guides clean builds, cache resets, and CocoaPods remediation for common iOS build failures, with clear stop-and-ask guardrails after repeated failures.
  • Runtime problem diagnosis support: Points you to the right tools for JS logs, component inspection, screenshot-based fallback, JS evaluation, and native crash visibility.
  • Testing support hooks: Helps locate and run typical Jest/E2E test setups or route UI-flow testing to the appropriate skill.

Quick Start

Ask the agent to start your React Native app by first inspecting the project’s configured Metro/build/run workflow, then boot the target device and run the app with Metro already running.

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 using custom build scripts instead of default commands?

This workflow inspects your project's configuration to find custom Metro and build/run scripts, then boots the iOS simulator or Android emulator and runs the app with Metro already active for a reliable React Native start.

Why does my React Native app fail to connect to Metro bundler on the correct port?

Metro connection issues often stem from server mismatches or stale bundles; this workflow checks for existing Metro on the correct port, verifies connectivity, and performs clean reloads or restarts to ensure the app uses the latest bundle.

How do I fix React Native iOS build failures related to CocoaPods?

To troubleshoot iOS build failures, this workflow guides you through clean builds, cache resets, and CocoaPods remediation steps, applying safe reinstall protocols and clear stop-and-ask guardrails after repeated failures.

What is the best way to debug runtime errors in a React Native app?

Debugging React Native runtime errors involves pointing you to the right tools for JS logs, component inspection, screenshot-based fallbacks, JS evaluation, and native crash visibility to diagnose issues effectively.

Can I use this workflow to run Jest and E2E tests for my React Native project?

Yes, this workflow includes testing support hooks that help locate and run typical Jest and E2E test setups, or route UI-flow testing to the appropriate skill if needed.

What should I do when React Native clean builds and cache resets still fail?

When clean builds and cache resets fail repeatedly, this workflow enforces clear stop-and-ask guardrails to prevent further system issues and guide you toward targeted native crash visibility and debugger tools.