xcode
π―SkillInstallation
npx skills add g1joshi/agent-skills --skill xcodeRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/xcodeInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/xcode/ - All projects
~/.claude/skills/xcode/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βExpert Xcode assistance covering Swift/SwiftUI development, iOS/macOS simulators, Xcode Cloud CI/CD, Instruments profiling, and Swift Package Manager (SPM). Use when configuring Xcode projects, debugging iOS apps with LLDB, profiling with Instruments, or managing Apple Developer signing.
Xcode
Xcode is Apple's unified IDE for developing software across iOS, iPadOS, macOS, watchOS, and visionOS, featuring Instruments profiling, LLDB debugging, and Swift Package Manager.
When to Use
- Native Apple Platform Engineering: Building iOS, iPadOS, macOS, watchOS, and visionOS applications using Swift and SwiftUI.
- Instruments Performance Profiling: Profiling memory leaks, CPU spikes, energy usage, and Time Profiler traces.
- Automated CI/CD Build Packaging: Building, signing, and releasing apps to TestFlight using Fastlane and
xcodebuild. - Swift Package Manager (SPM) Dependency Resolution: Managing native modular libraries and cross-platform Swift packages.
Quick Start
1. Build and Test via xcodebuild CLI
# Build for iOS Simulator
xcodebuild -scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16,OS=latest' \
clean build
# Run unit tests
xcodebuild test -scheme MyApp \
-destination 'platform=iOS Simulator,name=iPhone 16,OS=latest'
2. Core Xcode Shortcuts
Cmd + B: BuildCmd + R: RunCmd + U: Run Unit TestsCmd + .: Stop RunningCmd + Shift + O: Open Quickly (search symbol or file)
Core Concepts
Modular Swift Package Architecture (Package.swift)
Defining modular application packages with explicit dependencies and targets:
// swift-tools-version: 5.10
import PackageDescription
let package = Package(
name: "CoreNetworking",
platforms: [
.iOS(.v17),
.macOS(.v14)
],
products: [
.library(name: "CoreNetworking", targets: ["CoreNetworking"]),
],
dependencies: [
.package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.9.0"),
],
targets: [
.target(
name: "CoreNetworking",
dependencies: ["Alamofire"],
swiftSettings: [
.enableExperimentalFeature("StrictConcurrency")
]
),
.testTarget(
name: "CoreNetworkingTests",
dependencies: ["CoreNetworking"]
),
]
)
Automated CI/CD Build & Test with xcodebuild
Executing headless builds and test runs in continuous integration:
# Clean, build, and test application for iOS Simulator
xcodebuild clean test \
-workspace "EnterpriseApp.xcworkspace" \
-scheme "EnterpriseApp" \
-destination "platform=iOS Simulator,name=iPhone 16 Pro,OS=latest" \
-resultBundlePath "./build/TestResults.xcresult" \
CODE_SIGN_IDENTITY="" \
CODE_SIGNING_REQUIRED=NO \
CODE_SIGNING_ALLOWED=NO
Declarative Build Settings (Config.xcconfig)
Extracting signing, bundle identifiers, and compiler flags from .xcodeproj into versioned files:
// Release.xcconfig
PRODUCT_BUNDLE_IDENTIFIER = com.company.enterpriseapp
SWIFT_VERSION = 5.10
SWIFT_STRICT_CONCURRENCY = complete
IPHONEOS_DEPLOYMENT_TARGET = 17.0
ENABLE_BITCODE = NO
DEBUG_INFORMATION_FORMAT = dwarf-with-dsym
SWIFT_OPTIMIZATION_LEVEL = -O
Common Patterns
LLDB Debugging Commands
Problem: Inspect memory, modify variables at runtime, and view view-hierarchy during breakpoints.
Solution: Use LLDB console commands.
# Print object description
po myViewModel.userProfile
# Print view hierarchy
po [[UIWindow keyWindow] recursiveDescription]
# Modify variable in memory during breakpoint
expr isFeatureFlagEnabled = true
# Continue execution
c
Instruments Memory Leak Profiling
Problem: Identifying retain cycles and memory leaks in SwiftUI and UIKit navigation flows.
Solution:
# Run Leaks instrument on application bundle from command line
xcrun xctrace record --template "Leaks" --device "iPhone 15 Pro" --launch -- com.example.MyApp --output ./build/MyAppLeaks.trace
Best Practices
Do:
- Enable Complete Strict Concurrency Checking (
SWIFT_STRICT_CONCURRENCY = complete) for Swift 6 safety. - Manage build configuration flags using
.xcconfigfiles rather than modifying.xcodeprojproject files directly. - Profile memory leaks, retain cycles, and allocation graphs using Xcode Instruments (
Cmd + I). - Automate archiving and TestFlight distribution using
fastlane gymandfastlane pilot.
Don't:
- Commit
xcuserdata/directories inside.xcodeprojor.xcworkspaceto Git. - Store private distribution certificates or provisioning profile passwords in plaintext CI scripts.
- Force-unwrap optionals (
!) or ignore Swift Concurrency compiler warnings.
Troubleshooting
| Error | Cause | Solution |
|---|---|---|
Code Signing Error: No signing certificate found | Apple Developer account credentials expired or provisioning profile missing | Check Signing & Capabilities tab; select your team and enable Automatically manage signing. |
| DerivedData corruption causing phantom build errors | Stale module cache or build artifacts | Run rm -rf ~/Library/Developer/Xcode/DerivedData and restart Xcode. |
| Simulator fails to boot or hangs on black screen | Corrupted simulator state | Open Simulator menu > Device > Erase All Content and Settings... or run xcrun simctl erase all. |
References
More from this repository10
A template skill providing a starter framework for creating new agent skills with structured sections for triggers, quick start examples, and capability descriptions.
Skill
Skill
Skill
Skill
Skill
Skill
Skill
Skill
Skill