🎯

xcode

🎯Skill
g1joshi/agent-skills2 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill xcode

Run 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.

Run it (Claude Code)/xcode
Install 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.

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: Build
  • Cmd + R: Run
  • Cmd + U: Run Unit Tests
  • Cmd + .: Stop Running
  • Cmd + 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 .xcconfig files rather than modifying .xcodeproj project files directly.
  • Profile memory leaks, retain cycles, and allocation graphs using Xcode Instruments (Cmd + I).
  • Automate archiving and TestFlight distribution using fastlane gym and fastlane pilot.

Don't:

  • Commit xcuserdata/ directories inside .xcodeproj or .xcworkspace to Git.
  • Store private distribution certificates or provisioning profile passwords in plaintext CI scripts.
  • Force-unwrap optionals (!) or ignore Swift Concurrency compiler warnings.

Troubleshooting

ErrorCauseSolution
Code Signing Error: No signing certificate foundApple Developer account credentials expired or provisioning profile missingCheck Signing & Capabilities tab; select your team and enable Automatically manage signing.
DerivedData corruption causing phantom build errorsStale module cache or build artifactsRun rm -rf ~/Library/Developer/Xcode/DerivedData and restart Xcode.
Simulator fails to boot or hangs on black screenCorrupted simulator stateOpen Simulator menu > Device > Erase All Content and Settings... or run xcrun simctl erase all.

References

More from this repository10