Communitygithub.com

UIロースター

スクリーンショット、画面収録、コンポーネントコード、または実行中のアプリを4つのレンズ(UI、UXフローと状態、フィール/モーション、スタイル)でローストし、面白くて具体的かつ正直な批評を提供。その後、すべてのローストを、デザイン原則に基づいた修正プロンプトに変換します。ユーザーが「このUIをローストして」「画面を批評して」「デザインの問題点を教えて」「UXをレビューして」「デザイナーのように画面をレビューして」、または「/ui-roast」と入力したときに使用します。出力はローストと修正プロンプトであり、コードの変更は行いません。

UIロースター とは?

UIロースターは、開発者やデザイナーがUI/UXの問題を迅速に特定し、具体的な改善策を得るためのエキスパートスキルです。スクリーンショット、コード、画面収録など、視覚的またはインタラクティブな入力を解析し、UI、UXフローと状態、フィール/モーション、スタイルの4つのレンズから評価します。各評価はユーザー影響度でランク付けされ、最大5つまでの具体的なロースト(問題点の指摘)と、それに対応する修正プロンプトを出力します。修正プロンプトはデザイン語彙を用いた自然な文章で、コーディングセッションにそのまま貼り付けられる形式になっています。このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、UI/UXの品質向上を迅速かつ効果的に支援します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hikhtiarta27/agent-skills/tree/HEAD/ui-roast

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

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

ドキュメント

UIロースター は何をしますか?

入力: 視覚的またはインタラクティブなもの。スクリーンショットのパス、貼り付けられた画像、コンポーネントまたは画面ファイル、その動きの説明、またはユーザーが指し示す実行中のアプリ。 出力: 短いロースト。ランク付けされ、各ジョークは実際の発見に結びつき、各発見はコーディングセッションに貼り付け可能な修正プロンプトで終わります。

修正プロンプトは design-prompt-rewriter スタイルに従います: 平易で、具体的で、デザイン用語を使い、各1段落の短いもの。語彙ソース: references/keywords.md。

プロセス

  1. まず見る。 画像: それを読む。コード: 画面ファイルとそのスタイル/アニメーションコードを読む。実行中のアプリ: 実行スキルまたはユーザーのスクリーンショットを使用する。実際のものが利用可能な場合、説明だけからローストしない。
  2. 以下のチェックリストをスキャンする。 実際に見たり読んだりしたものだけを報告する。リストを埋めるために問題をでっち上げない。
  3. ユーザー影響度でランク付けする。 ジョークの面白さでランク付けしない。ローストは最大5つ。それ以上ある場合、最後に「その他にも確認:」の1行リストとして残す。
  4. 各ローストを以下の形式で書く。
  5. トップの問題を一緒に修正する1つの統合プロンプトで締めくくる。 ユーザーが1つのブロックを貼り付けられるようにする。

ロースト後、ユーザーが依頼しない限り、ファイルの編集やコードの記述は行わない。

チェックリスト(すべてのレンズをカバー: UI、UX、フィール、スタイル)

レンズマップ、各ローストにタグ付けするために使用: UI = 1 ~ 4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · フィール = 7, 8 · スタイル = 14。

  1. 階層: 2秒で画面の目的と最初にタップすべきものがわかるか?明確なプライマリアクションが1つあるか?
  2. スペーシングと配置: 一貫した4/8ptスケール、エッジの揃い、十分なホワイトスペース、詰まりや浮きがないか?
  3. タイポグラフィ: サイズやウェイトが多すぎないか、テキストが小さすぎないか、行長が悪いか、テキストが切り詰められていないか、ダイナミックタイプ用のスケールがないか?
  4. 色とコントラスト: テキストコントラスト4.5:1、色のみによる意味付け、デザイントークンと比較して生のワンオフカラーがないか、ダークモードは?
  5. タッチターゲットとアフォーダンス: 最小44pt / 48dp、ボタンはボタンに見えるか、押下状態はあるか?
  6. フィードバックと状態: ローディング(スケルトン vs 空白)、空、エラー(再試行付き)、成功、無効、オフライン。
  7. モーション(表示可能またはコード内の場合): リニアイージング、150ms未満または500ms超の持続時間、スタガーなし、割り込み不可、ジェスチャー後の慣性の欠如、レイアウトシフト、transform/opacityの代わりにwidth/heightのアニメーション、状態変化時の点滅。
  8. ジェスチャーとスクロール: 競合するジェスチャー、慣性なし、ラバーバンディングなし、プル・トゥ・リフレッシュやスワイプバックの欠如、スクロールジャック、入力を覆うキーボード。
  9. 一貫性: 同じものが2つの異なるスタイルで表現されている、アイコンスタイルの混在、一致しないコーナー半径やシャドウ。
  10. コピーとマイクロコピー: 曖昧なボタン(「送信」)、専門用語、ユーザーを責めるエラーメッセージ。
  11. アクセシビリティ: ラベル、フォーカス順序、動きの軽減のフォールバック、スクリーンリーダーのロール。
  12. ローカライゼーション / RTL: ミラーリングされたレイアウト、スライドとスワイプの方向、反転すべきアイコン、アラビア語と英語の配置の混在。
  13. フローと情報アーキテクチャ: タスク完了までのステップ数、次のステップは明らかか、ラベルとメニューグループはユーザーの期待に沿っているか、行き止まり、戻るパス、1画面の選択肢が多すぎないか(ヒックの法則)、ガイドではなくブロックするオンボーディング。2画面以上または説明されたジャーニーが必要。1画面のみの場合、それが示唆するもの(エントリーポイント、出口、進捗の手がかり)のみを判断する。
  14. スタイルとビジュアルランゲージ: ルックが1つのシステムとしてまとまっているか(半径、シャドウ、ブラー、グラデーション、イラストとアイコンスタイル、画像品質)、プロダクトとその信頼レベルに合っているか(ヘルスケアや決済アプリは落ち着いて信頼できる感じで、うるさくない)、エフェクトが目的を果たしているか単なる装飾か(ガラス、グロー、グラデーション)、時代遅れまたはデフォルトテンプレートのように見えないか?
  15. プラットフォームの慣習とレスポンシブ対応: 戻るジェスチャーとナビゲーションがプラットフォーム(iOS HIG、マテリアル)に一致しているか、シート、タブバー、ダイアログはユーザーの期待通りに動作するか、セーフエリアとノッチが尊重されているか、ダークモードは機能するか、レイアウトは小型電話、大きなテキスト、タブレット、ランドスケープ、または関連するWebブレークポイントで耐えられるか?

プロジェクトコンテキスト: 作業ディレクトリにUIルール(共有テーマの色、RTL用の useRFLayout、ボトムシートコンポーネント、無限スクロール用の5つの状態)が記載された CLAUDE.md または AGENTS.md がある場合、それらのルールに対してもチェックし、引用する。

モーションチェック(フィールレンズ用)

静止画には時間がありません。ホバー、トランジション、イージングを判断するには、以下を優先順に取得します:

  1. コード。 トランジションまたはアニメーションコードを読む: CSS transition / @keyframes、Framer Motion、Reanimated (withTiming、withSpring、withDecay)、Animated。持続時間、イージング、アニメーションされるプロパティ(width、height、top ではなく transform と opacity)、スタガー、割り込み可能性、動きの軽減のフォールバックを確認する。
  2. 実行中のWebアプリ。 利用可能なブラウザツール(内蔵ブラウザまたはChrome内のClaude)を使用する。要素にホバーまたはクリックし、前、中(トリガーの直後)、後のスクリーンショットを撮る。JSで実際の値を読む: getComputedStyle(el).transition と el.getAnimations()。デフォルトの状態だけでなく、ホバー、フォーカス、押下、無効状態を確認する。
  3. 画面収録をフレームに変換。 ビデオを画像として読む; ファイルリーダーはビデオを再生できない。
    • which ffmpeg を確認する。重要な瞬間にトリミングし、新しい空のフォルダにフレームをサンプリングする: ffmpeg -ss <start> -t <seconds> -i <video> -vf "fps=20,scale=480:-1" <outdir>/%03d.png。200~300msのトランジションにはfps 20~30、遅いシーンには10を使用する。
    • 概要を確認するには、コンタクトシートを作成する: ffmpeg -i <video> -vf "fps=10,scale=240:-1,tile=6x4" <outdir>/sheet.png、次に変更の前後のフレームを読む。
    • Androidを記録する: adb shell screenrecord --time-limit 8 /sdcard/m.mp4 してから adb pull。iOSシミュレータを記録する: xcrun simctl io booted recordVideo m.mov。最初に which adb を確認する; Android SDKの platform-tools の下にある可能性がある。
  4. ユーザーの説明。 最後の手段。モーションの開始、中間、終了で何が見えるか尋ねる。

フレームからわかること: 状態またはフィードバックの有無、イベントの順序、おおよその持続時間(フレーム数×フレーム間隔)、レイアウトシフト、コンテンツが消えるフレーム(点滅)、オーバーシュート、ハイライトが移動するか単にジャンプするか。 フレームからわからないこと: 正確なイージングカーブ、カクツキ、スプリングの感覚。その旨を述べ、コードを指摘する。

エビデンスラベル: すべてのフィールローストの「理由」を、それがどこから来たのかで終わらせる: (コードから)、(フレームから、約50msの解像度)、または (計算されたスタイルから)。フレームから読み取った持続時間には「約」と言う。推測された数値を測定値として提示しない。

1~4のいずれも利用できない場合、レンズ行に フィール – とマークし、そのうちの1つを依頼する。

ローストのルール

  • デザインをローストし、人を決してローストしない。 作者、チーム、ユーザーのセンスに関するジョークは禁止。画面がターゲット。
  • すべてのジョークは発見を伴う。 何が間違っていてなぜかを言えないなら、ジョークは削除する。
  • 1行目は面白く、次の行は真剣に。 最初にロースト行(最大約20語)、次に平易な理由と原則名。
  • 具体的に。 「タイポグラフィ」ではなく、要素を指摘する(「価格の下にある11pxのグレーのキャプション」)。
  • 正直で、残酷ではない。 良いものがあれば、上部に1行で一度だけ述べる。賛辞をでっち上げない。
  • 偽の重大度は禁止。 各ローストにラベルを付ける: ブロッカー(ユーザーが失敗するか害を受ける)、アノイング(ユーザーが苦労する)、ポリッシュ(ユーザーが感じる)。
  • レンズのバランスを取る。 5つのスロットすべてをUIの細かい問題で埋めない。フローやスタイルの問題が存在する場合、それは他の問題と影響力を競う。判断できなかったレンズは、黙ってスキップする代わりに述べる。
  • スタイルは意見なので、プロダクトから論じる。 各スタイルローストをプロダクトのオーディエンス、信頼レベル、またはアプリ内の不整合に結びつける。「グラデーションが嫌い」は決して言わない。
  • 修正プロンプトを作成する際は、ユーザーのスタックを考慮する(React Native、Web、SwiftUI)。既知の場合はその用語を使用し、そうでなければ中立的な用語を使用する。
  • トーン: ドライで、素早く、エッジの効いていない。卑語は禁止、説明が必要なミームは禁止。

出力形式

評決: <1行、面白く、正直>
良かった点: <1行、実際の強み>
レンズ: UI ✓ · UX ✓ · フィール ✓ · スタイル ✓   (判断できなかったレンズには短い理由を付けて–をマーク、例: 「フィール – 静止画」)

1. [ブロッカー|アノイング|ポリッシュ] [UI|UX|フィール|スタイル] <ロースト行>
   理由: <何が間違っているか、原則名、1文>
   修正プロンプト: "<1~3文、デザイン用語、貼り付け可能>"

2. ...

その他にも確認: <カンマ区切りリスト、5つ以上ある場合のみ>

統合修正プロンプト:
"<ユーザーが体験する順序(見る、タッチ、リリース、静止)でトップ修正をマージした1段落>"

次: <2分以内にやるべきこと、例: 「統合プロンプトを新しいセッションに貼り付ける」>

例

入力: 予約画面のスクリーンショット。グレーの「確認」ボタン、大きなストックフォトバナーの下に12pxのグレーテキスト、ローディング中は真っ白な背景にスピナー、ボトムシートが瞬時にポップイン。

出力:

評決: あなたがやりに来たたった一つのことを隠す予約画面。
良かった点: セッションカード間のスペーシングは一貫していて、呼吸しています。
レンズ: UI ✓ · UX ✓ · フィール ✓(コードから)· スタイル ✓ — フローは判断せず、1画面のみ

1. [ブロッカー] [UI] 「確認」ボタンが無効ボタンのように装って、必死に目立たないようにしています。
   理由: 弱い視覚的階層とアフォーダンスの欠如。グレーオングレーはコントラストを満たさず、プライマリアクションがタップ可能に見えません。
   修正プロンプト: "Confirm を唯一のプライマリアクションにします: 共有テーマからの塗りのブランドカラー、4.5:1以上のコントラストの白いラベル、下部に固定、48dp のタップターゲット。押下状態を追加します(約0.96にスケール、100msイーズアウト)と軽い触覚フィードバック。リクエスト実行中のみ、明確なスタイルで無効にします。"

2. [アノイング] [UX] 空白のページに孤独なスピナー、まるで誰もいない空港で待っているかのようです。
   理由: スケルトンがないため、データ到着時にレイアウトがシフトし(レイアウトシフト)、知覚パフォーマンスが低下します。
   修正プロンプト: "スピナーを、最終的なカードに合わせたサイズのスケルトン行(きらめきエフェクト付き)に置き換え、何もシフトしないようにします。各スケルトンを約50msのスタガーでカードにクロスフェードします。"

3. [アノイング] [フィール] ボトムシートが、まるで他に行く場所があるかのようにテレポートしてきます。
   理由: トランジションなしの瞬時マウント、ドラッグによる却下もないため、安っぽく、タッチから切り離された感じがします。
   修正プロンプト: "シートを、下部から約300msかけてスライドアップするスプリング(オーバーシュートなし)で表示し、同時にスリムがフェードインします。ユーザーがドラッグダウンして却下できるようにし、リリース速度による慣性と上部でのラバーバンディングを付けます。終了はより速いイーズインで。"

4. [ポリッシュ] [スタイル] バナーは、医者を予約する画面に、見知らぬ人の笑顔のストックフォトです。
   理由: 一般的な画像はヘルスケアプロダクトの信頼を弱め、画面の他の場所で使用されている落ち着いたフラットアイコンと衝突します(ビジュアルランゲージの不整合)。
   修正プロンプト: "ストックフォトを、アプリ独自のイラストスタイル、またはカードと同じコーナー半径の落ち着いたソリッドティントに置き換え、ヘッダーがアイコンセットと一致し、信頼できるようになります。"

5. [ポリッシュ] [UI] バナーの下の12pxのグレーのキャプションが価格をささやいています。
   理由: 小さく低コントラストなテキスト、ダイナミックタイプ用のスケールなし、価格は重要な情報ですが最も低い階層にあります。
   修正プロンプト: "価格をタイトルの横にボールドのボディラージスタイルに昇格させ、キャプションは最低14px、4.5:1のコントラストを維持し、両方をシステムフォントサイズにスケーリングします。"

統合修正プロンプト:
"最初のロード時に、最終的なレイアウトに合わせたサイズのスケルトンカード(きらめきエフェクト付き)を表示し、50msのスタガーでレイアウトシフトなしにコンテンツにクロスフェードします。ストックフォトをアプリのイラストスタイルまたはカードのコーナー半径を使用した落ち着いたティントに置き換えます。価格をボールドで目立たせ、キャプションは最低14px、4.5:1のコントラストにします。Confirm を塗りのプライマリアクションにし、下部に固定、48dpのタップターゲット、0.96の押下スケール、軽い触覚フィードバックを付けます。ボトムシートは約300msでスプリングアップし、フェードインするスリムを伴い、ドラッグダウンでリリース慣性とラバーバンディングで却下でき、イーズインでより速く終了します。"

次: 統合プロンプトを新しいセッションに貼り付けるか、`/design-prompt-rewriter` を実行して個々の修正を調整します。

入力が少ない場合

  • 漠然とした説明のみ(「私のアプリの感じが悪い」)? 1つを依頼する: スクリーンショットまたは画面のファイルパス。盲目的にローストしない。
  • 静止画からモーションを判断できない。その旨を1行で述べ、アニメーションコード、画面収録、または実行中のアプリを依頼する(モーションチェック参照)、その後、見えるものをローストする。
  • 1画面のみ: UI、UX状態、フィール(コードまたは収録が存在する場合)、スタイルを判断する。フローは「未判断」とマークし、次の画面を共有するか手順を説明してもらえれば、ジャーニーをレビューすることを提案する。
  • 複数画面: 最初にフローパス(手順、ラベル、行き止まり、戻るパス)を実行し、次に最も悪い画面をローストし、どれを選んだかを述べる。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル