wordpress-agent-kit 0.3.2 → 0.4.0

package/.github/skills/wp-playground/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wp-playground
-description: "Use for WordPress Playground workflows: fast disposable WP instances in the browser or locally via @wp-playground/cli (server, run-blueprint, build-snapshot), auto-mounting plugins/themes, switching WP/PHP versions, blueprints, and debugging (Xdebug)."
+description: "Use for WordPress Playground workflows: fast disposable WP instances in the browser or locally via @wp-playground/cli (server, run-blueprint, build-snapshot), auto-mounting plugins/themes, switching WP/PHP versions, blueprints, PHPUnit testing, E2E Playwright testing, programmatic runCLI API, and debugging (Xdebug)."
 license: GPL-2.0-or-later
 compatibility: "Targets WordPress 6.9+ (PHP 7.2.24+). Playground CLI requires Node.js 20.18+; runs WP in WebAssembly with SQLite."
 ---
@@ -14,6 +14,9 @@ compatibility: "Targets WordPress 6.9+ (PHP 7.2.24+). Playground CLI requires No
 - Build a reproducible snapshot of a site for sharing or CI.
 - Switch WP/PHP versions quickly to reproduce issues.
 - Debug plugin/theme code with Xdebug in an isolated Playground.
+- Run PHPUnit tests without a local database (no Docker, no MySQL).
+- Write E2E Playwright tests against a real WordPress instance.
+- Automate Playground in CI/CD pipelines via the programmatic `runCLI` API.
 
 ## Inputs required
 
@@ -82,6 +85,134 @@ npx @wp-playground/cli@latest build-snapshot --blueprint=<file> --outfile=./site
   - Query: `https://playground.wordpress.net/?blueprint-url=<public-url-or-zip>`
 - Use the live Blueprint Editor (playground.wordpress.net) to author blueprints with schema help; paste JSON and copy a shareable link.
 
+### 8) PHPUnit testing (no database required)
+
+Run PHPUnit inside Playground — every run starts with a clean WordPress install, fully isolated.
+
+Plugin:
+```bash
+npx @wp-playground/cli@latest php \
+  --auto-mount \
+  -- \
+  /wordpress/wp-content/plugins/MY_PLUGIN/vendor/bin/phpunit \
+  -c /wordpress/wp-content/plugins/MY_PLUGIN/phpunit.xml.dist
+```
+
+Theme (replace `plugins/` with `themes/`):
+```bash
+npx @wp-playground/cli@latest php \
+  --auto-mount \
+  -- \
+  /wordpress/wp-content/themes/MY_THEME/vendor/bin/phpunit \
+  -c /wordpress/wp-content/themes/MY_THEME/phpunit.xml.dist
+```
+
+- Requires PHPUnit installed via Composer in the project (`composer require --dev phpunit/phpunit`).
+- `--auto-mount` maps the current directory to the correct WP content path automatically.
+- Use `--php=8.1 --wp=6.5` flags to test against specific versions (PHP 7.4–8.5 supported).
+- Explicit mount: `--mount=.:/wordpress/wp-content/plugins/MY_PLUGIN`.
+
+### 9) E2E testing with Playwright
+
+Use `runCLI` from `@wp-playground/cli` to start a Playground server programmatically in Playwright tests. No Docker, no database.
+
+Install:
+```bash
+npm install --save-dev @playwright/test @wp-playground/cli
+npx playwright install chromium
+```
+
+Minimal `playwright.config.ts`:
+```ts
+import { defineConfig } from '@playwright/test';
+export default defineConfig({
+  testDir: './tests/e2e',
+  fullyParallel: false,
+  workers: 1,           // prevent port conflicts
+  timeout: 120_000,     // WP boot takes time
+  expect: { timeout: 30_000 },
+  use: { screenshot: 'only-on-failure', trace: 'on-first-retry' },
+});
+```
+
+First test (`tests/e2e/plugin.spec.ts`):
+```ts
+import { test, expect } from '@playwright/test';
+import { runCLI } from '@wp-playground/cli';
+
+let cli: Awaited<ReturnType<typeof runCLI>>;
+
+test.beforeAll(async () => {
+  cli = await runCLI({
+    command: 'server',
+    blueprint: {
+      preferredVersions: { php: '8.3', wp: 'latest' },
+      login: true,
+    },
+  });
+});
+
+test.afterAll(async () => { await cli?.server?.close(); });
+
+test('dashboard loads', async ({ page }) => {
+  await page.goto(`${cli.serverUrl}/wp-admin/`);
+  await expect(page.locator('#wpbody-content')).toBeVisible();
+});
+```
+
+Mount a local plugin:
+```ts
+cli = await runCLI({
+  command: 'server',
+  mount: { './': '/wordpress/wp-content/plugins/my-plugin' },
+  blueprint: {
+    preferredVersions: { php: '8.3', wp: 'latest' },
+    login: true,
+    steps: [{ step: 'activatePlugin', pluginPath: 'my-plugin/my-plugin.php' }],
+  },
+});
+```
+
+Locator priority (most to least preferred):
+1. `page.getByRole()` — buttons, headings, links, inputs
+2. `page.getByLabel()` — labeled form fields
+3. `page.getByText()` — visible text
+4. `page.getByTestId()` — your own `data-testid` attributes
+5. `page.locator()` — CSS/XPath last resort (WP core layout elements like `#wpadminbar`)
+
+Version matrix pattern:
+```ts
+const matrix = [{ php: '8.1', wp: '6.5' }, { php: '8.3', wp: 'latest' }];
+for (const { php, wp } of matrix) {
+  test.describe(`PHP ${php} + WP ${wp}`, () => {
+    // ... beforeAll/afterAll with those versions
+  });
+}
+```
+
+CI (GitHub Actions): see `references/e2e-playwright.md`.
+
+### 10) Programmatic `runCLI` API (scripts / Vitest integration)
+
+```ts
+import { runCLI } from '@wp-playground/cli';
+
+const server = await runCLI({
+  command: 'server',
+  php: '8.3',
+  wp: 'latest',
+  login: true,
+  mount: [{ hostPath: './my-plugin', vfsPath: '/wordpress/wp-content/plugins/my-plugin' }],
+  blueprint: { steps: [{ step: 'activatePlugin', pluginPath: 'my-plugin/plugin.php' }] },
+});
+
+// server.serverUrl — the base URL
+// server.server — the HTTP server instance (call .close() in afterEach)
+// server[Symbol.asyncDispose]() — cleanup in Vitest afterEach
+```
+
+Use `wordpressInstallMode: 'do-not-attempt-installing'` + `skipSqliteSetup: true` when testing pure PHP with no WordPress overhead.
+
 ## Verification
 
 - Verify mounted code is active (plugin listed/active; theme selected).

package/.github/skills/wp-playground/references/e2e-playwright.md

@@ -0,0 +1,115 @@
+# E2E Testing with Playwright + WordPress Playground
+
+## Install
+
+```bash
+npm install --save-dev @playwright/test @wp-playground/cli
+npx playwright install chromium
+```
+
+## playwright.config.ts
+
+```ts
+import { defineConfig } from '@playwright/test';
+export default defineConfig({
+  testDir: './tests/e2e',
+  fullyParallel: false,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: 1,
+  reporter: 'html',
+  timeout: 120_000,
+  expect: { timeout: 30_000 },
+  use: { screenshot: 'only-on-failure', trace: 'on-first-retry' },
+});
+```
+
+## Server lifecycle
+
+**Shared** (faster, tests can affect each other — use for read-only tests):
+```ts
+test.beforeAll(async () => { cli = await runCLI({ command: 'server', blueprint }); });
+test.afterAll(async () => { await cli?.server?.close(); });
+```
+
+**Per-test** (isolated, slower — use when tests modify state):
+```ts
+test.beforeEach(async () => { cli = await runCLI({ command: 'server', blueprint }); });
+test.afterEach(async () => { await cli?.server?.close(); });
+```
+
+## Blueprint fixtures
+
+Installing from wordpress.org:
+```ts
+steps: [{ step: 'installPlugin', pluginData: { resource: 'wordpress.org/plugins', slug: 'contact-form-7' } }]
+```
+
+Creating content:
+```ts
+steps: [{ step: 'runPHP', code: `<?php require '/wordpress/wp-load.php'; wp_insert_post([...]);` }]
+```
+
+## WordPress-specific locator guidance
+
+- `page.getByRole('button', { name: 'Save Changes' })` — works for standard WP buttons
+- `page.getByLabel('API Key')` — works for labeled form fields
+- `page.locator('#wpadminbar')` — CSS required for WP core layout elements (no ARIA)
+- Add `data-testid` to your own plugin markup for stable selectors
+- Run `npx playwright codegen localhost:9400/wp-admin/` to auto-generate locators
+
+## Page Object Model
+
+```ts
+// tests/e2e/pages/plugin-settings.ts
+export class PluginSettingsPage {
+  constructor(readonly page: Page) {}
+  async goto(baseUrl: string) { await this.page.goto(`${baseUrl}/wp-admin/options-general.php?page=my-plugin`); }
+  async setApiKey(key: string) {
+    await this.page.getByLabel('API Key').fill(key);
+    await this.page.getByRole('button', { name: 'Save Changes' }).click();
+  }
+  async expectSaved() { await expect(this.page.getByText('Settings saved')).toBeVisible(); }
+}
+```
+
+## GitHub Actions CI
+
+```yaml
+name: E2E Tests
+on:
+  push: { branches: [main] }
+  pull_request: { branches: [main] }
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20, cache: 'npm' }
+      - run: npm ci
+      - uses: actions/cache@v4
+        id: playwright-cache
+        with:
+          path: ~/.cache/ms-playwright
+          key: playwright-${{ hashFiles('package-lock.json') }}
+      - if: steps.playwright-cache.outputs.cache-hit != 'true'
+        run: npx playwright install chromium --with-deps
+      - run: npx playwright test
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with: { name: playwright-report, path: playwright-report/, retention-days: 30 }
+```
+
+## Troubleshooting
+
+- **Timeout errors** — increase `timeout` in config; CI needs 120–180s
+- **Port conflicts** — don't hardcode ports; use `cli.serverUrl`
+- **Browser not found** — run `npx playwright install chromium`
+- **Passes locally, fails CI** — increase timeouts, ensure `workers: 1`
+- **Debug** — `npx playwright test --debug` or `--ui` for interactive mode
+
+## Docs
+
+- https://wordpress.github.io/wordpress-playground/guides/e2e-testing-with-playwright
+- https://wordpress.github.io/wordpress-playground/guides/programmatic-playground-cli

package/.github/skills/wp-wpengine/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: wp-wpengine
+description: "Optional: Use for WP Engine hosting workflows — SSH-based git push to WP Engine environments, managing installs/domains/cache/backups via the wpe-labs Claude Code skills, and WP Engine API access. Requires WPE_USERNAME and WPE_PASSWORD env vars."
+license: GPL-2.0-or-later
+optional: true
+---
+
+# WP Engine
+
+## When to use
+
+- Deploy WordPress code to a WP Engine environment via `git push`.
+- Manage WP Engine installs, domains, cache, backups, or users through natural language.
+- Generate monthly usage/bandwidth reports across WP Engine accounts.
+- Manage LargeFS media offload configuration.
+
+## Prerequisites
+
+- SSH key for WP Engine git push stored in 1Password (`Employee` vault, item `wpengine_ed25519`).
+- WP Engine API credentials in 1Password (`Employee` vault, item `WP Engine API`).
+- `op` CLI authenticated (`op whoami` works).
+- The `wpe-labs` Claude Code skills installed (`~/.claude/skills/wpe-labs:*`).
+
+## Procedure
+
+### 1) First-time SSH setup on a new machine
+
+Pull the private key from 1Password and configure SSH:
+
+```bash
+op read "op://Employee/wpengine_ed25519/private key" > ~/.ssh/wpengine_ed25519
+chmod 600 ~/.ssh/wpengine_ed25519
+ssh-keyscan git.wpengine.com >> ~/.ssh/known_hosts
+```
+
+Add to `~/.ssh/config` (before any `Host *` block):
+```
+Host git.wpengine.com
+  User git
+  IdentityFile ~/.ssh/wpengine_ed25519
+  IdentitiesOnly yes
+```
+
+Verify:
+```bash
+ssh git@git.wpengine.com info
+# Expected: hello <username> / R W <install-name>
+```
+
+The public key is already registered on WP Engine — no portal action needed on new machines.
+
+### 2) Add a WP Engine git remote
+
+Find the remote URL on the WP Engine portal: `https://my.wpengine.com/installs/<ENV>/git_push`
+
+```bash
+git remote add wpengine git@git.wpengine.com:<install-name>.git
+# Example for staging:
+git remote add wpengine-staging git@git.wpengine.com:<install-name>stg.git
+```
+
+### 3) Deploy via git push
+
+```bash
+git push wpengine main
+```
+
+- WP Engine deploys the pushed branch automatically.
+- Only the WordPress files are pushed (not `node_modules`, build artifacts, etc.).
+- After push, WP Engine may take 1–2 min to propagate the deploy.
+
+### 4) wpe-labs skills (natural language management)
+
+Load API credentials, then use any `/wpe-labs:*` skill:
+
+```bash
+# Load credentials from 1Password for the session
+eval $(op run --env-file ~/.config/op-ssh/.env.1pass -- env | grep ^WPE | sed 's/^/export /')
+```
+
+Available skills:
+
+| Skill | What it does | Risk |
+|---|---|---|
+| `/wpe-labs:account-usage` | Bandwidth, visits, storage across accounts | 🟢 Read-only |
+| `/wpe-labs:monthly-report` | Client-ready monthly usage report | 🟢 Read-only |
+| `/wpe-labs:backups` | On-demand backups + progress monitoring | 🟡 Write |
+| `/wpe-labs:cache` | Purge object/page/CDN cache | 🟡 Write |
+| `/wpe-labs:users` | List, invite, update roles, remove users | 🟡/🔴 |
+| `/wpe-labs:domains` | Manage domains, DNS, SSL | 🟡/🔴 |
+| `/wpe-labs:installs` | List, create, copy WordPress installs | 🟡/🔴 |
+| `/wpe-labs:offload` | LargeFS media offload config | 🟡 Write |
+
+Example prompts:
+```
+/wpe-labs:account-usage which accounts are closest to their bandwidth limit?
+/wpe-labs:cache purge all cache for uofdev production
+/wpe-labs:backups back up uofdev production before deployment
+/wpe-labs:installs copy uofdev production to staging
+/wpe-labs:monthly-report last month
+```
+
+### 5) Re-installing wpe-labs skills
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/wpengine/wpe-labs-platform-skills/main/install.sh | bash
+```
+
+## Verification
+
+- SSH: `ssh git@git.wpengine.com info` — should return `hello <username> / R W <install>`
+- API: `op run --env-file ~/.config/op-ssh/.env.1pass -- bash -c 'curl -s -u "$WPE_USERNAME:$WPE_PASSWORD" https://api.wpengineapi.com/v1/user | jq .email'`
+
+## Failure modes
+
+- **SSH: Host key verification failed** — re-run `ssh-keyscan git.wpengine.com >> ~/.ssh/known_hosts`
+- **SSH: Permission denied** — confirm the key is at `~/.ssh/wpengine_ed25519` with `chmod 600`
+- **git push rejected** — verify the remote URL matches the install name exactly
+- **wpe-labs: 401 Unauthorized** — regenerate API credentials at `https://my.wpengine.com/api_access` and update the `WP Engine API` item in 1Password
+- **wpe-labs: storage shows zero** — ask Claude to "refresh storage" (async recalculation, ~30–60s)
+
+## References
+
+- WP Engine git push portal: `https://my.wpengine.com/installs/<ENV>/git_push`
+- WP Engine API access: `https://my.wpengine.com/api_access`
+- wpe-labs skills source: `https://github.com/wpengine/wpe-labs-platform-skills`
+- SSH setup log (first machine): gist `602d6a16ddfea438c0611a8e5cc31d5e`

package/README.md

@@ -2,11 +2,11 @@
 
 [![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg?style=flat-square)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/Written%20in-TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![Version](https://img.shields.io/badge/version-0.3.2-blue?style=flat-square)](package.json)
+[![Version](https://img.shields.io/badge/version-0.4.0-blue?style=flat-square)](package.json)
 [![Node](https://img.shields.io/badge/node-%3E%3D20.18-green?style=flat-square)](package.json)
 [![CI](https://img.shields.io/badge/CI-passing-brightgreen?style=flat-square)](.github/workflows/ci.yml)
 
-**WordPress-focused AI agent starter kit** for GitHub Copilot, Cursor, Claude, and Pi Coding Agent. Installs 13 specialized WordPress agent skills, an agent persona, workflow instructions, and AGENTS.md configuration — everything an AI coding agent needs to build WordPress plugins, themes, and blocks correctly.
+**WordPress-focused AI agent starter kit** for GitHub Copilot, Cursor, Claude, and Pi Coding Agent. Installs 17 specialized WordPress agent skills (plus an optional WP Engine skill), an agent persona, workflow instructions, and AGENTS.md configuration — everything an AI coding agent needs to build WordPress plugins, themes, and blocks correctly.
 
 Maintained by [Kyle Brodeur](https://brodeur.me).
 
@@ -40,7 +40,7 @@ my-plugin/
 │   ├── instructions/
 │   │   └── wordpress-workflow.instructions.md
 │   ├── prompts/
-│   └── skills/                      # 17 WordPress skills
+│   └── skills/                      # 17 WordPress skills + 1 optional
 │       ├── wp-project-triage/       # Project detection
 │       ├── wp-plugin-development/   # Plugin architecture
 │       ├── wp-block-development/    # Gutenberg blocks
@@ -51,9 +51,10 @@ my-plugin/
 │       ├── wp-performance/          # Performance profiling
 │       ├── wp-phpstan/              # Static analysis
 │       ├── wp-wpcli-and-ops/        # WP-CLI operations
-│       ├── wp-playground/           # Testing environments
+│       ├── wp-playground/           # Testing environments (PHPUnit, Playwright, CI)
 │       ├── wpds/                    # Design system
-│       └── wordpress-router/        # Repo classification
+│       ├── wordpress-router/        # Repo classification
+│       └── wp-wpengine/             # (optional) WP Engine hosting + git push
 └── .wp-agent-kit-manifest.github.json  # Safe-update tracking
 ```
 
@@ -227,7 +228,7 @@ console.log(triage.data.project.primary); // "plugin"
 
 ## Skills Reference
 
-All 13 skills follow the [AgentSkills.io](https://agentskills.io) specification:
+All 17 skills follow the [AgentSkills.io](https://agentskills.io) specification. Skills in `skills-custom/` are project-specific (not from upstream) and survive `sync-skills`:
 
 | Skill | When to Use |
 |-------|------------|
@@ -243,10 +244,12 @@ All 13 skills follow the [AgentSkills.io](https://agentskills.io) specification:
 | `wp-performance` | Profile and optimize WordPress performance |
 | `wp-phpstan` | Configure and run PHPStan static analysis |
 | `wp-wpcli-and-ops` | WP-CLI commands, automation, multisite operations |
-| `wp-playground` | Test in disposable WordPress Playground instances |
+| `wp-playground` | Test with disposable Playground instances; PHPUnit, Playwright E2E, CI |
 | `blueprint` | Write and edit WordPress Playground blueprint JSON |
 | `wpds` | Build UIs with the WordPress Design System |
 | `wp-plugin-directory-guidelines` | GPL compliance, naming, slug rules for WP.org submission |
+| `wordpress-router` | Route/classify repository type and select appropriate skills |
+| **`wp-wpengine`** *(optional, custom)* | **WP Engine git push, install/domain/cache/backup management via wpe-labs skills** |
 
 ---
 

package/dist/lib/api.js

@@ -264,6 +264,19 @@ export async function syncSkillsApi(options = {}) {
                 fs.cpSync(sourceSkills, targetSkills, { recursive: true });
                 skillsSynced = fs.readdirSync(targetSkills).length;
             }
+            // Merge custom skills (skills-custom/) — these are not part of the upstream
+            // WordPress/agent-skills repo and survive upstream syncs.
+            const customSkillsDir = path.join(PACKAGE_ROOT, 'skills-custom');
+            if (fs.existsSync(customSkillsDir)) {
+                for (const skillName of fs.readdirSync(customSkillsDir)) {
+                    const src = path.join(customSkillsDir, skillName);
+                    const dest = path.join(targetSkills, skillName);
+                    if (fs.statSync(src).isDirectory()) {
+                        fs.cpSync(src, dest, { recursive: true });
+                        skillsSynced++;
+                    }
+                }
+            }
             return { success: true, skillsSynced, method };
         });
         return formatter.success({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wordpress-agent-kit",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "WordPress-focused AGENTS.md + Agent Skills starter kit for AI coding agents.",
   "license": "GPL-2.0-or-later",
   "author": "Kyle Brodeur <kyle@brodeur.me> (https://brodeur.me)",

package/skills-custom/wp-wpengine/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: wp-wpengine
+description: "Optional: Use for WP Engine hosting workflows — SSH-based git push to WP Engine environments, managing installs/domains/cache/backups via the wpe-labs Claude Code skills, and WP Engine API access. Requires WPE_USERNAME and WPE_PASSWORD env vars."
+license: GPL-2.0-or-later
+optional: true
+---
+
+# WP Engine
+
+## When to use
+
+- Deploy WordPress code to a WP Engine environment via `git push`.
+- Manage WP Engine installs, domains, cache, backups, or users through natural language.
+- Generate monthly usage/bandwidth reports across WP Engine accounts.
+- Manage LargeFS media offload configuration.
+
+## Prerequisites
+
+- SSH key for WP Engine git push stored in 1Password (`Employee` vault, item `wpengine_ed25519`).
+- WP Engine API credentials in 1Password (`Employee` vault, item `WP Engine API`).
+- `op` CLI authenticated (`op whoami` works).
+- The `wpe-labs` Claude Code skills installed (`~/.claude/skills/wpe-labs:*`).
+
+## Procedure
+
+### 1) First-time SSH setup on a new machine
+
+Pull the private key from 1Password and configure SSH:
+
+```bash
+op read "op://Employee/wpengine_ed25519/private key" > ~/.ssh/wpengine_ed25519
+chmod 600 ~/.ssh/wpengine_ed25519
+ssh-keyscan git.wpengine.com >> ~/.ssh/known_hosts
+```
+
+Add to `~/.ssh/config` (before any `Host *` block):
+```
+Host git.wpengine.com
+  User git
+  IdentityFile ~/.ssh/wpengine_ed25519
+  IdentitiesOnly yes
+```
+
+Verify:
+```bash
+ssh git@git.wpengine.com info
+# Expected: hello <username> / R W <install-name>
+```
+
+The public key is already registered on WP Engine — no portal action needed on new machines.
+
+### 2) Add a WP Engine git remote
+
+Find the remote URL on the WP Engine portal: `https://my.wpengine.com/installs/<ENV>/git_push`
+
+```bash
+git remote add wpengine git@git.wpengine.com:<install-name>.git
+# Example for staging:
+git remote add wpengine-staging git@git.wpengine.com:<install-name>stg.git
+```
+
+### 3) Deploy via git push
+
+```bash
+git push wpengine main
+```
+
+- WP Engine deploys the pushed branch automatically.
+- Only the WordPress files are pushed (not `node_modules`, build artifacts, etc.).
+- After push, WP Engine may take 1–2 min to propagate the deploy.
+
+### 4) wpe-labs skills (natural language management)
+
+Load API credentials, then use any `/wpe-labs:*` skill:
+
+```bash
+# Load credentials from 1Password for the session
+eval $(op run --env-file ~/.config/op-ssh/.env.1pass -- env | grep ^WPE | sed 's/^/export /')
+```
+
+Available skills:
+
+| Skill | What it does | Risk |
+|---|---|---|
+| `/wpe-labs:account-usage` | Bandwidth, visits, storage across accounts | 🟢 Read-only |
+| `/wpe-labs:monthly-report` | Client-ready monthly usage report | 🟢 Read-only |
+| `/wpe-labs:backups` | On-demand backups + progress monitoring | 🟡 Write |
+| `/wpe-labs:cache` | Purge object/page/CDN cache | 🟡 Write |
+| `/wpe-labs:users` | List, invite, update roles, remove users | 🟡/🔴 |
+| `/wpe-labs:domains` | Manage domains, DNS, SSL | 🟡/🔴 |
+| `/wpe-labs:installs` | List, create, copy WordPress installs | 🟡/🔴 |
+| `/wpe-labs:offload` | LargeFS media offload config | 🟡 Write |
+
+Example prompts:
+```
+/wpe-labs:account-usage which accounts are closest to their bandwidth limit?
+/wpe-labs:cache purge all cache for uofdev production
+/wpe-labs:backups back up uofdev production before deployment
+/wpe-labs:installs copy uofdev production to staging
+/wpe-labs:monthly-report last month
+```
+
+### 5) Re-installing wpe-labs skills
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/wpengine/wpe-labs-platform-skills/main/install.sh | bash
+```
+
+## Verification
+
+- SSH: `ssh git@git.wpengine.com info` — should return `hello <username> / R W <install>`
+- API: `op run --env-file ~/.config/op-ssh/.env.1pass -- bash -c 'curl -s -u "$WPE_USERNAME:$WPE_PASSWORD" https://api.wpengineapi.com/v1/user | jq .email'`
+
+## Failure modes
+
+- **SSH: Host key verification failed** — re-run `ssh-keyscan git.wpengine.com >> ~/.ssh/known_hosts`
+- **SSH: Permission denied** — confirm the key is at `~/.ssh/wpengine_ed25519` with `chmod 600`
+- **git push rejected** — verify the remote URL matches the install name exactly
+- **wpe-labs: 401 Unauthorized** — regenerate API credentials at `https://my.wpengine.com/api_access` and update the `WP Engine API` item in 1Password
+- **wpe-labs: storage shows zero** — ask Claude to "refresh storage" (async recalculation, ~30–60s)
+
+## References
+
+- WP Engine git push portal: `https://my.wpengine.com/installs/<ENV>/git_push`
+- WP Engine API access: `https://my.wpengine.com/api_access`
+- wpe-labs skills source: `https://github.com/wpengine/wpe-labs-platform-skills`
+- SSH setup log (first machine): gist `602d6a16ddfea438c0611a8e5cc31d5e`