bootstrap-xcode-app-project

Generate XcodeGen project.yml and source files for SwiftUI Apple app repositories.

9|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill bootstrap-xcode-app-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bootstrap-xcode-app-project
Source: https://github.com/gaelic-ghost/apple-dev-skills/tree/main/skills/bootstrap-xcode-app-project
Command: npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill bootstrap-xcode-app-project

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Quickly and safely create a new native Apple app repository scaffold so engineers and maintainers avoid manual Xcode project setup, inconsistent project files, and missing maintainer guidance.

Core Features & Use Cases

  • Deterministic XcodeGen generation: Produces project.yml, source files, and unit-test targets for SwiftUI apps using XcodeGen.
  • Repo-maintenance toolkit installation: Installs a managed maintainer toolkit and copies AGENTS.md to ensure consistent validation, sync, and release flows.
  • Guarded validation and guided fallbacks: Validates prerequisites (xcodegen, xcodebuild), refuses destructive overwrites, and returns clear next steps for guided Xcode flows.
  • Use Case: Create a new macOS, iOS, or iPadOS SwiftUI-first app repository with a reproducible project spec and integrated maintainer guidance.

Quick Start

Bootstrap a new SwiftUI XcodeGen-backed app named MyApp in the current directory by providing name, destination, platform, ui_stack, and project_generator to the workflow.

Frequently Asked Questions about bootstrap-xcode-app-project

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

FAQPage Schema
How do I scaffold a reproducible SwiftUI Xcode project repository?

You can scaffold a reproducible SwiftUI Xcode project by generating a deterministic XcodeGen-backed project.yml, source files, and unit-test targets, avoiding manual Xcode project setup and inconsistent project files.

Can I bootstrap an iOS or iPadOS app repository with XcodeGen?

Yes, you can use it to bootstrap an iOS or iPadOS SwiftUI-first app repository. The scaffold applies to native Apple apps across macOS, iOS, and iPadOS, generating the project spec and maintainer guidance.

Do I need xcodegen and xcodebuild installed to create an Xcode app scaffold?

You need xcodegen installed to generate the project. The tool validates prerequisites, and while xcodebuild is used for validation when available, the scaffold provides guided fallbacks if it is missing.

What is included when bootstrapping an XcodeGen-backed app repository?

Bootstrapping an XcodeGen-backed app repository includes generating a project.yml, source and test files, installing a repo-maintenance toolkit, copying AGENTS.md, and running xcodegen generate.

Will scaffolding a new Xcode project overwrite my existing repository files?

No, scaffolding a new Xcode project will not overwrite existing files. The tool refuses destructive overwrites and returns clear next steps for guided Xcode flows to protect your current repository.