Playwright 코어 테스트 가이드
Playwright E2E·API·컴포넌트·시각·접근성 테스트를 실전 검증된 패턴으로 작성하고 디버깅하도록 돕는 스킬입니다.
개발·코딩중급★ 352⑂ 57AI 점수 9/10마지막 업데이트: 2026. 7. 2.
무엇을 해주나
getByRole()우선,waitForTimeout()금지 등 실전 검증된 골든 룰 10가지를 Claude에게 주입해 흔들리지 않는 테스트 코드를 쓰게 합니다.- 로케이터 전략, 웹 우선 어서션, 픽스처/훅, 네트워크 목킹, 인증 플로우, 시각 회귀, 접근성, API 테스트 등 46개 주제별 레퍼런스 가이드로 라우팅합니다.
- Next.js(App/Pages Router), React, Vue 3/Nuxt, Angular별 레시피와 flaky 테스트·에러 메시지 인덱스를 제공해 디버깅 시간을 줄여줍니다.
- TypeScript와 JavaScript 예시를 모두 다루고, 외부 페이지·API 응답을 신뢰하지 않는 보안 경계 규칙도 명시합니다.
이런 분께 추천
- Playwright로 E2E 테스트를 운영하는 프론트엔드 개발자 및 QA 엔지니어
- 자주 깨지는(flaky) 테스트와 CI 재시도 설정에 시달리는 팀
- 테스트 아키텍처(E2E vs 컴포넌트 vs API)나 목킹 범위를 결정해야 하는 리드 개발자
활용 예시
- "로그인 플로우 테스트를 작성해줘" → storageState 기반 인증 재사용 패턴으로 로그인 픽스처와 테스트를 생성.
- "이 테스트가 CI에서만 실패해" → flaky-tests·debugging 가이드를 참조해 trace 분석과 웹 우선 어서션으로 교체.
- "결제 API 목킹해서 체크아웃 테스트 만들어줘" → 서드파티만 목킹하고 자체 앱은 실제로 태우는 when-to-mock 원칙에 따라
page.route()예시 작성.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/testdino-hq/playwright-skill/HEAD/core/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 testdino-hq/playwright-skill 의 core 폴더를 내 ~/.claude/skills/playwright-core/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/testdino-hq/playwright-skill.git && mkdir -p ~/.claude/skills && cp -r playwright-skill/core ~/.claude/skills/playwright-core⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 작업 폴더로 이동합니다.
- 저장소를 내려받습니다:
git clone https://github.com/testdino-hq/playwright-skill.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 가이드 파일까지 통째로 복사합니다:
cp -r playwright-skill/core ~/.claude/skills/playwright-core ~/.claude/skills/playwright-core/SKILL.md와 함께locators.md,debugging.md등 참조 문서가 같이 복사됐는지 확인합니다.- Claude Code를 다시 시작하고 "Playwright 테스트를 작성해줘"처럼 요청하면 스킬이 자동으로 발동합니다.
- 프로젝트에 Playwright가 없다면
npm init playwright@latest로 먼저 설치하세요.
GitHub에서 원본 보기 ↗라이선스: MIT