# Xcuitest Real Device Config > Prepare real iOS or tvOS devices for Appium XCUITest by validating readiness, provisioning, signing, WebDriverAgent deployment, and connectivity. Use only after setup-xcuitest completes shared XCUITest prerequisites and continues to this Skill for a real-device target. Do not use for general XCUITest setup or later runtime failures unrelated to signing or WebDriverAgent deployment. - **Type:** Skill - **Install:** `agentstack add skill-appium-skills-xcuitest-real-device-config` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [appium](https://agentstack.voostack.com/s/appium) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** Apache-2.0 - **Upstream author:** [appium](https://github.com/appium) - **Source:** https://github.com/appium/skills/tree/main/skills/xcuitest-real-device-config ## Install ```sh agentstack add skill-appium-skills-xcuitest-real-device-config ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # XCUITest Real-Device Configuration Workflow ## Real-device routing and handoffs This workflow covers real iOS or tvOS trust, Developer Mode, signing, provisioning, WebDriverAgent installation, prebuilt or preinstalled WDA, and use of a running WDA endpoint. Enter only from `skills/setup-xcuitest/SKILL.md` after its shared prerequisite gates pass. Use `skills/appium-troubleshooting/SKILL.md` as a new published entrypoint for later runtime failures outside real-device signing or WDA deployment, not as a continuation owned by this workflow. ## Required inputs Confirm the iOS or tvOS device, global `appium` or explicitly requested local `npx appium` mode, host macOS and Xcode state, WebDriverAgent runtime route, device trust and Developer Mode state, relevant capabilities, and permissions for local signing or device checks. For routes that build, sign, or install WDA, confirm the signing option and locally available provisioning assets without requesting their secret contents. ## Workflow outline 1. Confirm the handoff evidence from `skills/setup-xcuitest/SKILL.md`, then load `contexts/tools/appium/real-device/xcuitest-readiness.md`. If the shared XCUITest prerequisite evidence is missing or failing, stop this continuation and report the setup blocker. 2. Select the WDA runtime route first. Load one signing profile only when this workflow will build, re-sign, install, or validate local WDA signing. Load no reuse profile for the default Appium-managed `xcodebuild` route; otherwise load exactly one matching prebuilt, preinstalled, or running-WDA URL profile. 3. Load the required real-device procedure, then load the required WDA runtime Context before executing any numbered step. Load the optional WDA preparation Context declared in metadata only when the selected route builds, modifies, signs, installs, or separately validates a local WDA bundle. Load the optional shared capability Context only when choosing or validating real-device capabilities. 4. Run the device, signing, provisioning, code-signature, deployment, and WDA connectivity checks required by the selected profiles. 5. Re-run the narrowest failed check after each approved change and record the evidence. ## Real-device safety and approval constraints - Keep Apple credentials, provisioning-profile contents, private keys, signing-archive contents, and passwords outside agent inputs and captured command output. Report device and signing identifiers only as redacted fingerprints or match/no-match results; if evidence cannot be sanitized, stop and ask the user to verify it locally. - Require explicit approval before privileged commands, trust changes, signing modifications, bundle changes, or device installation. - Preserve existing working signing and WDA deployment choices unless evidence requires a change. - Use global Appium mode by default and local `npx appium` only when explicitly requested. ## Completion criteria Complete build or install routes only when their applicable device, signing, provisioning, code-signature, deployment, and connectivity checks pass or are isolated as explicit manual blockers. After the shared macOS, XCUITest-driver, and device-visibility prerequisites pass, complete a running-WDA URL route when the endpoint is reachable and an Appium session attaches successfully; local WDA preparation, signing, and installation evidence is not required for that route. In every route, keep privileged or optional actions user-approved and report the validated configuration, sanitized evidence, and remaining manual actions. ## Evidence Example input: `Prepare a real iPhone for Appium XCUITest and verify WebDriverAgent can be installed.` Verify device trust, Developer Mode, signing assets, bundle IDs, WebDriverAgent deployment mode, and final connectivity before reporting readiness. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [appium](https://github.com/appium) - **Source:** [appium/skills](https://github.com/appium/skills) - **License:** Apache-2.0 Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-appium-skills-xcuitest-real-device-config - Seller: https://agentstack.voostack.com/s/appium - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.