browser-qa-plus

Built on affaan-m/ECC by @affaan-m (246,833 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

A Claude Code skill that tests web pages, user actions, page speed, screen sizes, and access needs after a deploy.

Made for developers who want a clear QA check before they release a site.

🔍 Why

A page can look fine on one screen and fail on another.

Forms may break. Menus may not open. A page may be slow or hard to use with a keyboard.

This skill gives Claude Code a safe, clear test plan. It checks the main tasks first and records proof when something fails.

It is one file with no added packages. It fits into your current browser test flow.

⚡ Install

Replace OWNER with the GitHub account that hosts this repo, then run one command:

curl --create-dirs -fsSL https://raw.githubusercontent.com/OWNER/browser-qa-plus/main/skill/SKILL.md -o ~/.claude/skills/browser-qa/SKILL.md

🧪 Usage

Ask Claude Code:

Use browser-qa to test https://preview.example.com on phone, tablet, and desktop.

Check sign-up, login, search, and the main menu.
Do not send email or make a real payment.

Expected output:

## QA Report: https://preview.example.com
Result: FAIL

### Summary
- Passed: 12
- Failed: 1
- Blocked: 1
- Not tested: 1

### Bugs
- BUG-1: The phone menu does not open at 375 px.

### Blocked Tests
- Login test: No test login was ready.

The report marks each check as passed, failed, blocked, not tested, or ready for review. Failed checks include the URL, screen size, steps, expected result, actual result, and proof.

🛠️ What we changed vs upstream

• 全文が日本語から平易な英語に書き直され、ECCへの明示的なクレジット表記が追加された。
• URL、対象タスク、テスト用ログイン、許可されたデータ、比較画像を事前確認する手順が追加された。
• 課金・公開・送信・本番データ変更を避ける安全策と、認証情報がない場合の「blocked」扱いが明文化された。
• 操作テストが、境界値入力、戻るボタン、新規タブ、各種UI状態などを含む、より具体的な手順へ拡張された。
• 表示・アクセシビリティ確認が、全ページ画像、200%ズーム、意図された変更の除外、詳細なWCAG項目まで強化された一方、元のレポート形式と統合案は削除された。

📄 License

Released under the MIT License. The upstream MIT license and credit are preserved in UPSTREAM_LICENSE.