Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

ios-simulator-skill Skill

Repository ↗

by conorluddy★ 1,3301 skills

Install

What it does

XCode CLI & Simulator Skill. Progressive disclosure of output. Minimises context & token use. Lets AI agents build, run sim & drive iOS apps without drowning in Xcode output. Now with Duo support.

  • Connects Instruction files the AI reads, with steps that call an outside service
  • Account or key Some steps need a key for GitHub, GH_TOKEN (per the README)
  • Category Coding
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skill/conorluddy-ios-simulator-skill.svg)](https://mcp.popnx.com/en/skills/conorluddy-ios-simulator-skill)

Use together with

MCP servers that connect the AI to services for the same work

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

by morlutoWidely used↓ 388.7K/wk★ 466.2KUpdated 6 days ago

MCP · Connects a serviceRuns on your computer

Fallow

Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.

by fallow-rsWidely used↓ 2.4M/wk★ 5.4KUpdated yesterday

MCP · Connects a serviceRuns on your computer

Desktop Commander

MCP server for terminal commands, file operations, and process management

by wonderwhy-erWidely used↓ 740.3K/wk★ 10.3KUpdated 6 days ago

MCP · Connects a serviceRuns on your computer

Similar Skills

Same kind of work, ordered like the Skills list

Compared with similar ones
This one
ios-simulator-skill
reaandrej-karpathy-skillsgraphifyMoneyPrinterTurbo
Makerconorluddymorlutomultica-aiGraphify-Labsharry0703
Skills11111
GitHub stars1,330465,460233,910149,364144,149
Last code changeNov 8, 2026Nov 17, 2026Apr 20, 2026Nov 17, 2026Nov 17, 2026
LicenseMITMIT–Apache-2.0MIT

1 skills (instruction sets) by conorluddy that an AI reads and follows · not an MCP server

How a Skill differs from MCP

MCP = the hands

Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.

Skill = the manual

A text file that teaches the AI how to do a task. It connects to nothing.

Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.

Works with

Claude CodeCodexCursor

From the maker’s README and the folders in the repo

Install

Is it safe?

  • Who made it

    GitHub account conorluddy (person), 15 years old

  • Use and upkeep

    ★ 1,330 stars · code last changed Nov 8, 2026

  • Any scripts?

    47 scripts that can run on a computer: scripts/accessibility_audit.py, scripts/app_launcher.py, scripts/app_state_capture.py, scripts/build_and_test.py and 43 more

  • Uses the internet?

    Could not check every script (some are too large); read them first

  • Changes machine-wide settings?

    No hooks or writes to machine settings found

Checked automatically from the repo files at commit 86fb9ba (read only, nothing was run). Not a safety guarantee: read it and decide for yourself

First: which AI do you use?

Pick your app and this page shows only how to install it there

Option 1Upload to claude.ai (web and app)

Uploading to claude.ai would fail: the description is over 200 characters (423). Use "Let the AI install it" instead

Option 1Let Claude Code install it

Copy this sentence and paste it into a Claude Code chat

Where to install
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) for all my projects, at ~/.claude/skills/ios-simulator-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) into the project this chat is open in (at .claude/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Restart Claude Code, then type /ios-simulator-skill or ask for a matching task and Claude picks it up

Checked against official docs Nov 12, 2026 · Source: code.claude.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

The maker’s recommended way

/plugin marketplace add conorluddy/ios-simulator-skill
/plugin install ios-simulator-skill@conorluddy

Copied from the maker’s README; it downloads and runs the maker’s code

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.claude/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/conorluddy/ios-simulator-skill.git /tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba/ios-simulator-skill/skills/ios-simulator-skill' ~/.claude/skills/ios-simulator-skill
  3. Restart Claude Code, then type /ios-simulator-skill or ask for a matching task and Claude picks it up

Skills you install yourself work in the ChatGPT desktop app, Codex CLI and the Codex IDE extension · ChatGPT on the web and mobile cannot use skills you install yourself, only skills that come with a plugin from the directory

ChatGPT desktop app

The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills

Option 1Let ChatGPT install it

Open Codex in the ChatGPT desktop app and paste this sentence into the chat

Where to install
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) for all my projects, at ~/.agents/skills/ios-simulator-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) into the project this chat is open in (at .agents/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Option 2Put the folder there yourself

Put the ios-simulator-skill folder at ~/.agents/skills/ios-simulator-skill

~ is your home folder ($HOME)

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/conorluddy/ios-simulator-skill.git /tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba/ios-simulator-skill/skills/ios-simulator-skill' ~/.agents/skills/ios-simulator-skill

After installing

  • ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
  • To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
  • Codex picks up newly installed skills by itself; if one does not show up, restart Codex

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

ChatGPT on the web and mobile

Skills you install yourself do not work here; only skills that come with a plugin from the directory

To use this skill with ChatGPT, use the ChatGPT desktop app as above

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

Option 1Let Codex install it

Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension

Where to install
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) for all my projects, at ~/.agents/skills/ios-simulator-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) into the project this chat is open in (at .agents/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name

Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.agents/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/conorluddy/ios-simulator-skill.git /tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba/ios-simulator-skill/skills/ios-simulator-skill' ~/.agents/skills/ios-simulator-skill
  3. Restart Codex, then ask for a matching task; Codex lists the skill

Option 1Let Cursor install it

Copy this sentence and paste it into a Cursor chat

Where to install
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) for all my projects, at ~/.cursor/skills/ios-simulator-skill. First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) into the project this chat is open in (at .cursor/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

In Cursor’s Agent chat, type / and pick ios-simulator-skill

Checked against official docs Nov 12, 2026 · Source: cursor.com

For Terminal users

A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead

  2. Copy the skill folder to ~/.cursor/skills

    This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md

    git clone --depth 1 https://github.com/conorluddy/ios-simulator-skill.git /tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-conorluddy-ios-simulator-skill-86fb9ba/ios-simulator-skill/skills/ios-simulator-skill' ~/.cursor/skills/ios-simulator-skill
  3. In Cursor’s Agent chat, type / and pick ios-simulator-skill

Option 1Let the AI install it

For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat

Where to install
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) for all my projects, at ~/.claude/skills/ios-simulator-skill (in Codex use ~/.agents/skills/ios-simulator-skill, in Cursor ~/.cursor/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the full path you will install to and wait for me to agree.
Please install the skill ios-simulator-skill from https://github.com/conorluddy/ios-simulator-skill folder ios-simulator-skill/skills/ios-simulator-skill (commit 86fb9ba) into the project this chat is open in (at .claude/skills/ios-simulator-skill; in Codex use .agents/skills/ios-simulator-skill, in Cursor .cursor/skills/ios-simulator-skill). First show me every file and tell me whether it has scripts or changes machine settings, then tell me the project name and the full path you will install to and wait for me to agree.

For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing

The AI tells you what it will do first and asks your permission at every step

Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com

For Terminal users

Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.

View on GitHub ↗

Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026

✓ Commands checked Nov 18, 2026

View the original SKILL.md

The text below comes from the maker’s repo, not from PopNx MCP

Showing the first 8,000 characters · Open the full file on GitHub

---
name: ios-simulator-skill
version: 1.8.0
description: Build, test, and drive iOS apps in the Simulator with 31 token-efficient scripts. Use when asked to build or test an Xcode project, launch an app on a simulator, tap/type/swipe through its UI by accessibility label, take screenshots or visual diffs, audit accessibility, read logs or diagnose hangs, or manage simulators (boot, erase, permissions, location, push, appearance). macOS only; needs Xcode, Python 3.12+ and idb.
---

# iOS Simulator Skill

Build, test, and automate iOS applications using accessibility-driven navigation and structured data instead of pixel coordinates.

## Quick Start

```bash
# 1. Check environment
bash scripts/sim_health_check.sh

# 2. Launch app
python3 scripts/app_launcher.py --launch com.example.app

# 3. Map screen to see elements
python3 scripts/screen_mapper.py

# 4. Tap button
python3 scripts/navigator.py --find-text "Login" --tap

# 5. Enter text
python3 scripts/navigator.py --find-type TextField --enter-text "user@example.com"
```

**Paths:** `scripts/` is relative to the directory containing this SKILL.md, not the user's project.
Examples write `scripts/...` for brevity; run them by absolute path from the user's project
(e.g. `python3 <skill-dir>/scripts/navigator.py ...`) so relative Xcode project paths still resolve.

All scripts support `--help` for detailed options; most support `--json` for machine-readable output.

## Navigation Strategy

**Always prefer the accessibility tree over screenshots for navigation.** The accessibility tree gives you element types, labels, frames, and tap targets — structured data that's cheaper and more reliable than image analysis.

Use this priority:
1. `screen_mapper.py` → structured element list (5-7 lines, ~10 tokens)
2. `navigator.py --find-text/--find-type/--find-id` → semantic interaction
3. Screenshots → only for visual verification, bug reports, or visual diff

Screenshots cost 1,600–6,300 tokens depending on size. The accessibility tree costs 10–50 tokens in default mode.

## 31 Production Scripts

### Build & Development (2 scripts)

1. **build_and_test.py** - Build Xcode projects, run tests, parse results with progressive disclosure
   - Build with live result streaming
   - Parse errors and warnings from xcresult bundles
   - Retrieve detailed build logs on demand
   - `--run` builds, installs and launches the app in one call: `Launched: <bundle> on <device> (pid N)`
   - Tests that never started (parallel clone failed to boot) report `Tests: NOT RUN`, not FAIL; retry with `--no-parallel`
   - Options: `--project`, `--scheme`, `--clean`, `--test`, `--run`, `--no-parallel`, `--verbose`, `--json`

2. **log_monitor.py** - Real-time log monitoring with intelligent filtering
   - Stream logs or capture by duration
   - Filter by severity (error/warning/info/debug)
   - Deduplicate repeated messages
   - Options: `--app`, `--severity`, `--follow`, `--duration`, `--output`, `--json`

### Device State (4 scripts)

3. **appearance.py** - Control simulator appearance: dark mode, Dynamic Type size, contrast, and locale/region
   - Toggle light/dark theme via `xcrun simctl ui`
   - Set Dynamic Type size with friendly aliases (XS through AX5)
   - `--contrast high|normal` toggles Increase Contrast and reads it back to confirm; `--reset` also restores normal contrast
   - Write locale and region defaults; optional app restart via `--bundle-id`
   - RTL flagged automatically for ar/he/fa/ur/yi locales
   - Options: `--theme`, `--text-size`, `--contrast`, `--locale`, `--region`, `--reset`, `--bundle-id`, `--udid`, `--json`, `--verbose`

4. **location.py** - Simulate GPS coordinates, named city presets, and GPX scenario playback
   - Fix a coordinate with `--lat`/`--lng` or pick a city with `--city`
   - Play a built-in scenario (City Run, Freeway Drive, etc.) via `--gpx <scenario>`
   - Animate multi-waypoint paths with configurable speed via `--waypoints` and `--speed`
   - Clear simulated location with `--clear`; list available scenarios with `--list-scenarios`
   - Options: `--lat`, `--lng`, `--city`, `--gpx`, `--waypoints`, `--speed`, `--clear`, `--list-scenarios`, `--udid`, `--json`, `--verbose`

5. **media.py** - Seed or empty the photo library for photo-picker tests
   - `--add a.jpg b.png` via `xcrun simctl addmedia`
   - `--clear --yes` empties the library via `idb photos clear` (idb 1.7+); `--clear --yes --add` leaves exactly the added files
   - Without `--yes`, `--clear` refuses if the library has photos (they can't be recovered): ask the user first
   - Fails fast on a missing file
   - Options: `--add`, `--clear`, `--yes`, `--udid`, `--json`

6. **duo.py** - Experimental iPhone Duo hinge and interface orientation controls
   - Requires an explicit booted Duo `--udid`; no automatic device selection
   - Read observed angle, active cover/inner display ID and rotation (default or `--state`)
   - `--pose closed|partial|open` (0°/90°/180°), `--angle 0..180`, or `--orientation portrait|landscape|portrait-upside-down|landscape-flipped`
   - Changes verify observed readback; hinge endpoints also verify cover/inner display activation
   - Bundled Objective-C helper compiles and signs with the selected Xcode on first use; no extra CLI
   - Private APIs are experimental; inner-display coordinate touch routing is unverified
   - Options: `--udid`, `--state`, `--pose`, `--angle`, `--orientation`, `--json`, `--verbose`

### Navigation & Interaction (5 scripts)

7. **screen_mapper.py** - Analyze current screen and list interactive elements
   - Element type breakdown
   - Interactive button list
   - Text field status
   - If labelled elements cover under 10% of the screen, adds a `Coverage:` line suggesting `--deep`
   - `--deep` reads through idb's axbridge backend (idb 1.7+): also sees Safari/WKWebView content
     and in-app alerts the default read misses, plus many unlabelled container views. It turns on
     the device's accessibility automation mode (not restored afterwards). Web-content frames are
     relative to the web view, so use `--deep` to find elements, not to take tap coordinates
   - Options: `--verbose`, `--hints`, `--deep`, `--json`

8. **navigator.py** - Find and interact with elements semantically
   - Find by text (fuzzy, or exact with `--find-exact`); interactive leaf elements rank above containers sharing the label
   - Find by element type
   - Find by accessibility ID
   - Enter text or tap elements
   - `--tap` on a Button/Link/Switch/CheckBox/Tab with a unique accessibility ID or label uses an accessibility press
     (idb 1.7+), so overlays like a floating search bar can't intercept it; output says
     `(accessibility press)`. Otherwise it taps the frame center
   - `--set-value TEXT` replaces a field's value without the keyboard (any characters, idb 1.7+).
     Focus doesn't move, so use `--enter-text` when a Return key must submit afterwards
     The value is read back before success is claimed (not for secure fields); a mismatch exits 1
   - `--tap --expect VALUE` taps only if the element's value is VALUE (toggles: `1` on, `0` off) and
     exits 1 without tapping otherwise, so "turn X off" is safe to repeat
   - iOS 27 reports toggles as `CheckBox`. Only a press flips them (no HID touch does, even on the
     switch itself); if neither ID nor label is unique, the output warns to check the value
   - A frozen app stalls every read and tap until its main thread responds
   - Failures include idb's stderr (e.g. a dead companion)
   - Options: `--find-text`, `--find-exact`, `--find-type`, `--find-id`, `--index`, `--tap`, `--expect`, `--tap-at`, `--enter-text`, `--set-value`, `--list`

9. **gesture.py** - Perform swipes, scrolls, pinches, and complex gestures
   - Directional swipes (up/down/left/right) - `--swipe` is the direction the finger moves
   - Multi-swipe scrolling - `--scroll` is the direction the content moves (`down` reveals content below)
   - Pinch zoom via `idb ui pinch` (`--pinch

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

From GitHub

GitHub stars
1,330
Maker
conorluddy
License
MIT
Last code change
Nov 8, 2026
SKILL.md files in the repo (including translated copies and templates)
1
Topics
agent, ai-agents, claude, claude-ai, claude-code, claude-skills, claudecode, claudeskills, dx, ios, iossimulator, iphone