Communitygithub.com

スティックシーン

ランディングページやWebサイト向けに、製品の機能をアニメーションで表現する手描き風スティックフィギュアの小さなシーンを作成します。スティックフィギュアがレバーを引いたり、メモをピン留めしたり、スタンプを押したりする、インタラクティブなキャンバスウィジェットです。

スティックシーン とは?

このスキルは、ランディングページやWebサイトに組み込むための、手描き風スティックフィギュアアニメーションシーン(`<stick-scene>`カスタム要素)を作成します。シーンは、ユーザーの操作(クリック、ホバー、スクロールによる表示)に応じて、製品の機能を象徴する5〜8秒の短いアクションを再生し、その後はアイドル状態(呼吸、あごをかくなど)に戻ります。すべての描画は単一の`<canvas>`要素内で行われ、外部依存関係はありません。クラフトマニュアル(`references/craft.md`)が用意されており、APIリファレンス、ポーズ集、タイミングレシピ、プロップレシピ、メタファーカタログなどが含まれます。開発フローは、製品理解→メタファーの提案→シーン作成→コンタクトシートとモーションチェック→埋め込み、という手順で進みます。すでに約90の実績あるシーンパターンが存在し、新しい描画スタイルを発明する必要はありません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilbuild/stick-scene/tree/HEAD

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

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

ドキュメント

スティックシーン は何をしますか?

カムランのインク&バタースタイルのスティックフィギュアが、製品の機能を示す1つの仕事を行います。シーンはアイドル状態(呼吸、一瞥、あごをかく)になり、トリガーされると5〜8秒のアクションを1回再生し、その後元の状態に戻ります。これは、依存関係のない<stick-scene>要素内の1つの<canvas>です。

ここにあるものはすべて、kamranahmed.info/story の約90のシーンで実証済みです。これらのパターンを出発点としてください。新しい描画スタイルを発明しないでください。

ファイル

  • runtime/stick.js: ランタイム全体。リグ(フィギュア、ポーズ、イージング、ペン)、プロップキット、ステージ、<stick-scene>要素。そのままプロジェクトの静的フォルダにコピーします。
  • templates/scene.js: 新しいシーンの開始点。
  • templates/preview.html + scripts/frames.mjs: 選択した瞬間にシーンをフリーズして1枚のコンタクトシートにレンダリングし、エラーを報告します。
  • scripts/motion.mjs: シーンを60 fpsでステップ実行し、静止画では隠れるグリッチ(関節のスナップ、顔を通る腕、頭に重なるプロップ、逆向きまたは後ろに突き出た肘、押しつぶされた回転、滑る足、手が届かない、アクションの開始または終了時のポップ)を報告します。
  • references/craft.md: APIチートシート、ポーズクックブック、タイミングレシピ、プロップレシピ、メタファーカタログ、およびすでに犯した過ち。シーンを書く前に読んでください。
  • examples/: 実際のシーン。diffity-review.js(コメント→エージェントによる修正→承認、2人のフィギュア、ボードと机)が最もすっきりした完全な例です。scenes-p3.js と scenes-p4.js には約30個以上のシーンが含まれています。craft.md のメタファーカタログにどれがどれかが記載されています。

ワークフロー

  1. 製品を理解する。 ユーザーが何をするか、ユーザーが何を得るかをそれぞれ1行で説明します。ランディングページやREADMEがあればそれを読んでください。
  2. 2〜3のメタファーを提案し、ユーザーに選択してもらいます。ただし、ユーザーがそのまま進めるように指示した場合は除きます。各アイデアは1行で:プロップ、アクション、成果。良いメタファーは物理的(レバー、スタンプ、コンベヤ、ピンボード、フレームレール、クレートスタック)で、一目でキャプションなしで読み取れ、目に見える結果(チェックマーク、スタンプ、何かが浮き上がったり光ったり)で終わります。craft.md のカタログを参照してください。
  3. templates/scene.jsからシーンを書きます。 最初に固定ワールド座標でプロップをレイアウトし、次にアイドル、次にT秒にわたるタイムラインとしてアクションをレイアウトします。labelにはスクリーンリーダー用の平易な文章を指定します。
  4. コンタクトシートでチェックします。 すべてのシートを確認してから完了とします。
    # 一度だけ、スクラッチディレクトリで:  npm i [email protected]
    NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \
      --scene <id> --src path/to/scene.js \
      --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png
    
    <skill-dir> はこのSKILL.mdが配置されているフォルダです。その後PNGを読み取ります。idle:<sec>は静止ループをフリーズし、s:<sec>はアクションのある瞬間、u:<0..1>はその一部分です。@<n>を追加してn回目の再生をレンダリングします(s:2.4@1)。これにより、S.nによって変化するシーンのすべてのバリアントをチェックできます。次の条件を満たすまで修正と再レンダリングを繰り返します:端が切り取られていない、プロップが顔や説明対象を覆っていない、各ビートが単独で読み取れる、テキストがボックス内に上下の余裕を持って収まっている、手が持っているものの前にあり、持っているものが現実と同じように体に接触している(口元のマイク、手のひらの中のハンドル)、矢印は手描きの山形(塗りつぶされた三角形ではない)、最後のフレームがアイドルと一致している(ループバック時にポップが発生しない)。通常2〜3ラウンド必要です。 次に、コンタクトシートでは判断できないモーションをチェックします。
    NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src path/to/scene.js
    
    すべての jump(ポーズを切り替えるのではなくブレンドする)、arm-through-face、head-covered(顔に重なるプロップ、メモ、または吹き出し)、bent-back-elbow、elbow-out-back(しばらくの間保持された折れた腕)、squash、start-pop、end-pop を、「motion is clean」と表示されるまで修正します。歩行の最初または最後の短い skate は許容されます。
  5. 埋め込みます。 runtime/stick.js とシーンファイルをサイトの静的フォルダにコピーし、以下を追加します。
    <stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene>
    <script src="/scenes/stick.js" defer></script>
    <script src="/scenes/<id>.js" defer></script>
    
    Astroでは <script is:inline ... defer> を使用します。stick.js はすべてのシーンスクリプトより前にドキュメント順で配置する必要があります(deferredスクリプトは順番に実行され、シーンはロード時に window.RIG を読み取ります)。複数のシーンがあるランディングページでは、各シーンをフレーム(1pxの境界線、白い背景、かすかなドットグリッド(14pxで radial-gradient(#e6e6e6 1px, transparent 1.2px))、フロアバンドを保持(no-floor無し)を持つ角丸カード)内に配置し、地面の線が小さなステージのように端から端まで続くようにします。ページ上のすべてのシーンに同じフレームと全コンテンツ幅を指定します。その後、実際のページをヘッドレスブラウザで読み込み、要素をビューにスクロールし、約3秒待機して、デスクトップとスマートフォンの幅でスクリーンショットを撮影します。

要素

  • scene: SCENES['<id>'] として登録されたID。
  • play: view(半分表示されたときに1回再生され、その後クリックで再生。ランディングページのデフォルトとして最適)、click、hover(マウスが上にある間ループ、タッチではクリック)、loop(常時実行、控えめに使用)、idle(決して再生しない)。
  • no-floor: 地面の線の下の薄いグレーのバンドを削除します。白いページで使用します。no-ground: 線も削除します。
  • zoom: ボックス内の描画を拡大縮小します(デフォルト1)。
  • label または aria-label: シーンが示す内容。デフォルトはシーンの label。
  • no-font: Google FontsからBalsamiq Sansをロードしません(サイトが既にセルフホスティングしている場合、またはGoogleを呼び出してはいけない場合)。
  • CSSでサイズを指定します。描画は高さ(230pxがネイティブサイズ)とシーンのワールド単位の width にフィットし、中央に配置されます。
  • prefers-reduced-motion では1つの静止フレームを表示し、再生しません。画面外のシーンは描画されません。
  • STICK.theme({ butter: '#…', greenInk: '#…' }) はページ全体のパレットカラーを変更します。1つのシーンだけに必要な場合は、シーン内のローカルカラー定数(diffity-review.js のGitHubの追加/削除の緑色など)を優先します。

スタイルルール

  • インク #141414、白い紙の塗りつぶし、1つのバターまたはアクセントのハイライト、多くの空白。単語には8.5〜11pxのBalsamiq Sansを使用し、単語は少数に抑えます。
  • フィギュアが主役です。頭やアクティブな手をプロップの後ろに隠さないでください。最初にプロップを描き、次にフィギュア、次に持っているものや飛んでいるものを描きます。
  • 1シーン1アイデア。説明にキャプションが必要な場合、メタファーが間違っています。
  • 作業ではなく結果を示します。状態が変化し、しばらく保持されるもので終わります。
  • 描かれた動物や詳細なキャラクターよりも物理的なオブジェクトを優先します。2人目のフィギュア(ヘルパー)には、ink/far を介して単一の色を割り当てます。AIエージェントはロボットです:fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } }) は、丸い頭、暗いバイザーと光る目、耳ボルト、アンテナ球、胸部ライトを描画します。2人目のエージェントはティール(#3d7a8c、dark #2a5866、far #a9c9d1)にします。黒いエージェントも機能します:暗い col は自動的に白いバイザーとインク色の目を取得します。作業中は明るい glow、完了時は happy を設定し、各フィギュアの下の y = 16 に小さなラベル(you、agent、claude)を配置します。
  • エージェントは即座に反応すべきではありません。リクエストが到着した後、作業を開始する前に一拍置きます(thinking… ライン、hmm… バブル、手をあごに当てる、ゆっくりとしたアンテナの点滅)。
  • 他社のロゴは使用しないでください。プロップ上のプレーンテキストとしての製品名は問題ありません。

関連スキル