Skip to main content
affpapa.org
RU EN
skill CX Codex GP ChatGPT official · OpenAI

ios-debugger-agent — Claude skill: build and debug iOS apps

A Claude skill that builds and launches your iOS app on a simulator through XcodeBuildMCP, then lets the agent poke at the UI and read logs.

Install into Codex · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add openai/plugins --skill ios-debugger-agent -a codex
Open on GitHub

What ios-debugger-agent does

The skill lays out a workflow for driving the simulator with XcodeBuildMCP tools. First the agent looks for a booted simulator via mcp__XcodeBuildMCP__list_sims and picks the one in state Booted. If none are booted, the skill says to ask you rather than boot one on its own.

Session defaults come next: projectPath or workspacePath, the app scheme, and simulatorId. Build and run go through mcp__XcodeBuildMCP__build_run_sim. After a successful build the agent confirms the app actually launched with describe_ui or screenshot. If the build fails, the skill suggests retrying with preferXcodebuild: true or handing the problem back to you.

UI work uses tap, type_text, gesture and screenshot. Logs are captured with start_sim_log_cap and stop_sim_log_cap against the app bundle id. You need XcodeBuildMCP installed and a booted simulator. Worth installing if you run iOS builds from Claude and want the agent to verify the result in the simulator instead of just compiling.

What it helps with

  • build and run the project scheme on a booted simulator
  • check what is actually on screen with a screenshot or describe_ui
  • tap an element by id or label instead of raw coordinates
  • capture app logs and pull out the lines that matter
  • figure out why the wrong app launched after a build

Example prompts for the agent

  • Build and run the current scheme on the booted simulator
  • Describe the running app's UI and tap the login button
  • Start log capture and show me what crashes on launch

How to install ios-debugger-agent

1Skills CLI (Vercel)

npx skills add openai/plugins --skill ios-debugger-agent -a codex

2Manually: put the files in place

.agents/skills/ios-debugger-agent/SKILL.md

For all projects use ~/.agents/skills/

From the same set201

The whole set →
supabase official supabase Guides the agent through database configuration and strict RLS policies in Supabase. CX Codex GP ChatGPT 8installs remotion-render official Remotion Exports videos and static stills from Remotion projects using CLI commands. CX Codex GP ChatGPT 3installs figma-create-new-file official Figma Creates blank Figma, FigJam, or Slides files inside draft folders. It resolves planKey and editor types before invoking Figma MCP tools. CX Codex GP ChatGPT 6installs swiftui-performance-audit official OpenAI Pinpoints SwiftUI runtime issues like frame drops, unresponsive taps, and excessive view body computations. Works code-first and guides Instruments profiling. CX Codex GP ChatGPT 109installs swiftui-liquid-glass official OpenAI This skill helps build and review SwiftUI Liquid Glass interfaces for iOS 26+. Use it when adopting the API or checking fallbacks, interaction, and design fit. CX Codex GP ChatGPT 121installs swiftui-ui-patterns official OpenAI This skill helps build and refactor SwiftUI interfaces, from navigation and state to layouts and controls. Use it for new screens or changes to an existing project. CX Codex GP ChatGPT 114installs swiftui-view-refactor official OpenAI Refactors SwiftUI view files into clean, testable structures with dedicated subview types and proper Observation ownership. CX Codex GP ChatGPT 113installs ios-memgraph-leaks official OpenAI Captures and inspects iOS leaks from a simulator process or .memgraph. Useful for tracing retained objects and checking a fix with before-and-after evidence. CX Codex GP ChatGPT 1,054installs

Similar

mvvm-toolkit official github Guides GitHub Copilot to scaffold ViewModels, source generator attributes, commands, and validation for CommunityToolkit.Mvvm. GitHub Copilot 89installs mvvm-toolkit-messenger official github A GitHub Copilot skill for CommunityToolkit.Mvvm Messenger: wires ViewModels together over pub/sub instead of direct references. GitHub Copilot 56installs gem-devops-guidelines official github A set of rules for infrastructure reviews, CI/CD pipelines, Docker, Kubernetes, and rollbacks. Guides production readiness and mobile releases in GitHub Copilot. GitHub Copilot 35installs vercel-react-native-skills vercel A rules pack for React Native and Expo work: lists, animations, navigation, native modules. Load it so your agent makes mobile changes the same way every time. Claude Code CX Codex Cursor +1 253,900installs animate-expo emilkowalski Builds React Native and Expo animations using Reanimated and Gesture Handler. Helps keep motion on the UI thread and avoid dropped frames on physical devices. Claude Code CX Codex Cursor +1 135,900installs mobile-native emilkowalski Strips the tells that give a web app away on a phone: sticky hover, tap highlight flash, the 100vh bug. Claude Code CX Codex Cursor +1 84,500installs aso coreyhaines31 Audits App Store and Google Play listings against store optimization standards. Helps uncover gaps in metadata, visual assets, and conversion. Claude Code CX Codex Cursor +1 74,900installs swiftui-pro Paul Hudson Reviews SwiftUI code for deprecated APIs, data-flow issues, accessibility gaps, and performance concerns. Use it during feature work or code review. Claude Code CX Codex Cursor +1 35,000installs

Questions about ios-debugger-agent

How do I install ios-debugger-agent in Claude?

Run npx skills add openai/plugins --skill ios-debugger-agent -a codex. The skill file lands at .agents/skills/ios-debugger-agent/SKILL.md.

What does ios-debugger-agent do?

It gives the agent a sequence for building and launching an iOS app on a simulator with XcodeBuildMCP, plus UI interaction and log capture.

What do I need for the skill to work?

XcodeBuildMCP and a booted simulator. If nothing is booted, the skill asks you to start one yourself.

Source text

SKILL.md · MIT 
---
name: ios-debugger-agent
description: Build, run, and debug iOS apps on Simulator with XcodeBuildMCP. Use when launching an app, inspecting simulator UI or logs, or diagnosing runtime behavior.
---

# 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
Use these when asked to inspect or interact with the running app.

- **Describe UI**: `mcp__XcodeBuildMCP__describe_ui` before tapping or swiping.
- **Tap**: `mcp__XcodeBuildMCP__tap` (prefer `id` or `label`; use coordinates only if needed).
- **Type**: `mcp__XcodeBuildMCP__type_text` after focusing a field.
- **Gestures**: `mcp__XcodeBuildMCP__gesture` for common scrolls and edge swipes.
- **Screenshot**: `mcp__XcodeBuildMCP__screenshot` for visual confirmation.

## Logs & Console Output
- Start logs: `mcp__XcodeBuildMCP__start_sim_log_cap` with the app bundle id.
- Stop logs: `mcp__XcodeBuildMCP__stop_sim_log_cap` and summarize important lines.
- For console output, set `captureConsole: true` and relaunch if required.

## Troubleshooting
- If build fails, ask whether to retry with `preferXcodebuild: true`.
- If the wrong app launches, confirm the scheme and bundle id.
- If UI elements are not hittable, re-run `describe_ui` after layout changes.

© OpenAI · MIT · openai/plugins

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor