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
Install
conorluddy/xclaude-plugin/xcode-workflows · repository language: TypeScript
git clone https://github.com/conorluddy/xclaude-plugin
cp -r xclaude-plugin/skills/xcode-workflows ~/.claude/skills/xcode-workflowsFrequently 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)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/xcode-workflows/SKILL.md