Skip to main content
skill CX Codex

build-dmg — Claude Code skill: signed macOS DMG from Xcode

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.

no license 135 installs ★ 5 updated 2026-08-31

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ulpi-io/skills --skill build-dmg -a claude-code
Open on GitHub

What build-dmg 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.

What it helps with

  • 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 for the agent

  • 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

How to install build-dmg

1Skills CLI (Vercel)

npx skills add ulpi-io/skills --skill build-dmg -a claude-code

2Manually: put the files in place

~/.claude/skills/build-dmg/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/build-dmg/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about build-dmg

How do I install build-dmg in Claude Code?

Run npx skills add ulpi-io/skills --skill build-dmg -a claude-code. The skill lands at ~/.claude/skills/build-dmg/SKILL.md.

What does build-dmg do?

It builds a macOS app into a DMG: resolves the scheme and signing inputs, runs archive and export through helpers/build-dmg.sh, then packages the result. You get the DMG path, version and signing status.

What has to be set before a build?

APP_NAME and SCHEME are required, while variables such as TEAM_ID or EXPORT_OPTIONS are added only when needed. The skill never guesses a scheme, team ID or export options; it asks when something is unclear.

Similar skills

All skills for DevOps and infrastructure →

From the same set49

The whole set →
kiro-review The kiro-review skill asks Kiro CLI to review a branch, commit, or uncommitted diff in read-only mode. Use it when you want an independent check of actual code changes. CX Codex +1 148installs run-parallel-agents-feature-build The run-parallel-agents-feature-build skill splits independent build work across agents, then checks their results. It is intended for tasks with at least three parallel lanes. CX Codex +1 145installs laravel Directs coding agents to follow your project backend standards across Laravel 13 and older releases instead of relying on default framework scaffolding. CX Codex +1 143installs codex-review codex-review — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that runs OpenAI Codex CLI as a separate reviewer against the real diff. Findings come back grouped by priority, not as raw CLI output. CX Codex +1 140installs rust Guides agents through systems-level Rust conventions for storage engines, tokio, and binary data. Keeps changes aligned with workspace rules. CX Codex +1 133installs lokei lokei — a skill for local development that runs applications on trusted HTTPS .test domains instead of localhost:port. CX Codex +1 132installs nestjs Guides AI agents through NestJS module design using project-specific dependency injection, thin controllers, and class-validator DTOs. CX Codex +1 129installs browse-stealth The browse-stealth skill runs Camoufox through the browse CLI to inspect and use sites that block ordinary browser automation. Reach for it when a page shows a CAPTCHA, a 403, or a browser challenge. CX Codex +1 126installs

Project sponsors

Companies that keep this analytics open