Community画像github.com

diagram-studio

図(アーキテクチャ図、フローチャート、パイプライン、システム概要、エージェントループ)を鮮明で編集可能なPNG+SVGとして再構築・美化・作成します。特に、ぼやけた・低解像度・AI生成・雑然とした・透かし入りの既存の図を、テキスト・レイアウト・色・外観(手書き風またはクリーン/フラット)をそのまま保持しながら高精細に描き直すことが核の用途です。

diagram-studio とは?

Diagram Studioは、既存の図画像を高忠実度でベクター再描画するAIエージェントスキルです。ぼやけた画像やAI生成図、透かし入り画像などを、元のテキスト・レイアウト・色・スタイルを完全に保持したまま鮮明なPNG+SVGに変換します。手書き風(Excalidrawライク、ホワイトボード)、クリーンなベクター、ブループリント、アカデミック、ダークなど多彩なスタイルに対応し、テキストやコードから新規作成も可能。中国語も完全サポート。Node 18+のみで動作し、ネットワーク不要で手軽に利用できます。CodexやClaude CodeなどのAIエージェント環境で、画像の参照・比較を行いながら繰り返しレンダリングを改善し、最終的にエラー0の美しい図を生成します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/stlmx/diagram-studio/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

Diagram Studio

JSON仕様書を鮮明な図に変換します。外観は完全に設定可能です:

  • 手書き風: rough.jsの揺れと手書きフォント。
  • クリスプベクター: 揺れなし、サンセリフまたはセリフフォント、ソフトシャドウ。
  • その中間も可能。

すべてのテキストはアウトラインに変換されるため、SVGとPNGはどこでも同じように見えます。リンターが重なり、あふれたテキスト、境界線上のラベル、ボックスを通過する矢印を検出します。

すべてバンドルされています: Node 18+のみ必要で、npm installやネットワークは不要です。 SKILL_DIR はこのスキルフォルダ(このファイルを含むフォルダ)の絶対パスを意味します。

node SKILL_DIR/scripts/render.mjs diagram.json --out out/     # → out/diagram.png (2x), .svg, .report.json, .tiles/

0. Codex、Claude Code、または他のエージェントで実行する場合

  • SKILL_DIR:
    • Codexでは、スキルの短いパスをスキルルートテーブルで展開します(例:r0/diagram-studio/SKILL.md → ~/.codex/skills/diagram-studio)。
    • Claude Codeでは、通常 ~/.claude/skills/diagram-studio です。
    • スクリプトは必ずその絶対パスで呼び出してください。
  • 画像の参照は必須です: オリジナル、グリッド、タイル、比較画像。
    • Codex: PNGパスを指定して view_image ツールを使用してください。render.mjs は name.preview.png(≤ 1400 px)を生成するので、自分でリサイズする必要はありません。詳細は name.tiles/*.png を使用してください。
    • Claude Code: Readツールを使用してください。
    • リンターの出力だけでレンダリングを判断しないでください。
  • サンドボックス対応:
    • node のみ必要です。ネットワーク呼び出しやインストールはありません。
    • 出力は --out に配置します。ワークスペース内(例:./diagram-out)に保持してください。
    • WebP/HEIC変換はシステムの一時ディレクトリに出力されます。
  • ユーザーがパスではなく画像を貼り付けた場合: 添付ファイルのパスが確認できればそれを使用します。そうでなければファイルパスを尋ねてください。ツールは実際のファイルを必要とするためです。
  • 完了時: PNG、SVG、JSONの絶対パスをリストアップして、ユーザーが開けるようにしてください。

1. ジョブを選択する

ユーザーの希望ジョブ次を読む
「この画像をより鮮明に/高解像度に/きれいに」、「赤raw / 再構築 / 复刻 / 高清重建 して」A. 画像から再構築。 忠実性優先:特に指示がなければ元のスタイルを保持references/rebuild-from-image.md (必須)
「この図を美化/整理 / 美化 して」A + 洗練。 Aと同じですが、次に階層、スペーシング、配置を改善references/rebuild-from-image.md
説明、コード、メモからの新しい図B. 新規図references/spec.md
異なる外観(「手書き風にして」「フラットな企業向けに」「ブループリントに」「論文用に」)C. スタイル変更references/style-guide.md

特定の画像に対しては、デフォルトでそのスタイルに合わせます: 手書き風は手書き風のまま、フラットはフラットのまま、色とフォントカテゴリもそのまま維持します。ユーザーが依頼した場合にのみ外観を変更します。プリセットは出発点であり、制限ではありません。styleOverrides、カスタムパレット、カスタムフォントファイル("fonts")を使用すれば、ほとんどすべての外観を再現できます。要求が真に曖昧な場合(例えば、参照スタイルなしで「美化して」)にのみ、忠実度レベルについて質問してください。それ以外の場合は、デフォルトで 忠実 + より鮮明 にします。

templates/ 内の最も近いテンプレートから始めてください。テンプレートを作業フォルダにコピーし、そのコピーを編集します。プレビューは assets/gallery/ にあります。テンプレートはパターンであり、内容ではありません。そのテキストをすべて置き換え、改行と矢印はソースと完全に同じに保ってください。--expect は置き忘れや言い回しの変更を検出します。

テンプレート内容
dense-rebuild.json高密度アーキテクチャ画像の再構築:明示的な座標、カード、パネル、マージされたコネクタ、インラインラベル
pipeline-rag.json左から右へのパイプライン:connect、rightOf、自動フィットパネルを含む行
layered-architecture-zh.json中国語の階層化アーキテクチャ:belowで積み重ねられた行、ファンイン矢印、シリンダー
flowchart-decision.jsonフローチャート:ピル、ひし形、Yes/No分岐、ループバック矢印
agent-loop.jsonサイクル:曲線矢印、バッジ、楕円ハブ
auto-layout.json座標なし:ELK自動レイアウトとグループ

2. ループ(すべてのジョブ)

  1. まずインベントリを作成します。 すべてのテキスト文字列をそのままリストアップし(texts.txt として保存、1行につき1つ)、すべてのノード、すべての矢印(from → to、ラベル)、すべてのグループをリストアップします。何も発明したり削除したりしません。

  2. テンプレートから始めて name.json を記述します。

  3. レンダリング: node SKILL_DIR/scripts/render.mjs name.json --out OUT --expect texts.txt

  4. すべてのERRORを修正します。各エラーには具体的な → による修正方法が付随します。WARNは意図的でない限り修正し、意図的である場合は該当する要素または矢印に "ignore": ["code"] を追加して抑制します。

  5. 確認: OUT/name.png と OUT/name.tiles/*.png を確認し、オリジナルと比較します(scripts/compare.mjs)。prompts/visual-review.md のチェックリストを実行してください。リンターは意味、バランス、忠実度を判断できません。

  6. エラーが0になり、読みやすくなるまで(通常2~4ラウンド)ステップ3~5を繰り返します。

  7. 成果物を納品:

    • name.png: 2x。印刷用には --scale 3 を使用。
    • name.svg: ベクター。
    • name.json: 後で編集できるように保持。

    保持した点と改善した点を1行追加します。

3. 60秒でわかる仕様

{
  "canvas": { "width": 1600 },
  "style": "marker",
  "title": "Checkout Service",
  "subtitle": "{blue:clients} · {purple:services} · {green:data}",
  "elements": [
    { "id": "web", "title": "Web app", "icon": "app-window", "x": 120, "y": 220 },
    { "id": "api", "title": "API", "color": "purple", "emphasis": true, "rightOf": "web", "gap": 160,
      "lines": ["`POST /checkout`", { "text": "validates cart", "muted": true }] },
    { "id": "db", "type": "cylinder", "title": "Orders DB", "color": "green", "below": "api", "gap": 120 },
    { "id": "core", "type": "panel", "title": "Backend", "color": "purple", "contains": ["api", "db"] },
    { "id": "n1", "type": "note", "text": "Idempotent by **order id**", "rightOf": "core", "gap": 40 }
  ],
  "arrows": [
    { "from": "web", "to": "api", "label": "HTTPS" },
    { "from": "api", "to": "db", "label": "INSERT", "color": "green" }
  ]
}
  • 要素タイプ: box(デフォルト)、pill、ellipse、circle、diamond、cylinder、note、card、panel、text、icon、badge、image、path(カスタムSVG形状)、およびレイアウトヘルパーの row、column、group。

  • 各要素の配置 は次のいずれかを使用:

    • 左上隅は x/y、中央は cx/cy。
    • below / above / rightOf / leftOf に gap を追加。
    • contains。子要素に合わせてパネルを自動フィットします。

    サイズは自動です。オリジナルに完全に一致させるには w/h を設定します。

  • テキスト: title は太字で、\n で改行します。lines は本文行です。テキスト内のマークアップ:

    • **bold**
    • `code`(コードフォントを使用)
    • {green:span} と {muted:span}
    • ->(矢印グリフとして描画)

    中国語と英語は自由に混在できます。要素ごとに size、textSize、font、textColor、align を設定できます。

  • 色 はファミリー(blue purple green orange red teal yellow pink gray navy)、シェード(blue.tint)、#hex またはプレーンなCSS名(white など)で指定し、color、fill、stroke、textColor で設定します。

  • 矢印 は from と to を接続:

    • 辺を固定し、"id.right" または "id.right+20" でそれに沿ってスライド。
    • ラベル: label。labelPos(above、below、left、right、または inline)で配置し、labelAt で微調整。
    • 外観: dash、color、width、head(end、start、both または none)。
    • パス: via 点、points(正確なポリライン)、または "route": "curve"。

すべてのキーは references/spec.md にあります。

4. 外観:スタイル、パレット、フォント、エフェクト

  • スタイルプリセット:

    • 手書き風: marker(デフォルト)、neat、excalidraw、sketchy、whiteboard、pencil、blueprint、chalk。
    • クリスプ: clean、paper。

    任意のプリセットフィールドは styleOverrides でオーバーライド可能:

    • roughness(0 = 完全に直線)と bowing
    • fillStyle(solid、hachure、cross-hatch、dots または none)
    • strokeScale、cornerRadius
    • shadow(none、soft または hard)
    • font、cjkFont、codeFont、background
  • パレット: marker、pastel、excalidraw、mono、academic、colorblind、modern、blueprint、chalkboard、midnight。オリジナルの色を正確に再現するには、node SKILL_DIR/scripts/palette.mjs original.png を実行し、結果を貼り付けます。

  • フォント:

    • 手書き: shantell、kalam、caveat、patrick、architects。
    • サンセリフ: inter。セリフ: serif。モノ: mono。
    • CJK: kai(手書き)、kuaile(遊び心)、sans-sc(クリーン)。
    • 独自の .ttf/.otf/.woff: "fonts": {"brand": {"regular": "Brand.ttf", "bold": "Brand-Bold.ttf"}}、その後 "font": "brand"。
  • カタログ: assets/gallery/styles.png、palettes.png、fonts.png。scripts/catalog.mjs で再生成。

  • アイコン: 1500以上のLucideアイコン。node SKILL_DIR/scripts/icons.mjs search 数据库 robot queue で検索、icons.mjs sheet a,b,c でプレビュー。

  • オリジナル画像ツール:

    • grid.mjs: オリジナルに座標を重ねて表示。赤い軸ラベルを読み取ります。ピクセル位置は使用しません。
    • fontmatch.mjs: すべてのフォントのサンプルテキストを、オリジナルの拡大切り抜きと並べて表示。
    • palette.mjs: オリジナルの色を抽出。
    • crop.mjs: ロゴ、写真、スクリーンショットを切り抜いて image 要素として埋め込み。
    • compare.mjs: 並べて比較。--crop x,y,w,h を追加して、両方の画像を同じ領域にズーム。
  • ダークまたは代替バージョン: 同じ仕様を維持し、palette(midnight、blueprint または chalkboard)または style のみを変更し、別の --name でレンダリング。

  • スライド用(PPT、Keynote): "canvas": {"aspect": "16:9"} で画像をスライド比率にパディング。"background": "transparent" でアルファ付きPNG。SVGは直接貼り付けも可能。

5. 明確さのルール(常に適用)

  1. 単語はそのまま 保持: ラベル、コード識別子、中国語の用語。特に指示がない限り、テキストを発明、翻訳、削除しない。
  2. 階層を可視化:
    • ボックスごとに太字のタイトル。
    • 識別子は本文または code テキストとして。
    • 説明は muted テキストとして。
    • セクションタイトルはそのセクションの色で。
  3. 色には意味がある: 領域または役割ごとに1つのファミリーを一貫して使用。矢印ラベルは矢印の色を継承。
  4. 余裕を持たせる:
    • ラベル付き矢印で結合された形状間は ≥ 60 px、それ以外は ≥ 24 px。
    • パネルは contains でフィット。
    • 境界線上にラベルを配置しない。
  5. 縮小時も読みやすい:
    • テキスト ≥ 18 px(デフォルト: タイトル 30、本文 25、ラベル 24)。
    • キャンバス幅 1400–2200 px、アスペクト比 1:2 ~ 3:1。リンターはそれ以外を警告。
    • 6ノード以上の長いチェーン: 2~3行に蛇行配置するか、ELK "direction": "DOWN" を使用。非常に長い1行にはしない。
  6. 交差を少なく、遠回りをしない。 via を追加する前に整列と並べ替えを行う。
  7. 再構築ジョブでは 再設計せず洗練: 配置、スペーシング、階層は改善するが、トポロジー、読みの順序、スタイルのアイデンティティは維持。

6. 完了条件

  • render.mjs が 0エラー を報告。残っている警告は意図的であり、ignore で抑制されている。
  • すべてのインベントリ文字列が存在し、正確にスペルされている(--expect texts.txt がパスすること)。
  • PNGとタイルを確認し、再構築の場合はオリジナルと並べて比較:同じ構造、同じスタイルのアイデンティティ、より鮮明。
  • PNG、SVG、JSON を、「保持した点 / 改善した点」の短いメモとともに納品した。

7. トラブルシューティング

  • node: command not found: Node 18+ をインストール。他には何も必要ありません。
  • WebP、HEIC、BMP、TIFF入力は、sips、magick、dwebp、ffmpeg、Python PIL が利用可能な場合に自動変換されます。それ以外の場合は、ユーザーにPNGまたはJPEGを依頼してください。
  • 文字が ? と表示される: バンドルされたフォントは、ラテン文字、GB2312中国語、一般的な記号をカバーしています。言い回しを変更するか、その文字を含むフォントを登録してください。
  • 各リンターコードとその修正方法については、references/troubleshooting.md を参照してください。

関連スキル