xcode-workflows
Xcode Workflows teaches you how to execute iOS build operations through the execute_xcode_command MCP tool, covering project discovery, building for simulators and devices, running unit and integration tests, and interpreting build results. The skill emphasizes using MCP tools instead of direct bash commands for all xcodebuild operations, and includes reference tables for common tasks, configuration options, and troubleshooting guidance for typical build failures.
Xcode Workflows provides MCP-based guidance for xcodebuild operations when building, testing, and troubleshooting iOS projects.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-02-07
Xcode Workflows provides MCP-based guidance for xcodebuild operations when building, testing, and troubleshooting iOS projects. Xcode Workflows teaches you how to execute iOS build operations through the execute_xcode_command MCP tool, covering project discovery, building for simulators and devices, running unit and integration tests, and interpreting build results. The skill emphasizes using MCP tools instead of direct bash commands for all xcodebuild operations, and includes reference tables for common tasks, configuration options, and troubleshooting guidance for typical build failures.
Use it when
- Xcode Workflows addresses scheme discovery as a foundational step.
- Xcode Workflows covers running unit and UI tests via the execute_xcode_command MCP tool.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
conorluddy/xclaude-plugin/xcode-workflows · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to build iOS app with xcodebuild using Xcode Workflows?
Xcode Workflows teaches you to build iOS apps through the execute_xcode_command MCP tool. Start by discovering your project's schemes and destinations, then invoke the tool with your chosen scheme and destination (simulator or device). The skill covers project structure discovery, build configuration selection, and interpreting build output to identify success or failure.
What should I do when xcodebuild scheme not found error occurs?
Xcode Workflows addresses scheme discovery as a foundational step. Use the execute_xcode_command tool to list available schemes in your project first. Common causes include typos in scheme names, schemes not marked as shared, or building from the wrong project directory. The skill includes troubleshooting guidance for resolving scheme-related errors.
How do I run and debug tests using Xcode Workflows?
Xcode Workflows covers running unit and UI tests via the execute_xcode_command MCP tool. You can run all tests, filter by specific test targets, or execute individual test cases. The skill teaches test failure debugging, log interpretation, and how to configure test destinations for both simulators and physical devices.
Can Xcode Workflows help integrate iOS builds into CI/CD pipelines?
Yes. Xcode Workflows emphasizes using MCP tools instead of direct bash commands for all xcodebuild operations, making it ideal for CI/CD automation. The skill covers build configuration, code signing setup, parallel builds, derived data caching strategies, and pipeline integration patterns for reliable automated iOS builds.
How does Xcode Workflows handle code signing and build configuration?
Xcode Workflows provides reference tables and configuration guidance for code signing identities, provisioning profiles, and build settings. The skill teaches how to specify signing identities through execute_xcode_command parameters, manage debug vs. release configurations, and troubleshoot signing-related build failures.
What are the key differences between simulator and device build destinations?
Xcode Workflows explains that simulator builds target x86_64 or arm64 architectures depending on your Mac, while device builds require valid code signing. The skill covers selecting appropriate destinations, handling architecture mismatches, and troubleshooting device-specific build errors through the execute_xcode_command tool.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Xcode Workflows
Use the execute_xcode_command MCP tool for all iOS build operations
The xclaude-plugin provides the execute_xcode_command MCP tool which consolidates all xcodebuild operations into a single, token-efficient dispatcher.
⚠️ CRITICAL: Always Use MCP Tools First
This is the most important rule: When working with iOS builds, you MUST use the execute_xcode_command MCP tool.
- ✅ DO: Invoke
execute_xcode_commandfor all build/test/clean operations - ✅ DO: If the MCP tool fails, adjust parameters and retry
- ✅ DO: Read error messages and debug the parameters
- ❌ NEVER: Fall back to bash
xcodebuildcommands - ❌ NEVER: Use
xcodebuilddirectly in bash - ❌ NEVER: Run
xcrun xcodebuildin a terminal
Why? The MCP tool provides:
- Structured error handling
- Token efficiency (consolidated into 1 tool vs. verbose bash
(truncated - see the full file via the links below)
File tree — 1 file
skills/xcode-workflows/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Build iOS projects using xcodebuild command-line operations”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
iOS Testing Patterns provides structured workflows for running unit and UI tests on simulators, analyzing results, and identifying intermittent failures. It covers test filtering, parallel execution across multiple devices, and strategies for isolating and debugging unreliable tests.
Automate iOS simulator device management directly within Claude conversations. This skill provides streamlined control over simulator lifecycle operations—launching, provisioning, and removing devices—without leaving your development environment. Designed for developers who want to integrate simulator management into their AI-assisted workflows.
simulator-utils streamlines iOS development by automating screenshot capture and resizing within the simulator environment. Perfect for testing UI consistency across different device configurations and verifying API compatibility without manual image processing. Works seamlessly with Claude Code and other coding agents to accelerate your iOS workflow.
This skill streamlines iOS quality assurance by automating test runs through xcodebuild and simulator environments. It handles both unit and UI testing scenarios, enabling developers to validate app behavior consistently across test suites. Integrate it into your CI/CD pipeline for repeatable, reliable test execution.
xcode-build equips your agent with direct access to Xcode's command-line utilities for iOS and macOS development. Control app builds, simulator management, and project workflows without intermediary servers—leveraging xcodebuild and xcrun simctl for native platform integration.
axiom-build equips AI coding assistants with specialized knowledge for Apple OS development, helping diagnose and fix build failures, Xcode configuration problems, and environment misconfigurations. Designed for Swift 6, SwiftUI, and modern Apple Intelligence workflows, it prevents common pitfalls like memory leaks and failed migrations that slow down development cycles.