stick-scene は、棒人間が小道具を動かしてプロダクトの働きを見せる「動く図解」を、AI エージェントに描かせるスキルだ。 driver.js や roadmap.sh で知られる Kamran Ahmed 氏が公開した(2026年11月、311スター・MIT。スター数は2026年11月18日時点)。Agent Skills の形式(SKILL.md)で配られ、README は「あなたのエージェントに描かせる」と書く。npx skills add で入れて /stick-scene のスラッシュコマンドで使うので、Claude Code がいちばん分かりやすいが、Claude Code 専用というわけではない。/stick-scene 見せたいこと と頼むと、エージェントが比喩を2〜3案出し、シーンのコードを書き、1フレームずつ描いて破綻がないかを確かめ、ページに埋め込む。できあがる表示部は canvas 1枚で、描画ライブラリへの依存はない(シーンを作るときの検証には Node.js と Playwright を使う)。編集部は、この「エージェントが描いて自分で検証する」流れが本当に成り立つのかを、2つのシーンを実際に描き出して確かめた。
30秒でわかる stick-scene
- ・何をする:プロダクトの働きを、棒人間が小道具を動かす動く図解にする。Claude Code 用のスキル
- ・作り:canvas 1枚・依存ライブラリなし。待機中は静かに呼吸し、スクロールやクリックで5〜8秒のアクションを1回再生
- ・AI の関わり:比喩の提案とシーンのコード生成をエージェントが行う。描けたかの検査は playwright で機械的に確かめる
- ・入れ方:
npx skills add nilbuild/stick-scene→/stick-scene …→ stick-scene タグを1つ足す
Claude Code のスキルの仕組みは Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き にまとめている。
stick-scene が作る「動く図解」とは
ランディングページの機能紹介に、文字や静止画の代わりに短いアニメを置きたい、という場面は多い。だが、そのためにアニメーションを1つ作るのは手間がかかる。stick-scene は、その1つを「棒人間が1つの仕事をして、プロダクトの働きを見せる」形に定型化し、作る手順をエージェントに任せる。
レバー、スタンプ、ベルトコンベアといった物理的な小道具を棒人間が操作し、最後に「チェックが付く」「スタンプが押される」「何かが立ち上がる」といった目に見える結果で終わる。キャプションが無くても一目で伝わることを狙う、と SKILL.md は書いている。作者によれば、この描き方は kamranahmed.info/story の約90本のシーンで使われてきた型だ(本数は作者の記述による)。
上のコマ割りは、編集部が実際に描き出した「コードレビュー」のシーンだ。棒人間が diff の1行に付箋を貼り、机のロボット(エージェント)がそれを直し、その行が緑に変わってチェックが付く。AI にコードを直させる流れを、言葉なしで見せている。
使い方:インストールから埋め込みまで
HOW IT WORKS/stick-scene を頼んでから、ページに載るまで
エージェントが比喩を提案し、1枚ずつ描いて検証する
-
01
プロダクトを理解
README やランディングページを読み、「何をして何が得られるか」を1行にする
-
02
比喩を2〜3案 出す
レバー・スタンプ・ベルトコンベアなど、物理的で一目で分かる案。人が選ぶ
-
03
シーンを書く
テンプレートから、小道具・待機の動き・5〜8秒のアクションを座標とタイムラインで書く
-
04
フレームで検証
コンタクトシートと60fpsの動き検査で、見切れ・顔に被る小道具・腕の破綻を直す
検証
-
05
ページに埋め込む
stick.js とシーンを置き、<stick-scene> タグを1つ足す
スキルの導入は1コマンドだ。Claude Code に /stick-scene と頼むと、SKILL.md の手順に沿ってエージェントが動く。
npx skills add nilbuild/stick-scene
そのうえで、見せたいことを頼む。エージェントはまず README やランディングページを読んで「利用者が何をして、何が得られるか」を1行にし、比喩を2〜3案出して選ばせる。
/stick-scene このランディングページのヒーロー用のシーン
/stick-scene CLI が YAML ファイルを JSON に変える様子を見せて
/stick-scene 私がdiffに残したコメントをエージェントが直す様子を見せて
できたシーンは、runtime/stick.js とシーンのファイルを静的フォルダに置き、タグを1つ足すだけで動く。
<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>
play で再生のきっかけを選ぶ。view(画面に入ったら1回、以降クリック)、click、hover、loop、idle だ。stick.js は各シーンのスクリプトより先に読み込む(シーンは読み込み時に window.RIG を参照するため)。
THE ELEMENTページに置く <stick-scene> タグの要点
1つのcanvas・依存なし。再生のきっかけを選べる
-
1.play で再生のきっかけを指定
view(画面に入ったら1回→以降クリック)、click、hover、loop、idle から選ぶ
-
2.省電力に配慮
画面の外では描画しない。OSの「視差効果を減らす」設定では静止画1枚で再生しない
-
3.読み上げと色
label でスクリーンリーダー向けの一文。STICK.theme や局所の色でブランド色に差し替え
stick-scene で作れるシーンの例
どんな比喩が向くかは、README とリファレンスの一覧が参考になる。プロダクトの「入力 → 処理 → 結果」を、物理的な動作に置き換えるのがコツだ。README に並ぶ例を整理すると、次のようになる。
| 見せたいこと | 比喩(棒人間がする動作) |
|---|---|
| データベースの操作 | レバーを引くとデータベースが立ち上がる |
| 形式の変換(YAML→JSON など) | クランクを回すと別の形で出てくる |
| CI / ワークフロー | コミットをワークフローに沿って押し流す |
| ログイン・セッション | 一度ログインすると、クッキーが扉を開ける |
| メール送信 | ボタンを押すと手紙が飛んでいく |
| モデルと effort の選択 | スポットライトでモデルを選び、つまみで effort を決める |
| コストのレポート | 請求書が印刷され、Slack に入る |
| キューの処理 | 課題が並び、エージェントが夜通し片付ける |
| コードレビュー | 行にコメントし、エージェントが直し、承認する |
アクションは「何かが立ち上がる」「スタンプが押される」「チェックが付く」といった、目に見える結果で終わるのがよい、と SKILL.md は書いている。逆に、写実的な UI の再現には向かない。そこは実画面の録画やスクリーンショットの出番だ。
stick-scene を実機で描いて検証した結果
stick-scene の肝は、「エージェントが描いて、自分で破綻を直す」検証の仕組みだ。編集部は、この環境にあらかじめ入っている Chromium(Playwright 1.63)を使い、付属の scripts/frames.mjs(指定した時刻のコマを1枚のシートに描き出す)と scripts/motion.mjs(60fps で動かして破綻を検出する)を動かした。
まず、コードレビューのシーン(この記事の冒頭のコマ割り)を描き出した。
node scripts/frames.mjs --scene diffity-review --src examples/diffity-review.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 sheet.png
node scripts/motion.mjs --scene diffity-review --src examples/diffity-review.js
8コマのシートは、付箋が顔に被らず、腕が体を貫かず、最後のコマが待機の姿勢に戻る、破綻のないものだった。動きの検査は motion is clean を返した。SKILL.md は、検査が見つける破綻として「関節が飛ぶ」「腕が顔を貫く」「小道具が頭に被る」「肘が後ろに折れる」などを挙げていて、これらを jump・arm-through-face・head-covered のように名前で指摘する。
次に、YAML を JSON に変える様子のシーンを描き出した。棒人間が「js-yaml」と書かれたクランク式の機械に YAML のカードを入れ、ハンドルを回すと、上に JSON のカードが出てくる。こちらも見切れや破綻はなかった。
コンタクトシートは止め絵なので、見切れ・顔に被る小道具・箱からはみ出た文字のような「位置の破綻」を見つける。動きの検査はそれでは分からない「動きの破綻」を担う。関節が飛ぶ、腕が顔を貫く、肘が後ろに折れる、足が滑る、アクションの始まりや終わりで姿勢がガクッと飛ぶ、といったものを 60fps で動かして検出し、名前を付けて指摘する。歩き出しや止まり際のわずかな滑りは許容する、という細かな判断も入っている。どんな破綻が起きやすいか、どう直すかは、付属の references/craft.md(API の早見表、ポーズ集、タイミングの作り方、比喩の一覧、過去にやった失敗)にまとまっている。
この2つは付属の examples/ のシーンだ。自分のプロダクト用に新しいシーンを AI に書かせた場合に、どのくらいの手戻りで破綻なく仕上がるかは、題材によって変わる。SKILL.md も「2〜3回の修正は普通」としている。検証の仕組みが付いているぶん、AI の出来を目で確かめながら詰められるのが、このスキルの要だ。
使う前に知っておきたいこと
読み込みは軽い。 編集部が測ると、ランタイムの stick.js は44KB(gzip で約14KB)、シーン1本は8KB前後だった。ページが読むのは、この stick.js 1本とシーンのファイルだけで、描画ライブラリは要らない。なお、画面上での CPU 使用率やモバイルでの実測は取っていないので、「軽い」はファイルの大きさの話だ。
見やすさ・省電力への配慮がある。 画面の外にあるシーンは描画せず、OS の「視差効果を減らす」を有効にしている人には静止画を1枚見せるだけで再生しない。読み上げ用に label で一文を付けられる。ページに複数のシーンを置くときは、角丸のカードに入れて地面の線を一本の舞台のように見せる、と SKILL.md は勧めている。
フォントは外部から読む。 既定では手書き風の Balsamiq Sans を Google Fonts から読み込む。サイトが Google にアクセスしない方針なら、no-font 属性で止めて、自前のフォントを使う。
色はブランドに合わせられる。 STICK.theme({ ... }) でページ全体の色を差し替えるか、シーンの中で局所的に色を指定する。レビューのシーンが使っている GitHub 風の赤・緑のように、1つのシーンだけ色を変えることもできる。
| 比べる点 | stick-scene | 既製のアニメ(Lottie 等) | GIF・動画 |
|---|---|---|---|
| 作り方 | AI に比喩から描かせる | デザイナーが作る/素材を買う | 録画・制作 |
| 依存 | なし(canvas 1枚) | ランタイムのライブラリ | なし(ファイル) |
| 対話 | クリック・ホバー・スクロールで再生 | 設定による | 基本は再生のみ |
| 中身の修正 | コードを直す/AI に頼む | 元データが要る | 作り直し |
| こんな人・場面 | 向くか |
|---|---|
| ランディングページの機能紹介に、軽い動く図解を足したい | 向く |
| 手書き風・棒人間のトーンがプロダクトに合う | 向く |
| 写実的な UI の再現や、実画面のデモが要る | 向かない(GIF・動画やスクショ) |
| ブランドのイラストの作風が厳密に決まっている | 要検討(作風は Kamran 氏の型に寄る) |
まとめ
stick-scene は、「動く図解を1つ作る」という手間のかかる作業を、比喩の提案からフレーム検証までエージェントに任せられるスキルだ。出来上がりは依存なしの canvas 1枚で軽く、省電力と読み上げにも配慮がある。編集部が付属のシーンを2つ描き出した範囲では、破綻なく描け、動きの検査も通った。自分のプロダクト用のシーンを AI に新しく書かせるときの手戻りの量は題材次第だが、検証の仕組みが付いているぶん、仕上がりを目で確かめながら進められる。
stick-scene は「棒人間が小道具を操作する」という1つの型に絞って質を上げている点が持ち味だ。Claude Code のスキルを自分で設計し、描いた結果を検証まで回す考え方は Claude Code 検証ループ|開発チームの verify skill と「3回で人へ」をフックで試す も参考になる。Claude Code のスキルそのものの作り方は Claude Skillsとは|「スキル=フォルダ」の仕組みと作り方・使い方を徹底解説 にまとめている。
参照ソース
・nilbuild/stick-scene(GitHub)
・stick-scene の SKILL.md
・Kamran Ahmed(作者)





