Communitygithub.com

qike7777/skill-library

際立つビジュアル・アイデンティティを持つ、魅力的なパーソナルポートフォリオウェブサイトを構築します。ui-ux-design-pro デザインデータベース(67以上のスタイル、161のパレット、57のフォントペアリング)を統合し、大胆で記憶に残る美学を実現。個人ブランディング、プロジェクトショーケースのレイアウト、レスポンシブHTML/CSS、インタラクティブエフェクト(ホバー/フィルター/ライトボックス)、Vercelデプロイまでをカバーします。デザイナー、デベロッパー、フリーランサー、クリエイティブプロフェッショナル向け。

skill-library とは?

このスキルは、個人のポートフォリオウェブサイトをゼロから構築するための包括的なエージェントワークフローです。訪れた人に「一緒に仕事をしたい」と思わせることを唯一の目的とし、デザイン・コピー・プロジェクト選択・インタラクションのすべてがその目標に貢献します。**理解 → ブランドアイデンティティ → コンテンツ → 構築 → デプロイ** という5つのフェーズで構成され、ui-ux-design-pro デザインデータベース(67以上のスタイル、161のカラーパレット、57のフォントペアリング)を活用。デザイナー、デベロッパー、クリエイティブ職、フリーランサー、学生など、あらゆるポートフォリオタイプに対応します。技術スタックはHTML + CSS + Vanilla JSが標準で、フレームワーク不要、Vercelへの静的ファイルデプロイにより高速な公開が可能です。プロジェクトグリッドのフィルタリング、ライトボックス、スクロールアニメーションなどのインタラクティブ機能も実装します。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/qike7777/skill-library/tree/HEAD/skills/3-websites-and-apps/portfolio

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

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

プレビュー

スキル README より

skill-library preview

ドキュメント

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 アバウトセクション

構成:

  1. あなたは誰か — 現在の状態(役割、場所、何に注力しているか)
  2. これまでの経緯 — 簡単なアーク(履歴書ではなく、ストーリー)
  3. あなたが大切にしていること — 仕事の「なぜ」
  4. あなたが探しているもの — 仕事募集中 / 特定のタイプのプロジェクト / コラボレーション

長さ: 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スコア(アクセシビリティ + パフォーマンス)が良好
  • ダークモードとライトモードをテスト済み(該当する場合)
  • ユーザーが最終承認

一般的なルール

  1. ポートフォリオはデザインそのものです。 凡庸に見えれば、作品も凡庸だと思われます。
  2. 問題から始め、テクノロジーは後から。 誰もあなたが使ったフレームワークを気にしません。彼らはあなたが何を解決したかを気にします。
  3. 質が量に勝ります。 3つの素晴らしいプロジェクトは、10の平均的なプロジェクトよりも説得力があります。
  4. 各プロジェクトの「役割」は具体的に。 「デザイナー」とだけ書かないでください。「ユーザーフローをデザインし、ビジュアルデザインをリードした」のように書きましょう。
  5. ヒーローはあなたの「一番の売り」です。 「私は[名前]です。[役割]です」では不十分です。興味をそそりましょう。
  6. パーソナルタッチを加えましょう。 プロフェッショナルでありながら人間らしく。最高のポートフォリオは、スキルだけでなく個性も伝えます。
  7. 簡潔にしましょう。 1ページあたりの訪問時間は数秒です。重要なものだけを表示し、散らかさないように。
  8. タイポグラフィが重要です。 フォントペアリングはコントラストがあり、意図的であるべき。選択を軽んじないでください。
  9. レスポンシブは必須です。 採用担当者の70%以上がモバイルで最初に閲覧します。両方のデバイスで完璧に動作することを確認してください。
  10. デプロイ前に必ずテストを。 壊れたリンク、スペルミス、モバイルの崩れ — これらはユーザーを逃します。

ユーザーと協力して構築してください。 すべてのフェーズの後でユーザーに確認と承認を求めてください。 ポートフォリオは最も個人的なウェブサイトです。ユーザーの声、彼らの作品、彼らのブランドがすべての決断を導くべきです。 あなたの仕事はコーディングすることではなく、ユーザー自身が表現するのを助けることだと覚えておいてください。

Individual skills in this repo

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

関連スキル