skills.rest
DingJun1028
DingJun1028COMMUNITY
Explore all skills by this author →
GitHub

xcode-project-setup

Adds Swift Package dependencies and links config files to Xcode projects via a Swift script.

Updated Aug 17, 2026
Search Tags:#dependency management#swift#ios#xcode#firebase#pbxproj#swift package manager
One-click install
npx skills add https://github.com/DingJun1028/esggo-kv --skill xcode-project-setup-dingjun1028
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xcode-project-setup
Source: https://github.com/DingJun1028/esggo-kv/tree/main/.agents/skills/xcode-project-setup
Command: npx skills add https://github.com/DingJun1028/esggo-kv --skill xcode-project-setup-dingjun1028

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Modifying Xcode project files (.pbxproj) by hand or with fragile text parsing is error-prone and can corrupt projects. This Skill safely adds Swift Package Manager dependencies (like Firebase or Alamofire) and links configuration files to Xcode projects using a native Swift script, without Ruby gems or manual .pbxproj edits. ## Core Features & Use Cases - SPM Package Installation: Adds a package repository dependency and automatically links the specified product modules to the main target's Frameworks build phase in one step. - Config File Linking: Optionally links files like GoogleService-Info.plist into the resources build phase via the --plist flag. - Firebase Safety: Automatically injects the -ObjC linker flag into OTHER_LDFLAGS when adding Firebase products, preventing runtime crashes from stripped Objective-C categories. - Use Case: You need to add FirebaseAuth and FirebaseFirestore to an iOS app. Run the bundled Swift script with the Firebase repo URL, latest SDK version, and product names, and the project is configured idempotently. ## Quick Start Ask the AI to add the Firebase iOS SDK with FirebaseCore and FirebaseAuth to your Xcode project using the xcode-project-setup skill.

Frequently Asked Questions about xcode-project-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Firebase to an Xcode project with Swift Package Manager?▼

Run the bundled xcode_spm_setup Swift script with the firebase-ios-sdk repository URL, the latest release version, and the product modules you need such as FirebaseCore and FirebaseAuth. The script adds the package dependency and links the modules to your target automatically.

How do I link GoogleService-Info.plist to an Xcode target?▼

Pass the --plist flag with the path to your GoogleService-Info.plist when running the xcode_spm_setup script. It adds the file to the resources build phase of the main target, and skips it if already linked.

Why does Firebase crash with 'Unexpectedly found nil' at runtime?▼

The Apple linker strips Objective-C categories and +load methods from statically linked Firebase libraries. Adding the -ObjC flag to OTHER_LDFLAGS fixes this, and the xcode_spm_setup script injects it automatically when adding Firebase products.

Can I use CocoaPods or the xcodeproj Ruby gem to modify .pbxproj files?▼

This Skill strictly forbids Ruby and the xcodeproj gem. All project manipulation is done through a native Swift script, with Node.js or TypeScript allowed only as a last resort when Swift is unviable.

What happens if no Xcode project exists in the directory?▼

The workflow stops and asks you to create an empty Xcode project manually in Xcode first. Once the .xcodeproj exists, the standard SPM setup workflow can proceed.

Related Skills

Explore More Software Engineering Skills→
NBXXFNBXXF
6

xxf-tracker-firebase

Configure XXFTracker Firebase provider to report events to Firebase Analytics.

Community
Intermediate
infinite-loop-factoryinfinite-loop-factory

expo-dev-client

Build customized Expo development clients for testing native code on physical devices.

Official
Intermediate
mcauduro0mcauduro0
1

ln-625-dependencies-auditor

Audit project dependencies for outdated packages, unused modules, and security vulnerabilities.

Community
Advanced
Cap-goCap-go
58

cocoapods-to-spm

Migrates Tanzu-Cap:ctor iOS projects from CocoaPods to Swift Package Manager workflows.

Official
Intermediate