v4.1.0

What's New

• Custom HTTP Headers Support - Added ability to configure custom HTTP headers for browser requests (#17)

Installation

claude mcp add playwright-skill -- npx --yes @anthropic-ai/claude-code-mcp-server skill https://github.com/lackeyjb/playwright-skill/releases/download/v4.1.0/playwright-skill.tar.gz

v4.0.2 - Path Resolution Fix

Fixes

• Fixed dynamic path resolution for all installation methods (#2)
  • Resolves path mismatch between plugin installation and hardcoded paths
  • Eliminates trial-and-error when Claude discovers skill directory
  • Supports plugin system, manual global, and project-specific installations
  • Replaced 9 hardcoded path references with dynamic $SKILL_DIR placeholder

What Changed

This patch release fixes a critical bug where the skill documentation referenced hardcoded paths that didn't match the actual plugin installation location, causing Claude to use trial-and-error to find the correct directory.

v4.0.1 - Documentation Improvements

Documentation Improvements

This release focuses on improving the README for better clarity and professionalism:

Changes

• Removed gimmicky elements (checkmarks, tagline footer)
• Streamlined installation and verification instructions
• Condensed all sections for better readability
• Removed changelog section from README
• Reorganized content flow - moved "What is a Claude Skill?" to the end for better information hierarchy

Installation

Via Plugin System (Recommended):

/plugin marketplace add lackeyjb/playwright-skill
/plugin install playwright-skill@playwright-skill
cd ~/.claude/plugins/marketplaces/playwright-skill/skills/playwright-skill
npm run setup

Manual Installation:

cd ~/.claude/skills
git clone https://github.com/lackeyjb/playwright-skill.git
cd playwright-skill/skills/playwright-skill
npm run setup

Full Changelog: v4.0.0...v4.0.1

v4.0.0 - Auto-Detection & Smart Test Management

🎉 Major Release: Auto-Detection & Smart Test Management

Version 4.0.0 brings significant workflow improvements that eliminate common friction points when testing with Playwright.

✨ What's New

🔍 Auto-Detect Dev Servers

• Automatically scans common ports (3000, 3001, 3002, 5173, 8080, 8000, 4200, 5000, 9000, 1234)
• Smart workflow:
  • 1 server found → Uses automatically
  • Multiple servers → Asks which one to test
  • No servers → Asks for URL or offers to help start one
• No more hardcoded URLs or manual edits!

🧹 Clean Test Management

• All test scripts now written to /tmp/playwright-test-*.js
• Automatic cleanup by OS (no project clutter)
• No more test files polluting your skill directory

🔗 URL Parameterization

• Every example includes TARGET_URL constant at the top
• Easy to modify if auto-detection picks wrong server
• Consistent pattern across all code examples

📚 Inline Execution Support

• Quick one-off tasks can be executed inline
• No file creation for simple screenshots or checks
• Documentation on when to use inline vs files

🔧 Technical Changes

New Functions:

• detectDevServers() in lib/helpers.js - Scans for running servers

Documentation:

• Complete rewrite of SKILL.md with critical workflow section
• Updated all examples to use /tmp and parameterized URLs
• New execution pattern showing server detection flow
• Enhanced tips section with best practices

📊 Impact

Before v4.0.0 (from real user transcript):

• ❌ Hardcoded localhost:3000
• ❌ Server was on port 3001 → required 3 manual edits
• ❌ No server detection
• ❌ Test files cluttered skill directory
• ❌ Hook errors from writing to wrong location

After v4.0.0:

• ✅ Auto-detects port 3001
• ✅ Zero manual edits needed
• ✅ Proactive server detection
• ✅ All files in /tmp (clean)
• ✅ No hook errors

🚀 Upgrade Notes

This is a major version bump due to workflow changes:

Breaking Changes:

• Skill now expects to run server detection before localhost testing
• Test files are written to /tmp instead of skill directory

Migration:

• No action needed - skill handles everything automatically
• Old test files in skill directory can be safely deleted

📖 Documentation

Updated examples show the new workflow:

1. Auto-detect servers
2. Write test to /tmp with parameterized URL
3. Execute and enjoy clean results

See SKILL.md for complete details and examples.

---

Full Changelog: v3.2.0...v4.0.0

v3.2.0 - Plugin Structure Fix

What's Changed

This release fixes the plugin structure to properly comply with Claude Code's plugin schema requirements.

Structural Changes

• Fixed plugin.json schema - Removed invalid skills field and corrected author and repository formats to match Claude Code validation requirements
• Reorganized directory structure - Moved skill files into skills/playwright-skill/ subdirectory following standard Claude Code plugin conventions
• Updated documentation - README now reflects the new nested directory structure for both manual and plugin installations

Installation

Via Plugin System (Recommended):
```bash
/plugin marketplace add lackeyjb/playwright-skill
/plugin install playwright-skill@playwright-skill
cd ~/.claude/plugins/marketplaces/playwright-skill/skills/playwright-skill
npm run setup
```

Manual Installation:
```bash
cd ~/.claude/skills
git clone https://github.com/lackeyjb/playwright-skill.git
cd playwright-skill/skills/playwright-skill
npm run setup
```

Breaking Changes

• Directory structure has changed - manual installers should reinstall or adjust paths
• Skill files now located in `skills/playwright-skill/` subdirectory

Bug Fixes

• Fixed plugin.json validation errors preventing installation via Claude Code plugin system
• Corrected plugin structure to match official Claude Code schema

---

Full Changelog: v3.1.0...v3.2.0

v3.1.0 - Marketplace Installation Support

🎉 Marketplace Installation Now Available!

You can now install the Playwright Skill directly from GitHub using Claude Code's plugin marketplace system!

Installation

New: Via Plugin Marketplace (Recommended)

/plugin marketplace add lackeyjb/playwright-skill
/plugin install playwright-skill@playwright-skill

Alternative: Manual Git Clone

cd ~/.claude/skills
git clone https://github.com/lackeyjb/playwright-skill.git
cd playwright-skill
npm run setup

What's New

• ✅ Marketplace Support - Added .claude-plugin/marketplace.json for direct GitHub installation
• ✅ Simplified Installation - No more manual git clone required
• ✅ Updated Documentation - Clear instructions for marketplace-based installation
• ✅ Cleaner README - Removed plugin management commands section

Features

• 🎭 Any Automation Task - Claude writes custom code for your specific request
• 👁️ Visible Browser by Default - See what's happening in real-time
• 🔧 Zero Module Resolution Errors - Universal executor ensures proper module access
• 📦 Progressive Disclosure - Concise SKILL.md with full API reference loaded only when needed

Notes

• Minor version bump - New feature (marketplace installation) added
• No breaking changes - All v3.0.x functionality remains unchanged
• Backward compatible - Manual installation still fully supported

---

Full Changelog: v3.0.1...v3.1.0

v3.0.1 - Documentation Improvements

Documentation Updates

This release includes important documentation improvements to help users install and understand the Playwright Skill.

Changes

• ✅ Plugin Installation Instructions - Added comprehensive guide for installing via /plugin commands
• ✅ Terminology Updates - Properly explains Claude Skills vs Plugins with links to official documentation
• ✅ Installation Options - Clarified plugin system installation vs manual git clone
• ✅ Plugin Management - Added commands for enabling, disabling, and uninstalling the plugin
• ✅ Verification Steps - Added post-installation verification guide
• ✅ Official Documentation Links - Links to Anthropic's Skills, Plugins, and Marketplace docs

Installation

Via Plugin System (when added to a marketplace):

/plugin install playwright-skill@marketplace-name

Via Git Clone (current method):

cd ~/.claude/skills
git clone https://github.com/lackeyjb/playwright-skill.git
cd playwright-skill
npm run setup

Notes

• No code changes - All v3.0.0 functionality remains unchanged
• Documentation only - Safe to update without breaking changes

---

Full Changelog: v3.0.0...v3.0.1

v3.0.0 - Initial Release

Playwright Skill for Claude Code

General-purpose browser automation with Playwright. Test pages, automate interactions, validate UX - any browser task on-the-fly with visible browser by default.

Features

• ✅ Any automation task - not limited to pre-built scripts
• ✅ Visible browser by default for debugging
• ✅ Zero module resolution errors
• ✅ Progressive disclosure pattern
• ✅ Safe cleanup and comprehensive helpers

Installation

cd ~/.claude/skills
git clone https://github.com/lackeyjb/playwright-skill.git
cd playwright-skill
npm run setup