Agent skill
xcode-mcp-first-executor
Execute Apple and Swift tasks through Xcode MCP tools first, with strict workspacePath-based tab resolution and structured fallback handoff when MCP tools are unavailable, time out, or cannot satisfy the requested operation.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/xcode-mcp-first-executor
SKILL.md
Xcode MCP First Executor
Use this skill when a task can be performed through Xcode MCP.
Core Rules
- Resolve target workspace by
workspacePathfromXcodeListWindows. - Do not trust stale tab index assumptions.
- Use MCP tools first for supported actions.
- If MCP fails after retry policy, output structured handoff to
$apple-swift-cli-fallback.
Workflow
- Resolve active tab:
- call
XcodeListWindows - pick tab by matching
workspacePath
- Execute via MCP matrix:
- use
references/mcp-tool-matrix.md
- Retry on transient MCP failures:
- one immediate retry for timeout or transport error
- if still failing, generate fallback handoff payload
- Handoff payload:
- include intent category
- include preferred official CLI command(s)
- include reason MCP path failed
Mutation Note
For mutation requests in Xcode-managed scope, continue through MCP mutation tools if available. If falling back to direct filesystem edits, route to $apple-dev-safety-and-docs first.
References
references/mcp-tool-matrix.mdreferences/mcp-failure-handoff.mdreferences/mutation-via-mcp.md
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?