Build Swift Apps

Build Swift Apps

Agent skills for building, debugging, profiling, testing, refactoring, and shipping Swift apps across Apple platforms.

Codex · Claude Code · Cursor · pi · Manual skill installs

Build Swift Apps is the Swift-focused plugin from Plug'n Skills. Use this repository when you want only the Swift, iOS, macOS, Xcode, simulator, and App Store workflows. Use Plug'n Skills when you want the full multi-plugin collection.

Build Swift Apps is a multi-agent skill pack for practical Apple-platform development. It focuses on the workflows that usually decide whether an AI coding session is useful in a real Swift repository: building the app, running it on a simulator, understanding failures, improving SwiftUI and AppKit code, profiling performance, auditing Xcode build times, and preparing apps for release.

The deepest coverage is for iOS and macOS, but the skills are written for Apple-platform Swift work in general. They are intentionally generic: no private project names, no private workflows, and no assumptions about one app architecture.

Repository Role

This repository is intentionally still active. It is the focused public entrypoint and install surface for Swift developers. The broader hub is Xopoko/plug-n-skills, where this same plugin lives under plugins/build-swift-apps alongside other focused agent skill packs.

For users, both install paths are valid:

• install this repository when you only want Build Swift Apps;
• install Plug'n Skills when you want the full curated plugin collection;
• link to this repository from Swift-specific posts, docs, and examples.

Quick Start

Easiest: Ask Your Agent

For most users, the simplest install path is to paste this prompt into the coding agent they already use:

Install the Build Swift Apps plugin from https://github.com/Xopoko/build-swift-apps on this computer. Follow the repository installation instructions for the agent you are running in, install required dependencies, ask before installing optional tools, run the doctor checks, and report what was installed.

If you want the whole plugin collection instead, ask your agent to install Plug'n Skills from https://github.com/Xopoko/plug-n-skills.

Codex

mkdir -p "$HOME/.agents/plugins/plugins"
git clone https://github.com/Xopoko/build-swift-apps.git \
  "$HOME/.agents/plugins/plugins/build-swift-apps"
cd "$HOME/.agents/plugins/plugins/build-swift-apps"

./scripts/install-local-plugin.sh
./scripts/doctor.sh --profile core --profile mcp

Then start a new Codex thread and ask for a focused workflow:

Use the iOS debugger skill to build and run this app on a simulator, inspect the first screen, and summarize any runtime failures.

Claude Code

This repository includes Claude Code plugin metadata under .claude-plugin/. After the repository is public or accessible to your GitHub account:

/plugin marketplace add Xopoko/build-swift-apps
/plugin install build-swift-apps@build-swift-apps
/reload-plugins

If you use the appstore-screenshot-studio skill in Claude Code, install its local Node helper dependency after the plugin is installed:

cd "$HOME/.claude/plugins/marketplaces/build-swift-apps"
./scripts/install-deps.sh --profile screenshots --yes

Claude Code namespaces plugin skills, so invoke them as /build-swift-apps:<skill-name> when calling skills explicitly.

Cursor

This repository includes Cursor plugin metadata under .cursor-plugin/. Use Cursor's plugin install or local testing flow once the repository is available to your Cursor workspace. The same skills/ directory is packaged for Cursor, and AGENTS.md provides repository-level guidance for agents that read the open instruction format.

Dependency Check

The skills can run with partial dependencies. Check the current machine first:

./scripts/doctor.sh --all

Install only the tool groups you need:

./scripts/install-deps.sh --profile core --profile mcp
./scripts/install-deps.sh --profile tuist --profile performance --dry-run
./scripts/install-deps.sh --all --skip ettrace --skip ipsw

See docs/INSTALL.md for full install instructions, dependency profiles, and manual setup notes.

Token Efficiency

Build Swift Apps is designed to keep startup context small. In Codex-style skill loading, the agent starts with lightweight skill metadata: the skill name, description, and file pointer. The full SKILL.md body is loaded only when that skill is selected for the current task.