Agent 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

Migrate to Tuist

Migrates existing Xcode projects to Tuist-generated workspaces with build and run validation, external dependency mapping, and migration checklists.

SKILL_NAME=tuist-migrate
SKILL_URL=https://tuist.dev/skills/migrate/SKILL.md

Installation

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

npx skills add tuist/agent-skills

You can also install a specific skill or target a specific agent:

# 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
npx skills add tuist/agent-skills -g

Manual installation

Each coding agent has its own mechanism for loading skills. If you prefer not to use the skills CLI, you can download SKILL.md files directly. The examples below use $SKILL_NAME and $SKILL_URL variables listed alongside each skill above.

Claude Code

Claude Code loads skills from SKILL.md files inside a skills/ directory.

Project:

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

Global:

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

Once installed, invoke it with /$SKILL_NAME inside a Claude Code session.

Codex

Codex loads skills from SKILL.md files inside a skills/ directory. It searches the repository root, current working directory, and parent folders.

Project:

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

Global:

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

Amp

Amp supports skills through SKILL.md files in a skills/ directory, and also reads AGENTS.md for general instructions.

Project:

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

Global:

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

OpenCode

OpenCode loads skills from SKILL.md files inside a skills/ directory.

Project:

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

Global:

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

---

This repository is automatically updated from tuist/tuist.