Agent Skill
2/7/2026

browser-testing

Browser automation skill. ALWAYS use this for ANY browser-related task including ブラウザテスト, ブラウザ操作, E2Eテスト, page check, localhost, screenshot.

S
simula
0GitHub Stars
1Views
npx skills add simula-labs/claude-code-marketplace

SKILL.md

Namebrowser-testing
DescriptionBrowser automation skill. ALWAYS use this for ANY browser-related task including ブラウザテスト, ブラウザ操作, E2Eテスト, page check, localhost, screenshot.

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 に追加推奨
Skills Info
Original Name:browser-testingAuthor:simula