This repository contains AI Agent skills for helping with Appium automation, including environment setup, real-device configuration, and troubleshooting common failures.
| Skill | Description |
|---|---|
| environment-setup-node | Prepares Node.js and npm environment |
| environment-setup-android | Prepares Android SDK, Java, and ADB prerequisites for Appium Android drivers |
| environment-setup-ffmpeg | Optional shared FFmpeg setup for media-related capabilities across drivers |
| environment-setup-bundletool | Optional shared bundletool.jar setup for UiAutomator2/Espresso app-bundle tooling |
| environment-setup-uiautomator2 | Prepares and validates an Android + UiAutomator2 Appium environment |
| environment-setup-espresso | Prepares and validates an Android + Espresso Appium environment |
| environment-setup-xcuitest | Prepares and validates a macOS + XCUITest Appium environment |
| 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 | Prepare a real iOS/tvOS device for Appium XCUITest automation |
- Run skill commands step-by-step rather than as one very long chained command.
- For long-running checks, prefer an isolated background terminal and capture output after completion.
- 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, run the optional shared skill
environment-setup-ffmpegonly when explicitly requested. - For bundletool-dependent capabilities, run the optional shared skill
environment-setup-bundletoolonly 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 strict execution rules and copy-paste prompt templates.
- Use the template matching your target (
uiautomator2,espresso,xcuitest,xcuitest real device, ortroubleshooting) and run skills in the documented order.