Community画像github.com

html-diagrams-decks

アニメーション付きインタラクティブSVG図、手描き風アーキテクチャ図、16:9スライドデッキを、単一の自己完結型HTMLファイルとして作成します(ライト/ダークテーマ、段階的ビルド、キャプション、コネクタ上のパケットフロー、ホバー詳細、レイアウトチェック、グリッド/エネルギー記号を含む50アイコンスプライト付き)。アーキテクチャ図、フロー図、階層ビュー、説明図、ステップバイステップのウォークスルー、あるいはHTMLページやclaude.aiアーティファクトとしてのプレゼンテーション/デッキが求められたときに使用します。

html-diagrams-decks とは?

このスキルは、Claude Code、GitHub CopilotなどのAIエージェントが、高品質な図やプレゼンテーションを生成するためのものです。2つの図作成ライブラリ(EdgeDiagram:宣言的SVGグラフ、ノード間の直交リンク、パケットフロー表示機能、EdgeSketch:手描き風図、グリッド上にボックスと矢印を配置)、スライドデッキエンジン(EdgeDeck)、3つのテーマ(engineering, indigo, drafting)、および3つのテンプレート(diagram.html, sketch.html, deck.html)を提供します。各テンプレートは単一のHTMLファイルとして成果物を生成し、GSAPがキャッシュされればオフラインでも動作し、視聴者のテーマ(ライト/ダーク)に自動対応し、claude.aiアーティファクトとして公開可能です。ワークフローは、図の内容決定、ライブラリ選択、テンプレートコピー、グリッド上へのレイアウト、ステップ記述(EdgeDiagram)、テーマ適用、ビルド・チェック・スクリーンショット撮影、必要に応じてdraw.ioへの編集可能ファイルのエクスポート、そして公開です。コネクタは水平・垂直のみ、直交配線が基本で、ファン配線やバス配線をサポートし、交差や斜め線を避けるルールがあります。また、レイアウトチェック(shot.sh --check)により、傾いた線や曲線、ジョギングする配線を検出し、修正を促します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nilsonfh/trazo/tree/HEAD/skills/html-diagrams-decks

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

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

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

ドキュメント

HTML図とデッキ

このスキル(Agent Skill:Claude Code、GitHub Copilotおよびその他のエージェントが読み込みます)は、2つの小型図ライブラリ、デッキエンジン、3つのテーマ、3つのテンプレートを提供します。各成果物は1つのHTMLファイルであり、GSAPがキャッシュされればオフラインで動作し、閲覧者のライトまたはダークテーマに従い、claude.aiアーティファクトとして公開できます。

パス説明
lib/edgediagram.js宣言的SVGグラフ:zone、node、text、link(デフォルトで直交、矢印、ラベル、パケットフロー)、fan(1つのポイントから複数のノードに給電)、bindFocus、steps、および各ステップでのレイアウトチェック
lib/edgesketch.jsグリッド上の手描き図:zone、box(テキストにフィット、垂直カラムと中央揃えバー)、arrow(直角、両矢印)、connect(ボックス間接続)、fan、text、およびEdgeSketch.check(任意のSVGのレイアウトチェック、斜め線や曲線も含む)
lib/icons.jswindow.EDGE_ICONS:24単位グリッド上の50個のラインアイコン(グリッド機器、コンピュート、トラスト、オペレーション)
lib/edgedeck.jsEdgeDeck.run:1600×900のスライドステージ、スライドごとのステップ、キャプション、キーボード、スワイプ、#nリンク
themes/*.css1つのトークン契約に基づくカラーとタイプのテーマ(ライト/ダーク):engineering(緑グレー上の青、Archivo NarrowとIBM Plex)、indigo(ラベンダーグレー上の藍色、Space GroteskとInter)、drafting(温かみのある紙上のティール、Barlow CondensedとSource Sans 3)
templates/diagram.htmlステップ付きEdgeDiagram図、キャプション、前/次ボタン、ドットナビゲーション
templates/sketch.html手描きEdgeSketch図:左から右へのゾーン、カラム、サービス、両矢印、凡例
templates/deck.htmlタイトルスライドと、図が段階的に構築されるコンテンツスライド
scripts/inline.pyライブラリファイルとテーマをページにインライン化し、1ファイルとして公開可能にする。見つからないものがあると失敗する。
scripts/shot.shヘッドレススクリーンショット(ライト/ダーク、任意の幅、指定クリック後、--onlyで1要素、--fullでページ全体)、および--check(ページ上のすべての図のレイアウトチェック)
scripts/todrawio.shビルド済みページの1つの図をdraw.ioファイルにエクスポート(EdgeDiagram図はリンク付き、手描きSVG図、HTML図)
scripts/check_theme.pyテーマのWCAGコントラストをライト/ダークでチェックし、2つのダークブロックが一致することを確認する。
scripts/theme_from_design.pyDESIGN.mdファイル(ブランドの色とフォント)からテーマを作成する(ライト/ダーク、すべてのペアがコントラスト条件を満たす)
scripts/test.shtests/内のテストを実行する。lib/、scripts/、themes/を変更した後に実行すること。
scripts/vendor.shライブラリを別のプロジェクトにコピーする。--checkでそのコピーが最新かどうかを表示する。
references/api.md両ライブラリとデッキエンジンのすべてのオプション
references/conventions.mdトークン、各トーンの意味、レイアウトルール、公開、実行すべきチェック
examples/ci-canary-deck.htmlニュートラルなワークフロー(CI/CD、カナリアリリース)に関する完全な2スライドデッキ
examples/isometric/等角投影の階層図ジェネレーター(SGAMキューブ)、教訓を含む
examples/design-md/DESIGN.mdテーマを作成するためのサンプルDESIGN.md(Harbor)

ワークフロー

  1. 図が示すべき内容を決定します。 メカニズム、それが依存する部品、およびそれを明らかにする順序に名前を付けます。それを速く言い表す文は、図よりも優れています。
  2. ライブラリを選択します。 意味のある配線で接続された部品のグラフをステップごとに表示する:EdgeDiagram(templates/diagram.html)。ボックスのグリッド、階層スタック、または左から右へのプラットフォームビューで、配置が意味を伝える:EdgeSketch(templates/sketch.html)。プレゼンテーション:templates/deck.html、スライドにいずれかのライブラリを使用。
  3. テンプレートを作業ディレクトリにコピーします。 例:cp <skill>/templates/sketch.html ./my-figure.html。<script src>とテーマのパスが<skill>/lib/と<skill>/themes/を指すように修正するか、最後に--libと--themesを指定してinline.pyを実行します。
  4. グリッド上にレイアウトします。 viewBoxを選択し、次にゾーン、次にボックス(均等サイズ、均等ギャップ)、次に配線(下記のコネクタを参照)を配置します。互いに通信するボックスは同じ行または列に配置し、配線が一直線になるようにします。意味を持つリンクにはinfoを付けます。オプションについてはreferences/api.mdを参照してください。
  5. ステップを記述します(EdgeDiagram)。 ステップ0は休止状態です。以降の各ステップは1つのアイデアを追加し、短いキャプションを持ちます。移動するデータにはflowsを使用し、ステップが過ぎ去ったものをdimまたはhideで示します。
  6. テーマを適用します。 ページは1つのテーマにリンクします(<link rel="stylesheet" href="../themes/engineering.css">)。名前を変更することでテーマを切り替えられます。engineeringは密度の高い技術資料、indigoは製品とソフトウェアデリバリー、draftingは文書として読まれる提案や調査に適しています。各トーンの意味を維持します(references/conventions.md)。ブランドの外観が必要な場合は、DESIGN.mdからテーマを作成します:python3 <skill>/scripts/theme_from_design.py DESIGN.md -o themes/<name>.css(examples/design-md/DESIGN.mdはサンプルです)。手動では、テーマをコピーし、すべてのトークン名を保持し、値を変更し、scripts/check_theme.py themes/<name>.cssがパスするまで実行します。
  7. ビルド、チェック、確認:
    python3 <skill>/scripts/inline.py my-figure.html > build/my-figure.html
    <skill>/scripts/shot.sh --check build/my-figure.html          # すべての図;問題があればexit 1
    <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-light.png light 1280
    <skill>/scripts/shot.sh --only '#my-fig' build/my-figure.html /tmp/f-dark.png dark 1280
    <skill>/scripts/shot.sh build/my-figure.html /tmp/sN.png dark 1280 'for(var i=0;i<5;i++)document.getElementById("next").click()'
    
    --checkが報告するすべてを修正します。次にPNGを開き、グリッドから外れたボックス、衝突する矢印先端、混雑したラベルなど、チェックで見つからないものを修正し、幅420でも再度確認します。スクリーンショットはパケットを配線の開始付近で固定するため、実際のブラウザで動きを判断します。
  8. 求められた場合、編集可能なコピーを提供します。 <skill>/scripts/todrawio.sh build/my-figure.html <svg idまたはセレクタ> out.drawio "名前" は、ライトテーマで最終ステップの1つの図のdraw.ioファイルを書き出します。これは、モーション、ステップ、ツールチップ、およびrectとellipse以外の塗りつぶし形状を保持しないことを示します(いくつ省略したかを出力します)。
  9. 公開します。 インライン化されたファイルがページです:ファイルとして共有するか、コミットするか、またはClaude内でArtifactツールに渡します(同じパスまたはURLを再公開して更新します)。

コネクタ

配線は読者がたどるものなので、意図的である必要があります:

  • 水平および垂直のみ。 斜めや曲線は絶対に使用しないでください。EdgeDiagramのリンクはデフォルトでorthoです:routeは指定しないでください。'straight'は両端がすでに一直線にある場合のみ、'curve'はユーザーが明示的に要求した場合のみ使用します。EdgeSketchではs.arrow、s.connect、s.fanを使用します。これらは直角に曲がります。手書きのSVGでは、HとVのパスコマンドで配線を描き、角だけを丸めます。
  • ボックスが向かい合っている場合は一直線にします。 位置(t)を指定しないと、EdgeDiagramまたはs.connectは、2つのボックスがスパンを共有するときに両端を一直線に配置します。チェックで数ピクセルのジョギングが報告された場合は、端が揃うようにボックスを移動します。tを微調整しないでください。
  • 1つのソースから複数のボックスに給電する場合は、ファンを使用します。 d.fan(id, {from: [src, 'bottom'], to: ['a', 'b', 'c']}) または s.fan(src, 'bottom', [a, b, c]) は、幹線、直角のバス、各ボックスへの分岐線を描き、各接合点にドットを打ちます。複数のボックスが1つに給電する場合も、リストを入れ替えた({from: [[...], ...], to: [...]} または {into: true})同じファンです。
  • 曲がりは少なく、交差は避けます。 各配線が最大2回曲がるように辺を選択します。辺を共有する配線は広げます('auto')。ボックスを迂回し、ボックスの中を通らないようにします。
  • shot.sh --checkは、傾いた線、曲線、ジョギングする配線を報告します。他の問題と同様に修正します。等角投影図など、意図的な例外はdata-route="free"でマークします。

ルール

  • 他のライブラリは使用しないでください。cdnjsのGSAP 3はオプションです:これがない場合、各ステップは最終状態を表示します。
  • すべての色はトークンから取得されるため、コンポーネントにリテラルカラーは含まれません。
  • infoを持つすべてのノード、ボックス、またはリンクはキーボードフォーカス可能です。SVGにはrole="img"と、図が主張する内容を述べるaria-labelが必要です。
  • 電話より広い図は、ページではなく、独自のoverflow-x: autoコンテナ内でスクロールします。
  • 内部名、顧客名、住所は、共有されるページから除外します。

関連スキル