How do I install the Run IOS skill?

Run npx skillmds@latest add vortiago/run-ios in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Run IOS skill do?

Build, launch, and drive the notes app natively on the iOS simulator (React Native hosted in .NET MAUI). Use when running or building the iOS app, or driving/screenshotting its UI. It is listed under Web & Frontend on SkillMD.

Is Run IOS safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Run IOS?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Run IOS free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Run IOS?

Vortiago (@vortiago) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Run IOS by vortiago — Agent Skill

Name: Run IOS
Author: Vortiago

File contents

Run on iOS

Native React Native (no WebView) hosted in .NET MAUI, talking to the in-process backend over 127.0.0.1:5001. Prereqs: Xcode + a booted simulator, CocoaPods, and the AXe CLI (brew install cameroncooke/axe/axe) for driving the UI.

Build and run

Run in order from the repo root:

./src/Client.MAUI/Scripts/build-rn-frameworks.sh --simulator-only (runs pod install on first use). Done when src/Client.MAUI/Frameworks/ holds the xcframeworks + a simulator static-lib build.
./src/Client.MAUI/Scripts/generate-rn-linker-flags.sh.
./src/Client.MAUI/Scripts/bundle-js.sh. Done when src/Client.MAUI/Resources/Raw/main.jsbundle exists.
./src/Client.MAUI/Scripts/e2e-ios.sh (add --udid <UDID> for a specific simulator). This builds the app, installs it, launches, and proves the round-trip. Done when it prints iOS end-to-end test PASSED.

Steps 1-3 produce the gitignored artifacts the build consumes; the csproj fails loudly if they are missing.

Drive or screenshot the running UI

RN testID becomes the accessibility identifier (AXUniqueId) for the input and button; plain Text is matched by its visible label.

Inspect: axe describe-ui --udid <UDID>.
Add a note: axe tap --id notes.text.input --udid <UDID>, axe type 'Buy groceries' --udid <UDID>, axe tap --id notes.add.button --udid <UDID>.
Screenshot: xcrun simctl io <UDID> screenshot shot.png (dismiss the debug LogBox banner first if it is showing).

Frequently asked questions

Run IOS