# debug-generated-project

Troubleshoots Tuist project generation failures, build errors, and runtime crashes. It sets up isolated reproductions and verifies fixes against the main branch.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 517 installs · ★ 35
- Author: tuist
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tuist/agent-skills/tree/HEAD/skills/debug-generated-project/SKILL.md
- Updated: 2026-03-27
- HTML: https://affpapa.org/en/nevibecode/skills/debug-generated-project

## What it does

The skill isolates Tuist project defects by asking for manifest files like `Project.swift`, the exact command run, and the failure stage. It builds a minimal isolated test case in a temporary directory, then executes `tuist generate` via `mise` against the newest public release.

When the problem persists, it checks out the Tuist source repository and builds both the CLI executable and `ProjectDescription` via `swift build`. After testing against `main`, it determines if the defect stems from project misconfigurations, such as wrong dependency types or bad glob paths, or an actual bug in the generator.

Full compile and runtime triage depends on local macOS tooling, requiring Xcode, `xcodebuild`, and an active iOS Simulator via `simctl`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill debug-generated-project -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/debug-generated-project/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/debug-generated-project/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill debug-generated-project -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/debug-generated-project/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill debug-generated-project -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/debug-generated-project/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tuist/agent-skills debug-generated-project
```

2. **Manually: put the files in place**
- File: `.github/skills/debug-generated-project/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill debug-generated-project -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tuist/agent-skills --path skills/debug-generated-project
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/debug-generated-project/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill debug-generated-project -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tuist/agent-skills/tree/HEAD/skills/debug-generated-project/SKILL.md

## When to use it
- diagnose manifest errors in Project.swift and Tuist.swift
- isolate generation bugs inside a clean temporary workspace
- test reproduction projects against the latest Tuist source code
- trace runtime app crashes on an iOS simulator via simctl

## Example prompts
- Debug why tuist generate fails on my external package dependencies
- The project generated by Tuist fails to compile in Xcode, help triage the error
- My app crashes immediately on launch after running tuist generate

## Similar
- [vercel-react-native-skills](https://affpapa.org/en/nevibecode/skills/vercel-react-native-skills.md) — skill · 255200 installs
- [animate-expo](https://affpapa.org/en/nevibecode/skills/animate-expo.md) — skill · 137900 installs
- [mobile-native](https://affpapa.org/en/nevibecode/skills/mobile-native.md) — skill · 86600 installs
- [aso](https://affpapa.org/en/nevibecode/skills/aso.md) — skill · 75400 installs
- [swiftui-pro](https://affpapa.org/en/nevibecode/skills/swiftui-pro.md) — skill · 35200 installs
- [orca-emulator](https://affpapa.org/en/nevibecode/skills/orca-emulator.md) — skill · 5800 installs

From the same set: [tuist/agent-skills](https://affpapa.org/en/nevibecode/by/tuist/agent-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md