ce-test-xcode — Claude Code skill: what it does, how to install
Builds and exercises iOS apps on a simulator via XcodeBuildMCP, capturing logs and screen evidence before code handoff.
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a claude-codeWhat ce-test-xcode does
The skill automates iOS application checks inside a simulator. It verifies XcodeBuildMCP availability, discovers project schemes, compiles the build, installs the app, and starts log capture. Any setup failure before the app launches halts execution immediately with an actionable blocker report.
During execution, the agent walks designated surfaces, collecting screenshots, console errors, and human-verified outcomes. Status reporting relies entirely on collected evidence: PASS requires verified runs, FAIL holds until a successful retest, and PARTIAL indicates skipped scoped checks. It never touches source code directly. For diagnosis, it routes control to ce-debug with narrowed permissions that forbid commits, pushes, or pull requests.
Automation stops at SwiftUI inline links due to platform limitations, so those flows require human verification. You also must have XcodeBuildMCP configured beforehand, or the test runner halts on the first step.
What it helps with
- exercise iOS builds inside a simulator before code handoff
- capture console logs and screenshots as test evidence
- route run failures to
ce-debugwithout committing changes - record human-verification results for manual UI checks
Example prompts for the agent
- Run ce-test-xcode current to verify recent changes
- Test the iOS build using ce-test-xcode MyAppScheme
- ce-test-xcode: check the checkout flow and capture logs
How to install ce-test-xcode
1Skills CLI (Vercel)
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a claude-code2Manually: put the files in place
~/.claude/skills/ce-test-xcode/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ce-test-xcode/
1Skills CLI (Vercel)
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a codex2Manually: put the files in place
.agents/skills/ce-test-xcode/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a cursor2Manually: put the files in place
.cursor/skills/ce-test-xcode/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install EveryInc/compound-engineering-plugin ce-test-xcode2Manually: put the files in place
.github/skills/ce-test-xcode/SKILL.md1Skills CLI (Vercel)
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a gemini-cli2Platform CLI
gemini skills install https://github.com/EveryInc/compound-engineering-plugin --path skills/ce-test-xcodeManually: put the files in place
.devin/skills/ce-test-xcode/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set21
The whole set →Similar
Questions about ce-test-xcode
How to install ce-test-xcode in Claude Code?
Run npx skills add EveryInc/compound-engineering-plugin --skill ce-test-xcode -a claude-code.
What does ce-test-xcode do?
It compiles your iOS app, deploys it to a simulator via XcodeBuildMCP, captures screenshots and logs, and produces an evidence-backed test summary.
Can ce-test-xcode fix discovered bugs automatically?
No, the skill only tests and reports. It passes failures to ce-debug under restricted permissions that prevent automated git commits or PR creation.
Source text
SKILL.md · MIT
--- name: ce-test-xcode description: "Test iOS apps in a simulator with XcodeBuildMCP. Use when iOS changes need simulator evidence before handoff." argument-hint: "[scheme name or 'current' to use default]" disable-model-invocation: true --- # Xcode Simulator Test Build and exercise an iOS app on a simulator, preserving screenshots, logs, human-verification results, and failures as evidence for the user. **Done:** - A completed run reports overall `PASS`, `FAIL`, or `PARTIAL` plus project, scheme, simulator, build result, per-surface `PASS` / `FAIL` / `SKIP`, console errors, human checks, and residual failures. - Per-surface status is derived from evidence, not the user's routing choice. `PASS` requires completed passing evidence. `FAIL` records observed failing evidence until a completed retest replaces it. `SKIP` means the check has no completed outcome. - The overall result is `FAIL` while any failure remains, `PARTIAL` when no failure remains but a scoped check is skipped, and otherwise `PASS`. - Any failure before the app is launched with log capture running stops later stages and reports an actionable setup blocker with its evidence. **Boundaries:** this skill tests and reports. Diagnosis and any user-approved product fix belong to `ce-debug`, invoked with its authority narrowed so it returns here without committing, pushing, or opening a PR. Keep simulator interaction within the app and flows the user placed in scope. ## Run 1. **Prepare and launch.** Read `references/setup-and-build.md`. It defines the XcodeBuildMCP availability check, project and scheme discovery, simulator choice, build, install, launch, and log-capture start. 2. **Exercise and report.** After launch, read `references/test-and-report.md`. It defines per-screen evidence, human-only flows, the SwiftUI inline-link automation limitation, what to do when a check fails, cleanup, and the fixed summary fields. Do not replace either required read with remembered tool names. XcodeBuildMCP adapters differ by host, while their observable success conditions do not.
© EveryInc · MIT · EveryInc/compound-engineering-plugin