v1.4.0: Major Skills Expansion - 75 Total Skills

skills/claude-codex-settings/plugins/playwright-tools/commands/setup.md

@@ -0,0 +1,104 @@
+---
+description: Configure Playwright MCP
+---
+
+# Playwright Tools Setup
+
+**Source:** [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
+
+Check Playwright MCP status and configure browser dependencies if needed.
+
+## Step 1: Test Current Setup
+
+Run `/mcp` command to check if playwright server is listed and connected.
+
+If playwright server shows as connected: Tell user Playwright is configured and working.
+
+If playwright server is missing or shows connection error: Continue to Step 2.
+
+## Step 2: Browser Installation
+
+Tell the user:
+
+```
+Playwright MCP requires browser binaries. Install them with:
+
+npx playwright install
+
+This installs Chromium, Firefox, and WebKit browsers.
+
+For a specific browser only:
+npx playwright install chromium
+npx playwright install firefox
+npx playwright install webkit
+```
+
+## Step 3: Browser Options
+
+The MCP server supports these browsers via the `--browser` flag in `.mcp.json`:
+
+- `chrome` (default)
+- `firefox`
+- `webkit`
+- `msedge`
+
+Example `.mcp.json` for Firefox:
+
+```json
+{
+  "playwright": {
+    "command": "npx",
+    "args": ["@playwright/mcp@latest", "--browser", "firefox"]
+  }
+}
+```
+
+## Step 4: Headless Mode
+
+For headless operation (no visible browser), add `--headless`:
+
+```json
+{
+  "playwright": {
+    "command": "npx",
+    "args": ["@playwright/mcp@latest", "--headless"]
+  }
+}
+```
+
+## Step 5: Restart
+
+Tell the user:
+
+```
+After making changes:
+1. Exit Claude Code
+2. Run `claude` again
+
+Changes take effect after restart.
+```
+
+## Troubleshooting
+
+If Playwright MCP fails:
+
+```
+Common fixes:
+1. Browser not found - Run `npx playwright install`
+2. Permission denied - Check file permissions on browser binaries
+3. Display issues - Use `--headless` flag for headless mode
+4. Timeout errors - Increase timeout with `--timeout-navigation 120000`
+```
+
+## Alternative: Disable Plugin
+
+If user doesn't need browser automation:
+
+```
+To disable this plugin:
+1. Run /mcp command
+2. Find the playwright server
+3. Disable it
+
+This prevents errors from missing browser binaries.
+```