How to Run Appium Tests With Agent Skills on TestMu AI

---

Agent Skills on TestMu AI let your AI coding assistant generate production-grade Appium automation from natural-language prompts. Install the appium-skill package, then your assistant writes correct project structure, dependencies, and desired capabilities and runs tests on real Android and iOS.

Instead of manually setting up your Appium project, use Agent Skills to let your AI coding assistant generate production-ready mobile app automation for you. The appium-skill is part of TestMu AI Agent Skills - structured packages that teach AI assistants how to write production-grade test code and run it on real devices.

What Agent Skills Are

---

Self-contained packages of instructions, code patterns, and configurations for a specific testing framework.

Once installed, your AI assistant works like a senior mobile QA automation architect with knowledge of:

• Proper Appium project structure for each language
• Correct dependency versions and desired capabilities
• Both local and TestMu AI real-device cloud execution patterns
• Common pitfalls and debugging approaches
• CI/CD integration with GitHub Actions

Prerequisites

---

Make sure you have the following set up before you start.

1. Create a TestMu AI account if you don't have one.
2. Get your Username and Access Key from the TestMu AI Dashboard.
3. Install an AI coding assistant: Claude Code, GitHub Copilot, Cursor, Gemini CLI, or any compatible tool.

Step 1: Install the Appium Agent Skill

---

Clone the repository and copy the Appium skill into your AI tool's skills directory.

git clone https://github.com/LambdaTest/agent-skills.git

# For Claude Code
cp -r agent-skills/appium-skill .claude/skills/

# For Cursor
cp -r agent-skills/appium-skill .cursor/skills/

# For GitHub Copilot
cp -r agent-skills/appium-skill .github/skills/

# For Gemini CLI
cp -r agent-skills/appium-skill .gemini/skills/

tip

Install all available framework skills at once by cloning the repository directly into your tool's skills directory (e.g., .claude/skills/, .cursor/skills/).

Step 2: Set Your Credentials

---

Add your TestMu AI credentials as environment variables so the generated tests can authenticate with the real device cloud.

Visit the TestMu AI Dashboard, navigate to the left sidebar, and select Credentials. Copy your Username and Access Key, then run:

export LT_USERNAME="YOUR_LAMBDATEST_USERNAME"
export LT_ACCESS_KEY="YOUR_LAMBDATEST_ACCESS_KEY"

Step 3: Run Your First Test

---

Ask your AI assistant to write tests in natural language.

"Write an Appium test in Python for my Android app's login flow and run it on TestMu AI real devices"

"Set up an Appium Java project with TestNG and Page Object Model, and run it on TestMu AI"

"Run my Appium test across an iPhone 14 and a Galaxy S23 in parallel on TestMu AI, tag the build as 'release-v1.0'"

The Agent Skill automatically handles:

1. Project setup - Creates the right folder structure, dependencies, and config files
2. Language detection - Maps your request to the correct language (Java, Python, JavaScript, C#, Ruby, or PHP)
3. Execution target - Configures local, real-device, or virtual-device execution on TestMu AI based on your request
4. Best practices - Uses explicit waits, proper locator strategies, and Page Object Model patterns

What's Included in the Appium Skill

---

A breakdown of everything the skill package contains.

appium-skill/
├── SKILL.md
└── reference/
    ├── playbook.md
    └── advanced-patterns.md

Section	Details
Project Setup	Dependencies, versions, configuration files, project structure
Core Patterns	Complete, runnable code examples with best practices
Cloud Integration	TestMu AI real-device capabilities and hub configuration
CI/CD Integration	GitHub Actions workflows with reporting and parallel execution
Debugging Guide	Common exceptions mapped to solutions
Best Practices	Actionable recommendations for production mobile test code

Supported Languages and Frameworks

---

The Appium Agent Skill supports every language TestMu AI runs Appium tests on. Each language guide below covers its frameworks as tabs.

Language	Frameworks	Guide
Java	JUnit, JBehave, Cucumber, TestNG	Appium with Java
JavaScript	WebDriverIO, Mocha	Appium with JavaScript
Python	Behave, Robot, Gauge, PyTest	Appium with Python
Ruby	Cucumber, RSpec	Appium with Ruby
PHP	Behat	Appium with PHP
C#	NUnit	Appium with C#
Kotlin	N/A	Appium with Kotlin
Flutter	N/A	Testing Flutter Apps

Supported AI Tools

---

Pick the tool you use and install the skill to the corresponding path.

Tool	Type	Installation Path
Claude Code	CLI	.claude/skills/
GitHub Copilot	Extension	.github/skills/
Cursor	IDE	.cursor/skills/
Gemini CLI	CLI	.gemini/skills/
Codex CLI	CLI	.codex/skills/
OpenCode	CLI	.opencode/skills/
Claude.ai	Web	Settings > Features > Skills

Next Steps

---

Continue with these related guides:

• Run Your First Appium Test
• Appium Automation Capabilities
• Upload Apps to the Real Device Cloud