Communitygithub.com

Readiz/skills

Readiz ウェブサイトとウェブアプリのデザインと改良:コンパクトなコントロール、アイコン操作、有用なテーブル、段階的な開示を活用。ダッシュボード、チャート、学習ページ、ツールなど、ウェブUIの作成・変更時に使用。

skills とは?

このスキルは、Readiz ウェブサイトやウェブアプリの UI デザインとリファインに特化したものです。ユーザーは画面を占有する大きなボタンや説明文を嫌うため、コンパクトな操作部と明確な階層構造で、実際のコンテンツを一目で読めて探索できる UI を実現します。主にダッシュボード、チャート、学習ページ、ツールなどの開発・変更時に適用し、指定されたブランドやアクセシビリティ要件があれば優先します。 基本的な密度設定として、ボタンやフィルターは高さ28px、アイコンボタンは26×26pxなど、無駄な余白を削減した設計値を提供します。また、画面構成では最初に表示されるエリアに実際のチャートや表を配置し、見出しやバッジの過剰な繰り返しを避けます。モバイルでも一律にタッチ領域を拡大せず、実際の操作エラーに基づいて調整します。 実際の画面検証では、修正前後の computed 値を確認し、既存のコンポーネントやCSSトークンを優先して修正します。代表的なPC、タブレット、モバイル(360〜390px)で確認し、テキストのカットやレイアウト崩れがないことを検証します。このスキル自体は公開やメッセージ送信の権限を追加しません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Readiz/skills/tree/HEAD/skills/readiz-web-ui

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

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

ドキュメント

Readiz ウェブ UI デザイン

ユーザーは、ボタンや説明が画面を占める構成を嫌います。小さな操作部と明確な階層で、実際のコンテンツを一目で読み、探索できるようにします。新しいウェブ UI と既存 UI の修正にこの基準を適用します。ユーザーが指定したブランド・プラットフォーム・アクセシビリティ要件があれば、それを優先します。

基本密度

以下は、別途デザイン指定がないウェブツールの初期値です。本文を小さく詰め込むのではなく、不要な余白と操作部を削減します。

要素初期値
通常ボタン・フィルター・select高さ 28px、フォントサイズ 12px、左右 padding 6~8px
アイコンボタン26×26px、アイコン 14~16px
補助・テーブル内操作24~26px
ボタン間4~6px
カード内側12~16px
テーブルセル縦 5~7px、横 6~10px
本文13~14px、line-height 1.5~1.7
  • 短いボタンは内容の幅に合わせます。主要な操作だからといって、大きくしたり広くしたりしません。
  • モバイルでもコンパクトな視覚サイズを維持します。共通の media query ですべてのボタンを 38~48px に拡大しません。実際のタッチエラーが確認された場合、該当操作の間隔・ヒット領域を調整し、隣接操作と重ならないことを確認します。明示されたプラットフォーム仕様は別途従います。
  • 長い選択肢やリスト行は、文の長さに応じて自然に伸びます。高さ固定や省略で読む内容を切り取りません。番号探索のように現在の見出しを別に表示できる場合は、小さな探索操作とコンテンツ見出しを分離します。
  • 青色系を基本強調色として好みます。明るく静かな背景、薄い境界、小さな角を使います。既存の明示されたブランドやチャートの意味ごとの色分けは維持します。

画面構成

  • 最初に表示される領域に、実際のチャート・表・コアコンテンツを配置します。紹介用の大きな見出し、長いサブタイトル、重複するバッジで作業領域を押し出しません。
  • 繰り返しの数値と比較は表、項目の探索はソートされたリスト・短いタブ、チャート操作は小さなツールバーで作成します。個別のボタンを大きなカードのように並べません。
  • 使い慣れた操作は、プロジェクトの既存 SVG/アイコン体系を使用します。アイコンにはアクセシブルな名前とツールチップ/必要な短いラベルを提供します。色だけで選択・成功・エラーを区別しません。
  • コアサマリとよく使う操作を残し、詳細な説明・出典・使用方法・保存基準は ⓘ または初期状態で折りたたまれた details に配置します。エラー、保存失敗、実行結果、重要な判断条件は必要なタイミングで表示します。
  • 同じ状態を見出し・カード・バッジ・説明で繰り返しません。ユーザーが機能を見つけるために長い文章を読ませることはしません。
  • 操作ボタン・表・チャートの間隔と整列を揃えます。デスクトップの目次は狭く、モバイルの目次は現在位置がわかる折りたたみ式が適切です。

実際の画面で確認

  • 修正前の実際のボタンの computed height、padding、line-height、および最初のコンテンツ位置を確認します。変更した CSS 宣言だけを見て小さくなったと判断しません。
  • 既存のコンポーネント variant とトークンを優先して修正します。共通 CSS、高い specificity、モバイル override、動的スタイルがサイズを再度大きくしていないか確認します。上書きルールを積み重ねるのではなく、そのサイズの原因を整理します。
  • 代表的な PC・タブレット・360~390px のモバイルで直接確認します。通常の操作が上記の初期値を維持しているか、長いテキストが切れていないか、ドキュメントの横方向のはみ出しやツール・チャートの重なりがないか確認します。
  • 展開・選択・キーボードフォーカス・タッチ、および必要な保存/復元を確認します。既存のデータ・保存キー・チャート座標をデザイン変更のために変更しません。
  • 要求された範囲の結果を実装・検証し、デプロイを含む作業では実際のデプロイ画面も確認します。このスキル自体が公開・メッセージ送信の権限を追加することはありません。

関連スキル