Communitygithub.com

fresh-eyes

WebプロダクトのUI画面(アプリ画面、ダッシュボード、設定、テーブル、フォーム、オンボーディング、空状態・エラー状態、ランディングページ、ホームページ、価格ページ)を、テンプレートではなく思慮深い人間が作ったようにデザイン・レビューします。各画面はユーザーのタスクと実際のコンテンツから構築され、レンダリング確認と第三者の視点でチェックされ、WCAG 2.2 AAに準拠し、機械臭さを排除します。

fresh-eyes とは?

Fresh eyesは、WebアプリケーションやSaaS製品のUI画面をデザイン・レビューするためのAIエージェントスキルです。単なるテンプレートからではなく、実際のユーザータスクとリアルなコンテンツに基づいて画面を構築します。このスキルは、スクリプトによる自動チェック(コントラスト、フォーカス、サイドスクロール、小さなターゲット、競合するプライマリボタンなど)と、人間の判断を組み合わせた7ステップのループを特徴としています。特に「第三者の目(fresh eyes)」として独立したサブエージェントが画面を評価するプロセスが重要で、これにより作成者の意図に囚われない客観的なフィードバックを得られます。アクセシビリティ基準(WCAG 2.2 AA)への準拠を徹底し、機械的な生成感を排除するための具体的なルール(実データのみ使用、エムダッシュ禁止、エッジの色ストライプ禁止など)を備えています。対応プラットフォームはWebアプリ中心で、Node.jsスクリプトとPlaywrightを用いたレンダリングチェックが可能です。ロゴ、スライドデッキ、ネイティブモバイルアプリは対象外です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bernardoo-soares/fresh-eyes/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Fresh eyes(フレッシュアイズ)

その画面を使う人のために、その人が来た目的と目にするコンテンツからデザインする。 判断が先導し、リファレンスがそれを研ぎ澄まし、スクリプトがそれをチェックする。何よりも常識が優先される。もし画面が混乱を招いていて、それを説明するルールがないとしても、それは依然として混乱している。

<skill> はこのスキルのディレクトリを表す:${CLAUDE_SKILL_DIR}(これがリテラル変数として表示される場合は、このファイルが読み込まれたフォルダを使用する)。

セットアップ

スクリプトにはNode 20以降が必要です。スクリプトがセットアップを必要とする場合、表示されるコマンドを実行します。npm --prefix "<skill>" install と node "<skill>/node_modules/playwright/cli.js" install chromium の一方または両方で、どのフォルダからでも、どのシェルでも動作します。

ここでスクリプトを実行できない場合(シェルがない、Nodeがない、ブラウザダウンロードのネットワークがない)は、処理を止めないでください。セッションで使用可能なブラウザツールでスクリーンショットを撮るか、コードを references/floor.md と1行ずつ確認し、レポートにレンダリングチェックが実行されなかったことを明記してください。コードだけから視覚チェックを行ったと報告しないでください。

ループ

作成時とレビュー時の両方で使用します。レビューの場合は、最初に references/review.md を読んでください。その手順がステップ1〜4を置き換え、改善版はオリジナルの隣にコピーとして配置されます(相手がファイルの変更を依頼した場合を除く)。

  1. 理解する。 誰が、どのような目的で、どのくらいの頻度で、どのデバイスで、どのような実際のコンテンツを使ってこの画面を使うのか。プロジェクトに DESIGN-CONTEXT.md(references/design-context.md)があればそれを読む。なければ、コード、コピー、リクエストから推測し、自分の前提をメモする。最初にユーザーにインタビューするために止まらない。
  2. スタイリング前に決める。 作業メモまたは返信に、簡潔に書き留める:この画面の唯一の目的は何か、最初に目が留まるべきものは何か、デスクトップと携帯電話での最初の画面に主要な判断のために必要なものは何か、その他すべての順序、単一のプライマリアクション、何を省略するか。このカテゴリのユーザーが既に好きな製品を2〜3つ挙げ、その構造に従うこと、そしてこの製品が持つ独自の特徴的な動きを1つ挙げる(references/modern.md)。これがあなたの意図であり、ステップ6でテストされる。
  3. まず言葉を書く。 見出し、ラベル、ボタン、空状態、エラー状態を、実際のデータに基づいて、その人の言葉で書く(references/words.md)。数字、名前、推薦の言葉、トレンドを決してでっち上げない。実際のデータがない場合は、目に見えるプレースホルダーを使用する。
  4. 順序通りに構築する: 構造、階層、そしてクラフトの順で、プロジェクトのコンポーネントとトークンを利用する(React + shadcn/uiの場合は references/stacks/react-shadcn.md を読む)。新しいビジュアルシステムは node "<skill>/scripts/tokens.mjs" --accent "<hex>" --out <dir> から始め、すべての色の組み合わせをチェックする。
  5. レンダリングして見る。 アプリの場合は、開発サーバーを起動しURLを渡す。--out はプロジェクト外のスクラッチフォルダに指定する:node "<skill>/scripts/render.mjs" <page.html | url> --out <dir>(セットアップが必要または実行できない場合は「セットアップ」を参照)。ログインが必要な場合は --storage-state <file> を追加する。デスクトップと携帯電話、ライトテーマとダークテーマのスクリーンショットを保存し、測定可能な問題(コントラスト、フォーカス、サイドスクロール、小さなターゲット、競合するプライマリボタン、エッジのストライプ、エムダッシュ)を表示し、その後「目視チェック」リストを表示する。すべての問題を修正するか、レポートにその理由を記載する。レビューでは、フロア問題、ストライプ、エムダッシュを修正し、その他の測定された兆候は発見事項として提示する。ライトとダークが同一に見えると警告された場合は、--theme-mode class を付けて再実行する。スクリーンショット(最初に -first.png の4つ)と、各「目視チェック」項目を確認する。空のリストはフロアがクリーンであることを意味するだけで、画面が良いことを意味しない。ストレスコンテンツ(最も長い実際の名前、最大の金額、空のアカウント)で1回レンダリングする。
  6. 第三者の目(Fresh eyes)。 この会話を一切持たない新しいサブエージェントを開始する(フォークではない)。first-look エージェントタイプがあればそれを使用する。プロンプト全体は次の通り:<skill>/agents/first-look.md を読んで従ってください。ジョブ:<一文>。画像:<絶対パス、最初の画面から>。他のファイルは開かないでください。 あなたの意図や構築・変更した内容については一切追加しない。その回答をステップ2と比較する。「これは何か」の誤り、間違った最初のクリック、ためらい、または「違和感」は修正対象。すでに機能しているページのレビューで、ジョブを妨げず誤解もさせないためらいは、修正ではなくオプションの提案とする。サブエージェントがない場合は、コードを再読する前に、最初の画面イメージのみから自分で first-look の質問に答える。
  7. 修正して止める。 ためらいのそれぞれを、まず構造(ラベル、リスト、ビジュアル、再グループ化)で修正する。どうしても他に方法がない場合のみ文章を追加する。名前への疑念は、より良い名前で修正し、その下に説明文を追加してはならない。メニュー内で何かを説明することは決してしてはならない。ステップ5と6を最大2ラウンド繰り返し、その後まだ未解決のものを挙げる。references/modern.md のテストの3つの質問(この製品はどのカテゴリーの製品と呼べるか、特徴的な動きはどこにあるか、これはどのスタートアップにも属する可能性があるか)に答え、報告する。

最もシンプルな経路を最初に。 メインアクションは画面が開いた瞬間に機能する。追加機能(すべての行の編集、一括ツール)は一段階下に配置し、最初の画面の邪魔にならないようにする(references/structure.md)。

完成していて、むき出しではない。 機械臭さを避けることが目標ではない。画面は完成したプロダクトのように見えるべきである:人が操作する単位がそれぞれのコンテナに収まり、意味を持つ場所にアイコンや小さなビジュアルがあり、判断全体が最初の画面に含まれている。灰色の文章が並ぶ広いカラムも失敗である(references/hierarchy.md)。

リクエストに合わせてスケールする。 言葉のみ(ラベル、エラーメッセージ):ステップ1〜3。コンポーネントまたは小さな修正:ステップ1〜5。画面全体またはレビュー:全7ステップ。

ほとんどの画面を決定する質問

質問参照先
誰が、どのくらいの頻度で、どのような目的でここに来るか?密度はどの程度にすべきか(姿勢)?ものはどのようにグループ化、命名、到達されるか?references/structure.md
最初に目が留まるべきものは何か?プライマリアクションは正確に1つか?すべての数字に比較対象、単位、日付が付いているか?references/hierarchy.md
初めての人がこれが何であるか、自分がどこにいるか、次に何をすべきかがわかるか?references/clarity.md
各領域はどの状態にあり、正確に1つの状態か?誰かが間違えた場合、元に戻すか確認するか?references/states.md
言葉は、その人がそう呼ぶようにものを命名しているか?各エラーは修正方法を示しているか?references/words.md
タイポグラフィ、スペーシング、色、ダークモード、動きは意図的か?references/craft.md
完成したように見えるか、それともドキュメントのように見えるか?最初の画面に判断が含まれているか?references/hierarchy.md
現代的に見えるが、生成されたようには見えないか?その特徴的な動きは何か?references/modern.md
この画面はどのプロダクトにも属する可能性があるか?何を削除できるか?references/tells.md
ランディングページ、ホームページ、価格ページか?訪問者は何を決定しなければならないか?references/landing.md
キーボード、コントラスト、リフロー、名前、ターゲット、両テーマで?references/floor.md

目の前の画面で質問が未解決の場合にのみリファレンスを読み、最初からすべてを読まないでください。各カードには 決定、実行、理由とその出典、探すべきもの、および適用されない場合(ただし)が含まれています。例外はルールと同じくらい重要です。

動かない線

  • 実際のコンテンツのみ:数字、人物、引用、履歴をでっち上げない。
  • アクセシビリティフロア(references/floor.md)はライトテーマとダークテーマの両方で保持される。
  • 要素の片方の端に色付きのストライプをアクセントとして使用しない。コピー内にエムダッシュを使用しない(references/tells.md)。
  • レビューでは、ページが持っていたすべてのデータとすべてのアクションを保持する。移動または格下げはしても、削除はしない。
  • 「変更不要」は、何もユーザーに負担をかけない場合に完全なレビューとなる。好みだけで変更してはならない。

レポート

平易な言葉で、簡潔に:

  • 何を構築または変更したか、それぞれをユーザーのジョブとそれがユーザーに何をもたらすかに関連付けて。レビューの場合は、すべての変更(サイズ、間隔、色などどんなに小さなものでも)を、例えば「以前、現在、ユーザーへのメリット」の短い表として。名前を挙げなかった変更は、破られた約束である。
  • 仮定したこと(最大3つ)、および仮定が間違っていた場合に何が変わるか。
  • チェックした内容:レンダリングの問題(前後)、および first-look があなたの意図とどう比較されたか。
  • テストしなかったこと(ジェスチャー、実機の電話、Safari、スクリーンリーダー)、およびレンダリングが実行されたかどうか。

スコア、ID、ルール番号は不要。プロジェクトに DESIGN-CONTEXT.md がない場合は、あなたの仮定から作成することを提案する。

関連スキル