Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

ソフトウェアエンジニア向けの、GSAPアニメーションを使用したクリエイティブなポートフォリオウェブサイトやセクションを構築するスキルです。

TasmiaZerin1128.github.io とは?

このスキルは、GSAP(GreenSock Animation Platform)とScrollTriggerを活用して、視覚的に印象的でストーリー性のあるポートフォリオサイトを構築するためのものです。単なるカードグリッドやヒーローセクションではなく、「見る人をスクロールで引き込む体験」を重視し、目的を持ったアニメーション(ステガーリビール、テキスト分割アニメーション、パララックス、磁気カーソル効果、水平スクロールセクションなど)を実装します。HTML/CSS/JSの単一ファイル、Reactプロジェクトの両方に対応し、アクセシビリティ(`prefers-reduced-motion`対応)やパフォーマンス最適化も考慮されています。また、ターミナルノワールやブルータリストコードなど、エンジニアのアイデンティティに合った5つの美的方向性から選択して構築できます。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

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

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

ドキュメント

GSAPポートフォリオスキル

あたかもクリエイティブスタジオが制作したかのような、しかしソフトウェアエンジニアの魂が宿ったポートフォリオウェブサイトを構築します。目標は「ヒーローとカードがある corporate dev ポートフォリオ」ではありません。目標は、誰かがスクロールする手を止めてしまうような体験です。

哲学

開発者のポートフォリオは2つの方法で失敗します。退屈か(白いページ、カードグリッド、「こんにちは、開発者です」)、あるいはコンテンツから切り離されたエフェクトでやりすぎてしまうかです。理想は目的を持ったドラマです。すべてのアニメーションは、単に動くためではなく、何かを明らかにしているように感じられるべきです。

ポートフォリオを「ページ」ではなく物語と考えてください。訪問者はストーリーを通じて導かれます。あなたは誰か → 何を築いてきたか → どのように考えるか → どうやって連絡を取るか。

GSAPの統合

GSAPは常にCDNから読み込んでください。最新バージョンをGSAP CDN(cdnjsではなく)から使用します。

<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>

Reactプロジェクトの場合は、npmでインストールします。

npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

使用する主要なGSAPパターン

1. ステガーリビール(段階的表示) — 基本中の基本。グループ要素を一度にすべて表示してはいけません。

gsap.from('.skill-item', {
  y: 60,
  opacity: 0,
  duration: 0.8,
  stagger: 0.12,
  ease: 'power3.out',
  scrollTrigger: {
    trigger: '.skills-section',
    start: 'top 80%',
  }
});

2. テキスト分割アニメーション — 見出しを文字/単語に分割し、アニメーションで表示します。これは追加できる中で最もインパクトのあるアニメーションです。可能であればSplitTextプラグインを使用し、そうでなければ手動でスパンに分割します。

// 手動の文字分割
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
  (char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? '&nbsp;' : char}</span>`
).join('');

gsap.from('.char', {
  y: 120,
  opacity: 0,
  rotateX: -80,
  stagger: 0.03,
  duration: 1,
  ease: 'power4.out',
});

3. スクロール駆動ピン留め — セクションをピン留めし、ユーザーがスクロールするにつれてコンテンツをアニメーションします。これが「映画的」な感覚を生み出します。

gsap.timeline({
  scrollTrigger: {
    trigger: '.pinned-section',
    start: 'top top',
    end: '+=200%',
    pin: true,
    scrub: 1,
  }
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');

4. パララックスレイヤー — 異なるスクロール速度で奥行きを与えます。

gsap.to('.bg-layer', {
  yPercent: -30,
  ease: 'none',
  scrollTrigger: {
    trigger: '.parallax-section',
    start: 'top bottom',
    end: 'bottom top',
    scrub: true,
  }
});

5. 磁気/カーソルフォロー効果 — CTAや注目プロジェクトなどのインタラクティブ要素に。

const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
  const rect = btn.getBoundingClientRect();
  const x = e.clientX - rect.left - rect.width / 2;
  const y = e.clientY - rect.top - rect.height / 2;
  gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
  gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});

6. 水平スクロールセクション — プロジェクトのショーケースに最適。垂直にスクロールするが、コンテンツは水平に移動します。

const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');

gsap.to(items, {
  xPercent: -100 * (items.length - 1),
  ease: 'none',
  scrollTrigger: {
    trigger: track,
    pin: true,
    scrub: 1,
    end: () => '+=' + track.scrollWidth,
  }
});

高度なパターン(形状のモーフィング、カスタムカーソルトレイル、ノイズベースの動き、WebGL統合のヒントなど)については、references/gsap-patterns.md を参照してください。

美的方向性

ソフトウェアエンジニアのポートフォリオには、以下の美的方向性が最適です。プロジェクトごとに1つ選び、決して混ぜないでください。

1. ターミナルノワール (Terminal Noir)

暗い背景、モノスペース書体とシャープなサンセリフの組み合わせ、黒地に緑/琥珀/シアンのアクセント。ターミナルの内部にいるような感覚 — ただし美しいもの。スキャンラインオーバーレイ、点滅カーソル、タイピングアニメーションを使用します。ハッカー美学とエディトリアルデザインの融合。

2. ブルータリストコード (Brutalist Code)

生々しく露出した構造。可視のグリッド線、大きなモノスペース書体、厳しいコントラスト。要素は意図的に position: absolute で配置されたように感じられます。アニメーションはスナップ感があり機械的 — ease-outは使わず、steps() または power4.inOut を使用します。コンパイラにセンスがあったら、という発想。

3. ソフトエンジニアリング (Soft Engineering)

暖かみのある中間色の明るい背景、余白をたっぷりと、見出しに優雅なセリフ体と清潔なサンセリフを組み合わせ。滑らかで流れるようなアニメーション。プレミアムで落ち着いた印象。ディーター・ラームスがポートフォリオをデザインしたら、という発想。

4. ネオンアーキテクト (Neon Architect)

暗いベース、鮮やかなネオンアクセント(マゼンタ、エレクトリックブルー、ライム)、グラスモーフィズム、グロー効果。アニメーションは流動的で、ほとんど液体のように感じられます。グリッドベースのレイアウトにオーバーラップする要素。ブレードランナーとスイスデザインの融合。

5. アナログデジタル (Analog Digital)

紙のテクスチャ、手描き要素とシャープなデジタル書体の組み合わせ、微妙なグレインオーバーレイ。暖色系のカラーパレット。アニメーションは物理的な動きを模倣 — 紙のようにスライドし、カードのようにスタックします。スケッチもする開発者、という発想。

セクションアーキテクチャ

強力なポートフォリオは以下の構造に従います。各セクションは独自の「シーン」のように感じられるべきです。

ヒーロー (Hero)

最初の3秒が最も重要です。テキストアニメーションから始めましょう — 訪問者はあなたの名前が生き生きと動くのを見るはずです。背景にさりげないアンビエントアニメーション(浮遊パーティクル、形状のモーフィング、グラデーションアニメーション)を含めます。メッセージは極めてシンプルに:名前 + 一行のアイデンティティ。

アバウト/哲学 (About/Philosophy)

事実を並べるだけではいけません。世界観を表現しましょう。スクロールトリガーを使用してテキストを一行ずつ表示します。写真は任意ですが、含める場合はクリエイティブな処理(デュオトーン、クリップパスリビール、パララックスオフセット)を施します。

スキル/技術スタック (Skills/Tech Stack)

退屈なロゴのグリッドは絶対に使わないでください。代わりに試すべきもの:オービタルビジュアライゼーション、スクロールするティッカー/マーキー、ホバーに反応するインタラクティブタグ、コンステレーションマップ、または自分自身を「タイプ」するターミナル形式のリスト。

プロジェクト (Projects)

中心となる部分。各プロジェクトには余裕が必要です。以下のいずれかを使用:水平スクロールギャラリー、ピン留めして遷移する全画面スタックカード、またはスクロールトリガーで展開するカード。各プロジェクトには以下を表示:タイトル、簡単な説明、使用技術、ビジュアル(スクリーンショット、動画、またはクリエイティブなイラスト)。

コンタクト/フッター (Contact/Footer)

意図を持って締めくくります。大きなタイポグラフィのCTA、おそらく時間に基づく挨拶(「こんばんは — 話しましょう」)、そして清潔なコンタクトリンク。パンチの効いたものにします。

各セクションタイプの詳細な HTML/CSS/JS テンプレートについては、references/portfolio-sections.md を参照してください。

タイポグラフィのルール

Google Fontsからフォントをインポートします。システムフォントやInter/Robotoは使用しないでください。

開発者ポートフォリオに適した組み合わせ:

  • ディスプレイ + ボディ:

関連スキル