| name | ralph-playwright:setup |
| description | One-time setup for ralph-playwright — installs playwright-cli globally, validates browser installation, and creates playwright-stories/ directory. Use when setting up ralph-playwright for the first time or diagnosing a broken install. |
Ralph-Playwright Setup
Install and configure playwright-cli for ralph-playwright skills.
Step 1: Install playwright-cli (required)
npm install -g @playwright/cli@latest
Verify installation:
playwright-cli --version
Must show a version. If the command is not found, the global install failed — check your npm prefix (npm config get prefix) and ensure it's on your PATH.
Step 2: Install browser binaries
playwright-cli install-browser --browser chrome
Step 3: Create story directory
In your project root:
mkdir -p playwright-stories
Story YAML files in playwright-stories/ should be committed to git.
Step 4: Verify .gitignore entries
Confirm these entries exist (added by ralph-playwright plugin):
# Root .gitignore
.playwright-cli/
# thoughts/.gitignore
local/
Validation Checklist
playwright-cli --version → prints a versionwhich playwright-cli → resolves to a pathplaywright-stories/ directory exists.playwright-cli/ is in .gitignore
Next Steps
- Browse directly:
/ralph-playwright:browser
- Generate stories:
/ralph-playwright:story-gen
- Explore a URL:
/ralph-playwright:explore http://localhost:3000
- Run tests:
/ralph-playwright:test-e2e
