Agent skill

iOS Debugger Agent

by harperreed in harperreed/dotfiles

Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator.

No licenceAuto-check passedMobile

Install iOS Debugger Agent

skills CLI
$ npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install harperreed/dotfiles ios-debugger-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/harperreed/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ios-debugger-agent .claude/skills/ios-debugger-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ios-debugger-agent
GitHub stars
334
Used in
7 other repos
Token cost
~607 tokens
SKILL.md length
251 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
None found

At a glance

Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator.

  • Works in 3 steps: Discover the booted simulator → Set session defaults → Build + run (when requested)
  • Asked to run an iOS app
  • SKILL.md covers Overview, Core Workflow, UI Interaction & Debugging and Logs & Console Output, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

iOS Debugger Agent is an agent skill from harperreed/dotfiles. Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator. Trigger when asked to run an iOS app, interact with the simulator UI, inspect on-screen state, capture logs/console output, or diagnose runtime behavior using XcodeBuildMCP tools.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering iOS development. It works with iOS and Model Context Protocol. The repository describes itself as: Dotfiles. Managed by YADM.

When your agent uses it

  • Asked to run an iOS app
  • Interact with the simulator UI
  • Inspect on-screen state
  • Capture logs/console output

Example prompts

  • “/ios-debugger-agent”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Discover the booted simulator
  2. Set session defaults
  3. Build + run (when requested)

What it can do on your machine

Read from SKILL.md and the folder at commit b78c10e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

iOS Debugger Agent loads about 607 tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 251 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~607

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 251 words (~607 tokens).

“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.”

— opening of SKILL.md by harperreed
name
ios-debugger-agent

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/ios-debugger-agent of harperreed/dotfiles.

Open the folder on GitHubat commit b78c10e

Used in 7 other repositories

We found 16 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 7 other GitHub owners. This page covers the copy in harperreed/dotfiles, which our catalogue first saw on October 7, 2026.

Compare with similar skills

iOS Debugger Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

iOS Debugger Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
iOS Debugger Agent this skillharperreed/dotfiles3347 repos~607Automated safety check: PassNone
Update Swiftui APIsAvdLee/SwiftUI-Agent-Skill3.7k—~1.2kAutomated safety check: PassMIT
iOS Simulator Skillconorluddy/ios-simulator-skill1.3k—~5.7kAutomated safety check: PassMIT
Inspector MCPipedro/Inspector170—~3.4kAutomated safety check: PassMIT
Xcode Buildpzep1/xcode-build-skill138—~1.5kAutomated safety check: NotesMIT
Releasemovieclaw/MovieClaw132—~2.3kAutomated safety check: PassCustom licence

Similar skills

  • Update Swiftui APIs

    AvdLee/SwiftUI-Agent-Skill

    Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.

    3.7k GitHub stars~1.2k tokensUpdated yesterday
    MobileAuto-check passed
  • iOS Simulator Skill

    conorluddy/ios-simulator-skill

    29 production-ready scripts for iOS app testing, building, and automation.

    1.3k GitHub stars~5.7k tokensUpdated yesterday
    MobileAuto-check passed
  • Inspector MCP

    ipedro/Inspector

    A skill your agent uses when an agent needs to inspect a live iOS app through the Inspector MCP bridge, register or troubleshoot InspectorMCPServer for a consumer Xcode project, or query, resolve…

    170 GitHub stars~3.4k tokensUpdated 5 mo ago
    MobileAuto-check passed
  • Xcode Build

    pzep1/xcode-build-skill

    Build and run iOS/macOS apps using xcodebuild and xcrun simctl directly.

    138 GitHub stars~1.5k tokensUpdated 8 mo ago
    MobileAuto-check: notes
  • Release

    movieclaw/MovieClaw

    发布 movieclaw 新版本。当用户要求发版、发布新版本、打 tag、发布 NER 模型、发布 Docker 镜像,或打包上传 iOS App 到 TestFlight / App Store、补传发版附件(IPA、Mac 转码器、Mac 版 App)时使用。涵盖版本号三处同步、应用/模型/镜像/iOS 的完整流程、可选附件失败补救与检查清单。

    132 GitHub stars~2.3k tokensUpdated today
    MobileAuto-check passed
  • Inspector Integration

    ipedro/Inspector

    A skill your agent uses when an agent needs to integrate the Inspector library into an app without focusing on the MCP bridge: startup wiring, configuration/customization, debug-only gating, and…

    170 GitHub stars~724 tokensUpdated 5 mo ago
    MobileAuto-check passed

More from harperreed/dotfiles

All 32 skills in this repo
  • Swiftui Liquid Glass

    harperreed/dotfiles

    Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API.

    334 GitHub starsUsed in 8 repos~941 tokens
    Auto-check passed
  • Swiftui Performance Audit

    harperreed/dotfiles

    Audit and improve SwiftUI runtime performance from code review and architecture.

    334 GitHub starsUsed in 8 repos~1.4k tokens
    Auto-check passed
  • Skill Creator

    harperreed/dotfiles

    Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.

    334 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Swiftui View Refactor

    harperreed/dotfiles

    Refactor and review SwiftUI view files for consistent structure, dependency injection, and Observation usage.

    334 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • App Store Changelog

    harperreed/dotfiles

    Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref).

    334 GitHub starsUsed in 4 repos~465 tokens
    Auto-check passed
  • Nothing Design

    harperreed/dotfiles

    This skill should be used when the user explicitly says "Nothing style", "Nothing design", "/nothing-design", or directly asks to use/apply the Nothing design system.

    334 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed

Categories

Questions about iOS Debugger Agent

What does iOS Debugger Agent do?

Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator. iOS Debugger Agent is an agent skill from harperreed/dotfiles. Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator.

When should I use iOS Debugger Agent?

iOS Debugger Agent fits situations like: asked to run an iOS app; interact with the simulator UI; inspect on-screen state; capture logs/console output.

How do I install iOS Debugger Agent in Claude Code?

Run `npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-code`. Or copy the skill folder (.claude/skills/ios-debugger-agent in harperreed/dotfiles) into .claude/skills/ios-debugger-agent in your project. Claude Code loads it when a task matches its description.

How do I install iOS Debugger Agent in Codex?

Run `npx skills add harperreed/dotfiles --skill ios-debugger-agent -a codex`. Or copy the skill folder (.claude/skills/ios-debugger-agent in harperreed/dotfiles) into .agents/skills/ios-debugger-agent in your project. Codex loads it when a task matches its description.

Can I use iOS Debugger Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add harperreed/dotfiles --skill ios-debugger-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ios-debugger-agent, .gemini/skills/ios-debugger-agent, .github/skills/ios-debugger-agent and .opencode/skills/ios-debugger-agent in your project.

What does iOS Debugger Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: iOS Debugger Agent is instructions for the agent only.

Does iOS Debugger Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is iOS Debugger Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does iOS Debugger Agent use?

No licence was found for iOS Debugger Agent or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does iOS Debugger Agent use?

About 607 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to iOS Debugger Agent?

Skills that share tags, products or a category with iOS Debugger Agent: Update Swiftui APIs (AvdLee/SwiftUI-Agent-Skill, 3.7k stars), iOS Simulator Skill (conorluddy/ios-simulator-skill, 1.3k stars), Inspector MCP (ipedro/Inspector, 170 stars) and Xcode Build (pzep1/xcode-build-skill, 138 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains iOS Debugger Agent?

harperreed (a GitHub user) maintains it in harperreed/dotfiles, which has 334 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 3, 2026.

Source: harperreed/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.