| name | description |
|---|---|
browser-automation |
Automates browser interactions using Playwright CLI and templates - takes screenshots, generates PDFs, clicks elements, fills forms, monitors console/network. Use when testing web pages, automating browser tasks, or when user mentions screenshots, web testing, form automation, or Playwright |
Hybrid browser automation using Playwright CLI for simple tasks and templates for complex interactions. Provides efficient automation without MCP server overhead.
Use this skill when you need to:
- Take screenshots or generate PDFs
- Test web pages or forms
- Click elements or fill inputs
- Monitor console logs or network requests
- Automate browser interactions
Don't use when:
- Simple HTTP requests suffice (use fetch/curl)
- Need persistent browser sessions across conversations
Use Playwright CLI directly for:
- Screenshot:
npx playwright screenshot <url> <filename> - PDF:
npx playwright pdf <url> <filename> - Open browser:
npx playwright open <url>(for manual inspection)
Use templates (16 total) for tasks requiring state management, event handling, or multi-step logic:
User Interactions (6)
- Click element with wait
- Fill form field with validation
- Hover over element
- Drag and drop
- Press keyboard key
- Select dropdown option
Form Handling (2)
- Fill multiple fields (bulk)
- Upload file
Page Monitoring (3)
- Capture accessibility snapshot
- Get console messages (event listening)
- Get network requests (event listening)
Advanced (5)
- Evaluate JavaScript
- Navigate back with wait
- Resize browser window
- Handle dialogs (alert/confirm/prompt)
- Wait for element with timeout
First time setup:
npm install -g playwright
npx playwright install chromium# Screenshot
npx playwright screenshot https://example.com ./tmp/playwright/screenshot.png
# PDF
npx playwright pdf https://example.com ./tmp/playwright/page.pdf
# Open browser for manual inspection
npx playwright open https://example.com# Click element (requires wait logic)
node $SKILL_DIR/templates/click.js https://example.com "button:has-text('Submit')"
# Fill form (multiple fields)
node $SKILL_DIR/templates/fill-form.js https://example.com '{"input[name=email]":"test@example.com"}'
# Monitor console (event listening)
node $SKILL_DIR/templates/console-messages.js https://example.comImportant Guidelines:
- Prefer CLI first: Use
npx playwrightfor screenshots, PDFs, and simple evaluation - Use templates when needed: Complex interactions, event listening, multi-step logic
$SKILL_DIRis automatically set to the skill's absolute path by Claude- Never use
cdbefore running commands - Never write inline Playwright code with
node -eor heredocs
Note: Output files are saved to ./tmp/playwright/ in the current project directory by default.
- Complete usage guide: See reference/TEMPLATES.md
- Template reference: Each template includes usage instructions in file header