ios-debugger-agent · harperreed — Claude Code skill: what it does, how to install
Controls a booted iOS simulator via XcodeBuildMCP to build schemes and inspect on-screen UI elements.
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-codeWhat ios-debugger-agent does
This skill guides coding agents through debugging iOS applications using XcodeBuildMCP tools. It begins by scanning for an active simulator marked as booted, then locks in session defaults like the scheme and workspace path. The model can then compile the project or start an existing build if the bundle ID is known.
Screen interactions rely on UI element discovery. Instead of guessing raw coordinates, the agent inspects accessibility labels or identifiers before tapping. It can trigger gestures and grab screenshots, while capturing simulator logs in real time.
The agent will not launch a fresh simulator on its own without a direct instruction. It depends strictly on an active XcodeBuildMCP setup and an existing booted device.
What it helps with
- run an iOS project scheme inside a booted simulator
- inspect UI hierarchy and tap elements by label or ID
- capture application runtime logs and console output
- take simulator screenshots to verify layout states
Example prompts for the agent
- Run the current scheme on the active iOS simulator and verify that the home screen loads.
- Inspect the simulator UI, tap the login button, and enter test credentials.
- Start log capture for our bundle ID, trigger the crash, and show relevant errors.
How to install ios-debugger-agent
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-code2Manually: put the files in place
~/.claude/skills/ios-debugger-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ios-debugger-agent/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a codex2Manually: put the files in place
.agents/skills/ios-debugger-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a cursor2Manually: put the files in place
.cursor/skills/ios-debugger-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles ios-debugger-agent2Manually: put the files in place
.github/skills/ios-debugger-agent/SKILL.md1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills/ios-debugger-agentManually: put the files in place
.devin/skills/ios-debugger-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ios-debugger-agent
How to install ios-debugger-agent in Claude Code?
Run npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-code in your terminal or place the file into ~/.claude/skills/ios-debugger-agent/SKILL.md.
What does ios-debugger-agent do?
It provides instructions for managing iOS apps in the simulator via XcodeBuildMCP. The agent uses it to discover booted devices, build code, perform UI interactions, and fetch logs.
Will the agent boot a simulator automatically?
No, the workflow looks for a device already in the booted state. If none is found, the agent asks you to start one before continuing.
Similar skills
All skills for Mobile →ios-debugger-agent by other authors comes first.
