Communitygithub.com

ポートフォリオサイト構築

デザイナー、開発者、写真家、書き手、フリーランスの個人ポートフォリオを、はっきりした構成と選んだ書体、抑えた動きで組み立てます。

ポートフォリオサイト構築 とは?

個人ポートフォリオ向けの再利用スキルです。人を紹介し、作品を見せ、汎用テンプレートに見せません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MorganMarshall/ZeroSkills/tree/HEAD/skills/zero-web-design-portfolio

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

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

ドキュメント

デザインポートフォリオ

ポートフォリオは、次の3つのことを適切に行うべきです:人物を紹介し、その作品を文脈とともに示し、連絡を取りやすくすること。ポートフォリオはランディングページではありません。訪問者は誘導されるのではなく、ブラウジングしたいと考えています。発見を促すデザインにしましょう。

3つの段階で作業を進める

  1. 計画. コードを書く前に方向性と構造を決めます(以下参照)。
  2. 構築. デザイントークンを使って計画を実装し、すべての色、サイズ、スペースが1つのシステムから来るようにします。
  3. レビュー. 最後のチェックリストに照らして結果を批評し、不足している点を修正します。

もしユーザーの要望書にスタイル、パレット、フォント、レイアウトが指定されている場合は、それを正確に従ってください。ユーザーの指定は、このスキルのデフォルト設定よりも常に優先されます。

1. コードの前に計画を立てる

以下の内容を含む短い計画を書いてください:

  • この人物が誰で、何をしているか. その人の役割、専門分野、経験年数、およびサイトの訪問者(採用担当者、クライアント、協力者、他のデザイナー)を明確にします。要望書に記載がない場合は、一文で提案し、それを仮定したことを明記してください。
  • 美的方向性. 1つを選び(エディトリアルミニマル、ソフトテクニカル、ウォームクラフテッド、ストレートドキュメンタリー、エクスペリメンタル)、それにコミットし、その人の作品に結びつけた1行の理由を述べてください。写真家のポートフォリオとフロントエンド開発者のポートフォリオは異なるべきです。
  • トークン. 4~6つの名前付きカラーを16進数で、タイプフェースとその役割、スペーシングユニット、半径スケール、シャドウスタイルを指定します。ポートフォリオサイトは、アクセントカラーが非常に薄いか、まったくない方が効果的なことがよくあります。作品自体に色を任せましょう。
  • ヒーローアイデア. 人物紹介と代表的なプロジェクト1つで始めるか、またはタイトな2行の紹介文と作品へのリンクで始めます。アニメーションするタイピング効果やストックフォトの画像は避けてください。

次に、計画を要望書と照合します。計画の一部が類似のリクエストに対して常に作成するものと同じである場合は、その部分を変更し、何を変更したかをメモしてください。一般的な計画は、一般的なポートフォリオを生み出します。

2. デザインシステム

カラー

  • :root でCSSカスタムプロパティとしてパレットを定義します:ニュートラルスケール(背景、サーフェス、ボーダー、ミュートテキスト、テキスト)、1つのプライマリアクセント、オプションで1つのセカンダリアクセント。
  • ポートフォリオサイトは、アクセントカラーがミュートまたはなしの場合に最も強く見えることがよくあります。作品(画像、スクリーンショット、ケーススタディ)に色を任せましょう。アクセントはリンク、アクティブ状態、および意図的に強調したい1~2箇所にのみ使用します。
  • prefers-color-scheme を使用してライトモードとダークモードをサポートし、個々のルールを上書きするのではなく、トークンを再定義します。
  • 本文テキストのコントラスト比は 4.5:1、大きなテキストとUIボーダーは 3:1 を維持します。

タイポグラフィ

  • 最大2つのファミリーを使用します。2つ使用する場合は、明確に異なる役割を与えます(名前と見出しにはディスプレイフェイス、読み物にはテキストフェイス)。
  • 最初に思いついたデフォルトではなく、専門分野に合わせてフェイスを選択し、font-display: swap と完全なフォールバックスタックを指定してWebフォントを読み込みます。
  • タイプスケールを構築し(比率は約 1.2~1.333)、clamp() を使用して見出しを流動的にします。
  • 人物名とセクション見出しはタイトに設定します(line-height 1.05~1.15、大きなサイズではわずかにネガティブなletter-spacing)。本文テキストは開放的です(16~18px、line-height 1.5~1.7)。
  • 行長は45~75文字の間に保ちます(max-width: 65ch が適切なデフォルトです)。

レイアウトとスペーシング

  • 4/8pxのスペーシングスケールをトークンとして定義し、それをすべてに使用します。
  • セクションに余裕を持たせます:デスクトップでは垂直パディング80~120px、モバイルでは48~64px。
  • コンテナの最大幅を約1100~1200pxに制限し、読み物のテキストはさらに狭くします。
  • CSS GridとFlexboxを使ってモバイルファーストで構築します。すべてが360px以上の画面で水平スクロールなしで動作する必要があります。大きな画像、コード、図はそれぞれのコンテナ内でスクロールします。
  • セクション間のリズム(密度、配置、スケール)を変化させ、1つのブロックを繰り返さないようにします。長いテキストは左揃えにします。
  • プロジェクトギャラリーには明確なグリッドを使用します(デスクトップでは2~3列、モバイルでは1列)。アセットが許せば、プロジェクト間でアスペクト比を変えてください。すべてのプロジェクトに統一されたカードが必要なわけではありません。

サーフェスとコンポーネント

  • 2~3サイズの1つの半径システムを使用し、階層に合わせます(入力やボタンでは小さく、コンテナでは大きく)。
  • プロジェクトカードには、重いシャドウの代わりに1pxの低コントラストボーダーを使用します。ポートフォリオの作品は、ページの上に積み重なっているように見えるのではなく、ページ上に載っているように見えるべきです。
  • すべてのインタラクティブ要素に、ホバー、:focus-visible、アクティブ、無効の各状態を設定します。アウトラインを削除する場合は、必ず代替を提供します。
  • ビューごとに1つのプライマリボタンを配置し、具体的なラベルを付け(「プロジェクトを見る」「お問い合わせ」)、タッチターゲットは最低44pxにします。
  • プロジェクトカードには次の項目を表示します:プロジェクトタイトル、簡単な説明(役割、年、技術)、ヒーロー画像またはスクリーンショット。一般的な「Feature One」のようなラベルは使用しないでください。

モーション

  • 状態変化には150~250msのease-outトランジションを使用し、何が変わったかをモーションで示します。
  • すべてのセクションに出現アニメーションを設定するよりも、1つの調整された瞬間(ページ読み込みシーケンスやヒーローの出現)を優先します。
  • transform と opacity のみをアニメーション化します。
  • prefers-reduced-motion を尊重し、必須でないモーションをオフにします。
  • プロジェクトギャラリーでは、微妙なホバースケールやボーダーの表示で十分です。プロジェクト画像を隠すようなホバーオーバーレイは追加しないでください。

画像とアイコン

  • 壊れた画像やプレースホルダー画像を絶対に配信しないでください。提供されたアセットを使用するか、画像が配置される場所を示すクリーンなCSS/プレースホルダーブロックを生成します(プロジェクト名でラベル付け)。
  • プロジェクトのサムネイルには一貫したアスペクト比を使用するか、アセットが大きく異なる場合はメーソンリーグリッドを使用します。
  • ソーシャルリンクやUI要素には、1つのアイコンセットと1つのストロークウェイトを維持します。意味のあるaltテキストを記述します。
  • ケーススタディには、実際のスクリーンショット、モックアップ、または写真を使用します。最終的な作品として、Lorem Ipsumやワイヤーフレームのスケッチは使用しないでください。

3. ページ構成

ポートフォリオは通常、次の流れに従います:

  • ヒーロー: 人物が誰か(名前+役割)、何をしているか、または現在の焦点についての一文、作品への明確なリンク。近くに連絡先やソーシャルリンク。
  • 厳選された作品: 4~8プロジェクトの厳選されたギャラリー。各項目は詳細ページまたは拡張セクションにリンクします。量より質。
  • About(オプション): 経歴、興味、連絡先についての短い段落。写真があればそれも(カジュアルで問題ありません。本人が希望しない限りヘッドショットは不要)。
  • 連絡先: 簡単な連絡手段(メールリンク、コンタクトフォーム、または希望するチャネルへのリンク)。モバイルでスクロールせずに表示できるようにします。
  • フッター: ソーシャルリンク(GitHub、LinkedIn、Dribbble、Instagramなど)、著作権表示、場合によっては短いタグライン。

ケーススタディ / プロジェクト詳細ページ:

  • プロジェクト名、役割、年、技術スタック、ライブプロジェクトまたはリポジトリへのリンク。
  • 問題またはコンテキストを1~2段落で。
  • スクリーンショット、モックアップ、または簡単な注釈付きのウォークスルー。
  • 学んだこと、または異なる方法で行うこと(これが実際のポートフォリオとハイライトリールを区別するものです)。
  • ブラウジングを続けるための次のプロジェクトへのリンク。

コピー

  • 具体的で実際のコピーを書きます。Lorem Ipsumや「Feature One」は使用しないでください。
  • 架空のペルソナではなく、実際の人物の名前と役割を使用します。
  • 訪問者の視点から、平易な言葉、文の先頭のみ大文字、能動態で書きます。
  • プロジェクトタイトルは、プロジェクトが何であるかを示すものにし、賢い抽象概念は避けてください。「クライアントCRMダッシュボード」は「シナジーエンジン」より優れています。
  • プロジェクトの説明は2~3文に抑えます:それが何か、何をしたか、結果があった場合はその結果。

技術的最低条件

  • セマンティックHTML(header、nav、main、section、footer)、単一の h1、順序通りの見出しレベルを使用します。
  • すべての要素をキーボードで操作可能にし、長いページにはスキップリンクを追加し、ネイティブ要素が不足する場合にのみARIAを使用します。
  • viewportメタタグ、タイトル、説明、ファビコンを含めます。
  • 依存関係を最小限に抑えます。小さなポートフォリオは、インラインCSSとJSを含む1つの自己完結型HTMLファイルにできます。既存のプロジェクトでは、新しいものを導入する代わりに、そのスタックと規則に従います。
  • メディアに width と height または aspect-ratio を設定して、レイアウトシフトを防ぎます。
  • 外部リポジトリやライブデモへのリンクは、明確なラベル(「GitHub」「ライブサイト」)でリンクします。

避けるべきよくある兆候

これらは、明確な視点なしに構築されたポートフォリオによく見られます:

  • ストックイラストやピクセルアートのアバターを使った「こんにちは、[名前]です。[役割]です」という一般的なヒーロー。
  • スキルバーやパーセンテージバー(「HTML 90%」「JavaScript 80%」)。誰も読まないし、意味がありません。
  • すべてのプロジェクトが同じアスペクト比、シャドウ、ホバー効果を持つ均一なカードグリッド。
  • モバイルで読みにくいアニメーション付きタイムライン。
  • すべてのプロジェクトカードに同じグラデーションオーバーレイがかかっている。
  • 実際にGoogle DocsのURLにリンクしている「履歴書をダウンロード」ボタン。
  • 見るべき作品がなく、リンクだけのページ。

最終レビュー

作業を提示する前に、以下を確認します(可能であればスクリーンショットまたはブラウザを使用):

  • スペーシングと配置がスケールに従っており、不適切な値がない。
  • コントラストとフォーカスリングが基準を満たし、すべてのインタラクティブ状態が存在する。
  • レイアウトが360px、タブレット、デスクトップで保持される。
  • プレースホルダー、壊れたもの、ラベルなしのものがない。
  • 作品ギャラリーが厳選されているように感じられ、網羅的ではない。4つの優れたプロジェクトは10の中程度のプロジェクトに勝ります。
  • 見知らぬ人が、ホームページを見てから5秒以内にその人物が誰か、何をしているか、連絡方法を言える。
  • すべてのプロジェクトが実際の場所またはもっともらしい詳細ページにリンクしており、外部リンクは明確にラベル付けされている。

Individual skills in this repo

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

関連スキル