Initial: pi-skill — 68 skills, 43 extensions, 11 themes for Pi

2026-05-25 16:38:02 +07:00
commit 69f7d8bdda
1689 changed files with 342427 additions and 0 deletions
--- a/skills/qa-automation/qa-setup/SKILL.md
+++ b/skills/qa-automation/qa-setup/SKILL.md
@@ -0,0 +1,113 @@
+---
+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
+bash .pi/skills/qa-automation/install.sh
+```
+
+### Check only (don't install anything)
+```bash
+bash .pi/skills/qa-automation/install.sh --check
+```
+
+### Manual install commands
+```bash
+# 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:
+   ```bash
+   export APP_BUNDLE_ID="com.yourapp.dev"
+   export PROJECT_DIR="/path/to/your/project"
+   ```
+
+2. **Verify**: Run the setup guard to check everything works:
+   ```bash
+   source .pi/skills/qa-automation/qa-scroll/lib/setup-guard.sh
+   run_setup_guard
+   ```
+
+3. **Test**: Run an example test flow:
+   ```bash
+   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.