Migrating To Tuist Generated Projects
If you're moving an existing Xcode project to Tuist's project generation system, this skill walks Claude through the migration process step by step. It covers the essentials: baselining your current build, inventorying targets and dependencies, creating the necessary Tuist configuration files, extracting build settings into xcconfig files, and validating everything still compiles and runs. The approach is methodical, starting with xcodebuild verification before touching anything, then iterating through generation and fixing build issues until you've got a working Tuist setup. This is straight infrastructure work that benefits from having the checklist and file structure spelled out, since migrating build systems always surfaces edge cases in your project configuration.
- skills.sh installs
- 513
- GitHub stars
- 35
- last updated
- Aug 21, 2026
Install
$ npx -y skills add tuist/agent-skills --skill migrating-to-tuist-generated-projects --agent claude-codeInstalls into .claude/skills of the current project.
Files
Migrating to Tuist Generated Projects
Quick Start
- Baseline build and run the app with xcodebuild.
- Inventory targets, build settings, and external dependencies.
- Create
Tuist.swift,Project.swift, andTuist/Package.swift. - Extract settings into
.xcconfigfiles and wire them inProject.swift. - Generate and build:
tuist generate --no-openthenxcodebuild build. - Fix build issues, regenerate, and validate runtime on a simulator.
Preflight Checklist
- Primary app scheme and any extension/test schemes
- Targets list (app, extensions, tests, helper tools)
- Deployment targets and bundle identifiers
- Info.plist locations and entitlements
- Custom build settings (per target and per configuration)
- External dependencies (SPM, XCFrameworks, local packages)
- Build scripts (SwiftGen, Sourcery, codegen)
- Runtime validation plan (simulator destination and launch command)
Outputs
Project.swiftandTuist.swiftTuist/Package.swiftfor external dependencies.xcconfigfiles (optional but recommended)- Build and runtime validation notes
- A short migration log of decisions and fixes
Migration Workflow
1. Baseline the project
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/tuist/agent-skills
- Categories
- DevOps & CI/CD, AI & Agent Building, Mobile Development
- First seen
- Jun 3, 2026
More from tuist/agent-skills
All 9Recommended
More DevOps & CI/CD
command-guidealirezarezvani/claude-skillsClaude Code Command Selection Guide - Automatically recommend and select the right commands, agents, and skills in Claude Code. Use when: (1) user is unsure whi512skills.sh installs
linkedin-sales-navigator-altonewave-ai/claude-skillsBuild targeted prospect lists by analyzing LinkedIn profiles, extracting job titles, companies, locations, and recent activity. Identifies decision-makers, trac510skills.sh installs
react-native-appaj-geddes/useful-ai-promptsBuild cross-platform mobile apps with React Native. Covers navigation with React Navigation, state management with Redux/Context API, API integration, and platf508skills.sh installs
bubbleteaggprompts/tfeBuild terminal user interfaces with Go and Bubbletea framework. Use for creating TUI apps with the Elm architecture, dual-pane layouts, accordion modes, mouse/k505skills.sh installs
accessibilityjezweb/claude-skillsBuild WCAG 2.1 AA compliant websites with semantic HTML, proper ARIA, focus management, and screen reader support. Includes color contrast (4.5:1 text), keyboar505skills.sh installsplaywright-localjezweb/claude-skillsBuild browser automation and web scraping with Playwright on your local machine. Prevents 10 documented errors including CI timeout hangs, extension testing fai505skills.sh installs