secondsky/claude-skills / plugins/playwright/skills/playwright
playwright
VerifiedBrowser automation and E2E testing with Playwright. Auto-detects dev servers, writes clean test scripts. Test pages, fill forms, take screenshots, check responsive design, validate UX, test login flows, check links, automate any browser task. Use for cross-browser testing, visual regression, API testing, component testing in TypeScript/JavaScript and Python projects.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.4 KB |
| examples/form-test.js | script | 876 B |
| examples/link-checker.js | script | 1.8 KB |
| examples/responsive-test.js | script | 1.1 KB |
| lib/helpers.js | script | 13.2 KB |
| package.json | manifest | 1.0 KB |
| references/API_REFERENCE.md | markdown | 14.6 KB |
| run.js | script | 7.1 KB |
run.js
View on GitHub#!/usr/bin/env node
/**
* Universal Playwright Executor for Claude Code
*
* Executes Playwright automation code from:
* - File path: node run.js script.js
* - Inline code: node run.js 'await page.goto("...")'
* - Stdin: cat script.js | node run.js
*
* Ensures proper module resolution by running from skill directory.
*/
const fs = require('fs');
const path = require('path');
const { execSync } = require('child_process');
// Change to skill directory for proper module resolution
process.chdir(__dirname);
/**
* Check if Playwright is installed
*/
function checkPlaywrightInstalled() {
try {
require.resolve('playwright');
return true;
} catch (e) {
return false;
}
}
/**
* Install Playwright if missing.
*
* Supply-chain trust assumption: first-run auto-install trusts the Playwright
* npm package and the CDN-hosted Chromium binary. For production use, pre-install
* Playwright in your image and set PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 so this
* step is skipped entirely.
*/
function installPlaywright() {
console.log('π¦ Playwright not found. Installing...');
try {
// Try bun first, fallback to npm
const packageManager = fs.existsSync(path.join(__dirname, 'bun.lockb')) ? 'bun' : 'npm';
const skipBrowserDownload = process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD === '1';
if (packageManager === 'bun') {
execSync('bun install', { stdio: 'inherit', cwd: __dirname });
if (!skipBrowserDownload) {
execSync('bunx playwright install chromium', { stdio: 'inherit', cwd: __dirname });
}
} else {
execSync('npm install', { stdio: 'inherit', cwd: __dirname });
if (!skipBrowserDownload) {
execSync('npx playwright install chromium', { stdio: 'inherit', cwd: __dirname });
}
}
console.log('β
Playwright installed successfully');
return true;
} catch (e) {
console.error('β Failed to install Playwright:', e.message);
console.error('Please run manually: cd', __dirname, '&& bun run setup');
return false;
}
}
/**
* Get code to execute from various sources
*/
function getCodeToExecute() {
const args = process.argv.slice(2);
// Case 1: File path provided
if (args.length > 0 && fs.existsSync(args[0])) {
const filePath = path.resolve(args[0]);
console.log(`π Executing file: ${filePath}`);
return fs.readFileSync(filePath, 'utf8');
}
// Case 2: Inline code provided as argument
if (args.length > 0) {
console.log('β‘ Executing inline code');
return args.join(' ');
}
// Case 3: Code from stdin
if (!process.stdin.isTTY) {
console.log('π₯ Reading from stdin');
return fs.readFileSync(0, 'utf8');
}
// No input
console.error('β No code to execute');
console.error('Usage:');
console.error(' node run.js script.js # Execute file');
console.error(' node run.js "code here" # Execute inline');
console.error(' cat script.js | node run.js # Execute from stdin');
process.exit(1);
}
/**
* Clean up old temporary execution files from previous runs
*/
function cleanupOldTempFiles() {
try {
const files = fs.readdirSync(__dirname);
const tempFiles = files.filter(f => f.startsWith('.temp-execution-') && f.endsWith('.js'));
if (tempFiles.length > 0) {
tempFiles.forEach(file => {
const filePath = path.join(__dirname, file);
try {
fs.unlinkSync(filePath);
} catch (e) {
// Ignore errors - file might be in use or already deleted
}
});
}
} catch (e) {
// Ignore directory read errors
}
}
/**
* Wrap code in async IIFE and export as promise for dynamic import
*/
function wrapCodeIfNeeded(code) {
// Check if code already has require() and async structure
const hasRequire = code.includes('require(');
const hasAsyncIIFE = code.includes('(async () => {') || code.includes('(async()=>{');
// If it's already a complete script, wrap it to export the promise
if (hasRequire && hasAsyncIIFE) {
return `
${code}
// Note: The above code contains an async IIFE. If you need to wait for it,
// ensure it's exported or awaited properly.
`;
}
// If it's just Playwright commands, wrap in full template
if (!hasRequire) {
return `
const { chromium, firefox, webkit, devices } = require('playwright');
const helpers = require('./lib/helpers');
// Extra headers from environment variables (if configured)
const __extraHeaders = helpers.getExtraHeadersFromEnv();
/**
* Utility to merge environment headers into context options.
* Use when creating contexts with raw Playwright API instead of helpers.createContext().
* @param {Object} options - Context options
* @returns {Object} Options with extraHTTPHeaders merged in
*/
function getContextOptionsWithHeaders(options = {}) {
if (!__extraHeaders) return options;
return {
...options,
extraHTTPHeaders: {
...__extraHeaders,
...(options.extraHTTPHeaders || {})
}
};
}
module.exports = (async () => {
try {
${code}
} catch (error) {
console.error('β Automation error:', error.message);
if (error.stack) {
console.error(error.stack);
}
process.exit(1);
}
})();
`;
}
// If has require but no async wrapper
if (!hasAsyncIIFE) {
return `
module.exports = (async () => {
try {
${code}
} catch (error) {
console.error('β Automation error:', error.message);
if (error.stack) {
console.error(error.stack);
}
process.exit(1);
}
})();
`;
}
return code;
}
/**
* Main execution
*/
async function main() {
console.log('π Playwright Skill - Universal Executor\n');
// Clean up old temp files from previous runs
cleanupOldTempFiles();
// Check Playwright installation
if (!checkPlaywrightInstalled()) {
const installed = installPlaywright();
if (!installed) {
process.exit(1);
}
}
// Get code to execute
const rawCode = getCodeToExecute();
const code = wrapCodeIfNeeded(rawCode);
// Create temporary file for execution
const tempFile = path.join(__dirname, `.temp-execution-${Date.now()}.js`);
try {
// Write code to temp file
fs.writeFileSync(tempFile, code, 'utf8');
// Execute the code using dynamic import
console.log('π Starting automation...\n');
// Convert file path to file URL for dynamic import
const { pathToFileURL } = require('url');
const fileUrl = pathToFileURL(tempFile).href;
// Use dynamic import and await the exported promise
const module = await import(fileUrl);
if (module.default) {
await module.default;
}
// Clean up temp file after completion
try {
fs.unlinkSync(tempFile);
} catch (e) {
// Ignore cleanup errors
}
} catch (error) {
console.error('β Execution failed:', error.message);
if (error.stack) {
console.error('\nπ Stack trace:');
console.error(error.stack);
}
// Clean up temp file on error
try {
fs.unlinkSync(tempFile);
} catch (e) {
// Ignore cleanup errors
}
process.exit(1);
}
}
// Run main function
main().catch(error => {
console.error('β Fatal error:', error.message);
process.exit(1);
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |