skills.rest
gaelic-ghost
gaelic-ghostCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

xcode-build-run-workflow

Inspect Xcode workspaces, run schemes, and guard .pbxproj edits.

6|Updated Apr 9, 2026
Search Tags:#workflow#build#swift#diagnostics#xcode#run#mutation
One-click install
npx skills add https://github.com/gaelic-ghost/socket --skill xcode-build-run-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xcode-build-run-workflow
Source: https://github.com/gaelic-ghost/socket/tree/main/plugins/apple-dev-skills/skills/xcode-build-run-workflow
Command: npx skills add https://github.com/gaelic-ghost/socket --skill xcode-build-run-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill tackles the complexity of managing builds, runs, and project integrity in Xcode workspaces, ensuring safe execution without risking corruption in testing or documentation-heavy tasks.

Core Features & Use Cases

  • Workspace Inspection and Builds: Handles scheme-aware builds, diagnostics, and toolchain checks via MCP or CLI fallbacks.
  • Guarded Mutations: Enforces safeguards for filesystem and .pbxproj edits, with explicit warnings for high-risk changes.
  • Use Case: For an iOS app developer debugging a build failure, use this Skill to inspect the workspace, run diagnostics on issues, and validate target membership after adding new files.

Quick Start

Use the xcode-build-run-workflow skill to build and run the main scheme in my Xcode project located at /Users/me/MyApp.xcodeproj.

Frequently Asked Questions about xcode-build-run-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an Xcode build and diagnose scheme failures?▼

To run an Xcode build and diagnose failures, this Skill executes scheme-aware builds and diagnostics via MCP-first execution with official CLI fallbacks. It inspects workspaces and surfaces diagnostic issues directly.

What is the safe way to edit .pbxproj files and verify target membership?▼

Safe .pbxproj edits require guarded mutations that enforce filesystem safeguards and issue explicit warnings for high-risk changes. This Skill verifies target file membership after adding files to prevent project corruption.

Can I manage toolchain checks and workspace inspection in Xcode projects?▼

Yes, you can manage toolchain checks and workspace inspection in Xcode projects. This Skill handles scheme execution, toolchain verification, and workspace inspection excluding primary testing tasks.

Does this workflow support MCP-first execution with CLI fallbacks for Swift builds?▼

Yes, this workflow supports MCP-first execution with official CLI fallbacks for Swift builds. It satisfies requirements for policy-driven handoffs to specialized skills during scheme execution and diagnostics.

When should I avoid using guarded mutations for Xcode project changes?▼

You should avoid using guarded mutations for primary testing tasks or documentation-heavy workflows, as this Skill explicitly excludes those scopes to prevent corruption and ensure safe execution.

What's the best way to handle build, run, and preview workflows in Xcode workspaces?▼

The best way to handle build, run, and preview workflows in Xcode workspaces is using this Skill for scheme-aware execution, diagnostics, and toolchain management. It applies policy-driven handoffs for specialized tasks.

Related Skills

Explore More Software Engineering Skills→
gaelic-ghostgaelic-ghost
6

sync-xcode-project-guidance

Synchronize AGENTS.md and Xcode workflow guidance for Apple app repositories.

Community
Intermediate
geekatrongeekatron
30

eng-team

Coordinates security-focused engineering across design, implementation and post-deployment stages via an 8-step workflow with ten specialized agents.

Community
Advanced
pradeepmoulipradeepmouli

axiom-build-debugging

Diagnose iOS build failures and dependency resolution issues for CocoaPods and Swift Package Manager.

Community
Advanced
no-problem-devno-problem-dev
5

ios-dev-workflow

Orchestrate iOS, Swift, and Xcode build, test, and diagnostic workflows via Xcode MCP or CLI sub-agents.

Official
Advanced