Communitygithub.com

個人サイト greenfield — 一言で GSAP ポートフォリオ

一言でデプロイ可能な個人ポートフォリオ:素の HTML/CSS/JS + GSAP、ビルド不要、5テーマ、12フォント、16の反AIスロップ規則、8+モーション。index.html を開けば動く。

個人サイト greenfield — 一言で GSAP ポートフォリオ とは?

Personal websites 手順1(scaffold):Mort1d portfolio-genesis。一言→完成度の高い素の個人サイト。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mort1d/portfolio-site/tree/HEAD/skill/portfolio-genesis

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

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

ドキュメント

Portfolio Genesis

ワンプロンプトでポートフォリオを生成。プロフェッショナルなGSAPアニメーション、レスポンシブデザイン、そしてAI生成とは思えない手作り感あふれる独自の美しさを備えた、完全でデプロイ可能なサイトを生成します。ユーザーが index.html をブラウザで開けば、プロ品質のポートフォリオが表示されます。

哲学

  • すべてのポートフォリオはストーリーを語る。デザイン自体がポートフォリオの最初のプロジェクトである。
  • アンチテンプレート:生成されるサイトはどれも同じ見た目にしてはならない。テーマはユーザーの分野、人格、トーンによって決定される。
  • 「index.htmlを開いて「ワウ」と言わせる」— npmゼロ、ビルドステップゼロ、即座に満足感を得られる。
  • 制約=自由:バニラHTML/CSS/JS + GSAPは、手作り感のあるクリエイティブなCSSを強制する。
  • 3つしっかりと紹介されたプロジェクトがあるポートフォリオは、20の一般的なカードに勝る。質は量に勝る。
  • スクロール体験こそがポートフォリオである。スクロールするすべてのピクセルが意図的に感じられるべきである。

プロセス

ステップ1:情報収集

ユーザープロンプトから以下を抽出する:

  • アイデンティティ: 名前、ハンドル/エイリアス、役割/肩書き
  • 自己紹介: 1〜3文(提供されていない場合は文脈から合成)
  • プロジェクト: タイトル、説明、タグ、リンク、取引金額、役割
  • ソーシャル: X、Discord、Telegram、GitHub、LinkedIn、メール、YouTube(提供されたもののみ含める)
  • アバター: ファイルパス、またはイニシャルでCSSグラデーション円を生成
  • 統計: 経験年数、プロジェクト数、コミュニティリーチ、探求したツール
  • トーン: プロフェッショナル | ハッカー | クリエイティブ | エレガント | 遊び心 | ミニマル | サイバー

ユーザーからの入力が最小限の場合は、文脈に関連したプレースホルダーデータを生成し、インジェクションポイントにマークを付ける:<!-- CUSTOMIZE: Replace with your Twitter handle -->。URLが提供されていない場合はソーシャルボタンを完全に省略する — href="#" を決してレンダリングしない。

ステップ2:テーマ選択

以下の決定木を使用して、5つのテーマから選択する。その後、 references/themes/{theme-name}.md からテーマファイルを読み込む。

ユーザーはcrypto/web3/blockchainにいますか?
  YES → "clean"/"minimal" に言及? → mono-minimal
        それ以外 → midnight-glass(デフォルト)または neon-cyberpunk("neon"/"cyber" に言及)

ユーザーはデザイナー/アーティスト/クリエイティブですか?
  YES → ダークを好む? → midnight-glass
        それ以外 → warm-organic(デフォルト)または paper-brutalist("editorial"/"print" に言及)

ユーザーは開発者/エンジニアですか?
  YES → midnight-glass(デフォルト)または mono-minimal("clean"/"minimal" に言及)

ユーザーは学生/初心者ですか?
  YES → warm-organic(フレンドリー)または neon-cyberpunk(若い/エネルギッシュな場合)

ユーザーはビジネス/プロフェッショナルですか?
  YES → mono-minimal(デフォルト)または warm-organic("approachable" に言及)

明示的なオーバーライド(最優先):
  "dark" / "glass" → midnight-glass
  "light" / "clean" / "paper" → paper-brutalist
  "neon" / "cyber" / "futuristic" → neon-cyberpunk
  "warm" / "earthy" / "organic" → warm-organic
  "minimal" / "mono" / "typography" → mono-minimal

ステップ3:ファイル生成

参照ファイルを以下の順序で読み込む:

  1. references/themes/{selected-theme}.md — 色、フォント、カードスタイル
  2. references/animations/gsap-patterns.md — アニメーションレシピ
  3. references/sections/hero-variants.md — ヒーローレイアウトを選択
  4. references/typography/font-pairings.md — フォントの選択を確定

3つのファイル(index.html、css/style.css、js/main.js)を正確に生成する。

ヒーローレイアウト決定

アバター画像が提供されている?
  YES → 中央寄せアバター(デフォルト)
        例外:強いプロジェクト紹介があるデザイナー → スプリットヒーロー
  NO  → 強いタイトル/タグライン? → 全画面タイポグラフィ
        それ以外 → ミニマル(名前+役割+スクロールインジケーター)

役割記述子の数:
  1   → 単一の大きなサブタイトル
  2-3 → ドット区切りのサブタイトル行
  4+  → GSAPテキストスワップによるアニメーション役割ローテーション

プロジェクトセクション決定

プロジェクト数:
  0   → プロジェクトをスキップ。代わりにスキル/テクノロジータグクラウドセクションを追加
  1-2 → 大きなフィーチャーカード(全幅または余分なパディングを付けた2カラム)
  3-4 → 均等サイズの2カラムグリッド
  5-8 → ベントーグリッド(1つの大きなカード+小さなカード)
  9+  → トップ6を表示し、「すべて表示」リンクを追加、または水平スクロール

ステップ4:品質チェック

ファイルを出力する前に、納品前チェックリストを実行する。

出力構成

index.html

完全なセマンティックHTML5。Google FontsとGSAP 3.12.5のCDNリンク。すべてのコンテンツはインライン。セクション:ナビ、ヒーロー、アバウト、プロジェクト(該当する場合)、オプションのマーキー/スキル、コンタクト、フッター。以下を含む:

  • <!DOCTYPE html>、<html lang="en">、charset、viewport
  • ユーザー名+役割を含む <title>
  • 自己紹介を含む <meta name="description">
  • OGタグ:og:title、og:description、og:type(website)
  • Google Fonts <link rel="preconnect"> + スタイルシート
  • defer 付きGSAP + ScrollTrigger CDN
  • <link rel="stylesheet" href="css/style.css">
  • bodyの最後に <script src="js/main.js" defer>

css/style.css

すべてのスタイル。 :root でのCSSカスタムプロパティ(色、フォント、間隔、半径、イージングをカバーする最小20変数)。完全なレスポンシブ(768px + 480pxブレークポイント)。以下を含める必要がある:

  • リセット:*、*::before、*::after { margin:0; padding:0; box-sizing:border-box }
  • html { scroll-behavior: smooth } + カスタムスクロールバー
  • body { overflow-x: hidden; -webkit-font-smoothing: antialiased }
  • テーマアクセントカラーでの ::selection
  • ノイズオーバーレイ(インラインSVG feTurbulence、不透明度0.02-0.04)
  • .reveal-up { opacity: 0; transform: translateY(30px) } 初期状態
  • @media (prefers-reduced-motion: reduce) — すべてのアニメーションを無効にし、カーソルのグローを非表示にする
  • すべての装飾的なfixed/absolute要素に pointer-events: none

js/main.js

DOMContentLoaded でラップされたGSAPアニメーション。GSAP利用可能性チェックから始まる:

if (typeof gsap === 'undefined') {
    document.querySelectorAll('.reveal-up').forEach(el => {
        el.style.opacity = '1';
        el.style.transform = 'none';
    });
    return;
}

ScrollTriggerを登録。以下を含む:ヒーローエントランスタイムライン、スクロールリビール、統計カウンター、カードチルト、カーソルグロー、マグネティックボタン、パララックス、ナビ収縮。正確な実装については references/animations/gsap-patterns.md を参照。

パーソナライゼーションポイント

場所データソースフォールバック
<title>名前+役割"Portfolio"
<meta description>役割+スキル役割から生成
OGタグタイトル/説明と同じ同上
ナビロゴ角括弧内のハンドル [MX]イニシャル
ヒーローh1役割またはアイデンティティステートメント分野+ "Builder"
ヒーローサブタイトル· で区切られた役割3つのスキル領域
ヒーローバッジ@ハンドル"@username"
アバター src + altユーザーパスイニシャル付きCSSグラデーション円
ソーシャルボタン実際のURLのみURLがない場合はボタンを省略
アバウト見出しパーソナルステートメント"Building at the intersection of X, Y & Z"
アバウト自己紹介ユーザー提供または合成3文の自己紹介
タグスキル領域役割/プロジェクトから
統計カード実際の数字+ラベル文脈からの推定
プロジェクトカードタイトル、説明、タグ、リンクプロジェクト情報から
コンタクトカードプラットフォーム、ハンドル、URL提供されたプラットフォームのみ
フッター名前+ new Date().getFullYear()JSで動的年度

アンチパターン

#アンチパターンなぜダメか代わりにこうする
1見出しフォントにInter/Robotoすぐに「AI生成」とわかる。これらはボディフォントであり、ディスプレイフォントではない。Syne、Outfit、Instrument Serif、Bricolage Grotesque、Unboundedなどの特徴的なディスプレイフォントを使用する。
2白地に紫のグラデーション2023年以来、#1の「AIスロップ」ビジュアルクリシェ。誰もが認識する。暗い背景に鮮やかなアクセント、または暖色系パレットを使用する。
3デフォルトとしてのSpace Grotesk2023年は特徴的だったが、現在はAI生成サイトで最も使い古されたフォント。12のキュレーションされたペアリングでローテーションする。ユーザーが明示的にブランドとして使用する場合のみ使用する。
4GSAPフォールバックなしの opacity:0GSAP CDNが失敗すると、サイト全体が表示されなくなる。空白ページ。最初のJS行:typeof gsap をチェックし、未定義の場合はすべての .reveal-up を表示可能に設定する。
5素晴らしいヒーローだが、下のほうは平凡スクロールすると「ワウ」が消える。映画的なヒーローの下に型にはまったカード。すべてのセクションに均等なデザインの注意を払う。スクロールジャーニーがポートフォリオである。
6ソーシャルリンクの href="#"サイトが明らかに偽物であることがわかる。信頼性を損なう。実際のURLを使用する。提供されていない場合は、ボタンを完全に省略する。
7どこでも同じアニメーションタイミングすべてが同じ速度で同じイージングだと、ロボットのように感じられる。持続時間(0.4秒〜1.2秒)を変える。要素ごとに異なるイージング。ネガティブオフセットでスタガー。
8pointer-events: none のない装飾要素オーブ、ノイズ、カーソルグローが下のコンテンツのマウスクリックをブロックする。すべての装飾的なfixed/absolute要素に pointer-events: none を設定する。
9グラデーション背景上のグラデーションテキスト読みにくい。2つの競合するグラデーションが打ち消し合う。グラデーションテキストは、無地/ほぼ無地の暗い背景の上のみに使用する。視覚領域ごとに1つのグラデーション。
10カードの cursor: pointer の欠如カードはインタラクティブに見えるが、カーソルはデフォルトのまま。ユーザーは混乱する。ホバー状態またはクリックハンドラーを持つすべての要素に cursor: pointer を設定する。
11UI内の絵文字アイコン普遍的な「AIが作った」シグナル。デザインの努力なし。assets/social-icons.svg からのインラインSVG。ナビ、ボタン、ヘッダーに絵文字なし。
12width: 100vwWindowsでスクロールバーがある場合、スクロールバーの幅を含むため、水平オーバーフローが発生する。width: 100% または body に overflow-x: hidden を使用する。
135つのアイコンのためにアイコンライブラリを読み込む余分なHTTPリクエスト、FOUC、約2KBのSVGパスのためのCDN依存。HTMLに直接インラインSVGを埋め込む。5〜8つのソーシャルアイコン=約2KBのインライン。
14一般的なCTAテキスト「Let's Connect」/「Get In Touch」— すべてのAIポートフォリオがこれらを使用する。人格に合わせる:「Let's Build Something」(ビルダー)、「Say gm」(暗号通貨)、「Drop a Line」(カジュアル)。
15アバターの alt の欠如アクセシビリティに失敗。スクリーンリーダーは何もアナウンスしない。alt="[ユーザー名]" — シンプルで説明的。
164色以上の虹色グラデーションテキストおもちゃのように見える。多色グラデーションはめったにうまく機能しない。同じファミリーから最大2〜3色(ピンク→紫、ピンク→緑→青ではない)。

必須アニメーション

実装については references/animations/gsap-patterns.md を参照。すべてのサイトに以下を含める必要がある:

  1. ヒーローエントランスタイムライン — スタガード .from():アバター(back.out)、バッジ、タイトル行、サブタイトル、ソーシャル(back.outスタガー)、スクロールインジケーター。ネガティブオフセットで重複。
  2. スクロールリビール — .reveal-up 要素が {y:30, opacity:0} から start: "top 85%" でアニメーション。ビューポートグループ内でスタガー。
  3. 統計カウンター — onUpdate を介して0から目標までアニメーション。スクロールでトリガー。
  4. カードチルト — mousemove → カーソルオフセットからの rotateX/rotateY。transformPerspective: 1000。mouseleaveでリセット。
  5. カーソルグロー — 600pxのラジアルグラデーションがマウスを追跡。requestAnimationFrame + 0.08 lerp。
  6. マグネティックボタン — ソーシャルボタンがカーソルに向かって移動(0.3倍係数)。elastic.out(1, 0.5) でスナップバック。
  7. パララックス背景 — 装飾要素がスクロールで scrub: 1 で移動。
  8. ナビ収縮 — 80pxスクロール深度で .scrolled クラスをトグル。

オプション(テーマ/コンテンツに基づいて追加):

  • スクロール速度ブースト付きマーキー
  • 文字単位のテキスト分割リビール(サイバーパンク/ドラマチック)
  • 5つ以上のプロジェクトの水平スクロール
  • ホバー時のグラデーションテキストシャイマー
  • 左からのセクションラベルスライドイン

品質チェックリスト

構造:

  • 3つのファイルすべて生成(index.html、css/style.css、js/main.js)
  • DOCTYPE、charset、viewport、lang属性が存在する
  • ユーザーの実際の情報を含むOGメタタグ
  • :root 内のすべてのCSSカスタムプロパティ
  • defer 付きGSAP CDNリンク
  • bodyの最後に defer でJSがリンクされている

コンテンツ:

  • すべてのユーザーデータが注入されている(名前、リンク、プロジェクト、自己紹介)
  • 一般的なプレースホルダーがない("Lorem ipsum"、"Your Name Here")
  • ソーシャルリンクは実際のURLを使用し、提供されたリンクに href="#" がない
  • フッターに正しい名前と動的年度がある

ビジュアル:

  • フォントペアリングがInter、Roboto、Arial、またはSpace Groteskではない(ユーザー指定の場合を除く)
  • 紫地に白の配色パターンがない
  • UIに絵文字アイコンがない
  • 色のコントラストがWCAG AA(ボディテキストで4.5:1)を満たしている
  • 375px、768px、1440pxでレスポンシブ — 水平スクロールなし
  • prefers-reduced-motion でアニメーションを無効にし、カーソルグローを非表示にする

技術:

  • GSAPフォールバックが存在する(typeofチェック+不透明度リセット)
  • すべての装飾要素に pointer-events: none がある
  • CSSに width: 100vw がない
  • すべてのインタラクティブ要素に cursor: pointer がある
  • 画像に alt 属性がある
  • 外部リンクに target="_blank" rel="noopener" がある

関連スキル