Use when connecting to Xcode via MCP, using xcrun mcpbridge, or working with ANY Xcode MCP tool (XcodeRead, BuildProject, RunTests, RenderPreview). Covers setup, tool reference, workflow patterns, troubleshooting.
Routes Xcode MCP interactions to specialized skills for setup, tools, and reference.
npx claudepluginhub charleswiltgen/axiomThis skill inherits all available tools. When active, it can use any tool Claude has access to.
You MUST use this skill for ANY Xcode MCP interaction — setup, tool usage, workflow patterns, or troubleshooting.
Xcode 26.3 ships an MCP server (xcrun mcpbridge) that exposes 20 IDE tools to external AI clients. This router directs you to the right specialized skill.
Use this router when:
xcrun mcpbridge for any MCP clientTriggers:
MCP_XCODE_PID)Invoke: /skill axiom-xcode-mcp-setup
Triggers:
xcodebuild)XcodeRM, XcodeMV)Invoke: /skill axiom-xcode-mcp-tools
Triggers:
Invoke: /skill axiom-xcode-mcp-ref
digraph xcode_mcp_router {
rankdir=TB;
"User has Xcode MCP question" [shape=ellipse];
"Setup or connection?" [shape=diamond];
"Using tools or workflows?" [shape=diamond];
"Need specific tool params?" [shape=diamond];
"xcode-mcp-setup" [shape=box];
"xcode-mcp-tools" [shape=box];
"xcode-mcp-ref" [shape=box];
"User has Xcode MCP question" -> "Setup or connection?";
"Setup or connection?" -> "xcode-mcp-setup" [label="yes"];
"Setup or connection?" -> "Using tools or workflows?" [label="no"];
"Using tools or workflows?" -> "xcode-mcp-tools" [label="yes"];
"Using tools or workflows?" -> "Need specific tool params?" [label="no"];
"Need specific tool params?" -> "xcode-mcp-ref" [label="yes"];
"Need specific tool params?" -> "xcode-mcp-tools" [label="general question"];
}
| Thought | Reality |
|---|---|
| "I'll just use xcodebuild directly" | MCP gives IDE state, diagnostics, previews, and navigator issues that CLI doesn't expose |
| "I already know how to set up MCP" | Client configs differ. Permission dialog behavior is specific. Check setup skill. |
| "I can figure out the tool params" | Tool schemas have required fields and gotchas. Check ref skill. |
| "Tab identifiers are obvious" | Most tools fail silently without correct tabIdentifier. Tools skill explains targeting. |
| "This is just file reading, I'll use Read tool" | XcodeRead sees Xcode's project view including generated files and resolved packages |
| Domain | Owner | Why |
|---|---|---|
| MCP-specific interaction (mcpbridge, MCP tools, tab identifiers) | xcode-mcp | MCP protocol and tool-specific |
| Xcode environment (Derived Data, zombie processes, simulators) | ios-build | Environment diagnostics, not MCP |
| Apple's bundled documentation (for-LLM guides/diagnostics) | apple-docs | Bundled docs, not MCP tool |
DocumentationSearch MCP tool usage specifically | xcode-mcp | MCP tool invocation |
| Build failures diagnosed via CLI | ios-build | Traditional build debugging |
| Build failures diagnosed via MCP tools | xcode-mcp | MCP workflow patterns |
User: "How do I set up Xcode MCP with Claude Code?"
-> Invoke: /skill axiom-xcode-mcp-setup
User: "How do I build my project using MCP tools?"
-> Invoke: /skill axiom-xcode-mcp-tools
User: "What parameters does BuildProject take?"
-> Invoke: /skill axiom-xcode-mcp-ref
User: "My mcpbridge connection keeps failing"
-> Invoke: /skill axiom-xcode-mcp-setup
User: "How do I target a specific Xcode window?"
-> Invoke: /skill axiom-xcode-mcp-tools
User: "Can I render SwiftUI previews via MCP?"
-> Invoke: /skill axiom-xcode-mcp-tools (workflow), then /skill axiom-xcode-mcp-ref (params)
User: "Cursor can't parse Xcode's MCP responses"
-> Invoke: /skill axiom-xcode-mcp-setup (schema compliance section)
Skills: xcode-mcp-setup, xcode-mcp-tools, xcode-mcp-ref
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.