Communitygithub.com

スクロール・ナラティブ

ウェブサイト、ランディングページ、プロダクトページ、ポートフォリオ、ケーススタディなどで、情報をブロックとして並べるのではなく、ストーリーを語るためのスキル。スクロールに合わせて物語を展開する「スクローリーテリング」ページを構築します。

スクロール・ナラティブ とは?

このスキルは、静的でカタログ的なページを、スクロールによって展開される没入型のストーリー体験に変えます。訪問者はスクロールホイールを回すことで物語を歩んでいき、事実は単なる機能ブロックではなく、プロットに織り込まれます。このスキルは、ブランド、中小企業、旅行、サービス、SaaSなどの「動作の仕組み」セクションに適しており、ECサイトやダッシュボードには推奨されません(これらのサイトでは代わりに`web-motion`スキルを使用します)。 このスキルは、コードを書く前にまずストーリーを見つけることを重視します。ヒーロー、欲求、障害、転機、その後という5つの要素を定義し、時間軸、パス、ズーム、変容、カウントダウン、キャラクターといったナラティブデバイスから1つを選びます。次に、フック、セットアップ、ジャーニー、転機、プルーフ、解像度+CTAという標準的なアークに沿ったビートシートを作成します。 構築時には、`web-motion`アセットに含まれる`storymotion.css`と`storymotion.js`を利用し、ピン留めされたシーン(`--p`)、ステップキャプション、リビール、カウントアップ、チャプターラベル、ドラッグ可能なスクロールゲージ、ローダー、多言語対応、動作軽減設定などを活用します。各ビートは1つのアイデア、1つのビジュアル、1つのモーションに抑え、ページ全体は6~12ビューポート高に収めます。テキストはそれが説明する瞬間と同時に出現し、訪問者は常にチャプターラベルと進行ゲージで現在地を把握できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

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

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

ドキュメント

スクロール・ナラティブ は何をしますか?

すべてのサイトにストーリーが必要なわけではありません。 まず決めてください:フルナラティブ(ブランド、中小企業、旅行、場所、工芸、目に見える結果を伴うサービス)、単一のストーリーシーン(SaaS、アプリ:通常は「動作の仕組み」)、またはなし(ショップ、ドキュメント、ダッシュボード、フォーム:フィードバックのためだけのモーションは web-motion のみを使用)。部分的な場合は、その1シーンにのみこのスキルを適用します。

ナラティブサイトとは、訪問者がスクロールホイールで歩き進めるストーリーです。 事実は機能ブロックとして積み上げられるのではなく、プロットに織り込まれます。モーション(web-motion スキルを参照)は、そのストーリーの中で時間がどのように経過するかを表現します。

1. コードの前にストーリーを見つける

それぞれ1行で答えなさい:

  • ヒーロー — 私たちが追うもの(訪問者、製品、場所、料理、一日)。
  • 欲求 — 彼らが望むもの、または行く場所。
  • 障害 — 立ちはだかるもの(製品が解決する問題)。
  • 転機 — 物事が変わる瞬間(製品、頂上、最初の一口)。
  • その後 — 転機の後の世界、そして訪問者が今取るべき唯一の行動。

次に、スクロール全体を構造化するナラティブデバイスを1つ選びます:

デバイススクロールの意味適している用途
時間軸夜明け→夜、1920→現代、1日目→30日目レストラン、イベント、歴史、ルーティン
パスルートや地図に沿って移動旅行、物流、探検、不動産
ズーム都市→通り→部屋→詳細建築、製品、工芸
変容原材料→完成品、Before→Afterサービス、リノベーション、SaaS、フィットネス
カウントダウンローンチやクライマックスに向けてフェスティバル、ドロップ、ローンチ
キャラクター一人の人物の一日を追うアプリ、B2Cサービス

2. ビートシートを書く

構築前に beats.md として保存します。ビートごとに1行:

#ビート見出し(8語以内)本文(40語以内)織り込む事実ビジュアルモーションスクロール長

標準アーク(6~9ビート):

  1. フック — 最初の画面。3秒以内に:これが何か、重要な数字、主要なアクション。「他に何もないのに『下にスクロールして発見』」は禁止。
  2. セットアップ — 転機前の世界;ヒーローと欲求。
  3. ジャーニー(2~4ビート) — デバイスを通じて進歩;各ビートは1つの事実をプロットポイントとして伝える(「午前6時にはパンはすでに並んでいる — 140斤」)。
  4. 転機 — 最大のシーン:通常はピン留めされたステージ(200~300vh)をスクロールでスクラブ。
  5. プルーフ — 数字、顔、レビューを、ストーリーの結果として伝える。
  6. 解像度 + CTA — ストーリーが着地する場所、そして1つの明確なアクション。フックのアクションを繰り返す。

3. ペーシングのルール

  • ビートごとに1つのアイデア、1つのビジュアル、1つのモーション。
  • 密度の濃いものと疎なものを交互に:ピン留めシーンの後は、落ち着いたフルブリードの写真か1文だけ。
  • 1ページあたりのピン留めシーンは最大約3つ;各ピンはそのスクロール長に見合うだけの価値がなければならない。
  • ページ全体:デスクトップで6~12ビューポート高。それ以上長くするのは、各画面にまだ新しい情報がある場合のみ。
  • テキストはそれが説明する瞬間と同時に表示され、決して先に現れてはならない。
  • 訪問者は常に現在地を把握できる:チャプターラベル+進行ゲージ。
  • スクロール自体がストーリーを語る:ゲージはナラティブデバイスをメタファーとして使い(時、km、スケール、年、チャプター番号)、サイトのパレットとタイポグラフィを反映;チャプターはゲージ上にマークされ、ホバーで名前が表示される。

4. コンテンツとクラフト

  • 写真が主役:高解像度で、100%クロップでシャープ;レスポンシブ srcset。
  • 人間らしい平易な言葉で書く;「解き放つ」「高める」「シームレス」は禁止。
  • 数字はプロットポイントであり、統計グリッドではない — ただし、そのグリッドがクライマックスである場合を除く。
  • すべてのビートは、動作軽減設定とJS無効でも耐えられること:それでも良い長いページとして読めること。
  • モバイルはデスクトップを縮小したものではない:ピンは短く(150~200vh)、ステージは積み重ね、フォントサイズは大きめに。

5. 構築

  1. storymotion.css + storymotion.js(web-motion/assets/ 内;--p によるピン留めシーン、ステップキャプション、リビール、カウントアップ、チャプターラベル、ドラッグ可能なスクロールゲージ、ローダー、多言語対応、動作軽減)と web-motion/references/recipes.md のレシピをベースに構築する。
  2. 各ビートをセクションにマッピング;ピン留めビートは [data-step] キャプションを持つ .scene > .stage になり;カスタムフレームごとのロジックはシーンの progress イベントをリッスンする。
  3. web-motion に従ってモーションを追加;375pxと1440pxで、動作軽減設定のオン・オフ両方で検証する。

完了前のチェックリスト:

  • フックが3秒テストに合格している。
  • 各ビートに役割と事実が1つずつある。
  • JSを無効にしてもストーリーが順番通り読める。
  • チャプターラベルとゲージがビートシートと一致している。
  • 最後のCTAがフックのアクションを繰り返している。

関連スキル