skill CX Codex

macos-build — Claude Code skill: what it does, how to install

Q: How to install macos-build in Claude Code?

Run `npx skills add fayazara/macos-app-skills --skill macos-build -a claude-code` in your terminal.

Q: How does it handle missing package dependencies?

It advises running `xcodebuild -resolvePackageDependencies` first to resolve SPM packages before building.

Directs AI agents to compile native macOS apps using xcodebuild and diagnose build errors from the terminal.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add fayazara/macos-app-skills --skill macos-build -a claude-code
npx skills add fayazara/macos-app-skills --skill build -a claude-code

Open on GitHub

What macos-build does

This skill guides coding agents through locating .xcodeproj or .xcworkspace files and listing available build schemes. When invoked, the agent runs xcodebuild with Debug configuration targeting the macOS platform, filtering terminal output to highlight compilation errors and line numbers.

It also addresses toolchain issues such as unresolved Swift Package Manager dependencies and code signing settings. Guidance includes selecting alternate toolchains via DEVELOPER_DIR for beta SDKs. If Xcode or command-line developer tools are missing on the host, build commands will fail immediately.

What it helps with

compile native macOS projects via command-line xcodebuild
verify code changes compile without launch errors
inspect available schemes inside xcodeproj and xcworkspace
diagnose Swift compiler errors from filtered terminal logs

Example prompts for the agent

Build the macOS app and check if it compiles
Run xcodebuild to verify my recent code changes
Fix build errors and run a debug build

How to install macos-build

1Skills CLI (Vercel)

npx skills add fayazara/macos-app-skills --skill macos-build -a claude-code

npx skills add fayazara/macos-app-skills --skill build -a claude-code

2Manually: put the files in place

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

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

1Skills CLI (Vercel)

npx skills add fayazara/macos-app-skills --skill build -a codex

2Manually: put the files in place

.agents/skills/build/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add fayazara/macos-app-skills --skill build -a cursor

2Manually: put the files in place

.cursor/skills/build/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install fayazara/macos-app-skills build

2Manually: put the files in place

.github/skills/build/SKILL.md

1Skills CLI (Vercel)

npx skills add fayazara/macos-app-skills --skill build -a gemini-cli

2Platform CLI

gemini skills install https://github.com/fayazara/macos-app-skills --path build

Manually: put the files in place

.devin/skills/build/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add fayazara/macos-app-skills --skill build -a opencode

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

Questions about macos-build

How to install macos-build in Claude Code?

Run npx skills add fayazara/macos-app-skills --skill macos-build -a claude-code in your terminal.

What does macos-build do?

It instructs agents how to locate Xcode projects, execute debug builds with xcodebuild, and isolate compilation issues.

How does it handle missing package dependencies?

It advises running xcodebuild -resolvePackageDependencies first to resolve SPM packages before building.

build-macos-apps official OpenAI A Claude plugin bundling macOS-first workflows: build, run, test, debug, sign and instrument local desktop apps. CX Codex GP ChatGPT ★ 7,596repo stars axiom-build CharlesWiltgen Routes iOS and macOS build failures, simulator hangs, and Xcode environment glitches before touching application code. CX Codex +1 1,300installs build-run-debug official OpenAI Build, launch, and debug macOS apps through a shell-first Xcode and Swift workflow when startup or runtime failures need investigation. CX Codex GP ChatGPT 60installs xcode-build-benchmark AvdLee Measures clean, cached clean, and incremental Xcode builds with repeatable inputs. Use it to establish a baseline or compare build time after changes. CX Codex +1 3,400installs macos-spm-app-packaging Dimillian A skill that scaffolds, builds and packages SwiftPM macOS apps without an Xcode project, from the starter layout to signing and notarization. CX Codex +1 1,400installs asc-xcode-build rorkai Teaches your agent to drive the asc CLI for Xcode archives, IPA and PKG export, and version bumps. Useful when a build has to reach App Store Connect or TestFlight. CX Codex +1 7,600installs

From the same set3

macos-patterns Guides native macOS app work with menu bar UI, windows, focus behaviour and platform-specific APIs. CX Codex +1 670installs macos-settings-ui Builds a native macOS settings window in SwiftUI: sidebar, grouped Form panes and liquid glass window chrome for macOS 26. CX Codex +1 650installs