{"id":"101420fe-61bb-41b5-9186-c43c753cd5b2","shortId":"625XwT","kind":"skill","title":"ios-debugger-agent","tagline":"Debug the current iOS project on a booted simulator with XcodeBuildMCP.","description":"# iOS Debugger Agent\n\n## Overview\nUse 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.\n\n## When to Use\n- When the user asks to run, debug, or inspect an iOS app on a simulator.\n- When you need simulator UI interaction, screenshots, or runtime logs via XcodeBuildMCP.\n\n## Core Workflow\nFollow this sequence unless the user asks for a narrower action.\n\n### 1) Discover the booted simulator\n- Call `mcp__XcodeBuildMCP__list_sims` and select the simulator with state `Booted`.\n- If none are booted, ask the user to boot one (do not boot automatically unless asked).\n\n### 2) Set session defaults\n- Call `mcp__XcodeBuildMCP__session-set-defaults` with:\n  - `projectPath` or `workspacePath` (whichever the repo uses)\n  - `scheme` for the current app\n  - `simulatorId` from the booted device\n  - Optional: `configuration: \"Debug\"`, `useLatestOS: true`\n\n### 3) Build + run (when requested)\n- Call `mcp__XcodeBuildMCP__build_run_sim`.\n- **If the build fails**, check the error output and retry (optionally with `preferXcodebuild: true`) or escalate to the user before attempting any UI interaction.\n- **After a successful build**, verify the app launched by calling `mcp__XcodeBuildMCP__describe_ui` or `mcp__XcodeBuildMCP__screenshot` before proceeding to UI interaction.\n- If the app is already built and only launch is requested, use `mcp__XcodeBuildMCP__launch_app_sim`.\n- If bundle id is unknown:\n  1) `mcp__XcodeBuildMCP__get_sim_app_path`\n  2) `mcp__XcodeBuildMCP__get_app_bundle_id`\n\n## UI Interaction & Debugging\nUse these when asked to inspect or interact with the running app.\n\n- **Describe UI**: `mcp__XcodeBuildMCP__describe_ui` before tapping or swiping.\n- **Tap**: `mcp__XcodeBuildMCP__tap` (prefer `id` or `label`; use coordinates only if needed).\n- **Type**: `mcp__XcodeBuildMCP__type_text` after focusing a field.\n- **Gestures**: `mcp__XcodeBuildMCP__gesture` for common scrolls and edge swipes.\n- **Screenshot**: `mcp__XcodeBuildMCP__screenshot` for visual confirmation.\n\n## Logs & Console Output\n- Start logs: `mcp__XcodeBuildMCP__start_sim_log_cap` with the app bundle id.\n- Stop logs: `mcp__XcodeBuildMCP__stop_sim_log_cap` and summarize important lines.\n- For console output, set `captureConsole: true` and relaunch if required.\n\n## Troubleshooting\n- If build fails, ask whether to retry with `preferXcodebuild: true`.\n- If the wrong app launches, confirm the scheme and bundle id.\n- If UI elements are not hittable, re-run `describe_ui` after layout changes.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["ios","debugger","agent","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-ios-debugger-agent","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/ios-debugger-agent","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34768 github stars · SKILL.md body (2,938 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T18:51:33.427Z","embedding":null,"createdAt":"2026-04-18T21:39:17.401Z","updatedAt":"2026-04-23T18:51:33.427Z","lastSeenAt":"2026-04-23T18:51:33.427Z","tsv":"'1':96,243 '2':129,250 '3':163 'action':95 'agent':4,18 'alreadi':225 'app':67,152,204,223,236,248,254,271,334,373 'ask':59,91,117,128,263,363,428 'attempt':194 'automat':126 'boot':12,32,99,112,116,121,125,156 'boundari':436 'build':23,164,171,176,201,361 'built':226 'bundl':239,255,335,379 'call':101,133,168,207 'cap':331,344 'captur':40 'captureconsol':353 'chang':394 'check':178 'clarif':430 'clear':403 'common':309 'configur':159 'confirm':320,375 'consol':322,350 'control':48 'coordin':291 'core':83 'criteria':439 'current':7,27,151 'debug':5,62,160,259 'debugg':3,17 'default':132,139 'describ':210,272,276,390,407 'devic':157 'discov':97 'edg':312 'element':383 'environ':419 'environment-specif':418 'error':180 'escal':189 'expert':424 'fail':177,362 'field':303 'focus':301 'follow':85 'gestur':304,307 'get':246,253 'hittabl':386 'id':240,256,287,336,380 'import':347 'input':433 'inspect':52,64,265 'interact':35,76,197,220,258,267 'io':2,8,16,33,66 'ios-debugger-ag':1 'label':289 'launch':205,229,235,374 'layout':393 'limit':395 'line':348 'list':104 'log':41,49,80,321,325,330,338,343 'match':404 'mcp':44,102,134,169,208,213,233,244,251,274,283,296,305,315,326,339 'miss':441 'narrow':94 'need':73,294 'none':114 'one':122 'option':158,184 'output':181,323,351,413 'overview':19 'path':249 'permiss':434 'prefer':42,286 'preferxcodebuild':186,368 'proceed':217 'project':9,28 'projectpath':141 're':388 're-run':387 'relaunch':356 'repo':146 'request':167,231 'requir':358,432 'retri':183,366 'review':425 'run':25,61,165,172,270,389 'runtim':79 'safeti':435 'scheme':29,148,377 'scope':406 'screenshot':77,215,314,317 'scroll':310 'select':107 'sequenc':87 'session':131,137 'session-set-default':136 'set':130,138,352 'sim':105,173,237,247,329,342 'simul':13,34,47,70,74,100,109 'simulatorid':153 'skill':398 'skill-ios-debugger-agent' 'source-sickn33' 'specif':420 'start':324,328 'state':111 'stop':337,341,426 'substitut':416 'success':200,438 'summar':346 'swipe':281,313 'tap':279,282,285 'task':402 'test':422 'text':299 'tool':45 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':411 'troubleshoot':359 'true':162,187,354,369 'type':295,298 'ui':38,75,196,211,219,257,273,277,382,391 'unknown':242 'unless':88,127 'use':20,55,147,232,260,290,396 'uselatesto':161 'user':58,90,119,192 'valid':421 'verifi':202 'via':81 'view':51 'visual':319 'whether':364 'whichev':144 'workflow':84 'workspacepath':143 'wrong':372 'xcodebuildmcp':15,21,82,103,135,170,209,214,234,245,252,275,284,297,306,316,327,340","prices":[{"id":"25352e6f-03c3-49b2-8d9b-7626287ca8d0","listingId":"101420fe-61bb-41b5-9186-c43c753cd5b2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:39:17.401Z"}],"sources":[{"listingId":"101420fe-61bb-41b5-9186-c43c753cd5b2","source":"github","sourceId":"sickn33/antigravity-awesome-skills/ios-debugger-agent","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ios-debugger-agent","isPrimary":false,"firstSeenAt":"2026-04-18T21:39:17.401Z","lastSeenAt":"2026-04-23T18:51:33.427Z"}],"details":{"listingId":"101420fe-61bb-41b5-9186-c43c753cd5b2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"ios-debugger-agent","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34768,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-23T06:41:03Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"e30bbe9819df8af052a19faf1d5687ea4cdac346","skill_md_path":"skills/ios-debugger-agent/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/ios-debugger-agent"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"ios-debugger-agent","description":"Debug the current iOS project on a booted simulator with XcodeBuildMCP."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/ios-debugger-agent"},"updatedAt":"2026-04-23T18:51:33.427Z"}}