stick-scene — 製品説明の棒人間アニメーションを生成するエージェントスキル
nilbuild/stick-scene
★ 537 ・ JavaScript ・ MIT
概要
nilbuild/stick-scene は、AIエージェントに対して「プロダクトの機能を説明する棒人間(stick-figure)アニメーション」を描画・生成させるためのスキル(Agent Skill)です。
Webサイトやランディングページの開発において、自社ツールやサービスの仕組みをわかりやすく視覚化したい場面は多くあります。本ツールをエージェントに導入することで、エージェントがプロジェクトの文脈を読み取ってアイデアを提案し、フレーム単位で重なりや見切れを検証しながらアニメーションコードを出力してくれます。生成されるシーンは外部ライブラリに依存しない単一の `` 要素として動作するため、軽量なアニメーション演出を手軽に取り入れたい開発者に向いています。
主な特徴
- 依存関係のない単一のCanvas描画: 各アニメーションシーンは外部ライブラリを必要とせず、1つの `` 要素のみで完結して動作します。
- 自然言語プロンプトによる自動生成と提案: エージェントに表現したい内容を指示すると、プロジェクト内容を読み取り、複数のアイデア提案から描画コードの生成までを実行します。
- 自動レイアウトチェック: エージェントがフレームごとにレンダリングを行って要素同士の重なりや画面外への見切れがないかを確認してからページへ配置します。
- 自然言語による細かな微調整: 再生速度やループ設定、特定要素のタイミング、配色変更などを自然言語のフィードバックで修正できます。
- 多彩な再生トリガー: 画面内へのスクロール時(view)、クリック時(click)、ホバー時(hover)、常時ループ(loop)、待機(idle)といったトリガーを属性で指定可能です。
- パフォーマンスとアクセシビリティへの配慮: 画面外にあるシーンは描画を停止するほか、OSの「視覚効果を減らす(prefers-reduced-motion)」設定が有効な場合は静止フレームを表示して自動再生を抑制します。
使い方
READMEに記載されているスキルのインストールからWebページへの組み込みまでの手順は以下のとおりです。
1. スキルのインストール
エージェント環境にスキルを追加します。
npx skills add nilbuild/stick-scene
2. シーンの生成指示
エージェントに対して /stick-scene コマンドとともに表現したい内容を伝えます。
/stick-scene [what you want to show]
# プロンプト例
/stick-scene a scene for the hero of this landing page
/stick-scene show that our CLI turns a YAML file into JSON
/stick-scene one scene for each feature section on the homepage
/stick-scene show an agent fixing the comments I leave on a diff
エージェントはプロジェクトを読み込み、2〜3個のアイデアを提示します。選択したアイデアに基づいてシーンコードが作成され、フレーム単位の検証を経てページに追加されます。
3. 自然言語での修正
表示に問題がある場合や演出を変えたい場合は、気になる点をそのまま伝えて修正を依頼します。
- レイアウトの修正:
"the note covers his face","the bubble runs off the edge" - タイミングや動作の変更:
"make the robot think for a moment before it starts","slower","loop it","only play it on click" - スタイルや配色の調整:
"use our brand green","add a second agent in teal" - 演出の連動:
"light up the steps on the page as it plays"
4. サイトへの組み込み
生成されたシーンファイルとランタイムである runtime/stick.js をWebサイトの静的アセットフォルダに配置し、HTMLにカスタム要素を記述します。
<stick-scene scene="db-playground" play="view" style="height: 230px"></stick-scene>
<script src="/scenes/stick.js" defer></script>
<script src="/scenes/db-playground.js" defer></script>
技術的なポイント
READMEからは、ランタイムの実装とエージェント連携の設計に関して以下の点が確認できます。
Web ComponentsとCanvasによる軽量ランタイム
アニメーションの再生基盤は runtime/stick.js が担っており、というカスタム要素を利用して宣言的に配置できます。描画先は単一の で完結しており、重い外部アニメーションライブラリをロードする必要がありません。高さや幅のサイズ調整は通常のCSSで行えます。
`` の属性オプション
カスタム要素には、表示や挙動を制御するための属性が用意されています。
scene: シーンスクリプト側で登録された識別子(ID)を指定します。play: 再生トリガーを指定します。view(スクロール表示時に1度再生し、以降はクリックで再生)のほか、click、hover、loop、idleが選択できます。no-floor: 地面ラインの下にあるグレーの帯を削除します(白背景向け)。no-ground: 地面ラインそのものを非表示にします。zoom: 枠内での描画スケールを指定します(デフォルトは1)。label: スクリーンリーダー向けに読み上げるテキストを設定します(デフォルトはシーン自身の説明文)。
アイドル状態の演出と描画制御
シーンは静止している間も完全に停止するのではなく、呼吸するような微細な動作や周囲を見回すような待機アクション(idle)を自動で行う仕組みになっています。一方で、画面外にスクロールアウトした際には描画処理が停止されるため、不要なリソース消費が抑えられます。
注意点
- エージェント環境の依存: 本ツールは
npx skills addコマンドでエージェントに機能を追加して利用する形式を採っています。一般的なスタンドアロンのCLIやUIライブラリ単体ではなく、AIエージェントのスキル実行環境を前提としています。 - 動作要件: クライアント側で
および JavaScript(Web Components /)が実行できるWebブラウザ環境が必要です。 - ライセンス: 本リポジトリのライセンスは MIT License であり、Kamran Ahmed 氏によって公開されています。
まとめ
nilbuild/stick-scene は、プロダクトの動作や特徴を視覚的に伝える棒人間アニメーションをAIエージェントの対話を通じて作成・調整できるスキルです。単一のCanvasとカスタム要素によるシンプルな配信構成を持ち、スクロールに応じた再生やアクセシビリティへの配慮が標準で組み込まれています。自社サイトやドキュメントにちょっとした動きのあるビジュアルを追加したい場合に役立つツールです。





