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つのシーンを実際に描き出して確かめた。

stick-scene の review シーンを編集部がコンタクトシートに描き出したもの。棒人間が diff のボード(store.ts、+1 −1)の1行に黄色い付箋を貼り、机の前のロボットのエージェントがそれを直し、最後にその行が緑になってチェックが付き『fixed, see reply』の吹き出しが出る、という8コマ

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枚ずつ描いて検証する

  1. 01

    プロダクトを理解

    README やランディングページを読み、「何をして何が得られるか」を1行にする

  2. 02

    比喩を2〜3案 出す

    レバー・スタンプ・ベルトコンベアなど、物理的で一目で分かる案。人が選ぶ

  3. 03

    シーンを書く

    テンプレートから、小道具・待機の動き・5〜8秒のアクションを座標とタイムラインで書く

  4. 04

    フレームで検証

    コンタクトシートと60fpsの動き検査で、見切れ・顔に被る小道具・腕の破綻を直す

    検証

  5. 05

    ページに埋め込む

    stick.js とシーンを置き、<stick-scene> タグを1つ足す

出典: stick-scene の SKILL.md(nilbuild/stick-scene)。検証は playwright でフレームを描き出して行う

スキルの導入は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. 1.play で再生のきっかけを指定

    view(画面に入ったら1回→以降クリック)、click、hover、loop、idle から選ぶ

  2. 2.省電力に配慮

    画面の外では描画しない。OSの「視差効果を減らす」設定では静止画1枚で再生しない

  3. 3.読み上げと色

    label でスクリーンリーダー向けの一文。STICK.theme や局所の色でブランド色に差し替え

出典: stick-scene の README・SKILL.md。フォントは Balsamiq Sans(no-font で読み込みを止められる)

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 のカードが出てくる。こちらも見切れや破綻はなかった。

stick-scene の yaml-sample シーンを編集部がコンタクトシートに描き出したもの。棒人間がjs-yamlと書かれたクランク式の機械にa: 1、b: - x のYAMLカードを入れ、ハンドルを回すと、上に中括弧で囲まれたJSONのカードが出てくる6コマ

コンタクトシートは止め絵なので、見切れ・顔に被る小道具・箱からはみ出た文字のような「位置の破綻」を見つける。動きの検査はそれでは分からない「動きの破綻」を担う。関節が飛ぶ、腕が顔を貫く、肘が後ろに折れる、足が滑る、アクションの始まりや終わりで姿勢がガクッと飛ぶ、といったものを 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(作者)