swift

Manages Swift project generation, xcodebuild testing, code signing, and device deployment for Apple platforms.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill swift-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swift
Source: https://github.com/leonardoacosta/skills/tree/main/swift-kit/skills/swift
Command: npx skills add https://github.com/leonardoacosta/skills --skill swift-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Native iOS, macOS, and watchOS development involves fragile project files, signing failures in remote sessions, and inconsistent build verification. This Skill standardizes XcodeGen-based project management, unsigned test runs, and signed remote builds so Apple-platform work follows repeatable conventions. ## Core Features & Use Cases - XcodeGen project management: Treats project.yml as the source of truth, regenerates the project with xcodegen generate, and flags unexpected drift in generated files. - Build and test verification: Runs the repository's scheme and destination through xcodebuild test CODE_SIGNING_ALLOWED=NO, plus focused swiftc -typecheck preflights and plutil -lint validation for plists and entitlements. - Code signing and remote deployment: Guides entitlements, signing configuration, and a GUI-session LaunchAgent bridge for signed builds and device installs from background SSH sessions. - Use Case: You SSH into a remote Mac mini build machine and a signed build fails with errSecInternalComponent. This Skill walks you through diagnosing the session difference and routing the build through a GUI-scoped LaunchAgent bridge. ## Quick Start Use the swift skill to regenerate the Xcode project with XcodeGen and run the test suite without code signing.

Frequently Asked Questions about swift

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

FAQPage Schema
How do I manage an Xcode project with XcodeGen?

Treat project.yml as the single source of truth and never hand-edit the generated project.pbxproj. Add source files under the configured source glob, run xcodegen generate, and commit the regenerated project if the repository tracks it.

Why does code signing fail over SSH on macOS?

Code signing can depend on the interactive login security session, so a background SSH session may fail with errSecInternalComponent even when the login keychain is unlocked. Route the signed build through a user LaunchAgent running in the GUI session instead.

Can I use swiftc -typecheck instead of a full xcodebuild test?

A swiftc -typecheck on a single file is only a fast preflight, not a project gate. Always follow it with xcodegen generate and a full xcodebuild test of the repository's scheme and destination before considering the change verified.

How do I validate plist and entitlement files before a signed build?

Run plutil -lint on plist and entitlement files before any signed build to catch syntax errors early. Add capabilities through the target's entitlements and required usage-description keys, then regenerate the project with XcodeGen.