SKILL.md — Portfolio Builder
あなたのことを覚えてもらえる、パーソナルポートフォリオを作りましょう。 67以上のUIスタイル、161のカラーパレット、57のフォントペアリング、ポートフォリオ固有のパターンをバックアップに。 パイプライン: 理解 → ブランドアイデンティティ → コンテンツ → 構築 → デプロイ。
概要
ポートフォリオの仕事はひとつです。誰かに「あなたと仕事をしたい」と思わせること。 デザイン、コピー、プロジェクトの選択、インタラクション。そのすべてがその目標に奉仕します。
パイプライン(5フェーズ):
フェーズ0 — 理解 → あなたは誰?何をする人?誰が見るの?
フェーズ1 — デザイン → ビジュアル・アイデンティティ:スタイル、パレット、フォント — 作品の「雰囲気」
フェーズ2 — コンテンツ → 自己紹介、プロジェクト説明、スキル、連絡先
フェーズ3 — 構築 → HTML/CSS + インタラクティブなプロジェクトグリッド + アニメーション
フェーズ4 — 納品 → ライブプレビュー → Vercelデプロイ
ポートフォリオタイプ
| タイプ | ターゲット | 焦点 |
|---|---|---|
| デザイナー | クライアント、採用担当者 | ビジュアルワーク、ケーススタディ、プロセス |
| デベロッパー | リクルーター、クライアント、協業者 | プロジェクト、技術スタック、GitHub |
| クリエイティブ(写真家/イラストレーター等) | クライアント、ギャラリー | フルブリード画像、最小限のテキスト |
| フリーランサー | 見込みクライアント | サービス、実績、連絡先/CTA |
| 学生 / キャリアチェンジャー | リクルーター、採用担当者 | プロジェクト、スキル、ストーリー |
技術スタック
デフォルト: HTML + CSS + Vanilla JS — ランディングページと同じ。フレームワーク不要。
- 構築とデプロイが最速
- 依存関係ゼロ、アニメーションの最大制御
- Vercelに静的ファイルとして即座にデプロイ
ファイル構成
portfolio/
├── index.html # メインページ(シングルページまたはアンカーナビゲーション)
├── styles.css # デザイントークン → リセット → レイアウト → コンポーネント → セクション → アニメーション
├── main.js # フィルター、ライトボックス、スクロールエフェクト、モバイルナビ
├── assets/
│ ├── images/ # プロジェクトスクリーンショット、アバター、OG画像
│ └── fonts/ # セルフホストフォント(任意)
└── README.md
フェーズ0 — 理解
0.1 重要な質問
| 質問 | なぜ重要か |
|---|---|
| あなたは何をする人ですか? | デザイナー / デベロッパー / 写真家 / フリーランサー / 学生 / ハイブリッド |
| 誰がこれを見ますか? | リクルーター、クライアント、協業者、ギャラリーキュレーター |
| 一番のゴールは? | 採用される / フリーランスのクライアントを得る / プログラムに入る / 存在感を示す |
| いくつのプロジェクトを表示しますか? | 3~6が理想的。質が量に勝る |
| すでにブランドはありますか? | 既存の色、フォント、ロゴがある — または新しく始める |
| トーンは? | ミニマル、大胆、ダーク、遊び心、エディトリアル、テクニカル、ラグジュアリー |
| 参考ポートフォリオはありますか? | 好きなサイト、または差別化したいサイト |
0.2 ポートフォリオアーキタイプマッピング
| アーキタイプ | 主要セクション | ビジュアル優先度 |
|---|---|---|
| デザイナー | ヒーロー + 厳選作品(ケーススタディ) + アバウト + スキル + 連絡先 | ケーススタディの詳細、プロセスショット |
| デベロッパー | ヒーロー + プロジェクト(ライブリンク + GitHub) + スキル/スタック + アバウト + 連絡先 | コードスニペット、ライブデモ、GitHub統計 |
| クリエイティブ | フルブリードヒーロー + ギャラリー/グリッド + アバウト + 連絡先 | 画像が支配的、最小限のUIクローム |
| フリーランサー | ヒーロー + サービス + 実績 + お客様の声 + 連絡先 | CTAの顕著さ、信頼シグナル |
| 学生 | ヒーロー + プロジェクト + スキル + アバウト + 連絡先 | ストーリーアーク — 成長と可能性 |
フェーズ1 — デザインリサーチ
1.1 デザインデータベース
# スタイル検索
python3 src/ui-ux-pro-max/scripts/search.py "<クエリ>" --domain style --max-results 5
# カラーパレット
python3 src/ui-ux-pro-max/scripts/search.py "<雰囲気/業界>" --domain color --max-results 5
# タイポグラフィ
python3 src/ui-ux-pro-max/scripts/search.py "<スタイル/雰囲気>" --domain typography --max-results 3
# ポートフォリオ固有パターン
python3 src/ui-ux-pro-max/scripts/search.py "portfolio" --domain landing --max-results 5
# 個人サイト向けプロダクトタイプルール
python3 src/ui-ux-pro-max/scripts/search.py "portfolio personal site" --domain product
# 完全なデザインシステム
python3 src/ui-ux-pro-max/scripts/search.py "<クエリ>" --design-system -p "Portfolio"
# スタック固有のスニペット
python3 src/ui-ux-pro-max/scripts/search.py "<クエリ>" --stack html
1.2 ポートフォリオ固有の美学原則
ポートフォリオはデザインそのものです。安っぽく見えれば、作品も安っぽいと思われます。
| ❌ 凡庸(避けるべき) | ✅ 個性的(目指すべき) |
|---|---|
| 白背景、Interフォント、グレーのテキスト | 個性を表現するパレット |
| 「こんにちは、[名前]です。デザイナーです。」ヒーロー | 興味をそそる書き出し |
| 同じパディングの3列カードグリッド | 作品の特徴を反映したレイアウト |
| ホバー: opacity 0.8 | ホバー: 個性をもってプロジェクト情報を表示 |
| フッター: "© 2024 名前 All rights reserved." | ブランドの延長としてのフッター |
1.3 ポートフォリオのカラー戦略
ランディングページ(アクセント=CTA)とは異なり、ポートフォリオの色は個性を表現します。
| ペルソナ | パレットの方向性 |
|---|---|
| ミニマリストデザイナー | ほぼ白 + 1つの強いアクセント、豊富な余白 |
| 大胆なクリエイティブ | ダーク背景 + 鮮やかなアクセント、高コントラスト |
| テクニカルデベロッパー | ダーク/ターミナル風 または コードに着想を得たアクセントのクリーンなライト |
| 温かみのあるフリーランサー | アーシートーン、親しみやすく人間らしい雰囲気 |
| ラグジュアリー/プレミアム | 深みのあるニュートラル + ゴールド/シャンパン、洗練されたタイポグラフィ |
1.4 ポートフォリオ向けデザインブリーフ
## ポートフォリオデザインブリーフ: <名前>
### アイデンティティ
- **誰:** <名前 + 役割>
- **アーキタイプ:** <デザイナー / デベロッパー / クリエイティブ / フリーランサー / 学生>
- **ポートフォリオの目標:** <採用される / クライアントを得る / 存在感を示す>
- **ターゲットビューア:** <リクルーター / クライアント / 協業者>
### 個性(3つの形容詞を選ぶ)
- <例:正確、温かい、大胆>
### スタイルの方向性
- **プライマリスタイル:** <検索結果から — 例:「ダークエディトリアル」、「ソフトミニマリズム」>
- **一言で表す美学:** <例:「フォーカス」、「表現力豊か」、「テクニカル」>
- **このスタイルが作品に合う理由:** <一文>
### カラーパレット
- **背景:** <16進数> — <名前>
- **背景セカンダリ:** <16進数> — カード/パネル用
- **テキストプライマリ:** <16進数>
- **テキストミュート:** <16進数>
- **アクセント:** <16進数> — 控えめに、最大のインパクト
- **ボーダー/区切り:** <16進数>
### タイポグラフィ
- **見出しフォント:** <名前> + ウェイト + Google Fonts URL
- **本文フォント:** <名前> + Google Fonts URL
- **見出しスタイルのメモ:** <例:「タイトなトラッキング、大スケールコントラスト」>
### レイアウトパターン
- **グリッド:** <例:非対称2カラム、メイソンリー、フルブリード行>
- **プロジェクトカードスタイル:** <例:画像ファーストでホバーオーバーレイ、最小限のテキストカード>
- **セクションのトランジション:** <例:全幅仕切り、ずらして出現、なし>
### インタラクション
- **プロジェクトカードホバー:** <例:拡大 + タイトル/タグのオーバーレイ>
- **スクロールアニメーション:** <例:ワークグリッドにずらしてフェードアップ>
- **カーソル:** <デフォルト / カスタムドット / なし>
1.5 品質基準
- アーキタイプが特定され、主要な目標が明確
- 決定前に3つ以上のスタイルオプションを検索
- パレットが個性を表現している(単なる「クリーン」なデフォルトではない)
- フォントペアリングにコントラストがある — 1つはディスプレイ、1つは本文
- レイアウトパターンが作品の種類に合っている(写真 ≠ コードプロジェクト)
- ユーザーがデザインブリーフを承認した
フェーズ2 — コンテンツ
2.1 ヒーローコピー
ヒーローの書き出しは、ページで最も重要なテキストです。あなたは誰で、何をし、なぜそれが重要なのかを、個性をもって答えなければなりません。
フォーミュラのオプション:
| フォーミュラ | 例 |
|---|---|
| 役割 + 差別化要因 | 「0.1秒の瞬間にこだわるプロダクトデザイナー」 |
| 成果ファースト | 「複雑なソフトウェアをシンプルに感じさせる」 |
| 大胆な主張 | 「良いデザインは見えない。素晴らしいデザインは不可避だ。」 |
| 遊び心/直接的 | 「ウェブのものを作っています。現在仕事を探しています。」 |
| 名前 + 説明 | 「こんにちは、マヤです — スクリーンのためではなく、人間のためにデザインします」 |
避けるべき:
- 「私は5年の経験を持つ情熱的なデザイナーです」
- 「私のポートフォリオへようこそ」
- 一般的な形容詞: クリエイティブ、革新的、献身的、情熱的
2.2 プロジェクト説明
各プロジェクトエントリに必要なもの:
### <プロジェクト名>
**役割:** <あなたの役割 — 例:「リードデザイナー」、「単独デベロッパー」>
**タイプ:** <例:「モバイルアプリ」、「ブランドアイデンティティ」、「ウェブアプリ」>
**タグ:** [<技術/スキルタグ>]
**課題:** <1-2文 — どんな問題を解決する必要があったか>
**私がやったこと:** <2-3文 — あなたの具体的な貢献と決断>
**結果:** <可能であれば結果を含む1文 — 「オンボーディング時間を40%削減」>
[ライブ →](<URL>) [ケーススタディ →](<URL>) [GitHub →](<URL>)
ルール:
- テクノロジーではなく、問題から始める
- 役割は具体的に — 「デザイナー」は役割ではない、「オンボーディングフローをデザインした」が役割
- 数値があれば使う。なければ質的な結果を説明する
- 最大3〜6プロジェクト — 厳選する
2.3 アバウトセクション
構成:
- あなたは誰か — 現在の状態(役割、場所、何に注力しているか)
- これまでの経緯 — 簡単なアーク(履歴書ではなく、ストーリー)
- あなたが大切にしていること — 仕事の「なぜ」
- あなたが探しているもの — 仕事募集中 / 特定のタイプのプロジェクト / コラボレーション
長さ: 80〜150語。経歴書でもCVでもなく、一人の人間として。
2.4 スキル / スタックセクション
デザイナー向け:
デザイン: Figma, プロトタイピング, デザインシステム, タイポグラフィ, モーション
リサーチ: ユーザーインタビュー, ユーザビリティテスト, 競合分析
デベロッパー向け:
フロントエンド: React, TypeScript, Next.js, CSS/Tailwind
バックエンド: Node.js, PostgreSQL, REST/GraphQL
ツール: Git, Docker, Vercel, Figma
タグクラウド、アイコングリッド、グループ化されたリストで表示 — 単なる箇条書きは避ける。
2.5 連絡先セクション
とにかくシンプルに:
- メール(最も重要 —
mailto:でクリック可能に) - 2〜3のソーシャルリンク(GitHub, LinkedIn, Twitter/X, Dribbble — 関連するものを選択)
- 任意: 短い「現在〜を募集中」の一文
- 任意: シンプルな問い合わせフォーム(Formspree)
6つのフィールドがある問い合わせフォームは禁止。「コーヒーでもどうぞ」の決まり文句も禁止。
2.6 品質基準
- ヒーローの書き出しに個性がある(一般的でない)
- 各プロジェクトはテクノロジーではなく問題から始まる
- 役割は具体的で、単なる肩書きではない
- アバウトセクションが人間が書いたように読める
- 3〜6プロジェクト、質で厳選
- 連絡先セクションにmailtoリンクが主要なアクションとしてある
フェーズ3 — 構築
3.1 HTML構造
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title><名前> — <役割></title>
<meta name="description" content="<150字の自己紹介>">
<!-- Google Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=<見出しフォント>:wght@400;600;700&family=<本文フォント>:wght@400;500&display=swap" rel="stylesheet">
<!-- OG Tags -->
<meta property="og:title" content="<名前> — <役割>">
<meta property="og:description" content="<説明>">
<meta property="og:image" content="<og-image.jpg>">
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<nav class="nav" id="nav">...</nav>
<main>
<section class="hero" id="home">...</section>
<section class="work" id="work">...</section>
<section class="about" id="about">...</section>
<section class="skills" id="skills">...</section> <!-- 任意 -->
<section class="contact" id="contact">...</section>
</main>
<footer class="footer">...</footer>
<div class="project-modal" id="modal" aria-hidden="true">...</div> <!-- 任意のライトボックス -->
<script src="main.js"></script>
</body>
</html>
3.2 CSS設計
/* ── 1. Google Fonts ── */
/* ── 2. CSS変数 ── */
:root {
/* デザインブリーフの色 */
--color-bg: <16進数>;
--color-bg-secondary: <16進数>;
--color-text: <16進数>;
--color-text-muted: <16進数>;
--color-accent: <16進数>;
--color-border: <16進数>;
/* タイポグラフィ */
--font-heading: '<見出しフォント>', serif;
--font-body: '<本文フォント>', sans-serif;
/* タイプスケール */
--text-hero: clamp(3rem, 8vw, 7rem);
--text-h2: clamp(1.75rem, 4vw, 2.75rem);
--text-h3: clamp(1.125rem, 2vw, 1.5rem);
--text-body: 1.0625rem;
--text-sm: 0.875rem;
/* スペーシング */
--section-padding: clamp(5rem, 12vw, 10rem);
--container-width: 1200px;
--gap: 1.5rem;
--radius: 8px;
--radius-lg: 16px;
/* トランジション */
--transition: 0.3s ease;
--transition-slow: 0.6s ease;
}
/* ── 3. リセット + ベース ── */
/* ── 4. レイアウト (.container, .section, .grid-2, .grid-3) ── */
/* ── 5. ナビ (固定、スクロールに応じて背景変更) ── */
/* ── 6. ヒーロー ── */
/* ── 7. 作品 / プロジェクトグリッド ── */
/* ── 8. プロジェクトカード + ホバー ── */
/* ── 9. アバウト ── */
/* ── 10. スキル ── */
/* ── 11. 連絡先 ── */
/* ── 12. フッター ── */
/* ── 13. モーダル / ライトボックス(使用する場合) ── */
/* ── 14. スクロールアニメーション ── */
/* ── 15. レスポンシブ ── */
3.3 プロジェクトグリッド
<!-- オプションのフィルター付き作品セクション -->
<section class="work" id="work">
<div class="container">
<div class="work__header">
<h2 class="work__title">Selected Work</h2>
<!-- オプションのフィルタータブ -->
<div class="work__filters" role="tablist">
<button class="filter-btn active" data-filter="all">All</button>
<button class="filter-btn" data-filter="design">Design</button>
<button class="filter-btn" data-filter="dev">Development</button>
</div>
</div>
<div class="work__grid" id="work-grid">
<!-- プロジェクトカード -->
<article class="project-card" data-category="design" data-index="0">
<div class="project-card__image">
<img src="assets/images/project-1.jpg" alt="<プロジェクト名> — <簡単な説明>" loading="lazy">
<div class="project-card__overlay">
<span class="project-card__type"><タイプ></span>
<h3 class="project-card__title"><プロジェクト名></h3>
<div class="project-card__tags">
<span class="project-tag"><タグ1></span>
<span class="project-tag"><タグ2></span>
</div>
</div>
</div>
</article>
<!-- さらにカードを追加... -->
</div>
</div>
</section>
3.4 JavaScript
// ── フィルタリング ──
// project-card要素のdata-category属性に基づいてフィルタリング
// フィルターボタンのアクティブ状態を切り替える
// ── ライトボックス / モーダル ──
// クリックでモーダルを開き、プロジェクトの詳細/画像を表示
// オーバーレイまたは閉じるボタンで閉じる
// フォーカストラップを実装してアクセシビリティを確保
// ── スクロールアニメーション ──
// IntersectionObserverを使用
// 要素に.is-visibleクラスを追加してCSSトランジションをトリガー
// ビューポートに入るたびにアニメーションが1回だけ実行されるようにする
// ── モバイルナビゲーション ──
// ハンバーガーメニューを切り替え
// モバイルメニューが開いているときにスクロールを無効にする
// リンクをクリックするとメニューを閉じる
3.5 品質基準
- HTMLセマンティクスが正しい(nav, main, section, article, footer)
- CSS設計が論理的に構造化されている(トークン→リセット→レイアウト→コンポーネント)
- カラー、タイポグラフィ、スペーシングにCSS変数を使用
- すべての画像にloading="lazy"が設定されている
- プロジェクトグリッド完全にレスポンシブ(デスクトップ3列、タブレット2列、モバイル1列)
- ホバーインタラクションがスムーズで目的がある
- ライトボックス/モーダルにフォーカストラップがある
- ナビゲーションがスムーズにスクロールし、モバイルで正しく機能する
- パフォーマンス: CSS/JSが小さく、外部依存関係がない
フェーズ4 — 納品
4.1 本番準備
| タスク | 説明 |
|---|---|
| OG画像 | 1200×630pxのOG画像を作成。名前、役割、ブランド要素を含める。ページの <head> に追加。 |
| ファビコン | SVGファビコンを使用(<link rel="icon" type="image/svg+xml" href="favicon.svg">)。ブランドカラーに合わせる。 |
| altテキスト | すべての画像に意味のあるaltテキストがあることを確認。 |
| キーボードナビ | Tabですべての要素にアクセスでき、Enterでアクティブ化できることを確認。 |
| 色のコントラスト | テキストのコントラスト比がAA(4.5:1)以上であることを確認。 |
| リンクテスト | mailto、ソーシャル、外部リンクがすべて正しく機能することを確認。 |
| モバイルテスト | 実機またはChrome DevToolsですべてのビューポートサイズをテスト。 |
| パフォーマンス | Lighthouseで90以上のパフォーマンススコアを目標に。画像を圧縮し、CSS/JSを最小化。 |
4.2 Vercelデプロイ
# Vercelアカウントをお持ちでない場合
npm install -g vercel
vercel login
# Vercelにデプロイ
cd portfolio
vercel --prod
# カスタムドメイン(任意)
vercel domians add <your-domain.com>
または、vercel.com/new にアクセスし、ポートフォリオフォルダをドラッグ&ドロップしてインポート。
4.3 デプロイ後のチェックリスト
- すべてのリンクが機能している
- OGタグがソーシャルシェアで正しく表示される
- ファビコンが表示される
- モバイルですべてのインタラクションが期待通りに動作する
- Lighthouseスコア(アクセシビリティ + パフォーマンス)が良好
- ダークモードとライトモードをテスト済み(該当する場合)
- ユーザーが最終承認
一般的なルール
- ポートフォリオはデザインそのものです。 凡庸に見えれば、作品も凡庸だと思われます。
- 問題から始め、テクノロジーは後から。 誰もあなたが使ったフレームワークを気にしません。彼らはあなたが何を解決したかを気にします。
- 質が量に勝ります。 3つの素晴らしいプロジェクトは、10の平均的なプロジェクトよりも説得力があります。
- 各プロジェクトの「役割」は具体的に。 「デザイナー」とだけ書かないでください。「ユーザーフローをデザインし、ビジュアルデザインをリードした」のように書きましょう。
- ヒーローはあなたの「一番の売り」です。 「私は[名前]です。[役割]です」では不十分です。興味をそそりましょう。
- パーソナルタッチを加えましょう。 プロフェッショナルでありながら人間らしく。最高のポートフォリオは、スキルだけでなく個性も伝えます。
- 簡潔にしましょう。 1ページあたりの訪問時間は数秒です。重要なものだけを表示し、散らかさないように。
- タイポグラフィが重要です。 フォントペアリングはコントラストがあり、意図的であるべき。選択を軽んじないでください。
- レスポンシブは必須です。 採用担当者の70%以上がモバイルで最初に閲覧します。両方のデバイスで完璧に動作することを確認してください。
- デプロイ前に必ずテストを。 壊れたリンク、スペルミス、モバイルの崩れ — これらはユーザーを逃します。
ユーザーと協力して構築してください。 すべてのフェーズの後でユーザーに確認と承認を求めてください。 ポートフォリオは最も個人的なウェブサイトです。ユーザーの声、彼らの作品、彼らのブランドがすべての決断を導くべきです。 あなたの仕事はコーディングすることではなく、ユーザー自身が表現するのを助けることだと覚えておいてください。
