IOS Debugger Agent

Build, run, and debug iOS apps on Simulator with XcodeBuildMCP. Use when launching an app, inspecting simulator UI or logs, or diagnosing runtime behavior.

49 stars 5 forksMobile Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add robinebers/skills --skill ios-debugger-agent
Manual install
git clone --depth 1 https://github.com/robinebers/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/ios-debugger-agent ~/.claude/skills/ios-debugger-agent

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# iOS Debugger Agent

## Overview
Use XcodeBuildMCP to build and run the current project scheme on a booted iOS simulator, interact with the UI, and capture logs. Prefer the MCP tools for simulator control, logs, and view inspection.

## Core Workflow
Follow this sequence unless the user asks for a narrower action.

### 1) Discover the booted simulator
- Call `mcp__XcodeBuildMCP__list_sims` and select the simulator with state `Booted`.
- If none are booted, ask the user to boot one (do not boot automatically unless asked).

### 2) Set session defaults
- Call `mcp__XcodeBuildMCP__session-set-defaults` with:
  - `projectPath` or `workspacePath` (whichever the repo uses)
  - `scheme` for the current app
  - `simulatorId` from the booted device
  - Optional: `configuration: "Debug"`, `useLatestOS: true`

### 3) Build + run (when requested)
- Call `mcp__XcodeBuildMCP__build_run_sim`.
- **If the build fails**, check the error output and retry (optionally with `preferXcodebuild: true`) or escalate to the user before attempting any UI interaction.
- **After a successful build**, verify the app launched by calling `mcp__XcodeBuildMCP__describe_ui` or `mcp__XcodeBuildMCP__screenshot` before proceeding to UI interaction.
- If the app is already built and only launch is requested, use `mcp__XcodeBuildMCP__launch_app_sim`.
- If bundle id is unknown:
  1) `mcp__XcodeBuildMCP__get_sim_app_path`
  2) `mcp__XcodeBuildMCP__get_app_bundle_id`

## UI Interaction & Debugging
Read the full skill on GitHub

Details

Skill name
ios-debugger-agent
Path
skills/ios-debugger-agent/SKILL.md
Repo updated
25 June 2026

FAQ

What does the IOS Debugger Agent skill do?

Build, run, and debug iOS apps on Simulator with XcodeBuildMCP. Use when launching an app, inspecting simulator UI or logs, or diagnosing runtime behavior.

How do I install the IOS Debugger Agent skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add robinebers/skills --skill ios-debugger-agent. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is IOS Debugger Agent popular?

It lives in robinebers/skills, which has 49 GitHub stars and 5 forks.

Related skills

Browse the most popular Claude skills, all mobile development skills, or write your own with the skills generator.