yjz211/vivid-figures-skill

让 AI 用你的数据生成科研图表：108 个配方，鲜艳与稳重两种风格，多套配色，交付图片与源码。仅限个人非商业使用。

何であるか

Vivid Figures は Agent Skill です。データ駆動型のチャートテンプレートとカラーパレットのコレクションであり、AIアシスタントが科学的図を自動生成するのに使用できます。リポジトリには以下のものが含まれます：

143の完成済みチャート「レシピ」（例：リッジプロット、ヒートマップ、3Dグループ化棒グラフ、SHAP重要度可視化など）
7つのカラースキームパック（各パックに5〜8色）を1つのJSONファイルに格納
レシピを読み取り、ユーザーのCSV/Excel/JSONデータをロードし、適切なチャートタイプを選択し、図をレンダリングし、PNG、PDF、再現可能なソーススクリプトを出力するPythonコード

このスキルは Agent Skills のオープン仕様に従っており、ファイルを読み取り、Pythonを実行し、画像を表示できる任意のAIアシスタントプラットフォームに簡単に統合可能です。

対象ユーザー

論文、コンペティションレポート、モデリングノートブックを執筆する研究者。
データ（表、モデル出力、空間座標など）を持っているが、チャートタイプの選択や色の調整を手動で行いたくない人。
Agent Skills形式をサポートするAIアシスタント（例：Claudeベースのボット、OpenAI関数コールエージェント、またはカスタム「アシスタント・アズ・ア・サービス」ツール）。

動作方法（概要）

スキルのロード – アシスタントが vivid-figures-skill フォルダ全体をインポートします。

ユーザーのプロンプト – 何を望むかを指示します。例：

vivid-figures-skill で results.csv を読み込み、異なる手法のスコア分布を比較する。コバルトブルー・グリーンのカラーパレットを使用。

データ解析 – PythonヘルパーがCSV/Excelファイルを読み取り、カラムの意味を推論し、チャートテンプレートにマッチさせます。
テンプレート選択 – データの形状とユーザーの意図に基づき、143のレシピカードのうち1つを選択します（各カードにはマークダウン説明、プレビュー画像、完全なソースコードが含まれます）。
レンダリング – 関連するPythonスクリプトが実行され、即時プレビュー用のPNG、出版用のPDF、および後で編集可能な完全なソースコード（Matplotlib/Seaborn/Plotlyなど）が生成されます。
後処理 – アシスタントは、凡例、フォントサイズ、要素の位置などを指示に従って調整でき、元のカラーパレットとデザイン意図を保持します。

主な特徴

豊富なチャートレシピライブラリ – 基本的なプロット（散布図、バイオリンプロット、ヒストグラム）から高度な可視化（3Dグループ化棒グラフ、多Y軸勾配ヒストグラム、SHAP依存性・寄与マップ、リリーフ風相関ヒートマップ）までカバー。
7つのキュレートされたカラーパレット – 各パレットはJSONファイル。デフォルトは Olive-Apricot ですが、自然言語コマンドで簡単に選択可能。
オープンなAgent-Skillフォーマット – SKILL.md（YAML + マークダウン）にメタデータを含み、すべてのアセットは相対パスで参照されるため、異なるAIアシスタントホスト間でポータブルです。
出力の柔軟性 – 即時チェック用のPNG、LaTeX/Wordへの挿入用のPDF、および後で再現・カスタマイズ可能な正確なPythonソースコードを提供。
非営利・個人利用ライセンス – 学術的または個人プロジェクトでは無料ですが、書面による許可なしに商業的再配布は禁止されています。
自己検証機能 – 各テンプレートには「忠実度ポイント」が含まれており、アシスタントが（例：勾配を保持、レイヤー順序を維持）を検証できるため、デザインの過度な簡略化を防ぎます。

すぐに始める（クイックチェックリスト）

前提条件 – Python 3.10+、Git、Bash（WindowsではGit Bash）。オプション：ローカルでHTMLカタログを閲覧する場合、Node.js 22+が必要。
インストール – docs/INSTALL.md を参照（リポジトリをクローンし、pip install -r requirements.txt を実行）。
AIアシスタントにロード – アシスタントがAgent Skillsを期待するフォルダに配置するか、ホスト固有のインポートコマンドを使用。
プロンプトを実行 – READMEに示す通り、アシスタントにデータファイルから図を生成するように依頼。
結果の確認 – アシスタントが figures/ ディレクトリを作成し、PNG、PDF、Pythonスクリプトを含みます。

有用でない場合

143のテンプレートではカバーできない完全にカスタムの可視化が必要な場合、依然として自分でコードを書く必要があります。
このスキルはPythonを実行し、画像を表示できるAIアシスタントを想定しています。LLMを搭載しない単純なCLIツールでは、選択ロジックを制御できません。
商業利用は別途ライセンスなしには禁止されています。

まとめ

Vivid Figuresは、即時利用可能でAI駆動のチャート生成スキルであり、言語モデルが最小限のプロンプトで生データを出版品質の図に変換できるようにします。豊富な事前検証済みテンプレート、カラーパレット、再現可能なPythonパイプラインを、オープンなAgent Skills仕様にパッケージ化しています。