SpillWave Solutions の図表スキル：エージェントがテキスト説明やソースコードを Mermaid のフローチャート、シーケンス図、クラス図、ER 図、状態図、C4、アーキテクチャ図に変換したり、テンプレートに従って図付きのアーキテクチャ / API / 機能 / データベース設計ドキュメントを作成したりします。付属の Python スクリプトで Markdown 内の図を抽出し、mermaid-cli で検証して PNG / SVG に変換することも可能です。
skills.sh インストール数 87855（+977 / 24h）
セキュリティ監査：未監査
- スキャン未実施
理由
- 意図に応じて専門ガイド（アクティビティ図、デプロイ図、アーキテクチャ図、シーケンス図、Wiki）をロードし、Spring Boot、FastAPI、React、Python ETL、Node/Express、Java Web の 6 種類のコードから図への変換例を提供
- 図が検証を通過してから Markdown に書き込むことを規定。ファイルは ./diagrams/ に統一保存し、「ドキュメント名_番号_タイプ_タイトル」で命名。失敗時は付属のトラブルシューティングガイドを参照
- 対象プラットフォームを明確化：GitHub wiki は mermaid コードブロックを使用し、Confluence、Notion、Word、PDF には別途 PNG または SVG を出力。PlantUML は Mermaid でサポートされていない数種類の図のみに使用
- README によると、Python スクリプトは標準ライブラリのみを使用し、MIT ライセンス。skills.sh では 24 時間でインストール数 977、累計 87855、直近 8 週間の週間インストール数は 4007 から 6318 へ増加（注目度のみを示す）
使い方
- インストールコマンドは監査通過後に表示。図を描くよう指示する際（例：「シーケンス図を描いて」「このコードをアーキテクチャ図に変換して」「API 設計ドキュメントを書いて」）にトリガー
- Mermaid コードの生成のみなら追加ツールは不要。検証と画像出力には npm install -g @mermaid-js/mermaid-cli と Python 3.7 以上が必要。アカウントは不要
リスク
- 本号では未監査のため、固定で C 評価とし、インストールコマンドは非表示。SKILL.md はエージェントに付属の Python スクリプトと mmdc を実行させ、現在のディレクトリに diagrams/ を作成してファイルを書き込むことを許可しており、用途とは整合するが、スクリプトはスキャンされていない。検証失敗時は perplexity、brave 検索 MCP、gemini スキル、Web 検索を順次呼び出して解決策を探すため、図表コードが外部サービスに送信される可能性がある。skills.sh 上では Gen Agent Trust Hub と Socket の監査結果は Pass、Snyk は Warn
- すべての図に Unicode 絵文字を追加し、指定の高コントラスト配色を使用するよう要求しており、プロジェクトのドキュメントスタイルに合わない可能性がある。SKILL.md は約 2.3 万バイトあり、ロード時にコンテキストを消費する
- 直近 8 週間のインストール曲線は、本号の fastify-best-practices、nx-workspace とほぼ同期している（fastify-best-practices、nx-workspace、design-doc-mermaid の 1 日あたりのインストール数はそれぞれ 986、971、977）。同じコレクションとして一括インストールされた可能性があり、インストール数を独立した注目度として扱うべきではない