playwright-py-skill

Playwright Skill for Claude Code

General-purpose browser automation as a Claude Skill

A Claude Skill that enables Claude to write and execute any Playwright automation on-the-fly - from simple page tests to complex multi-step flows. Packaged as a Claude Code Plugin for easy installation and distribution.

Claude autonomously decides when to use this skill based on your browser automation needs, loading only the minimal information required for your specific task.

Made using Claude Code.

Features

• Any Automation Task - Claude writes custom code for your specific request, not limited to pre-built scripts
• Visible Browser by Default - See automation in real-time with headless=False
• Zero Module Resolution Errors - Universal executor ensures proper module access
• Progressive Disclosure - Concise SKILL.md with full API reference loaded only when needed
• Safe Cleanup - Smart temp file management without race conditions
• Comprehensive Helpers - Optional utility functions for common tasks
• PEP 723 Metadata - All scripts include inline dependency specifications
• Always Uses Playwright 1.57.0 - Exact version pinned for consistency

Installation

This repository is structured as a Claude Code Plugin containing a skill. You can install it as either a plugin (recommended) or extract it as a standalone skill.

Understanding the Structure

This repository uses the plugin format with a nested structure:

playwright-py-skill/              # Plugin root
├── .claude-plugin/           # Plugin metadata
└── skills/
    └── playwright-py-skill/     # The actual skill
        └── SKILL.md

Claude Code expects skills to be directly in folders under .claude/skills/, so manual installation requires extracting the nested skill folder.

Prerequisites

• Python 3.10 or later (required for PEP 723 support)
• Chromium browser (correct version for Playwright 1.57.0) - must be installed separately
• uv package manager (for running scripts with PEP 723 metadata)

Note: This skill does NOT install browsers. Chromium must be installed separately at the correct version for Playwright 1.57.0.

---

Option 1: Plugin Installation (Recommended)

Install via Claude Code's plugin system for automatic updates and team distribution:

# Add this repository as a marketplace
/plugin marketplace add akaihola/playwright-py-skill

# Install the plugin
/plugin install playwright-py-skill@playwright-py-skill

# Verify installation (auto-installs playwright==1.57.0)
cd ~/.claude/plugins/marketplaces/playwright-py-skill/skills/playwright-py-skill
uv run run.py --help

Verify installation by running /help to confirm the skill is available.

---

Option 2: Standalone Skill Installation

To install as a standalone skill (without the plugin system), extract only the skill folder:

Global Installation (Available Everywhere):

# Clone to a temporary location
git clone https://github.com/akaihola/playwright-py-skill.git /tmp/playwright-py-skill-temp

# Copy only the skill folder to your global skills directory
mkdir -p ~/.claude/skills
cp -r /tmp/playwright-py-skill-temp/skills/playwright-py-skill ~/.claude/skills/

# Navigate to the skill and run setup (auto-installs playwright==1.57.0)
cd ~/.claude/skills/playwright-py-skill
uv run run.py --help

# Clean up temporary files
rm -rf /tmp/playwright-py-skill-temp

Project-Specific Installation:

# Clone to a temporary location
git clone https://github.com/akaihola/playwright-py-skill.git /tmp/playwright-py-skill-temp

# Copy only the skill folder to your project
mkdir -p .claude/skills
cp -r /tmp/playwright-py-skill-temp/skills/playwright-py-skill .claude/skills/

# Navigate to the skill and run setup (auto-installs playwright==1.57.0)
cd .claude/skills/playwright-py-skill
uv run run.py --help

# Clean up temporary files
rm -rf /tmp/playwright-py-skill-temp

Why this structure? The plugin format requires the skills/ directory for organizing multiple skills within a plugin. When installing as a standalone skill, you only need the inner skills/playwright-py-skill/ folder contents.

---

Option 3: Download Release

1. Download and extract the latest release from GitHub Releases
2. Copy only the skills/playwright-py-skill/ folder to:
   • Global: ~/.claude/skills/playwright-py-skill
   • Project: /path/to/your/project/.claude/skills/playwright-py-skill
3. Navigate to the skill directory and run setup:

   cd ~/.claude/skills/playwright-py-skill  # or your project path
   uv run run.py --help
   

---

Verify Installation