play-tight

Play-Tight

Play-Tight provides context-efficient browser automation using Playwright scripts executed via bash, with an optional subagent pattern for isolating verbose browser responses. The skill replaces the verbose Playwright MCP server with optimized scripts and subagent patterns to minimize context window pollution, saving context for actual engineering processes.

When to Use This Skill

Use Play-Tight when you need to:

• Verify elements exist on web pages (buttons, forms, links)
• Extract text content or structured data from websites
• Check status of web dashboards (CI/CD, monitoring, PRs)
• Take screenshots of pages or specific elements
• Automate repetitive browser tasks
• Validate web application behavior

Automatic Browser Detection

IMPORTANT: Before using any Playtight script, automatically check if Playwright browsers are installed.

Detection Process

1. Check for browser installation by running:

node -e "const { chromium } = require('playwright'); chromium.executablePath()" 2>&1

1. If the check fails (exit code non-zero or error message):

   • Inform the user that Playwright browsers need to be installed
   • Offer to run the installation: "I can install the required browsers by running npm run install-browsers in the scripts directory. Would you like me to do that?"
   • If user agrees, run:

   cd ~/.claude/plugins/mad-skills/play-tight/scripts && npm run install-browsers
   

2. If npm dependencies are missing (error about 'playwright' module not found):

   • First install npm dependencies: cd ~/.claude/plugins/mad-skills/play-tight/scripts && npm install
   • Then install browsers: npm run install-browsers

Example Detection Flow

# First attempt to use a script
node scripts/check-element.js https://example.com h1

# If error mentions "browserType.launch: Executable doesn't exist"
# Or "Cannot find module 'playwright'"

# Then detect and offer installation:
"I see that Playwright browsers aren't installed yet. I can install them now by running 'npm run install-browsers'. This will download Chromium (~100MB). Would you like me to proceed?"

# On user approval:
cd ~/.claude/plugins/mad-skills/play-tight/scripts && npm install && npm run install-browsers