# build-dmg

build-dmg turns an Xcode project into a signed, distributable DMG: it resolves the scheme and team, then archives, exports and packages through a bundled script.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 135 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/build-dmg/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/build-dmg

## What it does

The skill takes a Mac app from Xcode project to a DMG you can hand out. It scans the repo first: app name, scheme, path to the `.xcodeproj` or `.xcworkspace`, any `ExportOptions.plist`, a `VERSION` file, signing hints already in place. Anything ambiguous gets a question before the build starts, not after it fails.

The work itself runs through `helpers/build-dmg.sh` from the project root: archive, export, packaging. `APP_NAME` and `SCHEME` are required; `PROJECT`, `WORKSPACE`, `TEAM_ID`, `EXPORT_OPTIONS`, `USE_XCODEGEN`, `DMG_BACKGROUND` and `VERSION_FILE` go in only when the project needs them. A `project.yml` means the project is regenerated with `xcodegen generate` first.

Signing is where it stays careful. It won't invent an identity, and `ExportOptions.plist` stays untouched without approval, since a bad export configuration ships something unsigned or aimed at the wrong distribution channel. With several schemes it asks which one to build. You get back the DMG path, app version and signing status; on failure you get the blocker category — signing, scheme, export options or the build itself.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill build-dmg -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill build-dmg -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill build-dmg -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills build-dmg
```

2. **Manually: put the files in place**
- File: `.github/skills/build-dmg/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill build-dmg -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path build-dmg
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill build-dmg -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/ulpi-io/skills/tree/HEAD/build-dmg/SKILL.md

## When to use it
- package a macOS app into a DMG without hand-writing xcodebuild steps
- pick the right scheme when the project has several
- regenerate the Xcode project with xcodegen before archiving
- tell a signing failure apart from an export-options failure
- get the DMG path and version after the build

## Example prompts
- Build a DMG from this Xcode project
- Package the Mac app as a signed installer, scheme `MyApp`
- Run the build-dmg skill for `App.xcworkspace`

## Similar
- [macos-build](https://affpapa.org/en/nevibecode/skills/macos-build.md) — skill · 732 installs
- [xcode-build-benchmark](https://affpapa.org/en/nevibecode/skills/xcode-build-benchmark.md) — skill · 3500 installs
- [developing-ios-apps](https://affpapa.org/en/nevibecode/skills/developing-ios-apps.md) — skill · 1600 installs
- [asc-xcode-build](https://affpapa.org/en/nevibecode/skills/asc-xcode-build.md) — skill · 8000 installs
- [axiom-build](https://affpapa.org/en/nevibecode/skills/axiom-build.md) — skill · 1400 installs
- [build-swiftui-interface](https://affpapa.org/en/nevibecode/skills/build-swiftui-interface.md) — skill · ★ 51 repo stars

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 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
