Xcode MCP First Executor

Use this skill when a task can be performed through Xcode MCP.

Core Rules

• Resolve target workspace by workspacePath from XcodeListWindows .

• 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.md

• references/mcp-failure-handoff.md

• references/mutation-via-mcp.md

Interactive Customization Flow

• Load current effective customization settings first:

• uv run python scripts/customization_config.py effective

• Ask targeted customization questions:

• Use references/customization-flow.md to drive knob-by-knob questions.

• Confirm desired behavior changes and safety constraints.

• Map requested changes to implementation files:

• Update SKILL.md , references/* , and any runtime script files listed in references/customization-flow.md .

• Persist durable customization state:

• Start from customization.template.yaml defaults.

• Apply approved overrides with uv run python scripts/customization_config.py apply --input <yaml-file> .

• Durable path: ~/.config/gaelic-ghost/apple-dev-skills/<skill-name>/customization.yaml .

• Optional override root: APPLE_DEV_SKILLS_CONFIG_HOME .

• Report resulting effective configuration:

• Re-run uv run python scripts/customization_config.py effective and summarize final active settings.

• If the user asks to remove customization state, run uv run python scripts/customization_config.py reset .

Use references/customization-flow.md for skill-specific knobs, file mapping, guardrails, validation checks, and example requests.