How do I install the Debugger Agent skill?

Run npx skillmds@latest add tomevault-io/debugger-agent 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 Debugger Agent 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 Debugger Agent?

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 Debugger Agent free to use?

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

Who published Debugger Agent?

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

Debugger Agent by tomevault-io — Agent Skill

Name: Debugger Agent
Author: tomevault-io

File contents

iOS Debugger Agent

Overview

Build and run iOS projects on a booted simulator, interact with the UI, and capture logs for debugging.

Prerequisites

Xcode installed with command-line tools
A booted iOS simulator (check with xcrun simctl list devices)
Project with .xcodeproj or .xcworkspace

Core Workflow

1) Discover the booted simulator

xcrun simctl list devices | grep -E "Booted"

If none are booted, ask the user to boot one:

xcrun simctl boot "iPhone 15 Pro"

2) Build the project

For a workspace:

xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build

For a project:

xcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build

3) Install and launch the app

Find the built app:

find ~/Library/Developer/Xcode/DerivedData -name "*.app" -path "*Debug-iphonesimulator*" | head -1

Install on simulator:

xcrun simctl install booted /path/to/MyApp.app

Launch the app:

xcrun simctl launch booted com.example.MyApp

4) Capture logs

Stream logs from the app:

xcrun simctl spawn booted log stream --predicate 'subsystem == "com.example.MyApp"' --level debug

Or capture all simulator logs:

xcrun simctl spawn booted log stream --level debug

UI Interaction

Take a screenshot

xcrun simctl io booted screenshot screenshot.png

Record video

xcrun simctl io booted recordVideo video.mp4
# Press Ctrl+C to stop recording

Open a URL in the simulator

xcrun simctl openurl booted "myapp://deeplink"

Send push notification

xcrun simctl push booted com.example.MyApp notification.apns

Troubleshooting

Build fails: Check scheme name with xcodebuild -list
App won't launch: Verify bundle ID with defaults read /path/to/MyApp.app/Info.plist CFBundleIdentifier
Simulator not found: List available simulators with xcrun simctl list devices available
Clean build: xcodebuild clean or delete DerivedData

Common Commands Reference

Task	Command
List simulators	`xcrun simctl list devices`
Boot simulator	`xcrun simctl boot "iPhone 15 Pro"`
Shutdown simulator	`xcrun simctl shutdown booted`
Erase simulator	`xcrun simctl erase booted`
Install app	`xcrun simctl install booted /path/to/App.app`
Uninstall app	`xcrun simctl uninstall booted com.example.app`
Launch app	`xcrun simctl launch booted com.example.app`
Terminate app	`xcrun simctl terminate booted com.example.app`
Get app container	`xcrun simctl get_app_container booted com.example.app`

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: debugger-agentdescription: Build, run, and debug iOS apps on a simulator. Use when asked to run an iOS app, interact with the simulator UI, capture logs, or diagnose runtime behavior. Use when this capability is needed.---# iOS Debugger Agent## OverviewBuild and run iOS projects on a booted simulator, interact with the UI, and capture logs for debugging.## Prerequisites- Xcode installed with command-line tools- A booted iOS simulator (check with `xcrun simctl list devices`)- Project with `.xcodeproj` or `.xcworkspace`## Core Workflow### 1) Discover the booted simulator```bashxcrun simctl list devices | grep -E "Booted"```If none are booted, ask the user to boot one:```bashxcrun simctl boot "iPhone 15 Pro"```### 2) Build the projectFor a workspace:```bashxcodebuild -workspace MyApp.xcworkspace -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build```For a project:```bashxcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15 Pro' build```### 3) Install and launch the appFind the built app:```bashfind ~/Library/Developer/Xcode/DerivedData -name "*.app" -path "*Debug-iphonesimulator*" | head -1```Install on simulator:```bashxcrun simctl install booted /path/to/MyApp.app```Launch the app:```bashxcrun simctl launch booted com.example.MyApp```### 4) Capture logsStream logs from the app:```bashxcrun simctl spawn booted log stream --predicate 'subsystem == "com.example.MyApp"' --level debug```Or capture all simulator logs:```bashxcrun simctl spawn booted log stream --level debug```## UI Interaction### Take a screenshot```bashxcrun simctl io booted screenshot screenshot.png```### Record video```bashxcrun simctl io booted recordVideo video.mp4# Press Ctrl+C to stop recording```### Open a URL in the simulator```bashxcrun simctl openurl booted "myapp://deeplink"```### Send push notification```bashxcrun simctl push booted com.example.MyApp notification.apns```## Troubleshooting- **Build fails**: Check scheme name with `xcodebuild -list`- **App won't launch**: Verify bundle ID with `defaults read /path/to/MyApp.app/Info.plist CFBundleIdentifier`- **Simulator not found**: List available simulators with `xcrun simctl list devices available`- **Clean build**: `xcodebuild clean` or delete DerivedData## Common Commands Reference| Task | Command ||------|---------|| List simulators | `xcrun simctl list devices` || Boot simulator | `xcrun simctl boot "iPhone 15 Pro"` || Shutdown simulator | `xcrun simctl shutdown booted` || Erase simulator | `xcrun simctl erase booted` || Install app | `xcrun simctl install booted /path/to/App.app` || Uninstall app | `xcrun simctl uninstall booted com.example.app` || Launch app | `xcrun simctl launch booted com.example.app` || Terminate app | `xcrun simctl terminate booted com.example.app` || Get app container | `xcrun simctl get_app_container booted com.example.app` |---> Converted and distributed by [TomeVault](https://tomevault.io/claim/patrickserrano) — claim your Tome and manage your conversions.

Frequently asked questions

Debugger Agent