Community画像github.com

svg-creator

ユーザーの説明をもとに、手書き風のSVGフローチャートや図を作成します。アスペクト比の指定(16:9、4:3、1:1、A4、カスタム)に対応しています。

svg-creator とは?

このスキルは、ユーザーがフローチャート、ダイアグラム、アーキテクチャ図、プロセスチャート、マインドマップ、またはワークフローやシステムの視覚的表現を要求した際に、それらを手描き風のSVGとして生成します。特に「画个图(図を描いて)」「draw a diagram」などの発言をトリガーとします。生成されるSVGは、`feTurbulence`フィルタによる歪みやハッチングパターン、手書きフォント(中国語: Ma Shan Zheng、英語: Comic Sans MS)を組み合わせ、ホワイトボードにマーカーで描いたような独特の手描き風が特徴です。このスキルはClaude CodeなどのAIエージェントプラットフォームで利用でき、16:9、4:3、1:1、A4、またはカスタムのアスペクト比を指定して、プレゼンテーションやドキュメントに最適なサイズで図を出力できます。内部ワークフローとして、ユーザーの説明の解析、レイアウト計画、SVG生成に加え、生成後に`rsvg-convert`でPNGに変換して視覚チェックを行い、矢の欠落やレイアウトの問題を自動修正するサイクルを備えています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retrocognition023/my-agent-skills/tree/HEAD/skills/svg-creator

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

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

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

ドキュメント

SVG 手書き風フローチャート作成ツール

あなたは、プロセス、システム、ワークフローに関する口頭または文章での説明を、美しい手書き風のSVGフローチャートに変換します。出力は、無機質な業務用ダイアグラムではなく、誰かがカラーマーカーでホワイトボードにスケッチしたように見えるものでなければなりません。

アスペクト比

すべてのSVGは、定義されたアスペクト比を持つ必要があります。ユーザーが明示的に指定することも、デフォルトで16:9(プレゼンテーション向け)になります。アスペクト比によって、<svg>要素のviewBox、width、height属性が決まります。

プリセット

名称比率標準的な viewBox最適な用途
16:916:90 0 1600 900スライド、プレゼンテーション、ワイドスクリーンディスプレイ
4:34:30 0 1200 900従来のスライド、ドキュメント
1:11:10 0 1000 1000ソーシャルメディア、正方形のサムネイル
A4~1:1.4140 0 1000 1414印刷用ドキュメント、縦長ポスター
A4-landscape~1.414:10 0 1414 1000印刷用横長ドキュメント

カスタム比率

ユーザーはW:Hの形式(例:3:2、21:9)で任意の比率を指定できます。長辺が約1400〜1600px、短辺が比率に従うようにスケーリングしてviewBoxを計算します。

アスペクト比がレイアウトに与える影響

  • ワイド形式(16:9、21:9):左から右へのフローを優先します。水平方向のスペースが広いため、1行に4〜6個の要素を快適に配置できます。垂直方向の積み重ねはスペースを無駄にします。
  • 縦長形式(A4、9:16):上から下へのフローを優先します。垂直方向のスペースを最大限に活用し、水平方向の要素は1行あたり2〜3個に制限します。
  • 正方形(1:1):バランスが取れています。放射状レイアウトと2×2/3×3グリッドの両方に適しています。強い方向性のないコンセプトマップに適しています。
  • 4:3:中間的なバランスです。どちらの方向にも機能しますが、やや水平方向が有利です。

ステップ2でレイアウトを計画する際は、常に最初にアスペクト比を確認し、利用可能なスペースを自然に使えるレイアウト方向を選択してください。左から右へのフローを縦長のキャンバスに、または上から下へのフローをワイドスクリーンのキャンバスに強制しないでください。

デフォルトの動作

ユーザーが比率を指定しない場合は、16:9を使用します。これはほとんどの図で適切に機能し、プレゼンテーションですぐに使用できます。内容が明らかに異なる比率を必要とする場合(例:非常に縦長の階層構造)は、変更を提案しますが、黙って上書きはしません。

全体的なワークフロー

  1. 理解と分解 — ユーザーの説明を個別のモジュール/ステップ/アクターに解析します
  2. アスペクト比の決定 — ユーザーが指定した比率、またはデフォルトの16:9を使用します
  3. レイアウトの計画 — 視覚的な構造を決定し、アスペクト比に適合させます
  4. SVGの生成 — 手書き風のスタイリングと正しいviewBoxでクリーンなSVGを記述します
  5. 矢印の検証 — ノード間のすべての接続に可視の矢印があることを自己チェックします
  6. 出力と反復 — ファイルパスをユーザーに提供し、フィードバックに基づいて改良します

ステップ 1: 理解と分解

ユーザーがプロセスを説明する際、以下を抽出します:

  • アクター/役割 — 参加者は誰ですか?(例:「PM」、「システム」、「ユーザー」)
  • 段階/フェーズ — 主要なグループ化は何ですか?(例:「入力フェーズ」、「処理フェーズ」)
  • ステップ — 各段階内の個々の操作は何ですか?
  • 接続 — どのようにフローしますか? 順次? 分岐? フィードバックループ?

説明があいまいな場合は、描画する前に質問を明確にしてください。

ステップ 2: レイアウトの計画

プロセス構造に一致するレイアウトを選択します:

  • トップダウン:単純な順次フロー
  • 左から右へのセクション:互いに引き継ぐ明確なフェーズがある場合
  • グループ化されたボックス:アクターが異なるステップセットを所有する場合
  • フィードバックループ:外側を回る破線の矢印を使用します

SVG座標を書く前に、おおよその境界ボックスを頭の中でスケッチします:

  • 各セクションに十分なスペースを与えます(通常、主要なグループあたり400×500px)
  • 矢印のために要素間に40〜60pxのギャップを残します
  • 30〜50pxのマージンで全てが収まるキャンバスサイズを計画します

ステップ 3: SVGの生成 — コアテクニック

3.1 手書き風エフェクト: feTurbulence + feDisplacementMap コンボ

これがスケッチ風の見た目の核心です。パーリンノイズを使用してピクセルを変位させ、直線や鋭い角を手書き風に見せます。

<defs>
  <!-- 形状(ボックス、楕円、大きなコンテナ)用 — 中程度のゆがみ -->
  <filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
    <feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
    <feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
                       xChannelSelector="R" yChannelSelector="G"/>
  </filter>
</defs>

重要:矢印/コネクタ線にはフィルタを適用しないでください。 feDisplacementMapフィルタは、低スケールであっても、ほとんどのSVGレンダラーで細い線が見えなくなったり断片化したりする原因となります。矢印はフィルタ属性なしで描画する必要があります。矢印の手書き風の表現は、stroke-width="3"以上を使用することで実現します。これにより、フィルタが適用された形状と並べても十分に有機的な見た目になります。

3.2 ハッチング塗りつぶしパターン

斜線パターンは手描きのクロスハッチングをシミュレートします:

<pattern id="hatch-blue" width="8" height="8" patternUnits="userSpaceOnUse"
         patternTransform="rotate(-45)">
  <line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>

読みやすさのために、ハッチパターンを半透明のベタ塗りと重ねます:

<!-- ハッチングレイヤー -->
<rect ... fill="url(#hatch-blue)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- 読みやすさのオーバーレイ -->
<rect ... fill="#dbeafe" opacity="0.25"/>

図で使用されるカラーテーマごとに1つのハッチパターンを作成します。

3.3 手書きフォント — これらを正確に使用し、代用は禁止

フォントはすべての図で一貫している必要があります。この正確な<style>ブロックを使用してください — Caveat、Patrick Hand、または他のフォントを使用しないでください。これは厳格な要件です。

中国語テキストを含む図の場合:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;family=ZCOOL+KuaiLe&amp;display=swap');
  /* 中国語テキスト — Ma Shan Zheng ブラシスタイルフォント */
  text {
    font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
  }
  /* 英語ラベル(コード名、/task-add、Backlog、YAMLなどの技術用語) */
  .label-en {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

図が完全に英語の場合:

<style>
  @import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&amp;display=swap');
  text {
    font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
  }
</style>

中国語の図では、英語のテキスト要素にclass="label-en"を適用します。Caveat、Patrick Hand、Indie Flower、または他の手書きフォントは絶対に使用しないでください — 中国語にはMa Shan Zheng、英語にはComic Sans MSを厳守してください。

3.4 矢印マーカー

各セクションのテーマに一致する色付きの矢印マーカーを定義します:

<marker id="arrow-blue" viewBox="0 0 12 12" refX="10" refY="6"
        markerWidth="10" markerHeight="10" orient="auto-start-reverse">
  <path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>

接続線にはmarker-end="url(#arrow-blue)"を使用します。間接的/オプショナルなフローを示す破線の接続の場合は、stroke-dasharray="14 10"を追加します。

3.5 形状の語彙

概念SVG形状例
アクター/役割<ellipse>PM、ユーザー、システム
プロセスステップ<rect rx="6">/task-add、build step
コンテナ/フェーズ<rect rx="20"> 大、ハッチングあり「1. 需求录入」セクション
データ/出力<path> 平行四辺形Backlog、Report
決定<path> ひし形Yes/No分岐
外部境界<rect> with stroke-dasharrayシステム境界、フィードバックループ

3.6 カラーテーマ

主要なセクション/アクターごとに独自の色を持つ必要があります。適切なパレット:

  • 青: stroke="#3b82d0", fill="#dbeafe", text="#1e40af", hatch="#a0c4f0"
  • オレンジ/黄: stroke="#d4920a", fill="#fef3c7", text="#92400e", hatch="#f0d080"
  • 緑: stroke="#2d8a4e", fill="#d1fae5", text="#065f46", hatch="#5a9e6f"
  • 紫: stroke="#7c3aed", fill="#ede9fe", text="#5b21b6", hatch="#b4a0e8"
  • グレー(破線コネクタ用): stroke="#777"

3.7 要素の接続 — 矢印にフィルタは付けない

これが最も重要なセクションです。壊れたり見えなくなったりする矢印は、図全体を台無しにします。

ルール:

  1. すべての矢印<line>または<path>コネクタはstroke-width="3"以上でなければなりません
  2. すべての矢印はmarker-end="url(#arrow-xxx)"属性を持たなければなりません
  3. いかなる矢印にもfilter="url(#sketchy)"またはfilter="url(#sketchy-line)"を追加しないでください — フィルタにより細い線が見えなくなります
  4. 形状の端と矢印の開始/終了点の間に5〜10pxのギャップを残し、矢印の先端がはっきり見えるようにします
  5. L字型の矢印は、ターゲットの中心軸で終了する必要があります — ターゲット形状がx=600を中心としている場合、矢印の最終セグメントはx=600、つまり中心で終了する必要があり、オフセットした位置では終了してはいけません。ターゲットの中心座標は、楕円の場合はcx/cyから、長方形の場合はx + width/2、yから計算します
  6. 矢印ラベルは矢印線と重なってはいけません — ラベルは矢印パスの15〜20px上または下に配置し、水平矢印と同じy座標、または垂直矢印と同じx座標には決して配置しないでください
<!-- 実線矢印(直接フロー)— フィルタ属性なし -->
<line x1="260" y1="390" x2="260" y2="425"
      stroke="#3b82d0" stroke-width="3"
      marker-end="url(#arrow-blue)"/>

<!-- 破線矢印(間接/オプショナルフロー)— フィルタ属性なし -->
<line x1="460" y1="440" x2="590" y2="440"
      stroke="#777" stroke-width="3" stroke-dasharray="14 10"
      marker-end="url(#arrow-gray)"/>

<!-- L字型または曲線パス — フィルタ属性なし -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
      stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
      marker-end="url(#arrow-green)"/>

ステップ 4: 矢印の検証(自己チェック)

SVGを作成した後、ファイルを保存する前にすべての接続を検証する必要があります。このステップは、最も一般的で最も有害な欠陥である矢印の欠落を防ぎます。

手順:

  1. すべての接続をリストアップ: ステップ1の分解に戻り、存在すべきすべての矢印を列挙します。チェックリストとして書き出します:

    接続チェックリスト:
    - [ ] ノードA → ノードB (下单)
    - [ ] ノードB → ノードC (处理订单)
    - [ ] ノードC → ノードD (支付成功)
    ...
    
  2. 各接続について、SVG内で、ソースノードの下端/右端からターゲットノードの上端/左端に移動する座標を持つ<line>または<path>要素があり、かつmarker-end属性を持っていることを確認します。

  3. フィルタ汚染をチェック: SVG内でfilter=を含む<line>またはコネクタ<path>を検索します。見つかった場合は、その要素からフィルタ属性を削除します。

  4. 座標の妥当性をチェック: 各矢印について、以下を確認します:

    • 開始点(x1,y1)がソース形状の下端/右端近くにあること
    • 終了点(x2,y2)がターゲット形状の上端/左端近くにあること
    • L字型パスの場合、最終セグメントはターゲット形状の中心xまたはyで終了していること
    • 開始点と終了点が異なること(長さゼロの線ではないこと)
  5. ラベルの配置をチェック: 各矢印ラベルのテキスト要素について、以下を確認します:

    • ラベルのyが、水平矢印の場合、矢印のy座標から少なくとも15px上または下にあること
    • ラベルのxが、垂直矢印の場合、矢印のx座標から少なくとも15px左または右にあること
    • ラベルが形状ボックスと重なっていないこと

接続が欠落している場合は、保存する前に追加します。

ステップ 5: 出力と反復

  1. 書き込み前に既存ファイルを確認: 保存する前に、ターゲットファイルが既に存在するか確認します。存在する場合は、上書きを避けるためにバージョンサフィックスを追加します:

    • 最初のファイル: flowchart.svg
    • flowchart.svgが存在する場合:flowchart-v1.svgとして保存
    • flowchart-v1.svgも存在する場合:flowchart-v2.svgとして保存
    • 未使用のファイル名が見つかるまでインクリメントを続けます
    • 書き込む前にlsまたはtest -fを使用して存在を確認します
  2. 決定されたファイルパスにSVGを書き込みます

  3. SVGをPNGに変換し、視覚的に自己チェック: まだユーザーにファイルを開かせないでください。代わりに、最初に結果を変換して検査します:

    rsvg-convert input.svg -o output.png
    

    次に、Readツールを使用して生成されたPNG画像を表示します。以下を注意深く検査します:

    • レイアウトの問題: 要素が重なっていませんか? テキストがクリップされたりコンテナからはみ出したりしていませんか? 大きな空きスペースや窮屈な領域はありませんか?
    • 矢印の問題: すべての矢印が表示されていますか? 矢印が間違った方向を向いたり、形状を横切ったり、切断/破損して見えたりしていませんか?
    • テキストの可読性: テキストは判読可能で、他の要素と重なっていませんか?
    • 全体的なバランス: 図はキャンバス内でバランスよく見えますか?

    問題が見つかった場合は、SVGに戻って修正し、再変換して再検査します。図が視覚検査に合格するまで繰り返します。

  4. 図が検査に合格したら、SVGファイルとPNGファイルの準備ができたことをユーザーに通知し、ファイルパスを提供します。openは使用しないでください — ユーザーはリモートサーバーを使用している可能性があります。

  5. フィードバックに備えてください — よくある要望:

    • 「这个框太小了」→ 寸法を拡大して再配置
    • 「箭头断了」→ 矢印からフィルタを削除し、stroke-widthを増やす
    • 「字体不够手写」→ Google Fontsのインポートを確認し、font-familyの文字列が正確か確認
    • 「颜色太淡/太深」→ 不透明度とストロークの色を調整
    • レイアウトの再配置 → 座標を再計算

よくある落とし穴

  • 矢印が消える: 問題の1位です。<line>または矢印<path>にfilterを決して適用しないでください。変位フィルタは細い要素を見えなくします。フィルタを適用するのは形状(<rect>、<ellipse>、コンテナ<path>)のみにしてください。
  • フォントの不一致: 中国語には常にMa Shan Zheng、英語にはComic Sans MSを使用してください。Caveat、Patrick Hand、Indie Flowerなどで代用しないでください。
  • テキストが手書きに見えない: Google Fontsの@importはインターネット接続が必要です。SVGレンダラーがフォントをダウンロードできること、フォールバックフォントが適切に設定されていることを確認してください。
  • テキストの重なり: サイズ変更や移動のたびにテキストの重なりを再確認してください。各テキスト要素は、最も近い形状の内側または横に十分なスペースがある必要があります。
  • 座標計算ミス: L字型の矢印を手動で計算するのは難しいです。L字型の矢印は、ターゲットボックスの中心軸(長方形の場合はcx、cy、またはx + width/2)で正確に終了していることを再確認してください。

関連スキル