Using Tuist Generated Projects

If you're using Tuist to manage your Xcode projects, this skill helps Claude work with the generated workspaces and schemes. It covers the basics like generating projects without auto-launching Xcode, running xcodebuild commands for building and testing specific schemes, and working with Tuist's project structure conventions. The skill has passed all three major security audits and comes from Tuist's official agent-skills repo. It's straightforward reference material for CI/CD setups or when you need Claude to interact with your Tuist-generated build system instead of fumbling through workspace configurations manually.

skills.sh installs: 616
GitHub stars: 35
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tuist/agent-skills --skill using-tuist-generated-projects --agent claude-code

Installs into .claude/skills of the current project.

Files

Using Tuist Generated Projects

Quick Start

# Generate workspace without opening Xcode
tuist generate --no-open

# Build a scheme with xcodebuild
xcodebuild build -workspace App.xcworkspace -scheme App

# Run tests with xcodebuild
xcodebuild test -workspace App.xcworkspace -scheme AppTests -only-testing AppTests/MyTestCase

Project definition

Prefer buildable folders

Use buildableFolders instead of sources and resources globs. Buildable folders stay synchronized with the file system, so adding or removing files does not require regeneration.

let target = Target(
  name: "App",
  buildableFolders: [
    "App/Sources",
    "App/Resources",
  ]
)

Tag targets for focus

Use target tags to group areas of the project, for example:

tag:team:*
tag:feature:*
tag:layer:*

These tags make it easier to scope generation and testing later.

Example target metadata with tags:

let target = Target(
  name: "PaymentsUI",
  metadata: .metadata(tags: [
    "tag:team:commerce",
    "tag:feature:payments",
    "tag:layer:ui",
  ])
)

When working on a focused area, generate only what you need:

SKILL.md on GitHub