xcode-integration

xcode-integration is a skill for Claude Code, Codex from troyjthomas/ios-agent-skills. It costs 79 tokens per session (1,629 once invoked), scanned A, original, MIT.

Safety guidance for using coding agents with Xcode, Apple’s app-development tool. It explains how to build and test projects while avoiding direct edits to fragile project files.

In plain words
What is it for?
Building, testing, and iterating on Xcode projects while handling new or deleted source files safely.
Why use it?
Directly changing Xcode project files can corrupt them and cause hard-to-diagnose build or opening failures.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/troyjthomas/ios-agent-skills/xcode-integration
Any agent
npx skills add troyjthomas/ios-agent-skills --skill xcode-integration
Clone the repo
git clone --depth 1 https://github.com/troyjthomas/ios-agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for xcode-integration

README.md
[![agentmods](https://agentmods.dev/badge/skills/troyjthomas/ios-agent-skills/xcode-integration.svg)](https://agentmods.dev/skills/troyjthomas/ios-agent-skills/xcode-integration)
Your own site
<a href="https://agentmods.dev/skills/troyjthomas/ios-agent-skills/xcode-integration"><img src="https://agentmods.dev/badge/skills/troyjthomas/ios-agent-skills/xcode-integration.svg" alt="Measured on agentmods" height="20"></a>
Per session 79 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,629 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00079 $0.01629
Opus 5 $0.00039 $0.00814
Sonnet 5 $0.00016 $0.00326
Haiku 4.5 $0.00008 $0.00163

Measured 4d ago against content hash d20fb1653024, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

xcode-integration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/xcode-integration/SKILL.md · 181 lines

How it starts

The opening of the file, as written. The whole thing — 181 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Xcode Integration

Claude Code and Xcode work together through MCPs. But Xcode project files are fragile. This skill keeps you safe.

The .pbxproj Rule (CRITICAL)

Never let Claude Code modify .pbxproj files directly.

The .pbxproj format is notoriously complex. Claude Code can read it but should never write to it. One corrupted project file wastes hours.

Add This to Every CLAUDE.md

## Xcode Project Safety
- NEVER modify .xcodeproj/project.pbxproj directly
- NEVER modify .xcworkspace files directly
- When creating new Swift files, create the file on disk.
  I will add it to the Xcode project manually.
- When deleting files, delete from disk. I will remove
  the reference in Xcode manually.
- If a build error is related to missing file references
  in the project, tell me to fix it in Xcode rather than
  attempting to edit the pbxproj.

Why This Matters for You

As a non-developer, you might not immediately recognize a corrupted .pbxproj. The symptoms: Xcode refuses to open the project, or builds fail with cryptic errors about missing references. The fix is usually reverting the file in git, but if you didn't commit before the corruption, you lose work.

The Workaround

Claude Code creates the .swift files in the correct directories. You open Xcode, drag the files into the project navigator, and Xcode handles the .pbxproj entries correctly. This takes 5 seconds per file and prevents hours of debugging.

Alternative for Swift Package Manager projects: If your project uses SPM exclusively (no .xcodeproj), this rule is less critical since SPM uses Package.swift which is more predictable. But most iOS apps still use .xcodeproj.

Build Patterns with XcodeBuildMCP

Building for Simulator

Tell Claude Code:

Build the project for the iPhone 16 Pro simulator.
If there are build errors, fix them.

Claude Code uses XcodeBuildMCP to run the build, reads the errors, and fixes them. This loop can happen multiple times without your intervention.

Read the full file on GitHub · 181 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 181 lines · 79 tokens per session scan A d20fb1653024

Subscribe to this mod's changes

xcode-integration is a skill published in the GitHub repository troyjthomas/ios-agent-skills (2 stars, last pushed 3mo ago), licensed MIT. It adds 79 tokens to every session and 1,629 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

push-notifications

Implement, review, or debug push notifications in iOS/macOS apps — local notifications, remote (APNs) notifications, rich notifications, notification actions, silent pushes, and notification service/content extensions. Use when working with UNUserNotificationCenter, registering for remote notifications, handling…

dpearson2699/swift-ios-skills · 102 tokens

activitykit

Implement, review, or improve Live Activities and Dynamic Island experiences in iOS apps using ActivityKit. Use when building real-time updating widgets for the Lock Screen and Dynamic Island — delivery tracking, sports scores, ride-sharing status, workout timers, media playback, or any time-sensitive information that…

dpearson2699/swift-ios-skills · 105 tokens

app-intents

Implement App Intents for Siri, Shortcuts, Spotlight, widgets, Control Center, and Apple Intelligence on iOS. Covers AppIntent actions, AppEntity and EntityQuery models, AppShortcutsProvider phrases, IndexedEntity Spotlight indexing, WidgetConfigurationIntent, SnippetIntent, and assistant schemas. Use when exposing…

dpearson2699/swift-ios-skills · 74 tokens

appmigrationkit

Transfer app data to or from other platforms using AppMigrationKit. Use when implementing system-orchestrated one-time migration between iOS and Android or another platform, building an AppMigrationExtension, packaging transportable resources with ResourcesArchiver, importing resources on the destination device…

dpearson2699/swift-ios-skills · 83 tokens

avkit

Create media playback experiences using AVKit. Use when adding video players with AVPlayerViewController, enabling Picture-in-Picture, routing media with AirPlay, using SwiftUI VideoPlayer views, configuring transport controls, displaying subtitles and closed captions, or integrating AVFoundation playback with system…

dpearson2699/swift-ios-skills · 60 tokens

browserenginekit

Build alternative browser engines using BrowserEngineKit. Use when developing a non-WebKit browser engine for iOS/iPadOS in supported regions, managing web content/rendering/networking extension processes, configuring GPU and networking process capabilities, checking alternative-engine device eligibility, or reviewing…

dpearson2699/swift-ios-skills · 68 tokens