unit-test

A workflow for checking user-facing scenarios with Playwright, a browser automation tool, and reporting whether each scenario passes, fails, or needs attention.

In plain words
What is it for?
Use it after implementing a feature, to generate and run happy-path or broader scenarios, review visual details, and optionally rerun after an automatic fix.
Why use it?
It catches regressions in how a feature behaves in a browser; despite its name, it is scenario-based end-to-end testing rather than static unit testing.

Skill for Claude CodeCodex

Part of the unit-test plugin — 1 skill shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cubha/claude-workflow-plugins/unit-test
Any agent
npx skills add cubha/claude-workflow-plugins --skill unit-test
Clone the repo
git clone --depth 1 https://github.com/cubha/claude-workflow-plugins

Made for: Claude Code, Codex.

Or install unit-test, the plugin that ships this one along with the rest of its 1 skill.

Per session 127 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,035 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00127 $0.05035
Opus 5 $0.00063 $0.02518
Sonnet 5 $0.00025 $0.01007
Haiku 4.5 $0.00013 $0.00504

Measured 2d ago against content hash 391bd3af6253, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

unit-test scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/unit-test/skills/unit-test/SKILL.md · 332 lines

How it starts

The opening of the file, as written. The whole thing — 332 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UNIT-TEST 기능 단위 테스트

$ARGUMENTS 에 대해 아래 파이프라인을 실행한다.

SCOPE → STORYBOARD → GENERATE → EXECUTE (+ 4.5 VISUAL-UX) → REPORT

분기 — 검증 vs 디버깅

상황 사용 방식 이유
기능이 의도대로 동작하는지 검증 (PASS/FAIL/WARN) /unit-test 시나리오 단위 회귀 검증
버그 현상 발생 — 원인 특정 필요 디버깅 워크플로우(예: debugger 스킬) 가설 도출 → 로그 삽입 → 재현 → 수정/정리
신규 구현 직후 동작 확인 /unit-test --happy-only 빠른 정상 흐름 검증
FAIL 발견 후 원인 추적·수정 디버깅 워크플로우로 전환 unit-test는 검증만, 로그 삽입·정리 미수행

--fix 플래그가 있어도 unit-test는 단순 재실행(최대 2회)만 수행. 원인 분석·로그 삽입·grep 검증이 필요하면 디버깅 워크플로우로 전환한다.

정적 단위 테스트 게이트와의 관계 (네이밍 주의): 이 스킬은 이름은 "unit-test"지만 실제로는 Playwright 기반 E2E/시나리오 동적 검증이다. vitest/jest 같은 정적 단위 테스트와는 레이어가 다르다 — 둘은 충돌이 아니라 상보다. 정적 단위 테스트(npm test)는 CI/빌드 게이트에서, 시나리오 동적 검증은 이 스킬에서 담당한다.


옵션 플래그

플래그 설명
--happy-only Happy Path 시나리오만 생성 (빠른 검증)
--auto 승인 없이 전체 파이프라인 연속 실행
--fix FAIL 발견 시 자동 수정 + 재검증
--no-ux-review Phase 4.5 Section B(LLM 폴리시 제안)만 스킵. Section A(design-lint 게이트)는 저비용이라 이 플래그와 무관하게 항상 실행(설치돼 있을 때)
--strict-visual Phase 4.5 Section A에 design-lint --strict를 전달(형제 겹침 D-LAYOUT-11 활성, low-confidence 기본 off). design-lint 미설치 시 무의미
--gate-visual Phase 4.5 Section A에 design-lint --gate-runtime을 전달(문서 레벨 가로 오버플로우만 error로 격상 — 해당 시나리오를 FAIL 취급). design-lint 미설치 시 무의미

Phase 1: SCOPE (테스트 범위 결정)

테스트 대상을 아래 우선순위로 결정한다.

우선순위 소스 조건 수집 방법
1 사용자 지정 $ARGUMENTS에 명시적 범위 존재 인자 파싱
2 Git Diff 인자 미지정 시 git diff HEAD~1 --name-only + git diff --cached --name-only → 변경 파일에서 기능 영역 추론
3 최근 작업 맥락 Diff도 없을 시 (non-git 또는 clean 상태) 프로젝트의 최근 완료 작업/이슈 기록(있으면)에서 대상 추론, 없으면 사용자에게 대상 확인

1-1. 변경 파일 분석

수집된 파일 목록에서:

  1. 테스트와 무관한 파일 제외 (설정 파일, README, 스타일만 변경 등)
  2. 남은 파일들의 기능 영역 분류 (컴포넌트, 훅, 유틸, 페이지 등)
  3. 각 파일을 읽어 사용자에게 노출되는 동작 파악

1-2. 진입점 결정

프로젝트 설정(CLAUDE.md·README·package.json 스크립트 등)에서 개발 서버 포트를 확인하고, 대상 기능의 접근 경로를 결정한다.

Read the full file on GitHub · 332 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 332 lines · 127 tokens per session scan A 391bd3af6253

Subscribe to this mod's changes

unit-test is a skill published in the GitHub repository cubha/claude-workflow-plugins (2 stars, last pushed 1mo ago), licensed MIT. It adds 127 tokens to every session and 5,035 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

browserstack

../../../engineering-team/playwright-pro/skills/browserstack/SKILL.md.

alirezarezvani/claude-skills · 0 tokens

ln-42-acceptance-test-builder

Creates, updates, consolidates, retires, and runs scoped acceptance tests using project-native tooling. Use when executable acceptance evidence must change; not for audits or product fixes.

levnikolaevich/claude-code-skills · 44 tokens

benchmark

Local-only regression / benchmark skill for ui-clone-skills maintainers. Drives the standard ui-reverse-engineering pipeline against the canonical reference site (https://realfood.gov) and records AE/SSIM, iteration count, gate fail counts, and outcome to benchmark/history.csv so prompt / sub-doc / model-version drift…

voidmatcha/ui-clone-skills · 152 tokens

electron-playwright-validator

This skill should be used when a user asks to launch, inspect, automate, test, validate, or debug an Electron desktop UI through Playwright/CDP, including blank renderers, runtime import failures, accessibility snapshots, layout defects, click-through flows, or post-change checks. Not for native macOS or mobile apps…

johnkozaris/jko-claude-plugins · 90 tokens

mobile-flows-maestro

This skill should be used when Maestro is explicitly requested or already present and the task is to author, run, or debug iOS/Android Maestro flows; use Maestro MCP; or handle Maestro selectors, system UI, permissions, Keychain, JavaScript, waits, device state, flakiness, or CI. Evidence includes a .maestro directory…

johnkozaris/jko-claude-plugins · 102 tokens

mastermind-browser-verification

Turn "I opened it and it looks fine" into recorded evidence — accessibility tree over screenshot, console and network errors as mechanical failures, viewport and colour-scheme checks as a checklist, and anything unchecked marked unchecked. Use after implementing a UI change in a client that can drive a browser.

xcrft/mastermind · 64 tokens