Communitygithub.com

動く個人ホームページ

カートゥーンの主役がカーソルを追い、スクロールでセクション間を演じる個人サイトを作り、公開まで届ける。

動く個人ホームページ とは?

聞き取りのあと、キャラクターと背景を一つに固定し、視線とつなぎの映像を作って静的ページに組み、公開する。スクロールの進み方が演技になる。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yaohuicong/motion-homepage/tree/HEAD

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

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

ドキュメント

動くパーソナルホームページ

完成品は静的なWebサイト(HTML/CSS/JS、ビルド不要)で、3つのレイヤーで構成されています。

  1. キャラクターステージ: フルスクリーンのキャンバスに、AI生成キャラクターの動画フレームを描画します。最初の画面では、マウスの方向に応じて「視線追従ループ」の対応するフレームを再生。次のセクションにスクロールすると、2つのセクション間の「トランジションクリップ」を再生し、スクロールの進行度が再生進行度になります。スマートフォン縦画面では、キャラクターは上半分に配置されます。
  2. コンテンツセクション: ファーストビュー / 職務経歴 / 作品一覧 / 厳選作品 / エンディング。テキストはステージの上に重ねられ、キャラクターがいる側を避けて配置されます。
  3. 手描き装飾とエフェクト: 落書き(登場時に一筆書きで表示され、その後手描きアニメーションのように震える)、ゆっくり変形する絵の具の塊、キャラクターの頭に追従する吹き出し、手描きの丸やブラシの下線、マウスがキャラクターを通過するときの回転する波状の歪み(React Bits「Ripple Distortion」、WebGL、ステージのみ歪ませる。非対応時は蛍光ペンの軌跡にフォールバック)、1文字ずつ表示、浮遊する小さなカートゥーンステッカー。

テンプレートのデフォルトスタイルは「ダーク手描き落書き + 3D主人公」(ほぼ黒背景 + 蛍光イエローグリーン/紫/青/オレンジ、マーカーペン手書きタイトル、3Dカートゥーンキャラクターに2D落書きステッカー)、全編英語。スタイルの変更は、theme(色、フォント)と各セクションの decor(装飾)を変更するだけで行え、エンジンを変更する必要はありません。

サイトの見栄えは、素材が連続的に一貫しているかどうか(同じキャラクター、同じ背景、前のセクションの最終フレームが次のセクションの最初のフレーム)に70%依存し、残りの30%はレイアウトです。そのため、このスキルは素材の企画とチェックに大部分の時間を割いています。コードは template/ に既に書かれており、通常は site.config.js と少量のCSSのみを変更します。

ディレクトリ構成

template/                 すぐに実行可能なテンプレート(プレースホルダー素材 assets/demo/ 付属)
  site.config.js          すべてのテキスト、素材パス、パラメータ
  js/  css/               エンジンとスタイル、通常は変更不要
  tools/calibrate.html    視線追従キーフレーム調整ツール
scripts/frames.py         動画/画像 → Web用フレームシーケンス(ffmpegが必要)
scripts/check-site.mjs    設定と素材が揃っているかチェック
scripts/fetch-reactbits.mjs   React Bits「Ripple Distortion」をサイトにダウンロード(マウス通過時の回転波状歪み。ライセンス上の理由でテンプレートには同梱せず)
scripts/cutout.py         単色背景のステッカー/小キャラクター → 透明背景webp(--split でステッカーコレクションを分割)
scripts/serve.py          ローカルプレビューサーバー(キャッシュなし、変更後リロードで最新版)
scripts/shoot.mjs         承認用スクリーンショット:ヘッドレスChrome + 実際のマウスイベント、セクションごとにスクリーンショット(デスクトップ/モバイル)
scripts/make-demo-assets.py  プレースホルダー素材の再生成(通常は使用しない)
references/
  01_計画.md              インタビューリスト、セクションとキャラクターの動線の決め方
  02_素材プロンプト.md    キャラクター、背景、視線追従、トランジション、作品画像のプロンプトテンプレートと承認手順(「最初のフレームしか送信できない」ツールの実際の使い方を含む)
  03_サイト構築と反復.md  設定項目の説明、よくある問題とその解決策、フィードバックの方法
  04_デプロイ.md          Netlify / Vercel / GitHub Pages / Cloudflare、および作品の追加方法
  05_オープンソースホームページデザイン参考.md  オープンソースまたは公開されている個人サイトから学ぶべき点(ユーザーが「もっと洗練されていない」と言ったら最初に読む)

ワークフロー

各ステップの終了時に、実際の結果(スクリーンショット、フレームコラージュ、またはローカルプレビュー)をユーザーに表示し、確認を得てから次のステップに進みます。ユーザーが技術に詳しくない場合は、設定を読ませるのではなく、画面を見せてください。

1. インタビューと計画 → references/01_計画.md を読む

まず、ホームページの所有者は誰か、どのようなコンテンツを掲載するか(職務経歴、作品、連絡先)、キャラクターはどこから来たか(本人の写真、既存IP、新しいデザイン)、どのようなスタイルが好みか(ユーザーに参考画像やWebサイトを1~2つ提示してもらう)、現在どのような画像生成/動画生成ツールを使用しているかを明確にします。次に、サイトディレクトリに plan.md を作成します。セクションの順序、各セクションのテキスト、各セクションにおけるキャラクターのポーズと位置、各トランジションでキャラクターが行うアクションを記述します。この「キャラクター動線」が、以降のすべての素材の基礎となります。ポーズと位置はレイアウトと連携する必要があります(テキストが左にある場合、キャラクターは右)。

2. 素材 → references/02_素材プロンプト.md を読む

順序が重要です。次のステップでは、前のステップの成果物を参照として使用します。

  1. キャラクター確定イラスト: 正面、全身または半身、表情がはっきりしている。既存IPがある場合は、識別可能な特徴(顔、髪型、特徴的なアクセサリー)を維持し、服装はテーマに合わせて変更可能。
  2. 背景ベース: キャラクターを含まない背景画像1枚。サイト全体で共有し、すべての動画の背景にもなります。これにより、クリップを切り替えても背景がちらつきません。
  3. 各セクションのポーズキーフレーム: 各セクションに1枚(キャラクター + 同じ背景 + 同じカメラアングル)。計画で定義されたポーズと位置に対応します。
  4. 視線追従ループ: 正面から始まり、8方向すべてを見渡してから正面に戻ります。動画ツールが最初と最後のフレームを送信できる場合は、セグメントごとに生成し、frames.py gaze-join で結合します。最初のフレームのみ送信できる場合(多くの画像生成動画ツールが該当)、「スター」方式を使用:8本すべてをファーストビューのキーフレームから開始し、それぞれ異なる方向を向き、1つの表情を作る短い動画を生成し、frames.py gaze-star で合成します(1本の長い動画で8方向を連続して生成すると、モデルがどんどんずれていきます)。
  5. トランジションクリップ: 隣接する2つのポーズキーフレームを最初と最後のフレームとして使用し、その間の動きを生成します。最初のフレームのみ送信できる場合は、チェーン方式で順次生成します(前のクリップの最終フレーム = 次のクリップの最初のフレーム)。クリップの最初のフレームにキャラクターの顔が見えない場合は、「逆再生法」を使用します(最初に終了ポーズの確定イラストを作成し、逆方向の動きを生成してから逆再生します)。そうしないと、終了時の顔がモデルによって変更されます。
  6. 作品カバー画像: ユーザーが既に持っている作品画像をそのまま使用します。横長の16:10が最適です。

ユーザーが画像の生成しかできず、動画の生成ができない場合でも、テンプレートは動作します。視線追従は9枚の画像(正面 + 8方向、クロスフェードで切り替え)を使用し、トランジションは2枚のポーズ画像を blend: true で使用します。具体的なコマンドと設定は 02 の「ルートC」を参照してください。効果は劣りますが、その違いをユーザーに正直に伝えてください。

素材が1つもない場合(ゼロアセット初版):まず、ユーザーがレイアウトとインタラクションを確認できるようにサイトを構築します。テンプレートをコピーし、ユーザーの情報に基づいて site.config.js のテキスト、色、作品を記入し、テンプレートのプレースホルダーキャラクターはそのまま保持します。このとき注意すべき点:

  • 吹き出しやテキストで、「私はキツネです」など、プレースホルダーキャラクターと合わない内容を言わない。まずは中立的な文章を使用します。
  • 納品時に最初に、「画面内のキャラクターはプレースホルダーです。あなたのキャラクターに変更するには、まず以下の画像/動画を生成する必要があります」と説明し、plan.md の素材リストを添付します。
  • check-site.mjs は、プレースホルダー素材がまだ使用されている場所を警告します。この警告をユーザーにそのまま伝えます。

現在の環境に画像生成/動画生成ツール(例:画像・動画生成MCP)がある場合は、それを使用して直接画像や動画を生成できます。ツールが最初のフレームのみ送信できる場合は、02 の「チェーン生成」に従って、1クリップずつ生成します。動画生成ツールがない場合は、ユーザーが即夢、可灵、Vidu、海螺などのプラットフォームで生成します。その場合は、完全なプロンプト、最初と最後のフレームとしてアップロードする画像、長さとアスペクト比を伝え、動画を受け取った後の確認方法を説明します。

各バッチの素材は、サイトに組み込む前に必ずチェックします。フレームを抽出して1枚の画像にコラージュし(ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg)、02 の承認チェックリストに従って項目ごとに確認します。問題がある場合は、問題を具体的に説明し(何秒目、何が変わったか、どのようになったか)、プロンプトを修正して再生成します。

3. サイト構築 → references/03_サイト構築と反復.md を読む

cp -r <skill>/template <サイトディレクトリ>          # まずテンプレートをコピー、元のテンプレートは変更しない
cd <サイトディレクトリ>
node <skill>/scripts/fetch-reactbits.mjs .                            # マウス通過時のキャラクター歪み、ダウンロード失敗時は自動的に liquid にフォールバック
python3 <skill>/scripts/frames.py extract トランジション1.mp4 assets/clips/t1     # トランジションごと
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze セグメント1.mp4 セグメント2.mp4 …   # 視線追従(最初と最後のフレームがセグメント化されている場合)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=左.mp4 UL=左上.mp4 …   # 視線追従(最初のフレームのみ送信可能な場合:スター方式)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000                                  # http://localhost:8000 を開く(キャッシュなし)

frames.py が出力する設定スニペットを site.config.js に記入し、テキスト、色(theme.bg にはスクリプトから報告される背景の4色を使用。ページと動画がシームレスに接続されます)、フォントを記入します。視線追従動画がセグメント結合されていない場合は、http://localhost:8000/tools/calibrate.html を使用してキーフレームと頭の位置を調整します。

theme と decor は参照画像から決定します。まず 03 の「参照画像からスタイルを導き出す」に従って、背景色、アクセントカラー、タイトルフォント、装飾言語、キャラクターの描き方を書き留め、次に設定を変更します。テンプレートのデフォルトは全編英語です(インターフェースの固定テキストは ui で変更)。日本語と英語の混在の場合、英語の大見出しフォントの後には必ず日本語フォントを指定します(例:"Permanent Marker", "ZCOOL QingKe HuangYou")。参照画像が他人の作品である場合、スタイルの方向性のみを借用し、キャラクター、名前、文章、レイアウトをそのままコピーしないでください。

4. 反復

ブラウザで最初から最後までスクロールし、03 のチェックリストに従って項目ごとに確認します。ファーストビューの視線追従が8方向すべてスムーズか、ファーストビューを離れるときに一旦正面に戻ってからトランジションするか、各トランジションの開始と終了にジャンプがないか、テキストや落書きがキャラクターの顔にかかっていないか、作品一覧の開閉、作品カルーセル、エンディングでキャラクターがパネルに隠れていないか、スマートフォン縦画面。

一度に1種類の問題のみを修正し、修正後にもう一度確認します。これにより、各変更の効果が明確になり、既に満足している部分を壊すことを防げます。03 にはよくある問題とその解決策が記載されています。

5. デプロイ → references/04_デプロイ.md を読む

デフォルトでは、Netlify Drop(フォルダをWebページにドラッグ&ドロップすると公開リンクが取得できます)をお勧めします。デプロイ前に、check-site.mjs を再度実行し、プレースホルダー素材や不足ファイルがないことを確認します。

納品時に明確に伝えること

  • サイトディレクトリの場所、ローカルプレビュー方法、テキストと作品の変更方法(site.config.js のどの部分を変更するか)。
  • どのチェックを実際に実施したか(どのブラウザ、どの画面サイズで確認したか。shoot.mjs のスクリーンショットは画面レイアウトが正しいことのみを証明し、アニメーションがスムーズかどうかは実際のブラウザで確認する必要があります)、どのチェックを実施していないか(例:実機でテストしていないなど)。
  • 素材のサイズとファーストビューの読み込み時間。大きすぎる場合は、圧縮方法を提示します。

関連スキル