skills.rest
UnaMentis
UnaMentisOFFICIAL
Explore all skills by this author →
WebsiteGitHub

xcode-project

Add Swift sources and frameworks to Xcode project files with validation and rollback.

6|Updated Dec 11, 2025
Search Tags:#automation#swift#ios#pbxproj#build-system#xcodeproj#xcode-project
One-click install
npx skills add https://github.com/UnaMentis/unamentis --skill xcode-project
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xcode-project
Source: https://github.com/UnaMentis/unamentis/tree/main/.claude/skills/xcode-project
Command: npx skills add https://github.com/UnaMentis/unamentis --skill xcode-project

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Safely manage Xcode projects by programmatically adding Swift source files, frameworks, and xcframeworks without manual edits to project.pbxproj, reducing human errors and drift.

Core Features & Use Cases

  • Safe PBXProj manipulation using the xcodeproj Ruby gem to create file references, assign them to the correct groups, and update compile phases.
  • Add files and frameworks across targets, including embedding frameworks when required.
  • Verify project integrity after modifications and recover from issues if something goes wrong.
  • Use case: on-boarding new libraries or generated code into an existing iOS app without opening Xcode.

Quick Start

Add a Swift file to the current Xcode project using /xcode-project add-files path/to/MyFile.swift.

Frequently Asked Questions about xcode-project

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

FAQPage Schema
How do I add a Swift file to an Xcode project from the command line?▼

To add Swift files to an Xcode project, you automate PBXProj manipulation by creating file references, assigning groups, and updating PBXSourcesBuildPhase entries. This safely injects sources without manual project.pbxproj edits.

What is the safest way to modify project.pbxproj to embed frameworks?▼

Safely modifying project.pbxproj to embed frameworks requires automated validation and rollback on error. This updates PBXFileReference and build phases programmatically, preventing human errors and configuration drift.

Can I add xcframeworks across multiple iOS targets without opening Xcode?▼

Yes, adding xcframeworks across multiple iOS targets is possible by automating standard PBXProj structures. The process updates file references and embeds frameworks across targets, verifying integrity after modifications.

Does the xcodeproj Ruby gem support rollback when project modifications fail?▼

Yes, automating Xcode project management with the xcodeproj Ruby gem includes validation and rollback on error. If modifications fail, the process recovers to maintain project integrity and prevent pbxproj corruption.

Why does modifying project.pbxproj manually cause configuration drift?▼

Modifying project.pbxproj manually causes configuration drift because human errors in updating PBXGroup and PBXSourcesBuildPhase structures break project integrity. Automating manipulations ensures correct group assignment and phase updates.

Related Skills

Explore More Software Engineering Skills→
michaelboedingmichaelboeding
24

add-to-xcode

Register new source files with an Xcode project via a Ruby script.

Community
Advanced
harshav167harshav167

ios-simulator-browser

Mirror iOS Simulator content in Cursor's embedded browser with hot reload.

Community
Advanced
LawrenceHwangLawrenceHwang

copilot-sdk

Wrap the GitHub Copilot CLI with JSON-RPC for multi-language SDK access.

Community
Advanced
asnar00asnar00
1

ios-add-file

Adds Swift files to Cubit projects by editing config files directly, bypassing Xcode's GUI.

Community
Advanced