Xcode Project Setup

This handles the messy parts of adding Swift Package Manager dependencies to Xcode projects without touching Ruby or manually editing pbxproj files. It bundles a Swift script that adds packages and links their products to your target in one shot, which is especially useful for Firebase setup since it auto-injects the ObjC linker flag that prevents those cryptic nil crashes. You point it at your xcodeproj, pass a repo URL and version, list the products you want, and optionally attach a plist like GoogleService-Info. The big win is it handles both adding the dependency and wiring up the frameworks phase, which normally requires clicking through Xcode's UI. Works on macOS with Swift installed, and it's smart enough to skip things already configured.

skills.sh installs: 137.9K
GitHub stars: 508
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add firebase/agent-skills --skill xcode-project-setup --agent claude-code

Installs into .claude/skills of the current project.

Files

Xcode Project Setup

⛔️ CRITICAL RULES & ENVIRONMENT CHECKS

Before performing any Xcode setup or file manipulation, you MUST adhere to the following rules. A hefty fee will be applied if you violate them.

1. The Anti-Ruby Mandate

You are strictly forbidden from using Ruby, Rails, or any Ruby gems (including the xcodeproj gem). Under no circumstances may you write or execute Ruby scripts.

2. Modern Xcode Folder Synchronization

Modern Xcode projects support folder synchronization. When adding new source code (.swift) or resource files, simply write them to the correct directory on disk. They will be automatically included in the Xcode project. Never manually modify the .pbxproj file to add files.

3. Allowed Scripting Languages

If you absolutely must write a script to manipulate the project environment (e.g., configuring SPM packages beyond what the provided xcode_spm_setup script does), you must use Swift. Only as an absolute last resort, if Swift is completely unviable, may you use Node.js or TypeScript.