line-art-animation — 手描きインク風SVGアニメを動かすTSライブラリとClaudeスキル
JDhruv14/line-art-animation
★ 837 ・ TypeScript ・ MIT
概要
line-art-animation は、紙の上にペンとインクで描かれたような質感のアニメーションを SVG で動的に描画・制御するための TypeScript ライブラリであり、同時に AI アシスタント「Claude」と連携してアニメーションコンポーネントを設計・生成するための Claude スキル(Claude Skill)でもあります。
描画されるオブジェクトはすべて SVG のベクターデータとしてリアルタイムにレンダリングされるため、どのような解像度や画面サイズでも輪郭がぼやけることなく鮮明に表示されます。また、ポインター操作やクリックなどのユーザー入力に反応するインタラクティブなコンポーネントとしても機能します。
Web サイト上で個性的な手描き風ベクターアニメーションを実装したいフロントエンド開発者はもちろん、Claude Code などのエージェント環境を活用して、自然言語の指示から動的な SVG コンポーネントを対話的に構築・調整したい開発者に向いています。
主な特徴
- 手描きインク画の質感を再現するベクター描画: 関節をつなぐ曲線の両側に2本のオープンストロークを配置する独自のアプローチなどにより、ベクターグラフィックスでありながらアナログのペン画のような質感を再現します。
- 歩行・走行を数理的に解くキネマティクスソルバー: 事前作成されたスプライトや静的キーフレームに頼るのではなく、接地足の滑りや遊脚の最小ジャーク軌道、歩幅に応じた腰の上下動などをプログラムがリアルタイムに計算して自然な歩容(Gait)を生成します。
- 時間帯に応じた昼夜サイクルとカラーパレット: 1日の時間の経過(パラメーター τ)に応じて空、紙、インクの色を滑らかに切り替えるパレット制御機能を持ち、夜間には紙が藍色に沈み、窓や灯籠の明かりが灯るような演出が可能です。
- 外部依存関係のない(dependency-free)コア設計: 主要な処理を担うモジュール群は外部の npm パッケージに依存せず、軽量かつ独立した TypeScript コードとして完結しています。
- Claude Code 向けスキルの同梱: プロジェクト内にスキル定義ファイルを取り込むことで、Claude に対して「夜明けのパン屋のアニメーションを作って」「この動画の歩行モーションを再現して」といった指示を出し、段階的なレビューを経ながらコードを自動生成させることができます。
- 決定論的なフレームキャプチャと動画出力: ブラウザのレンダリング速度に左右されず、1コマずつ正確に進めてスクリーンショットを取得するスクリプトが用意されており、高品質な MP4 動画として書き出すことができます。
使い方
1. Claude スキルとしての利用
Claude Code を利用している環境では、スキルディレクトリにリポジトリをクローンすることで導入できます。
git clone https://github.com/JDhruv14/line-art-animation ~/.claude/skills/line-art-animation
プロジェクト単位で導入したい場合は、対象プロジェクトの .claude/skills/ 内にクローンします。導入後は Claude に対し、以下のように自然言語でアニメーションの作成や動画のトレースを依頼できるようになります。
- 「夜明けのパン屋のラインアートアニメーションを作って。パン職人がトレイを運び、オーブンから湯気が立ち、窓辺に猫がいる情景で」
- 「添付した動画の歩行リズムに完全に一致するループラインアートコンポーネントを作って」
- 「シーンに昼夜サイクルを追加して、30秒の 1080p 動画としてレンダリングして」
Claude はリポジトリ内の SKILL.md を読み込み、必要なモジュールをプロジェクトにコピーしたうえで、フィギュアの承認やコマごとの動作確認を挟みながら制作を進めます。
2. サンプルプロジェクトの実行
本リポジトリには、単体の歩行キャラクター(examples/walker/)と、町家や運河、時間帯の推移を再現した大規模な村の情景(examples/village/)の2つのサンプルが含まれています。実行には Node.js 22.18 以上が必要です。
npm install
npm run dev # http://localhost:5173 で開発サーバーが起動
村のサンプルでは、太陽や月をドラッグして時刻を変更したり、ポインターを動かして風を起こしたり、街を行き交う人々や猫、提灯などをクリックして反応を楽しむことができます。URL クエリパラメータによる制御にも対応しています。
?start=0.9: 開始時刻の設定(0 が深夜、0.5 が正午)?tau=0.5: 時刻を固定?day=30: 1日の周期を30秒に設定?debug: 手動で時間を1ステップずつ進めるデバッグモード
型の検証やビルドは以下のコマンドで実行できます。
npm run typecheck # lib/ と walker の厳格な型チェック
npm run build
3. ライブラリを用いたコード例
以下は、画面上を横切る歩行脚を描画する最小構成のコードです。
import { el, limb, shoe, place, inkDefs, run } from './lib/ink.ts';
import { gait } from './lib/gait.ts';
const svg = el('svg', { viewBox: '0 0 480 240' });
document.body.append(svg);
const fig = el('g', { filter: inkDefs(svg).filter }, svg);
const legs = [limb(fig, 4.2), limb(fig, 4.2)];
const shoes = [el('path', {}, fig), el('path', {}, fig)];
const walk = gait({ kind: 'walk' });
let phase = 0, x = 60;
run((t, dt) => {
phase += dt / walk.period;
x += walk.speed * 1.25 * dt; // 歩行速度に合わせて移動し、足の接地を保つ
place(fig, x % 520 - 20, 196, 1, 1.25);
const p = walk.pose(phase);
p.feet.forEach((foot, i) => {
legs[i].draw([p.hip, foot.knee, foot.ankle]);
shoe(shoes[i], foot.ankle, foot.pitch);
});
});
4. 動画レンダリング
ヘッドレス Chrome と ffmpeg を組み合わせて、シーンを連番静止画としてキャプチャし、MP4 形式の動画を生成できます。
npm run dev
node scripts/capture.ts "http://localhost:5173/examples/village/?debug&capture&day=30&start=0.3" \
captures/village 900 30 1920 1080
ffmpeg -framerate 30 -i captures/village/f%04d.png -c:v libx264 -preset slow -crf 15 \
-pix_fmt yuv420p -movflags +faststart -tune animation village.mp4
技術的なポイント
- 依存関係ゼロで構成された 4 つのコアモジュール:
ink.ts: SVG 要素の生成、手描き風フィルターの定義、手足を描画するlimb()などの描画プリミティブを提供します。gait.ts: 足の接地・離地や遊脚の移動経路、歩行に伴う腰の上下動を解析的に導出する歩行ソルバーです。motion.ts: バネ(スプリング)、振り子、風のシミュレーションなどの物理的挙動を扱います。daynight.ts: 1日の時間軸に応じたカラーパレットの計算と適用を担当します。
- 運動学(Kinematics)に基づく歩行計算:
gait()は事前にアニメーションキーフレームを用意するのではなく、足が地面についている間は進行速度に合わせて足を後方に滑らせ、浮いている足は最小ジャーク(minimum-jerk)軌道で前方に運びます。足が届く範囲に基づいて腰の高さが決まるため、歩幅に応じて胴体が自然に浮き沈みし、着物やコートの裾などの衣服も膝や足首の動きに連動して開閉します。 - CSS クラスと currentColor によるパレット切り替え: インク描画に
currentColorを採用し、紙の塗りつぶし部分にはppクラスを付与しています。applyPalette()を実行するだけで、SVG 全体のスタイルが再計算され、昼間の白い紙と黒いインクの表現から、夜間の藍色の紙と淡いインク、温かく灯る窓の表現へと滑らかに切り替わります。 - DevTools Protocol を直接操作するフレームキャプチャ: 動画キャプチャスクリプト(
scripts/capture.ts)は、サードパーティのブラウザ自動化ライブラリを挟まず、Node.js から直接 Chrome DevTools Protocol を操作してヘッドレス Chrome を駆動します。アニメーション時間を1フレームずつ厳密に進めてスクリーンショットを撮影するため、マシンスペックによるフレーム落ちや処理遅延の影響を受けずに動画を生成できます。
注意点
- 実行環境: 開発サーバーやスクリプトの実行には Node.js 22.18 以降が必要です。
- 外部ツールの依存(動画生成時): 連番画像から MP4 動画を作成するには
ffmpegが必要です。また、フレームキャプチャ時にはローカルにインストールされた Google Chrome または Chromium(環境変数$CHROMEで指定可能)が呼び出されます。 - プロジェクトの形態: 単体の npm パッケージとしてレジストリからインストールして利用する形式ではなく、TypeScript ソースコード(
lib/)をプロジェクト内に直接取り込んで使用するか、Claude スキルとして連携させる構成をとっています。 - ライセンス: 本リポジトリは MIT ライセンスで公開されています。
まとめ
line-art-animation は、数理的な運動計算と緻密な SVG 描画を組み合わせ、手描きインク画の温かみとベクターグラフィックスの柔軟性を両立させたユニークなライブラリです。Claude Code などの LLM エージェントと連携するスキルとしても設計されており、インタラクティブな Web 表現やアニメーション動画の制作において新しいアプローチを提供しています。





