diagram-design — AIエージェントに美しいHTML+SVG図を出力させるAgent Skill
cathrynlavery/diagram-design
★ 68,685 ・ HTML ・ MIT
概要
diagram-design は、Claude Code、Cursor、GitHub Copilot、Codex などの各種 AI コーディングエージェントに高品質な作図能力を追加する Agent Skill です。自然言語でプロンプトを入力するだけで、エージェントが適切な図の種類を選択し、単一の自己完結型 HTML + SVG ファイルとして図を生成します。
Mermaid や標準的なツールで生成される機械的な図(README では「Mermaid slop」と表現)や過度なドロップシャドウを避け、エディトリアルデザインのように整理された美しいビジュアルを出力する点に焦点が当てられています。ドキュメント用のアーキテクチャ図、シーケンス図、マトリクス図などを AI エージェントに日常的に作成させたい開発者やテクニカルライターに向いています。
主な特徴
- 自己完結型の HTML + SVG 出力: 生成されるファイルは依存関係のない単一の
.htmlファイルであり、ブラウザでダブルクリックするだけですぐに閲覧できます。 - 50種類以上の図タイプに対応: システムアーキテクチャ図、シーケンス図、象限マトリクス図など、README によると 51 種類(メタデータでは 45 種類)の多様なダイアグラム形式をサポートしています。
- ブランドデザインへの適応: ウェブサイトの URL を指定することで、パレット(配色)やフォント情報を抽出し、自社やプロジェクトのブランドに合わせた外観で図を生成できます。
- 幅広い AI エージェント環境に対応: Claude Code、Codex、Qoder、GitHub Copilot、Factory Droid、Pi、Cursor、Cline、Windsurf など、多様なクライアントやホスト環境に対応しています。
- 外部形式からのインポート: Draw.io、Mermaid、Excalidraw、PlantUML といった既存の図ツールからのインポート機能や、PNG/SVG へのエクスポート機能が用意されています。
使い方
インストール
利用している AI エージェント環境に合わせてインストール方法を選択します。
汎用的な Agent Skills CLI を利用する場合は、以下のコマンドを実行します。
npx skills add cathrynlavery/diagram-design
Cursor、Cline、Gemini CLI、Windsurf などのホストでは、この CLI がリポジトリ内の skills/diagram-design/SKILL.md を検出し、必要な構成ファイルを各ホストのルートディレクトリへ配置します。複数環境が存在する場合は、シンボリックリンクまたはファイルコピーを選択できます。
Claude Code の場合
Claude Code のプラグインマーケットプレイスを利用して追加します。
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design
インストール後は /plugin からマーケットプレイスを開き、自動更新(Enable auto-update)を有効化することが推奨されています。
Codex の場合
codex plugin marketplace add cathrynlavery/diagram-design
codex plugin add diagram-design@diagram-design
GitHub Copilot の場合
copilot plugin marketplace add cathrynlavery/diagram-design
copilot plugin install diagram-design@diagram-design
図の生成
インストールが完了したら、通常のエージェント対話で自然言語を用いて図の生成を依頼します。
Make me an architecture diagram of my app: frontend, backend, database, Redis cache.
I need a quadrant showing Q2 projects by impact vs effort.
Give me a sequence of a bearer call with token refresh on 401.
また、特定サイトのデザインルールに合わせたい場合は、以下のように指示を出してオンボーディングを実行できます。
Onboard diagram-design to https://yoursite.com
指示を受け取ったエージェントは、図の種類を選定し、設計計画を示したうえで、単一の .html ファイルを出力します。
技術的なポイント
diagram-design は独立したバイナリや重厚なランタイムではなく、エージェントが読み取って実行するためのプロンプト定義、リファレンス、スクリプト群から構成されています。
- Agent Skill 仕様への準拠: リポジトリ内の
skills/diagram-design/配下にSKILL.md、references/、assets/、scripts/などの構造を持ち、エージェントがコンテキストとして参照しやすい設計になっています。 - HTML/SVG による描画: 専用のレンダラや Canvas による動的描画ではなく、プレーンな SVG を内包した HTML ファイルを出力するため、外部の描画ライブラリをブラウザ側で読み込む必要がありません。これにより、オフライン環境でも表示が崩れにくく、バージョン管理もしやすくなっています。
- スタイルガイドの分離とプロファイル管理: エージェントが参照するデザイン基準は
references/style-guide.mdなどにまとめられています。独自のデザイン調整を永続化したい場合のために、リポジトリを直接クローンして編集可能なローカルインストールを行う運用方法や、~/.diagram-design/profiles/によるプロファイル保持の仕組みが考慮されています。
注意点
- ライセンス: 本プロジェクトは MIT ライセンスで公開されています。
- アップデート経路の差異:
npx skills addによるスタンドアロンインストールを行った場合、各ホストの公式マーケットプレイスが持つ自動アップデートには追従しません。Codex や Claude Code ではマーケットプレイス経由での導入が推奨されています。 - スタイルのカスタマイズ時の注意: パッケージ管理ツール経由でインストールした環境で内部の
style-guide.mdを直接書き換えると、バージョン更新時に上書きされる可能性があります。永続的な変更を行う場合は、ローカルクローンからのシンボリックリンク運用や専用プロファイルディレクトリの活用が求められます。 - 公式リポジトリの確認: README には「公式ビルドは本リポジトリからのみ提供される」と明記されており、第三者による非公式なプラグイン一覧に注意するよう呼びかけられています。また、通信内容に関しては付属の
PRIVACY.mdを確認する必要があります。
まとめ
diagram-design は、各種 AI エージェントの出力を洗練された HTML + SVG の図に引き上げる実用的な Agent Skill です。外部ライブラリへの依存なしに、ブランドに合わせた美しいアーキテクチャ図やシーケンス図をすばやく作成したい場面で役立ちます。





