Skills

Skills are pre-built instruction sets for performing complex, multi-step Tuist tasks. Instead of manually guiding an agent through a migration or setup process, you install a skill and let the agent handle it.

Available skills

Skill	Description
`migrate`	Migrates existing Xcode projects to Tuist-generated workspaces with build and run validation, external dependency mapping, and migration checklists.
`generated-projects`	Guides day-to-day work in Tuist-generated workspaces: generation, build/test commands, and buildable folders.
`fix-flaky-tests`	Fixes flaky tests by analyzing failure patterns from Tuist test insights, identifying root causes, and applying targeted corrections.
`debug-generated-project`	Debugs issues with Tuist-generated projects by reproducing the scenario, building Tuist from source when needed, and triaging whether it is a bug, misconfiguration, or something that needs team input.
`compare-gradle-builds`	Compares two Gradle build runs to identify duration regressions, cache changes, and task outcome differences. Can be invoked with build IDs, dashboard URLs, or branch names.

Installation {#installation}

The recommended way to install Tuist skills is with the skills CLI. It detects your coding agents automatically and places the SKILL.md files in the right location.

Install all skills

npx skills add tuist/agent-skills

The interactive prompt lets you choose which skills and agents to install for.

Install a specific skill

npx skills add tuist/agent-skills --skill migrate

Install for a specific agent

npx skills add tuist/agent-skills -a claude-code

Install globally

Add the -g flag to install skills in your home directory so they are available across all projects:

npx skills add tuist/agent-skills -g

Update skills

npx skills update

Non-interactive (CI)

npx skills add tuist/agent-skills --all -y

Manual installation {#manual}

If you prefer not to use the skills CLI, you can download SKILL.md files directly. Set the variables for the skill you want and run the curl command for your agent:

SKILL_NAME=tuist-migrate          # or tuist-generated-projects
SKILL_URL=https://tuist.dev/skills/migrate/SKILL.md  # or .../generated-projects/SKILL.md

::: code-group

mkdir -p .claude/skills/$SKILL_NAME
curl -o .claude/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .codex/skills/$SKILL_NAME
curl -o .codex/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .agents/skills/$SKILL_NAME
curl -o .agents/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .opencode/skills/$SKILL_NAME
curl -o .opencode/skills/$SKILL_NAME/SKILL.md $SKILL_URL

:::