How do I install the IOS Native skill?

Run npx skillmds@latest add builderio/ios-native 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.

Is IOS Native 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 IOS Native?

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 IOS Native free to use?

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

Who published IOS Native?

Builder.io (@builderio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

IOS Native by builderio — Agent Skill

Name: IOS Native
Author: Builder.io

IOS Native

Build and run the iOS app on a simulator or device. Use when the user asks to build, compile, run, launch, or deploy the iOS app, or mentions Xcode, xcodebuild, xcrun, the IPA, simulator, or native-run, even if they don't explicitly say "ios-native".

Builder.io ae32212 2.4 KB Updated Sep 17, 2026 3.4k repo stars

File contents

iOS Native

Build

Use xcodebuild to build the app. First, identify the scheme and workspace/project:

# List available schemes
xcodebuild -list

Build for simulator:

xcodebuild -scheme <SchemeName> -sdk iphonesimulator -configuration Debug -derivedDataPath build build

Running on Simulator (preferred)

Use npx native-run to launch the app on an iOS simulator. First list available targets:

npx native-run ios --list

If there is more than one option, ask the user which one to use.

Then build and run:

xcodebuild -scheme <SchemeName> -sdk iphonesimulator -configuration Debug -derivedDataPath build build && npx native-run ios --app build/Build/Products/Debug-iphonesimulator/<AppName>.app --target <SimulatorUDID>

Running on a Physical Device

Use xcodebuild with -sdk iphoneos and deploy via xcrun:

xcodebuild -scheme <SchemeName> -sdk iphoneos -configuration Debug -derivedDataPath build build
xcrun devicectl device install app --device <DeviceUDID> build/Build/Products/Debug-iphoneos/<AppName>.app

Finding the App Bundle Path

After a successful build, the .app bundle is located at:

build/Build/Products/Debug-iphonesimulator/<AppName>.app   # simulator
build/Build/Products/Debug-iphoneos/<AppName>.app           # device

Gotchas

Always run xcodebuild -list first to get the correct scheme name — do not guess it.
If the project uses a .xcworkspace (e.g. CocoaPods), pass -workspace <Name>.xcworkspace instead of -project.
Use npx native-run ios --list to get the exact simulator UDID for the --target flag.
Code signing is not required for simulator builds; for device builds, a valid provisioning profile and team ID are needed. If signing fails, inform the user.
If xcodebuild is not found, Xcode Command Line Tools may not be installed (xcode-select --install).

Shell command formatting

Always write commands on a single line — no backslash line continuations. The command ACL uses glob patterns without dotAll, so embedded newlines break matching for commands like xcodebuild *. For long output, pipe to tail/head or write to a file.

---name: ios-nativedescription: Build and run the iOS app on a simulator or device. Use when the user asks to build, compile, run, launch, or deploy the iOS app, or mentions Xcode, xcodebuild, xcrun, the IPA, simulator, or native-run, even if they don't explicitly say "ios-native".---# iOS Native## BuildUse `xcodebuild` to build the app. First, identify the scheme and workspace/project:```bash# List available schemesxcodebuild -list```Build for simulator:```bashxcodebuild -scheme <SchemeName> -sdk iphonesimulator -configuration Debug -derivedDataPath build build```## Running on Simulator (preferred)Use `npx native-run` to launch the app on an iOS simulator. First list available targets:```bashnpx native-run ios --list```If there is more than one option, ask the user which one to use.Then build and run:```bashxcodebuild -scheme <SchemeName> -sdk iphonesimulator -configuration Debug -derivedDataPath build build && npx native-run ios --app build/Build/Products/Debug-iphonesimulator/<AppName>.app --target <SimulatorUDID>```## Running on a Physical DeviceUse `xcodebuild` with `-sdk iphoneos` and deploy via `xcrun`:```bashxcodebuild -scheme <SchemeName> -sdk iphoneos -configuration Debug -derivedDataPath build buildxcrun devicectl device install app --device <DeviceUDID> build/Build/Products/Debug-iphoneos/<AppName>.app```## Finding the App Bundle PathAfter a successful build, the `.app` bundle is located at:```build/Build/Products/Debug-iphonesimulator/<AppName>.app # simulatorbuild/Build/Products/Debug-iphoneos/<AppName>.app # device```## Gotchas- Always run `xcodebuild -list` first to get the correct scheme name — do not guess it.- If the project uses a `.xcworkspace` (e.g. CocoaPods), pass `-workspace <Name>.xcworkspace` instead of `-project`.- Use `npx native-run ios --list` to get the exact simulator UDID for the `--target` flag.- Code signing is not required for simulator builds; for device builds, a valid provisioning profile and team ID are needed. If signing fails, inform the user.- If `xcodebuild` is not found, Xcode Command Line Tools may not be installed (`xcode-select --install`).## Shell command formattingAlways write commands on a single line — no backslash line continuations. The command ACL uses glob patterns without dotAll, so embedded newlines break matching for commands like `xcodebuild *`. For long output, pipe to `tail`/`head` or write to a file.

Frequently asked questions