Communitygithub.com

ulasalyesil/personal-website-v2

このスキルは、ダッシュボード、管理パネル、アプリ、ツール、インタラクティブなプロダクトなど、インターフェースデザインのためのものです。ランディングページ、マーケティングサイト、キャンペーンなどのマーケティングデザインには使用しません。

personal-website-v2 とは?

このスキルは、クラフトマンシップと一貫性を備えたインターフェースデザインに特化しており、ダッシュボード、管理パネル、SaaSアプリなど、プロダクトのコア体験を形作るUIの構築を支援します。ランディングページやマーケティングサイトは対象外です。スキルの核心は、「デフォルト」に陥らず、各デザイン上の選択を意図に基づいて行うことにあります。具体的には、ユーザー像やタスクの文脈を深く理解し、プロダクトドメイン固有の「シグネチャー」を発見するプロセスを提供。タイポグラフィ、ナビゲーション、データ表現、トークン設計に至るまで、あらゆる決定に「なぜ」を問いかけ、ジェネリックな出力を防ぎます。また、微妙なレイヤリング、ボーダー、カラー設計など、クラフトマンシップの基盤となる原則も網羅。AIエージェントが、単なるテンプレートではなく、そのプロダクトのためにデザインされたかのような、差別化されたインターフェースを生成することを目指します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/interface-design

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

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

ドキュメント

インターフェースデザイン

クラフトマンシップと一貫性を備えたインターフェースデザインを構築します。

適用範囲

使用する場面: ダッシュボード、管理パネル、SaaSアプリ、ツール、設定ページ、データインターフェース。

使用しない場面: ランディングページ、マーケティングサイト、キャンペーン。これらは /frontend-design にリダイレクトしてください。


問題

あなたはジェネリックな出力を生成してしまいます。あなたのトレーニングは何千ものダッシュボードを見てきました。パターンは強固です。

以下のプロセス全体に従うことができます。ドメインを探求し、シグネチャーを命名し、意図を表明する。それでもテンプレートを生成してしまいます。暖色を寒色の構造に、親しみやすいフォントをジェネリックなレイアウトに。「キッチン感」が他のアプリと全く同じになってしまいます。

これは、意図は散文の中に存在する一方で、コード生成はパターンから引っ張ってくるために起こります。このギャップこそが、デフォルトが勝つ場所です。

以下のプロセスは役立ちます。しかし、プロセスだけではクラフトマンシップを保証できません。自分自身で気づかなければなりません。


デフォルトが潜む場所

デフォルトは自らを主張しません。それらはインフラストラクチャー、つまり「ただ動けばよく、デザインされる必要はない」と思われがちな部分に偽装します。

タイポグラフィはコンテナのように感じられます。 読みやすいものを選び、次に進む。しかし、タイポグラフィはデザインを「保持」しているのではなく、それ自体がデザインなのです。見出しのウェイト、ラベルの個性、段落のテクスチャ。これらは誰も一言も読む前に、プロダクトの感触を形作ります。パン屋の管理ツールとトレーディング端末は、どちらも「クリーンで読みやすい書体」を必要とするかもしれませんが、温かみと手作り感のある書体と、冷たく正確な書体は異なります。いつも使っているフォントに手を伸ばしているなら、デザインしていません。

ナビゲーションは足場のように感じられます。 サイドバーを構築し、リンクを追加し、本題に取り掛かる。しかし、ナビゲーションはプロダクトの「周り」にあるのではなく、それ自体がプロダクトなのです。自分がどこにいるのか、どこへ行けるのか、何が最も重要か。宇宙に浮かぶページは、コンポーネントデモであり、ソフトウェアではありません。ナビゲーションは、人々が自分がいる空間をどのように考えるかを教えます。

データはプレゼンテーションのように感じられます。 数字があるので、数字を表示する。しかし、画面上の数字はデザインではありません。問題は、その数字がそれを見ている人にとって何を意味するのか、その人がそれを元に何をするのか、ということです。プログレスリングと積み重ねられたラベルは、どちらも「10個中3個」を示します。一方はストーリーを語り、もう一方はスペースを埋めます。数字をラベルに貼り付けているだけなら、デザインしていません。

トークン名は実装の詳細のように感じられます。 しかし、CSS変数はデザイン上の決定です。--ink と --parchment は世界観を呼び起こします。--gray-700 と --surface-2 はテンプレートを連想させます。トークンだけを読んだ人が、これがどのプロダクトかを当てられるべきです。

落とし穴は、ある決定は創造的であり、他の決定は構造的であると考えることです。構造的な決定などありません。すべてがデザインです。「なぜこれなのか?」と問いかけるのをやめた瞬間、デフォルトが支配し始めます。


まず意図を

コードに触れる前に、これらに答えてください。頭の中でではなく、声に出して、自分自身またはユーザーに。

この人間は誰ですか? 「ユーザー」ではありません。実際の人間です。彼らはこれを開くとき、どこにいますか?何を考えていますか?5分前は何をしていて、5分後には何をする予定ですか?朝7時にコーヒーを飲んでいる教師は、深夜にデバッグしている開発者とは違います。投資家ミーティングの合間の創業者とも違います。彼らの世界がインターフェースを形作ります。

彼らは何を達成しなければなりませんか? 「ダッシュボードを使う」ではありません。動詞です。これらの課題を採点する。壊れたデプロイを見つける。支払いを承認する。その答えが、何が先行し、何が後続し、何が隠れるかを決定します。

これはどのように感じられるべきですか? 意味のある言葉で言ってください。「クリーンでモダン」は何の意味もありません。すべてのAIがそう言います。ノートのように温かみがある?ターミナルのように冷たい?トレーディングフロアのように密度が高い?読書アプリのように落ち着いている?その答えが、色、書体、スペーシング、密度など、すべてを形作ります。

具体的にこれらの質問に答えられないなら、止まってください。ユーザーに尋ねてください。推測しないでください。デフォルトにしないでください。

すべての選択は、選択でなければならない

すべての決定について、「なぜ」を説明できなければなりません。

  • なぜこのレイアウトであり、別のレイアウトではないのか?
  • なぜこの色温度なのか?
  • なぜこの書体なのか?
  • なぜこのスペーシングスケールなのか?
  • なぜこの情報階層なのか?

答えが「一般的だから」「クリーンだから」「うまくいくから」なら、あなたは選択していません。デフォルトにしたのです。デフォルトは見えません。見えない選択が積み重なって、ジェネリックな出力になります。

テスト: あなたの選択を最も一般的な代替案と入れ替えても、デザインが実質的に変わったと感じられないなら、あなたは本当の選択をしていません。

同じであることは失敗

別のAIが、同じようなプロンプトに対して、実質的に同じ出力を生成するなら、あなたは失敗しています。

これは、単に異なること自体を目的とするものではありません。インターフェースが、特定の問題、特定のユーザー、特定のコンテキストから生まれることについてです。意図に基づいてデザインするとき、同じになることは不可能です。なぜなら、二つとして同じ意図はないからです。

デフォルトに基づいてデザインするとき、すべてが同じに見えます。デフォルトは共有されているからです。

意図はシステム全体にわたっていなければならない

「温かみ」と言いながら寒色を使うのは、貫徹していません。意図はラベルではありません。それは、すべての決定を形作る制約です。

意図が温かみなら、表面、テキスト、ボーダー、アクセント、セマンティックカラー、タイポグラフィのすべてが温かみを帯びます。意図が密度なら、スペーシング、タイプサイズ、情報アーキテクチャのすべてが密度が高くなります。意図が落ち着きなら、動き、コントラスト、彩度のすべてが落ち着きます。

出力を、表明した意図に対してチェックしてください。すべてのトークンがそれを強化していますか?それとも、意図を表明しただけで、結局デフォルトに陥っていませんか?


プロダクトドメインの探求

ここでデフォルトが捕捉されるか、あるいは捕捉されないかが決まります。

ジェネリックな出力: タスクタイプ → ビジュアルテンプレート → テーマ クラフトされた出力: タスクタイプ → プロダクトドメイン → シグネチャー → 構造 + 表現

違いは、視覚的または構造的な思考の前に、プロダクトの世界に費やす時間です。

必要な出力

以下の4つすべてを生成するまで、方向性を提案してはいけません:

ドメイン: このプロダクトの世界からのコンセプト、メタファー、語彙。機能ではなく、領域。最低5つ。

色の世界: このプロダクトのドメインに自然に存在する色は何ですか?「暖色」や「寒色」ではなく、実際の世界に行ってください。このプロダクトが物理的な空間だとしたら、何が見えますか?他の場所にはない、ここに属する色は何ですか?5つ以上リストアップしてください。

シグネチャー: このプロダッドにのみ存在しうる、視覚的、構造的、またはインタラクションの要素を1つ。名前を挙げられなければ、探求を続けてください。

デフォルト: このインターフェースタイプに対する明白な選択肢を3つ。視覚的かつ構造的なもの。名前を付けていないパターンを避けることはできません。

提案の要件

あなたの方向性は、以下を明示的に参照しなければなりません:

  • 探求したドメインのコンセプト
  • 色の世界の探求からの色
  • シグネチャー要素
  • 各デフォルトを何で置き換えるか

テスト: あなたの提案を読んでください。プロダクト名を削除してください。誰かがこれが何のためのものかを特定できますか?できないなら、それはジェネリックです。もっと深く探求してください。


必須事項

ユーザーに見せる前に、自分が作ったものを見てください。

自問してください: 「もしユーザーが『これにはクラフトマンシップが欠けている』と言ったら、それは何を意味するだろうか?」

あなたが今考えたそのこと — 先に修正してください。

最初の出力はおそらくジェネリックです。それは普通のことです。仕事は、ユーザーが指摘する前にそれを見つけることです。

チェックリスト

提示する前に、出力に対してこれらを実行してください:

  • スワップテスト: 書体をいつもの書体と入れ替えても、誰も気づかないだろうか?レイアウトを標準的なダッシュボードテンプレートと入れ替えても、違うと感じられるだろうか?入れ替えても問題ない場所が、あなたがデフォルトに陥った場所です。

  • スキントテスト: 目を細めてください。それでも階層を認識できますか?何かが激しく飛び出していませんか?クラフトマンシップは囁きます。

  • シグネチャーテスト: シグネチャーが現れている5つの具体的な要素を指し示せますか?「全体的な雰囲気」ではありません。実際のコンポーネントです。位置を特定できないシグネチャーは存在しません。

  • トークンテスト: CSS変数を声に出して読んでください。それらはこのプロダクトの世界に属しているように聞こえますか?それとも、どのプロジェクトにも属するように聞こえますか?

いずれかのチェックに失敗した場合、表示する前に反復してください。


クラフトマンシップの基礎

微妙なレイヤリング

これはクラフトマンシップの背骨です。方向性、プロダクトタイプ、ビジュアルスタイルに関わらず、この原則はすべてに適用されます。システムが機能していることにほとんど気づかないはずです。Vercelのダッシュボードを見るとき、「素敵なボーダー」とは思いません。ただ構造を理解するだけです。クラフトマンシップは見えません。それがうまく機能している証拠です。

サーフェスの階層

サーフェスは積み重なります。ドロップダウンはカードの上にあり、カードはページの上にあります。番号付きのシステムを構築してください。ベース、そして階層レベルを増やしていきます。ダークモードでは、高い階層 = わずかに明るく。ライトモードでは、高い階層 = わずかに明るい、または影を使用します。

それぞれのジャンプは、明度のわずか数パーセントポイントにすべきです。単独ではほとんど違いがわかりません。しかし、サーフェスが積み重なると、階層が浮かび上がります。見るというより感じる、ささやくような静かなシフト。

重要な決定:

  • サイドバー: キャンバスと同じ背景。異なるものにしてはいけません。色を変えると、視覚空間が「サイドバーの世界」と「コンテンツの世界」に断片化されます。微妙なボーダーで十分な分離になります。
  • ドロップダウン: 親サーフェスよりも1つ上のレベル。両方が同じレベルを共有すると、ドロップダウンはカードに溶け込み、レイヤリングが失われます。
  • 入力欄: 周囲よりもわずかに暗く、明るくしないでください。入力欄は「内側」にあります。コンテンツを受け取ります。暗い背景は、重いボーダーなしで「ここに入力」を示します。

ボーダー

ボーダーは、探していないときは消えているべきですが、構造が必要なときには見つけられるべきです。低不透明度のrgbaは背景と調和します。注意を要求せずにエッジを定義します。ソリッドな16進数カラーのボーダーは、それと比べて粗く見えます。

プログレッションを構築してください。すべてのボーダーが同じではありません。標準ボーダー、よりソフトな区切り、強調ボーダー、フォーカスリングのための最大強調。境界の重要性に強度を合わせてください。

スキントテスト: 目を細めてインターフェースを見てください。それでも階層が認識できるはずです。何が何の上にあるか、どこでセクションが区切られているか。しかし、何も飛び出してはいけません。鋭い線はありません。不快な色のシフトもありません。ただ静かな構造だけです。

これが、プロフェッショナルなインターフェースとアマチュアなものを分けます。これを間違えると、他の何も意味をなしません。

無限の表現

すべてのパターンには無限の表現があります。同じように見えるインターフェースはあってはなりません。

メトリック表示は、ヒーロー数値、インライン統計、スパークライン、ゲージ、プログレスバー、比較デルタ、トレンドバッジ、または何か新しいものになり得ます。ダッシュボードは、密度、余白、階層、またはフローをまったく異なる方法で強調できます。サイドバー+カードでさえも、プロポーション、スペーシング、強調において無限のバリエーションがあります。

構築する前に、問いかけてください:

  • ユーザーがここで最もよく行うことは何か?
  • 同様の問題を解決するプロダクトで、優れているものは何か?それらを研究してください。
  • なぜこのインターフェースは、その目的のためにデザインされたと感じられるのか、テンプレート化されたとは感じられないのか?

決して同一の出力を生成しないでください。 毎回同じサイドバー幅、同じカードグリッド、同じアイコン-左-大きな数字-小さなラベルのメトリックボックス。これはすぐにAI生成であることを示します。忘れられやすいものです。

アーキテクチャとコンポーネントは、タスクとデータから出現し、新鮮に感じられる方法で実行されるべきです。LinearのカードはNotionのものとは異なります。VercelのメトリクスはStripeのものとは異なります。同じコンセプト、無限の表現。

色はどこかに存在する

すべてのプロダクトは世界の中に存在します。その世界には色があります。

パレットに手を伸ばす前に、プロダクトの世界の中で時間を過ごしてください。この空間の物理的なバージョンを歩いていくと、何が見えますか?どんな素材?どんな光?どんなオブジェクト?

あなたのパレットは、どこか「から」来たように感じられるべきです。何かに「適用された」ようには感じられないべきです。

暖色と寒色を超えて: 温度は一つの軸です。これは静かですか、それとも騒がしいですか?密度が高いですか、それとも広々としていますか?真剣ですか、それとも遊び心がありますか?幾何学的ですか、それとも有機的ですか?トレーディング端末と瞑想アプリは、どちらも「集中」しています。まったく異なる種類の集中です。ジェネリックなラベルではなく、具体的な品質を見つけてください。

色は意味を運びます: グレーは構造を構築します。色はコミュニケーションします。ステータス、アクション、強調、アイデンティティ。動機のない色はノイズです。意図を持って使われる1つのアクセントカラーは、考えなしに使われる5色に勝ります。


各コンポーネントを書く前に

毎回 UIコードを書くときは、たとえ小さな追加でも、以下を宣言してください:

意図: [この人間は誰か、彼らは何をしなければならないか、どのように感じられるべきか]
パレット: [あなたの探求からの色、そしてそれらがこのプロダクトの世界に適合する理由]
深度: [ボーダー / シャドウ / レイヤード、そしてこれが意図に適合する理由]
サーフェス: [あなたの階層スケール、そしてこの色温度の理由]
タイポグラフィ: [あなたの書体、そしてそれが意図に適合する理由]
スペーシング: [あなたのベースユニット]

このチェックポイントは必須です。それは、すべての技術的な選択を意図に結びつけることを強制します。

各選択について「なぜ」を説明できないなら、デフォルトに陥っています。止まって考えてください。


デザイン原則

トークンアーキテクチャ

インターフェース内のすべての色は、少数のプリミティブに遡るべきです: フォアグラウンド(テキスト階層)、バックグラウンド(サーフェス階層)、ボーダー(分離階層)、ブランド、セマンティック(破壊的、警告、成功)。ランダムな16進数カラーは禁止。すべてがプリミティブにマッピングされます。

テキスト階層

「テキスト」と「グレーテキスト」だけを持つのでなく、プライマリ、セカンダリ、ターシャリ、ミューテッドの4つのレベルを構築してください。それぞれが異なる役割を果たします: デフォルトテキスト、補足テキスト、メタデータ、無効/プレースホルダー。これら4つすべてを一貫して使用してください。2つしか使っていないなら、階層が平坦すぎます。

ボーダーのプログレッション

ボーダーは二値ではありません。強度を重要性に合わせたスケールを構築してください。標準的な区切り、よりソフトな区切り、強調、最大強調。すべての境界が同じ重みに値するわけではありません。

コントロールトークン

フォームコントロールには特定のニーズがあります。サーフェストークンを再利用しないでください。コントロールの背景、コントロールのボーダー、フォーカス状態のために専用のトークンを作成してください。これにより、インタラクティブ要素をレイアウトサーフェスから独立して調整できます。

スペーシング

ベースユニットを選び、その倍数に固執してください。異なるコンテキストのためのスケールを構築してください。アイコンギャップ用のマイクロスペーシング、ボタンやカード内のコンポーネントスペーシング、グループ間のセクションスペーシング、異なる領域間のメジャーな分離。ランダムな値は、システムがないことを示します。

パディング

対称性を保ってください。片側に値がある場合、コンテンツが自然に非対称性を必要としない限り、他の側も一致させるべきです。

...

[翻訳のため省略]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

関連スキル