Communitygithub.com

ビジュアルストーリー

複雑な事柄を人に見せるためのビジュアルストーリーテリング:大きなキャンバス上にカメラ、シーン、キャプションを備えたモーション説明動画、プロセスやシステムのインタラクティブマップ、マイクロアニメーションとトランジションを備えたピッチデッキと静的PDF、そのスマートフォン版、フレーム単位のMP4エクスポート、サブドメインとQRコードによる公開。

ビジュアルストーリー とは?

このスキルは、複雑な概念やシステムを視覚的に伝えるための包括的なツールです。モーション説明動画、インタラクティブマップ、アニメーション付きピッチデッキなど、ユーザーの要求に応じて適切な形式を選択し、構築します。主な特徴は、「シーン、カメラ、キャプション」を備えた一枚の大きなキャンバス上でのストーリーテリング、マイクロアニメーションとトランジション、フレーム単位のMP4エクスポート、レスポンシブ対応、サブドメインとQRコードによる公開です。ワークフローは、目標の確認、スクリプト作成、パイロット制作、2〜3シーンごとのバッチ作業、全体の組み立てという段階を踏み、ユーザーの「はい」を待ちながら進めます。コード生成時に参照するべき複数の「Runbook」(例:motion-film.md、scheme.md、deck.md、video-export.md、responsive.md、publish.md、qa.md、taste.md、examples.md)がSkill.md内で指定されており、開発者はこれらを開いてから作業を開始します。共通のミスとして、全量を作ってから見せる、要素を小さくしすぎる、不要なテキストや装飾を追加する、適切なサイズでのフレーム確認を怠る、などが挙げられています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

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

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

ドキュメント

ビジュアルストーリー は何をしますか?

複雑な事柄を画像として見せる:シーンごとに、大きく、説明するための動き(飾りではなく)。キャプションは何が起きているかを説明し、キャンバスはそれを示す。作業の各バッチは、ユーザーにフレームを見せ、その「はい」を得て終了する。

何を作るか → どのRunbookを開くか

タスクRunbook
説明動画:一つのキャンバス上のシーン、カメラ、キャプション、「全体図」マップreferences/motion-film.md
プロセスやシステムのインタラクティブマップ(ノード間ジャンプ付き)references/scheme.md
マイクロアニメーション、トランジション、PDF付きピッチデッキreferences/deck.md
シーンやカメラのない通常のカンファレンストーク通常のスライドデッキワークフローを使用;deck.mdの可読性ルールを流用
フィルムやマップをMP4にエクスポートreferences/video-export.md
スマートフォン・タブレット版references/responsive.md
公開、サブドメイン、パスワード、QRreferences/publish.md
目視確認:URLによるフレーム、コンタクトシート、チェックリストreferences/qa.md
テイストルール:色、タイポグラフィ、動き、密度references/taste.md
スケルトンをコピーするためのリファレンス作品references/examples.md

最初のコード行の前に taste.md、examples.md、および該当するRunbookを開く。最初の表示の前に qa.md を開く。

フィルムかマップか? フィルムは時間と共に展開されるストーリーであり、プレゼンターが視聴者をシーンごとに導く。マップは視聴者が自分で探索する一枚の大きな絵である。「ウェビナー用にプロセスをアニメーション化」はフィルム、「見回すためのシステムマップ」はマップ。不明な場合は、1つの質問をする。

すべての種類における作業の順序

  1. ユーザーの言葉での目標、次に質問。 一度にまとめて質問し、推奨オプションを最初に、まだ答えが出ていないものだけにする:どのリファレンス(「前回と同じ」)、どのように表示するか(プレゼンタークリック/自動再生/ビデオ/PDF)、スタイル(製品のWebサイト)、言語、データ(架空かユーザーのソースか)、期限、画面。
  2. 表形式のスクリプト — シーンまたはスライド:番号、タイトル、一言の意味。「はい」を待つ。
  3. パイロット。 1シーンまたは1〜2スライドを完全に仕上げる:画像、動き、キャプション。フレーム→表示→「はい」を待つ。なぜか:パイロットで確立されたスタイルはすべてに引き継がれる;シーン12でスタイルが決まると、12シーンをやり直すことになる。
  4. 2〜3シーンまたはスライドのバッチ;各バッチを表示して待つ。
  5. 全体を組み立てる: ナビゲーション、全体図マップまたは概要、スマートフォンレイアウト、公開、QR、PDFまたはビデオ — 注文されたものすべて。

期限が1日未満の場合: パイロット1つと「はい」1回、残りは1バッチで;表示されるサイズ(放送画面、および視聴者がリンクを受け取る場合はスマートフォン)でのみフレームを確認する。

「完了」と言う前に

  • qa.mdから表示サイズでのフレームを取得しレビュー;不具合は1バッチで修正。
  • 公開が注文された場合:ライブアドレスが新しいバージョン(?v=NN)を提供し、zbarimgがQRを読み取ること。
  • PDFまたはビデオが注文された場合:ファイルを開き、ページごとまたはフレームごとにレビュー。
  • ユーザーが結果を見て回答したこと。
  • 自身のスクリーンショット、ブラウザセッション、サーバープロセスをクリーンアップする(pidでサーバーを停止)。

よくある間違い

  • すべてを作り込んで最後に見せる → ユーザーがスタイルを変更し、すべてを作り直すことになる。バッチで作業する。
  • 小さく作りすぎる:キャンバス上に10個の小さなラベルではなく、1つの大きなアイデア。画像は大きく、コードは小さく。
  • テキストでごまかす:QRの下に「スマートフォンでスキャン」、「まだ成長中」、「できます…」、ジェスチャーヒント。言葉がなくても明確なものは、言葉なしのままにする。
  • 装飾:カードの端に色付きアクセントストライプ、点滅、「ただきれい」。動きはトランジションを説明するか、存在しない。
  • 名詞と瞬間のない数字(「8枚のカード」)→ 視聴者は何を見ているのかわからない。
  • 適切なサイズのフレームなしで「コードを読んで」確認する → スマートフォンではすべてが崩れる。

関連スキル