This repository contains AI Agent skills for Appium automation, including environment setup, real-device configuration, and troubleshooting common failures.
Each workflow includes or delegates to a self-improvement prompt in the loaded context/reference/procedure, asking agents to note missing, ambiguous, outdated, or retry-causing instructions after use. When a gap is found, consider opening a PR that updates the loaded context, reference, procedure, or thin SKILL.md router with clearer routing, verification, or newer commands.
| Skill | Description |
|---|---|
| setup | Routes Appium environment setup to canonical contexts for Node.js, Android, UiAutomator2, Espresso, Chromium, Gecko, Mac2, Safari, XCUITest, FFmpeg, or bundletool procedures |
| prepare-development-environment | Prepares this repository for local Appium skills development by checking Git, Node, npm, helper-script readiness, and routing driver-specific setup |
| appium-troubleshooting | Troubleshoots UiAutomator2 or XCUITest failures with a driver-scoped workflow that starts from the failing symptom and re-checks the smallest reproduction after each fix |
| xcuitest-real-device-config | Prepares a real iOS/tvOS device for Appium XCUITest automation |
- Run one skill at a time in dependency order.
- If output appears incomplete, rerun only the affected step and collect logs from that step.
- Treat Appium doctor as the source of truth for pass/fail (
0 required fixes needed). - For FFmpeg-dependent capabilities, use
setupcontextcontexts/tools/appium/setup/ffmpeg-environment.mdonly when explicitly requested. - For bundletool-dependent capabilities, use
setupreferencecontexts/tools/appium/setup/references/environment-setup-bundletool.mdonly when explicitly requested. - For startup, WDA, or locator failures after setup is complete, use
appium-troubleshootingin a single driver path and follow the checks documented in that skill.
- See AGENTS.md for repository-level execution rules and skill entrypoint guidance.
- Use the selected
SKILL.mdand its routedcontexts/assets for target-specific step order.