dark-mode-testing について
アプリのダークテーマ表示を、ライト/ダークのスクリーンショットとアクセシビリティツリーで確認するテストスキルです。ブラウザーでの検査と問題報告の手順を示します。
主な機能
- 01ライト/ダークのスクリーンショット撮影
- 02複数の方法でテーマを切り替え
- 03アクセシビリティツリーと画像の確認
- 04コントラスト、色、枠線、入力欄の検査
- 05修正用の問題報告
活用シーン
- 01Webページのダークテーマ表示を確認
- 02暗い背景で見えないテキストを発見
- 03ライト専用の枠線やフォーム欄を特定
- 04修正を記録してページを再テスト
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ revitalb-port/ skills-registry-demo --skill dark-mode-testingインストール後、Claude Code で/dark-mode-testingを入力して読み込まれたか確認します。
詳細
ダークモードのテスト
テーマを切り替えて比較し、ダークモードが正しく動作することを確認します。
ワークフロー
1. アプリを開く
browser_navigate を使用して、対象のページに移動します。
2. ライトモードのスクリーンショットを撮る
browser_take_screenshot を使用して、ページのデフォルト(ライト)状態のスクリーンショットを撮ります。
3. ダークモードに切り替える
次のいずれかの方法でダークモードに切り替えます(上から順に試してください)。
- クラスの切り替え:JS を実行して、
<html>にdarkクラスを追加します。document.documentElement.classList.toggle('dark') - 属性の切り替え:
data-theme="dark"を設定します。document.documentElement.setAttribute('data-theme', 'dark') - メディアクエリ:ブラウザーで
prefers-color-scheme: darkをエミュレートします。 - UI の切り替え:
browser_snapshotでテーマ切り替えボタンを見つけてクリックします。
4. ダークモードのスクリーンショットを撮る
切り替え後に、もう一度スクリーンショットを撮ります。
5. 問題がないか確認する
browser_snapshot の aria ツリーとスクリーンショットを確認し、次の問題がないかチェックします。
- 白いフラッシュ:
bg-white dark:bg-slate-900ではなく、bg-whiteがハードコードされた要素 - 見えないテキスト:ダーク背景と同じ色のテキスト(例:ダーク背景に黒いテキスト)
- ボーダーの欠落:ライトモード専用の色が使われ、ダーク背景で見えなくなるボーダー
- コントラスト違反:ダーク背景とのコントラストが低すぎるテキスト(4.5:1 が必要です)
- 色のハードコード:インラインスタイル内の
#ffffff、#000000、white、black - 画像:ダークモード用のバリエーションがないロゴやアイコン
- シャドウ:ダーク背景で見えなくなるボックスシャドウ
- フォーム入力欄:ダークモードでも白い背景のままになっている入力フィールド
6. 報告
Dark Mode Test:
Light mode: OK
Dark mode issues found:
- Header logo: white logo invisible on dark bg (needs dark variant)
- Card borders: border-gray-200 invisible on dark bg → add dark:border-gray-700
- Footer text: hardcoded #333 → use text-gray-900 dark:text-gray-100
各問題を修正し、再テストしてください。
コメント
Markdown 対応