Communitygithub.com

yeevclaw/animated-flow-diagram

あらゆるプロセス、ワークフロー、パイプライン、意思決定ループ、またはシステムを、そのトピック専用にデザインされたアニメーションフローチャート説明動画に変換します。

animated-flow-diagram とは?

このスキルは、任意のプロセス(ワークフロー、パイプライン、意思決定ループ、システムなど)を、20~30秒のアニメーションフローチャート説明動画に変換します。最大の特徴は、トピックごとに専用のデザインを生成する点で、レイアウト、ノード形状、コネクタ、色、モーションが異なり、単なるテンプレートの使い回しではありません。デフォルトはプロフェッショナルで技術的なルック(コンソール、アーキテクチャ図、ダッシュボード風)ですが、カジュアルなトピックでは温かみのあるイラスト風にも対応します。ユーザーが「フローチャートをアニメーション化」「動画/GIFにして」「あの図解動画のように説明して」「流程圖/動畫にして」と要望した場合や、エージェント/AIパイプライン、承認フロー、データパイプライン、銀行/ITワークフロー、オンボーディング、インシデントプロセスなどの可視化に最適です。内部では、まずプロセスをモデル化し(ワーク、ボトルネック、チェック、回答者、ストア、アクターを分類)、次にデザインブリーフを記述、そしてレイアウトと衝突チェックを行い、最後にMotionツールまたはスタンドアローンビルドスクリプトでHTML動画プレーヤーを生成します。速度制御、データの往復(質問→回答者→回答)、ループバック、リアルタイムの読み出し表示など、アニメーション文法は統一されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yeevclaw/animated-flow-diagram/tree/HEAD/skills/animated-flow-diagram

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

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

ドキュメント

アニメーションフローチャート図

プロセスを20~30秒のアニメーション説明動画にします。以下の2点が最も重要です(順序通り)。

  1. トピックごとに独自のデザインを持つこと。 レイアウト、ノード形状、コネクター、「回答者」、読み出し、パレット、モーションは対象に合わせて選択します。2つの動画が、単にラベルを変えただけの同じテンプレートに見えてはいけません(ユーザーは「每一份流程看起來都會一模一樣」と明確に拒否しました)。作成前に、1段落のデザインブリーフを書き、この会話内の以前の動画(およびここにある2つの例)と照合し、references/design-directions.md のバリエーション軸のうち少なくとも4つを変更してください。
  2. デフォルトでプロフェッショナルかつ技術的に。 基本のトーンは、洗練された技術/製品ルック(コンソール、アーキテクチャ図、ダッシュボード、設計図、クリーンな製品UI)です。温かみのある、イラスト風、遊び心のあるルックは、トピックが明らかにカジュアルな場合(レシピ、家族計画)またはユーザーが明示的に求めた場合のみ使用します。

動画間で一定なのはアニメーション文法であり、見た目ではありません。速度制御(素早いホップ、遅いボトルネック、最初のチェックより速い後のチェック)、データの往復(質問→回答者が処理→回答)、1つのループバック、どこかに何かが可視で書き込まれること、そして最後に要約行を表示して保持すること。紙のページや図の下に本文段落はありません。

ワークフロー

1. プロセスをモデル化する(黙って行う;本当に不足しているものだけ質問する)

各ステップを分類します。ワーク(誰か/何かがタスクを実行;滞留時間 ∝ 実際の労力)、ボトルネック(最も遅いワーク)、チェック(スコア/はい-いいえ/1つ選択など、小さな回答空間)、回答者(チェックを決定する者:ルールエンジン、ポリシーファイル、レビューアー、モデル、シェフ)、ストア(結果が書き込まれる場所)、アクター(各ステップを実行する者)。1つのループバックと終了状態を見つけます。ユーザー自身の用語を使用します。ユーザーから与えられていない数値は画面上で「示意 / illustrative」とラベル付けし、実際の数値(しきい値、カウント、終了コード)は最良の読み出し値として使用します。

2. デザインブリーフを書く

references/design-directions.md を読んでください。トピックと対象読者に合った方向性を選び、以下の各軸を決定します。レイアウト文法、ステーション形状、コネクタースタイル、回答者の見た目と発光方法、パケット/トークンの形状、読み出しパネル、パレット(4色)、タイプ、背景処理、モーションの特徴。ブリーフをチャットで一文で伝えます(「主控台風:深藍格線、直角匯流排、右側規則面板…」) — 承認を待たずに進みます。

3. レイアウトと衝突チェック

references/design-rules.md(幾何学、衝突チェック、タイミング、ラウンドトリップフェーズ、読み出し)を使用します。デフォルトは16:9 1920×1080 @ 30 fps、ユーザーがReels/Shortsを希望する場合は9:16。

4. 構築

ArtifactツールがMotion(アニメーション/ビデオ)タイプをリストする場合 — 推奨(再生、スクラブ、MP4/GIFエクスポート可能):そのタイプの指示に従い、ファイルと書き込み順序を守ります。1つの連続シーン。モデル、ルート、マークアップを shared.js に、モーションを scene-<id>.js に、ルートを反映したスコアを score.js に記述します。完成した2つの動画が references/ にあります — メカニズム(ルートタイムライン、posAt、ポリライン/ベジェヘルパー、パケットトレイル、ターミナルスクロール、メーター)を借用しますが、その構成やパレットは借用しません。

画面上のテキストはリテラル文字(\uXXXX エスケープではなく)として記述し、ユーザーがプレイヤーでラベルを再入力できるようにします。

それ以外の場合、同じファイルをフォルダに書き込み、python scripts/build_player.py <folder> <out.html> --title "<title>" を実行して、再生/一時停止/スクラブ機能を持つ1つの自己完結型HTMLページを生成します。公開またはプレゼンテーションします。Nodeが利用可能な場合は、jsdomでスモークテストを行います(references/example-kitchen/README.md を参照)。

5. 納品

リンク + サウンドに関する一文(ミュートで開始)+ エクスポート:MotionのエクスポートはMP4またはGIFを保存します(GIFは無音で1080pではサイズが大きいため、短いカットを提案します)。ソースに記述されていないメカニズム(例:リトライループ)を示すビートを考案した場合は、その旨を一文で伝え、削除提案を行います。

ファイル

  • references/design-directions.md — 方向性、バリエーション軸、パレット、「繰り返し禁止」チェック。最初に読むこと。
  • references/design-rules.md — 幾何学、衝突チェック、振り付け/タイミング、ラウンドトリップ、読み出し。
  • references/example-ops-console/ — 技術方向:ダークコンソール、サービスカード+六角形ゲート、直交バス、ストレージシリンダー、ポリシーパネル(ルール行)、ターミナルログ、しきい値メーター(ナレッジベースパイプライン)。
  • references/example-kitchen/ — カジュアル方向:温かみのある紙、ジグザグレーン、ハブリングライト(レシピ)。そのREADMEは各ファイルの変更箇所とスモークテストを説明しています。
  • assets/player.html、scripts/build_player.py — スタンドアローンフォールバックプレイヤー。

関連スキル