| name | qa-setup |
| description | Verify and install all dependencies for the QA Automation skill package. Checks for agent-device, agent-browser, Node.js, iOS/Android tools, and the 'ws' WebSocket library. Installs missing tools automatically. Invoke when user says "check qa setup", "install qa tools", "verify qa dependencies", "set up qa automation", "prepare for testing", or any task requiring QA tool verification.
|
| allowed-tools | Bash(agent-device:*) Bash(agent-browser:*) Bash(npm:*) Bash(npx:*) Bash(node:*) Bash(which:*) Bash(xcrun:*) Bash(brew:*) Read |
qa-setup
Dependency verification and installation for the QA Automation skill package. Ensures both agent-device (native app testing) and agent-browser (web app testing) are installed and functional, along with all supporting tools.
What Gets Checked
| Dependency | Purpose | Auto-Install? |
|---|
| agent-device | Native iOS/Android simulator control, screenshots, gestures | ✅ npm install -g agent-device |
| agent-browser | Web browser automation, form filling, screenshots | ✅ npm install -g agent-browser |
| Node.js | Runtime for CDP WebSocket and JSON processing | ❌ Manual install required |
| npm / npx | Package management | ❌ Comes with Node.js |
| ws | WebSocket library for CDP connections | ✅ npm install ws |
| Xcode / xcrun | iOS Simulator management | ❌ Manual install (Mac App Store) |
| adb | Android emulator management | ❌ Manual install (Android Studio) |
| Bash 4.0+ | Required for array support in test scripts | ❌ brew install bash |
| curl | HTTP requests for health checks | ❌ Usually pre-installed |
| jq | JSON processing (optional) | ❌ brew install jq |
Usage
Full check + auto-install
bash .pi/skills/qa-automation/install.sh
Check only (don't install anything)
bash .pi/skills/qa-automation/install.sh --check
Manual install commands
npm install -g agent-device
npm install -g agent-browser
cd /path/to/your/project
npm install ws
xcode-select --install
brew install android-platform-tools
brew install jq
brew install bash
After Setup
-
Configure: Copy qa.config.sh and set your app-specific values:
export APP_BUNDLE_ID="com.yourapp.dev"
export PROJECT_DIR="/path/to/your/project"
-
Verify: Run the setup guard to check everything works:
source .pi/skills/qa-automation/qa-scroll/lib/setup-guard.sh
run_setup_guard
-
Test: Run an example test flow:
bash .pi/skills/qa-automation/qa-scroll/run.sh
Architecture
The QA Automation package uses a dual-driver architecture:
┌─────────────────────────────────────────────────────────────┐
│ QA Automation Skills │
├──────────────────────┬──────────────────────────────────────┤
│ Native App Testing │ Web App Testing │
│ │ │
│ ┌──────────────┐ │ ┌──────────────┐ │
│ │ agent-device │ │ │ agent-browser │ │
│ │ │ │ │ │ │
│ │ • Screenshots │ │ │ • Screenshots │ │
│ │ • Gestures │ │ │ • Click/Fill │ │
│ │ • A11y tree │ │ │ • A11y tree │ │
│ │ • App launch │ │ │ • Navigation │ │
│ └──────┬───────┘ │ └──────┬────────┘ │
│ │ │ │ │
│ ┌──────▼───────┐ │ ┌──────▼────────┐ │
│ │ CDP (Hermes) │ │ │ Browser DOM │ │
│ │ │ │ │ │ │
│ │ • JS eval │ │ │ • JS eval │ │
│ │ • Navigation │ │ │ • State check │ │
│ │ • State query │ │ │ • Network │ │
│ │ • Debug hooks │ │ │ • Cookies │ │
│ └──────────────┘ │ └───────────────┘ │
└──────────────────────┴──────────────────────────────────────┘
Both drivers are required for full functionality. agent-device handles the physical device/simulator layer, while CDP (or agent-browser for web) handles the application runtime layer.
