← Back to list

browser-testing
by simula-labs
⭐ 0🍴 0📅 Jan 16, 2026
SKILL.md
name: browser-testing description: Browser automation skill. ALWAYS use this for ANY browser-related task including ブラウザテスト, ブラウザ操作, E2Eテスト, page check, localhost, screenshot.
Browser Testing Skill
ブラウザテストを実行する際のルール集。
重要なルール
1. agent-browser優先(スクリプト生成禁止)
❌ NG: TypeScript/JavaScriptスクリプトを生成して実行
✅ OK: npx agent-browser コマンドをBashで実行(優先)
✅ OK: MCP Playwrightツールを使う(フォールバック)
2. --headed オプション必須
ブラウザを表示してユーザーが確認できるようにする。
3. スクリーンショット必須
各ステップでスクリーンショットを取得してエビデンスを残す。
保存先: test-results/ ディレクトリ
4. テスト終了後はブラウザを閉じる
正常終了時もエラー時も close コマンドでブラウザを終了する。
agent-browser close --session test
5. 実行方法の選択
テスト開始前にユーザーに確認:
| 選択肢 | 説明 |
|---|---|
| メインエージェント(推奨) | 進捗がリアルタイムで見える。デバッグしやすい |
| サブエージェント | バックグラウンドで実行。並行作業時に便利 |
デフォルトは「メインエージェント」。
テスト開始前の自動確認
サーバー起動確認(自動検出)
ポート番号はpackage.jsonやlsofで自動検出:
lsof -i -P -n | grep LISTEN
起動していない場合はpackage.jsonを確認してバックグラウンドで起動。
認証情報
.env.claude から読み取り(/browser-testing-setupで設定):
| 変数名 | 必須 | 説明 |
|---|---|---|
| TEST_USERNAME | ✅ | ユーザー名/メールアドレス |
| TEST_PASSWORD | ✅ | パスワード |
| TEST_ORGANIZATION | - | 組織名 |
| TEST_ORG_SWITCH_STEPS | - | 組織切り替え手順 |
設定がない場合は /browser-testing-setup を案内。
注意事項
- スクリプト生成禁止
- --headed必須(ブラウザ表示)
- スクリーンショット必須(test-results/に保存)
- テスト終了後はブラウザを閉じる
- エラー時もブラウザを閉じる
- 認証情報はログに出力しない
test-results/を.gitignoreに追加推奨
Score
Total Score
55/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
○最近の活動
3ヶ月以内に更新がある
0/10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
○言語
プログラミング言語が設定されている
0/5
○タグ
1つ以上のタグが設定されている
0/5
Reviews
💬
Reviews coming soon