setup-xcuitest

Stars13

Forks4

UpdatedJuly 23, 2026 at 06:39

Prepare and verify Appium XCUITest for iOS or tvOS on macOS by validating Node/Appium, Xcode, driver installation, doctor output, simulator or shared real-device prerequisites, and server smoke evidence. Use when the setup Skill selects XCUITest or appium-troubleshooting hands off an XCUITest prerequisite or doctor failure. For a real device, continue to xcuitest-real-device-config after this Skill passes. Do not use for real-device signing, provisioning, or WebDriverAgent deployment.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

appium

appium/skills

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

name	setup-xcuitest
description	Prepare and verify Appium XCUITest for iOS or tvOS on macOS by validating Node/Appium, Xcode, driver installation, doctor output, simulator or shared real-device prerequisites, and server smoke evidence. Use when the setup Skill selects XCUITest or appium-troubleshooting hands off an XCUITest prerequisite or doctor failure. For a real device, continue to xcuitest-real-device-config after this Skill passes. Do not use for real-device signing, provisioning, or WebDriverAgent deployment.
metadata	{"renma.id":"skill.setup-xcuitest","renma.continues-with":"[\"skill.xcuitest-real-device-config\"]","renma.title":"XCUITest Setup Workflow","renma.owner":"appium","renma.tags":"[\"setup\",\"xcuitest\",\"ios\",\"tvos\"]","renma.requires-context":"[\"contexts/platform/macos/profile.md\",\"contexts/tools/appium/setup/profiles/xcuitest.md\",\"contexts/tools/appium/setup-basics.md\",\"contexts/platform/macos/xcode-prereqs.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-driver-doctor.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-smoke-status.md\"]","renma.optional-context":"[\"contexts/tools/appium/setup/profiles/global-appium.md\",\"contexts/tools/appium/setup/profiles/local-npx.md\",\"contexts/tools/appium/setup/examples/xcuitest.md\",\"contexts/tools/appium/capabilities.md\",\"contexts/tools/ffmpeg/setup.md\"]","renma.security-profile":"appium-local-workflows"}

XCUITest Setup Workflow

XCUITest setup routing and handoffs

Prepare shared Appium XCUITest prerequisites for iOS or tvOS. For a simulator, complete this Skill after doctor and smoke checks pass. For a real device, complete these shared prerequisites first and then continue with skills/xcuitest-real-device-config/SKILL.md for trust, Developer Mode, signing, provisioning, WebDriverAgent deployment, and connectivity. Hand later runtime failures to skills/appium-troubleshooting/SKILL.md.

Required inputs

Confirm iOS or tvOS, simulator or real device, macOS host, global appium mode or explicitly requested local npx appium mode, Xcode state, permissions, and optional FFmpeg requests.

Workflow outline

Load the global command profile by default or the local profile only when explicitly requested.
Load the macOS and XCUITest profiles, shared Appium setup basics, Xcode prerequisites, and XCUITest decision, driver-doctor, and smoke references.
Run node tools/appium/setup/scripts/check-xcuitest-env.mjs; pass --appium-mode local only for local mode. Use summary.requiredOk: true as the read-only setup gate.
Apply required fixes in technical dependency order and rerun the affected check.
Run the XCUITest doctor and server smoke checks. Load the matching example only when it clarifies execution.
If the target is a real device, continue to the real-device Skill only after these shared prerequisites pass.

XCUITest setup safety and approval constraints

Require macOS.
Ask before optional FFmpeg setup, privileged commands, Xcode license or first-launch changes, trust changes, signing changes, or device installation.
Leave real-device signing, provisioning, and WDA deployment to the real-device Skill.
Preserve the selected command mode and working Xcode and driver installations.

Completion criteria

xcodebuild -version and xcode-select -p succeed.
Xcode license and first-launch requirements are handled.
Appium succeeds in the selected command mode and the installed list includes xcuitest.
appium driver doctor xcuitest reports 0 required fixes needed; optional warnings are non-blocking.
/status succeeds and logs list xcuitest.
For a real-device request, the exact continuation to skill.xcuitest-real-device-config is reported after shared setup passes.

Evidence boundary

Report Xcode tooling, Appium and XCUITest versions, helper and doctor summaries, simulator or device target, /status, server driver evidence, cleanup, and whether the real-device continuation applies.

Self-Improvement Prompt

Before the final response, report any missing, ambiguous, outdated, or retry-causing XCUITest setup instruction with its asset path and proposed wording. Leave unrelated assets unchanged.

More from this repository

same repository

appium-troubleshooting

appium/skills

Diagnose existing UiAutomator2 session-startup, app-activity, adb transport, helper-server, native or hybrid locator failures, and XCUITest WebDriverAgent, session-startup, app install or launch, device or simulator state, alert, element-source, or locator failures. Use when a session or command under one of those drivers already fails. Do not use for first-time setup, pre-failure real-device provisioning, or Espresso, Chromium, Gecko, Safari, or Mac2 failures.

2026-07-2313

prepare-development-environment

appium/skills

Prepare and validate this Appium Skills repository for local development or contribution by checking the workspace, Git, Node, npm, helper scripts, Skill entrypoint structure, repository-local paths, and JavaScript syntax. Use before editing or validating repository Skills, Context Assets, examples, or tools. Do not use for Appium driver setup, existing runtime failures, or real-device signing.

2026-07-2313

setup-chromium

appium/skills

Prepare and verify Appium Chromium for Chrome, Chromium, or Edge desktop automation by validating Node/Appium, browser prerequisites, driver installation, doctor support, and a minimal browser-session smoke check. Use after the setup Skill selects Chromium. Do not use for an existing Chromium runtime failure after prerequisites pass.

2026-07-2313

setup-espresso

appium/skills

Prepare and verify Appium Espresso by validating Node/Appium, Android SDK and Java prerequisites, driver installation, doctor output, and server smoke evidence. Use after the setup Skill selects Espresso. Do not use for an existing Espresso runtime failure after prerequisites pass; this repository does not provide that troubleshooting workflow.

2026-07-2313

setup-gecko

appium/skills

Prepare and verify Appium Gecko for Firefox desktop automation by validating Node/Appium, Firefox prerequisites, driver installation, optional GeckoDriver availability, doctor support, and server smoke evidence. Use after the setup Skill selects Gecko. Do not use for an existing Gecko runtime failure after prerequisites pass.

2026-07-2313

setup-mac2

appium/skills

Prepare and verify Appium Mac2 for native macOS automation by validating Node/Appium, macOS and Xcode tooling, driver installation, doctor output, privacy authorization boundaries, and server smoke evidence. Use after the setup Skill selects Mac2. Do not use for an existing Mac2 runtime failure after prerequisites pass.

2026-07-2313

name	setup-xcuitest
description	Prepare and verify Appium XCUITest for iOS or tvOS on macOS by validating Node/Appium, Xcode, driver installation, doctor output, simulator or shared real-device prerequisites, and server smoke evidence. Use when the setup Skill selects XCUITest or appium-troubleshooting hands off an XCUITest prerequisite or doctor failure. For a real device, continue to xcuitest-real-device-config after this Skill passes. Do not use for real-device signing, provisioning, or WebDriverAgent deployment.
metadata	{"renma.id":"skill.setup-xcuitest","renma.continues-with":"[\"skill.xcuitest-real-device-config\"]","renma.title":"XCUITest Setup Workflow","renma.owner":"appium","renma.tags":"[\"setup\",\"xcuitest\",\"ios\",\"tvos\"]","renma.requires-context":"[\"contexts/platform/macos/profile.md\",\"contexts/tools/appium/setup/profiles/xcuitest.md\",\"contexts/tools/appium/setup-basics.md\",\"contexts/platform/macos/xcode-prereqs.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-decision-logic.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-driver-doctor.md\",\"contexts/tools/appium/setup/references/xcuitest/xcuitest-smoke-status.md\"]","renma.optional-context":"[\"contexts/tools/appium/setup/profiles/global-appium.md\",\"contexts/tools/appium/setup/profiles/local-npx.md\",\"contexts/tools/appium/setup/examples/xcuitest.md\",\"contexts/tools/appium/capabilities.md\",\"contexts/tools/ffmpeg/setup.md\"]","renma.security-profile":"appium-local-workflows"}

XCUITest Setup Workflow

XCUITest setup routing and handoffs

Required inputs

Confirm iOS or tvOS, simulator or real device, macOS host, global appium mode or explicitly requested local npx appium mode, Xcode state, permissions, and optional FFmpeg requests.

Workflow outline

Load the global command profile by default or the local profile only when explicitly requested.
Load the macOS and XCUITest profiles, shared Appium setup basics, Xcode prerequisites, and XCUITest decision, driver-doctor, and smoke references.
Run node tools/appium/setup/scripts/check-xcuitest-env.mjs; pass --appium-mode local only for local mode. Use summary.requiredOk: true as the read-only setup gate.
Apply required fixes in technical dependency order and rerun the affected check.
Run the XCUITest doctor and server smoke checks. Load the matching example only when it clarifies execution.
If the target is a real device, continue to the real-device Skill only after these shared prerequisites pass.

XCUITest setup safety and approval constraints

Require macOS.
Ask before optional FFmpeg setup, privileged commands, Xcode license or first-launch changes, trust changes, signing changes, or device installation.
Leave real-device signing, provisioning, and WDA deployment to the real-device Skill.
Preserve the selected command mode and working Xcode and driver installations.

Completion criteria

xcodebuild -version and xcode-select -p succeed.
Xcode license and first-launch requirements are handled.
Appium succeeds in the selected command mode and the installed list includes xcuitest.
appium driver doctor xcuitest reports 0 required fixes needed; optional warnings are non-blocking.
/status succeeds and logs list xcuitest.
For a real-device request, the exact continuation to skill.xcuitest-real-device-config is reported after shared setup passes.

Evidence boundary

Self-Improvement Prompt

Before the final response, report any missing, ambiguous, outdated, or retry-causing XCUITest setup instruction with its asset path and proposed wording. Leave unrelated assets unchanged.