pi-skill/skills/qa-automation/qa-setup/SKILL.md

name, description, allowed-tools

name	description	allowed-tools
qa-setup	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.	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

# Core tools
npm install -g agent-device
npm install -g agent-browser

# CDP dependency (in your project)
cd /path/to/your/project
npm install ws

# iOS tools
xcode-select --install

# Android tools
brew install android-platform-tools

# Optional
brew install jq
brew install bash  # If Bash < 4.0

After Setup

1. 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"
   

2. Verify: Run the setup guard to check everything works:

   source .pi/skills/qa-automation/qa-scroll/lib/setup-guard.sh
   run_setup_guard
   

3. 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.