VisActor/skills

VisActor / skills – AIエージェント向けプラグイン「スキル」

概要 – 言語モデルベースのエージェント（Codex、Claude Code、またはツール対応の互換エージェントなど）が、生のデータファイルを視覚的な成果物に変換できるようにする3つのエージェントスキルのコレクションです：

スキル	機能	典型的な出力
vchart-skill	VChartチャートの生成、設定問題の診断、チャート画像の複製、すぐに使えるReactコンポーネントの提供。	ブラウザでインタラクティブなチャートをレンダリングするJavaScript/HTML。
vtable-skill	ソート可能なテーブル、ピボットテーブル、ピボットチャートの構築、インタラクティブな動作の追加、設定ミスの検出。	検索・ソート可能なテーブルまたはピボットチャート用のHTML/JS。
data-storytelling	データ分析の実行、ナラティブの設計、スクロールテリングページや「Web-PPT」プレゼンテーションの作成。	自己完結型のHTMLストーリーまたはブラウザベースのプレゼンテーション（`.pptx`ファイルは不要）。

これら3つのスキルは完全にローカルで動作します。必要なテンプレート、スクリプト、参照ファイルが同梱されています。個別のVisActorサーバー、APIキー、ホスト型サービスは不要です。ホストエージェントがLLMモデルとシェル/FSコマンドの実行機能を提供します。

プロジェクトへのスキルの追加方法

# 必要なスキルを選択
npx skills add VisActor/skills --skill vchart-skill
npx skills add VisActor/skills --skill vtable-skill
npx skills add VisActor/skills --skill data-storytelling

インストーラーは Codex を使用しているか Claude Code を使用しているかを尋ね、スキルのディレクトリ（SKILL.md、テンプレート、Python/JSヘルパースクリプトを含む）をエージェントのスキルフォルダにコピーします。

前提条件

Node ≥ 14 および npm (npx skills CLI用)。
モデルを呼び出せるファイルシステム対応エージェント。
VChart/VTable用にPython 3.9+。data-storytelling用にPython 3.10+ および Node.js（Python部分は標準ライブラリのみを使用）。
インターネットアクセスが可能なモダンブラウザ – 生成されたページは、VChart/VTable、React、Monaco、VSeed、GSAPなどをパブリックな unpkg CDNから取得します。

スキルの使用方法

インストール後、エージェントにデータを使ってスキルを実行するように依頼するだけです。例：

「VChartを使って、このCSVの地域別・四半期別の売上を比較して。編集可能なソースとHTMLをちょうだい。」

「VTableを使って、このファイルの全行を使用したソート可能な詳細テーブルを作成して。」

「data-storytellingを使って、このCSVの継続率の変化を成長担当者に説明する共有可能なHTMLストーリーを作成して。」

エージェントは以下の処理を行います：

CSV（またはその他のサポートされているファイル）を読み込む。
適切なスキルスクリプトを呼び出し、チャート/テーブル/ストーリーを作成する。
生成されたソースコード（HTML/JS）を返し、可能な場合はレンダリングされたプレビューを表示する。

出力は実行可能なJavaScript/HTMLであり、ローカルで開くことができます。リポジトリでは、評価用ブラウザは信頼できないコードのためのサンドボックスではないことに注意してください。生成された成果物は実行前に確認する必要があります。

開発とテスト（コントリビューター向け）

メインの開発ブランチは develop です。
チェックアウトからのローカルインストールには npx skills add ./skills/<skill> を使用します。
テストはPython 3.12+で uv（高速なパッケージマネージャー）を使用して実行されます：
```
uv sync --locked
uv run pytest tests -q
uv run ruff check skills tests evals/scripts
```
ブラウザスモークテストのセットが evals/smoke/ にあります。これらは各スキルが期待通りの視覚的出力を生成することを確認します。
より詳細なデバッグには、オプションの model-API harness（OpenAI互換のChat Completion）を使用して、Codex/Claudeなしで固定ケースを実行できます。これはメンテナー向けであり、エンドユーザー向けではありません。また、APIコストが発生する可能性があります。

リリースモデル

3つのスキルすべてが単一のリポジトリバージョンを共有しています。Gitタグは、スキルの説明、参照ファイル、テンプレート、スクリプトを含む正式なリリースを示します。個々のライブラリ（例：VTable 1.26.8）は個別にバージョン管理され、スキルメタデータ内で参照されます。

ライセンス

MIT – スキルを自由に利用、変更、再配布できます。

まとめ

VisActor/skillsは、LLM駆動のエージェントにデータファイルをインタラクティブなチャート、テーブル、ナラティブなHTMLストーリーに変換する能力を与える、実用的でインストール可能なツールキットです。独自のバックエンドを必要とせず、データ可視化とストーリーテリング機能を組み込んだAIエージェントを構築する開発者を対象としています。