코딩 에이전트를 위한 범용 극작가 자동화

간단한 페이지 테스트부터 복잡한 다단계 플로우까지 실시간으로 Playwright 자동화를 작성하고 실행할 수 있게 해주는 에이전트 스킬입니다. 또한 편리한 설치를 위해 Claude Code 플러그인으로도 패키지로 제공됩니다.

Claude는 브라우저 자동화 필요에 따라 이 기술을 언제 사용할지 자율적으로 결정하며, 특정 작업에 필요한 최소한의 정보만 불러옵니다.

클로드 코드로 만들었습니다.

특징

• 모든 자동화 작업 - Claude는 사전 구축된 스크립트에 국한되지 않고 귀하의 특정 요청에 맞춰 맞춤형 코드를 작성합니다
• 기본적으로 보이는 브라우저 - [[T0]로 실시간 자동화 확인
• 휴대용 실행 도구 - 파일 및 인라인 스크립트를 안정된 모듈 해상도로 실행함
• 점진적 공개 - 필요한 경우에만 전체 API 참조를 로드하는 간결한 SKILL.md
• Safe Cleanup - 경쟁 조건 없는 스마트 임시 파일 관리
• 종합 헬퍼 - 일반적인 작업에 대한 선택적 유틸리티 기능

설치

이 저장소에는 표준 에이전트 스킬과 Claude Code 플러그인 래퍼가 포함되어 있습니다.

Playwright Skill

General-purpose Playwright automation for coding agents

An Agent Skill that enables coding agents to write and execute Playwright automation on the fly, from simple page tests to complex multi-step flows. It is also packaged as a Claude Code Plugin for convenient installation.

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
• Portable executor - Runs file and inline scripts with stable module resolution
• 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

Installation

This repository contains a standard Agent Skill and a Claude Code plugin wrapper. The recommended installation method is Vercel’s skills CLI, which installs skills into the native locations for supported agents.

Why this skill?

Use this skill when the agent needs to write a real Playwright program: loops, assertions, multiple contexts, network interception, screenshots, video, or a script you want to keep and rerun. It also provides dev-server detection and a small set of focused helpers.

For straightforward interactive browsing, start with Microsoft’s official @playwright/cli and install its agent skills with playwright-cli install --skills. For tool-based browser control with accessibility snapshots, use playwright-mcp. This project is the code-first option when the automation itself is the useful artifact.

Understanding the Structure

This repository uses the plugin format with a nested structure:

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

The repository keeps the skill inside the plugin’s skills/ directory. Installers handle that layout automatically; manual copying is only a fallback for clients without an installer.

---

Option 1: Install with skills (Recommended)

Install globally for your user:

npx skills add lackeyjb/playwright-skill --skill playwright-skill --global --yes

Install only for the current project by omitting --global:

npx skills add lackeyjb/playwright-skill --skill playwright-skill --yes

To target specific agents, add --agent followed by one or more agent IDs: