Communitygithub.com

anton-abyzov/vskill

公式Excalidraw MCPを介してExcalidraw図を作成し、同じソースから実際の.excalidrawファイルまたはObsidianの.excalidraw.md図面を生成します。ユーザーが「Excalidraw MCPを使って」と言ったとき、図、フローチャート、アーキテクチャ、シーケンス、スイムレーン、マインドマップ、ER図の作成/描画/可視化を求められたとき、図をリポジトリやボールトに保存したいとき、または既存のExcalidrawシーンをチェック/再レンダリングしたいときに使用します。

vskill とは?

このスキルは、Claude CodeやVisual Studio CodeなどのAIエージェントが、公式Excalidraw MCPサーバーを通じてライブで複雑なExcalidraw図を作成・操作し、同時にディスク上に正しく保存可能な.excalidrawファイル(またはObsidian用.excalidraw.mdファイル)を生成するための包括的なツールセットです。 最大の特徴は、MCPの`create_view`ツールが受け付ける「スケルトン」形式と、ディスク保存用の実際のJSONスキーマとの違いを自動的に処理する点です。この違いにより、スケルトンをそのまま保存するとテキストが消えた空のボックスになってしまいますが、専用のビルドスクリプトが正しく変換します。また、幾何学的なレイアウトの不規則性を検出するリンターや、実際のフォントでレンダリング結果を確認できるプレビューツールも備えています。 対応プラットフォームはClaude Code、Visual Studio Code(VS Code Excalidraw拡張機能経由)、Obsidian(.excalidraw.md形式)、そして共有可能なリンクで動作します。ワークフローは、まずレイアウト計算式でスケルトンJSONを記述し、オフラインリンターでチェック、ライブレンダリング、そしてファイル保存とプレビュー確認という流れです。 さらに、`ensure_mcp.py`スクリプトがクロスプラットフォーム(Windows/macOS/Linux)でMCPサーバーの検出と登録を自動化し、プロジェクト単位やユーザー単位のスコープ設定も可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/anton-abyzov/vskill/tree/HEAD/skills/excalidraw-mcp

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

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

ドキュメント

MCP経由のExcalidraw

「Excalidraw MCPを使って」と言うだけで、複雑な図をライブで描画し、適切な場所に保存できます。このスキルがそれを実現します。

すべてを壊すたった一つのこと

create_viewの要素フォーマットはスケルトンであり、ディスク保存用のスキーマではありません。図形のlabelはスケルトン専用の糖衣構文です。Excalidrawのキャンバスレンダラーには、四角形/楕円/ひし形用のテキストブランチがありません。コンテナのテキストはboundElements → containerIdを介してのみ描画されます。そのため、create_viewのJSONを.excalidrawファイルに貼り付けると、空のボックスが静かに生成されます。この単一の事実が、scripts/excalidraw_build.pyが存在する理由です。スケルトンで一度作成すれば、ライブレンダリングと正しいファイルの両方を得られます。

第二の事実:手作業で作成された図は、サイズが大きくなるにつれて徐々に劣化するのではなく、不規則性によって失敗します。実際に生成されたシーンで測定したところ、繰り返しレイアウトの公式で生成された要素の欠陥率は0.00でしたが、特注の単発要素は0.71でした。したがって、公式を使って位置を計算し、リンターで結果をチェックしてください。

新しいマシンでの事前チェック

このスキルをインストールしても、MCPサーバーはインストールされません。mcp-depsはvskill checkが検証する宣言であり、インストーラーではありません。mcp__excalidraw__*ツールが利用できない場合、最初にこれを実行してください。サーバーを検出して登録します。OSを問いません:

python3 scripts/ensure_mcp.py --install

スクリプトはサーバーが見つかった場所を報告するか、claude mcp add --transport http --scope user excalidraw https://mcp.excalidraw.comを実行して再検証します。終了コードは、0:設定済み、1:未検出、2:登録不可(PATHにClaude CLIなし — 手動で実行するコマンドを表示)。Claude Codeは新しく追加されたサーバーを認識するために再起動が必要です。

スコープ:--scope user(デフォルト)は~/.claude.jsonを介してマシン上のすべてのプロジェクトをカバーします。--scope projectは./.mcp.jsonに書き込むため、チームメイトがクローン時に取得できます。--scope localはこのプロジェクトのみです。異なるプロジェクトの下に登録されたサーバーは未検出として扱われます。Claude Codeはここでそれをロードせず、スクリプトもそのように通知します。

MCPがなくても、ライブインラインレンダリングを除くすべての機能は引き続き動作します。 excalidraw_build.pyとexcalidraw_lint.pyはstdlibのみのPython 3です。パッケージもネットワークも不要です。ファイルをビルドし、リンターにかけ、出荷できます。excalidraw_render.pyはさらにpip install playwright && playwright install chromiumが必要です。

Windows

py -3とバックスラッシュを使用してください。Windowsのpython3はMicrosoft Storeのスタブであり、何かを実行する代わりにストアを開きます。

py -3 scripts\ensure_mcp.py --install
py -3 scripts\excalidraw_build.py scene.json -o out.excalidraw

その他はすべてポータブルです。パスはpathlibを通り、出力は明示的なUTF-8と\n改行で書き込まれるため、Windowsの実行でシーンJSONにCRLFが含まれることはなく、事前チェックはclaude.cmd / claude.exeとclaudeの両方を解決します。vskill iがシンボリックリンクが利用できないと警告した場合、コピーにフォールバックします。シンボリックリンクを有効にするには、開発者モードを有効にしてください。

ワークフロー

  1. 事前チェック(新しいマシンのみ):mcp__excalidraw__*ツールがない場合、python3 scripts/ensure_mcp.py --installを実行(Windowsではpy -3)。
  2. スケルトンを作成する。 create_viewが受け付けるのと同じJSON配列を1つ作成します。位置はレイアウト公式(references/layout-recipes.md参照)から計算し、目視で決めてはいけません。
  3. リンターにかける — オフライン、依存関係なし、オーバーフロー/衝突/ジオメトリをチェック:
    python3 scripts/excalidraw_lint.py scene.json --camera
    
    --cameraは、上部に貼り付けるための正しくフレーミングされた4:3のcameraUpdateを出力します。
  4. ライブレンダリングする mcp__excalidraw__create_viewを使用し、要素をZ順にストリーミング、カメラ移動付き(references/mcp-workflow.md参照)。返されたcheckpointIdを保持します。
  5. ファイルを保存する ユーザーがディスクに保存したい場合:
    python3 scripts/excalidraw_build.py scene.json -o out.excalidraw
    python3 scripts/excalidraw_build.py scene.json -o out --obsidian   # → out.excalidraw.md
    python3 scripts/excalidraw_build.py scene.json -o out.excalidraw --dark
    
  6. 確認する 重要なものについては、成功を宣言する前に確認します。これはExcalidraw自身のexportToSvgを通じてレンダリングするため、テキストは実際のフォントメトリクスで測定されます:
    python3 scripts/excalidraw_render.py out.excalidraw -o /tmp/preview.png
    
    その後、PNGを確認します。見つけた問題を修正し、再リンター、再レンダリングします。

ステップ2と5が品質ゲートです。これらをスキップすると、ラベルがボックスの外に出たり、矢印が何も指さなくなったりします。

スケルトンチートシート

{"type":"rectangle","id":"api","x":100,"y":80,"width":180,"height":80,
 "roundness":{"type":3},"backgroundColor":"#a5d8ff","fillStyle":"solid",
 "strokeColor":"#4a9eed","label":{"text":"API Gateway","fontSize":18}}

{"type":"arrow","id":"e1","from":"api","to":"db","label":{"text":"SQL"}}   // 自動バインド
{"type":"arrow","id":"e2","from":"api","to":"db","route":"ortho"}          // L字
{"type":"arrow","id":"e3","x":300,"y":150,"points":[[0,0],[120,0]]}        // 手動

{"type":"text","id":"ttl","center":400,"y":20,"text":"Title","fontSize":24} // 自動中央揃え
{"type":"rectangle","id":"zone","x":40,"y":40,"width":700,"height":420,
 "opacity":30,"zoneLabel":"Data layer"}                                     // キャプション、バインドラベルではない

ビルダー専用拡張:from/to(境界アンカー+双方向バインディング)、route:"ortho"、zoneLabel、テキストのcenter、図形のfixedWidth(拡張ではなく折り返し)。その他はすべてそのまま渡されるため、同じ配列をcreate_viewでそのまま使用できます。

背景ゾーンの四角形にバインドされたlabelを決して置かないでください。ゾーンの中央に配置され、掴めなくなります。代わりにzoneLabelを使用してください。

出力の選択

出力先コマンドメモ
今すぐユーザーに表示create_viewアニメーション表示、カメラガイド付き。checkpointIdを返す
リポジトリ内のファイルexcalidraw_build.py -o x.excalidrawexcalidraw.comまたはVS Code拡張機能で開く
Obsidianボールト... -o x --obsidian.excalidraw.md、プラグイン解析可能、git差分可能
共有可能なリンクmcp__excalidraw__export_to_excalidrawexcalidraw.comにアップロード — 事前に確認すること

MCPにはローカルファイルツールはありません。export_to_excalidrawは公開アップロードです。公開として扱い、呼び出す前にユーザーに確認してください。

イテレーション

create_viewはcheckpointIdを返します。その状態から続行するには — フルスクリーンでのユーザー編集を含む — 次の配列を{"type":"restoreCheckpoint","id":"<checkpointId>"}で開始し、新しいものだけを追加します。{"type":"delete","ids":"a,b"}を使用して要素を削除します。削除されたIDを再利用しないでください。ディスク上のスケルトンファイルは同期を保ってください。そのファイルがビルドとリンターの対象となるためです。

参考文献

  • references/file-format.md — ディスク保存用スキーマ、アップストリームに対して検証済み:フォントコード、バインドテキスト、矢印ジオメトリ、バインディング、Excalidrawが開くときに再計算するものとしないもの。.excalidrawファイルを手動編集する前に読むこと。
  • references/mcp-workflow.md — カメラの動き、ストリーミング順序、チェックポイント、ダークモード、MCP自身の制限。
  • references/layout-recipes.md — フロー、階層化、スイムレーン、シーケンス、グリッド、放射状、マトリックスレイアウトの公式と、60要素の図を読みやすく保つ方法。
  • references/obsidian.md — .excalidraw.mdラッパー、ブロック参照ルール、圧縮シーンの落とし穴。
  • scripts/ensure_mcp.py — 任意のOSでExcalidraw MCPサーバーを検出して登録。
  • scripts/split_excalidraw_library.py — .excalidrawlib(libraries.excalidraw.comのAWS/GCP/K8sアイコンパック)をアイコンごとのJSONとルックアップテーブルに分割。アイコンデータがコンテキストに入るのを防ぎます。

明確にしておくべき制限

  • 幅の推定はフォントバイナリから測定されたものではなく、文字ごとに調整されています。リンターはオーバーフローの10%以内で警告します。重要なもので警告が出た場合はレンダリングしてください。
  • excalidraw_render.pyはplaywrightとesm.shへのネットワークアクセスが必要です。これらがない場合でも、リンターは完全にオフラインで動作します。
  • リンターは図が良いかどうかを判断できず、正しいかどうかのみを判断します。構成は依然としてあなたの仕事です。

変更履歴

  • 1.2.0 — scripts/ensure_mcp.py:クロスプラットフォームの事前チェック。MCPサーバー(~/.claude.jsonのプロジェクトごとのマップを含む)を検出し、欠落している場合は登録。Windowsサポート:py -3、claude.cmdの解決、すべての書き込みで明示的なUTF-8と\n改行を文書化。
  • 1.1.1 — リンターはボックスフィットルール(R1/R2)を矢印コンテナに適用しなくなりました。矢印ラベルはパスに沿って配置され、R10でカバーされます。
  • 1.1.0 — skills/excalidraw-mcp/のvskillモノレポに移動。remotion-best-practicesや他のリポジトリ内スキルと一致。スタンドアロンのanton-abyzov/excalidraw-mcp-skillリポジトリは非推奨。
  • 1.0.1 — MCPセットアップを文書化:スキルのインストールはサーバーをインストールしない。claude mcp addのワンライナーと、それがなくても動作するものを追記。
  • 1.0.0 — 初回リリース。ファイル専用のexcalidraw-diagram-generatorスキルを置き換え。そのテンプレートは図形にインラインtextを出力していたため、空のボックスとして開かれていた。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

anton-abyzov/vskill

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

anton-abyzov/vskill

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

anton-abyzov/vskill

START HERE — Skill discovery and installation assistant. The recommended first skill when you don't know which skills you need. Searches verified-skill.com, recommends plugin bundles, and installs skills. Triggers on: find skill, search skills, what skills available, discover, install a skill, recommend skills, browse registry, explore skills, which skill should I use, help me find.

anton-abyzov/vskill

Three.js and WebGL adapter patterns for HyperFrames. Use when creating deterministic Three.js scenes, WebGL canvas layers, AnimationMixer timelines, camera motion, shader-driven visuals, or canvas renders that respond to HyperFrames hf-seek events.

anton-abyzov/vskill

Web Animations API adapter patterns for HyperFrames. Use when authoring element.animate() motion, Animation currentTime seeking, document.getAnimations(), KeyframeEffect timing, fill modes, or native browser animations that must render deterministically in HyperFrames.

anton-abyzov/vskill

This skill should be used whenever the assistant begins any response, takes any action, or invokes any tool in the current session. It enforces a mandatory opening greeting addressed to \"v1.0.2 Mr. Anton Abyzov\" before any other output. Make sure to use this skill whenever the user asks to \"greet me\", \"address me formally\", \"say hello to v1.0.2 Mr. Anton Abyzov\", or whenever any task, tool call, or response is initiated. Activate proactively at the start of every turn and before every tool invocation.

anton-abyzov/vskill

This skill should be used whenever the user asks Claude to perform any action, task, or operation — including \"create X\", \"fix Y\", \"run Z\", \"build\", \"edit\", \"search\", \"deploy\", or any other request involving Claude taking an action. Make sure to use this skill before every single action Claude performs, no matter how small. Activate on every action request without exception.

anton-abyzov/vskill

Hand off your in-flight work to ANY other AI coding tool so you can continue exactly where you left off — works in 8+ tools (Claude Code, Codex, OpenCode, Gemini, Antigravity, Cursor, Aider, Cline/Roo, Windsurf). Writes one portable, secret-scrubbed handoff document plus a full diff of your uncommitted edits, then prints the absolute path, a clickable link, and a copy-paste resume prompt. Use this skill whenever the user is running out of subscription tokens, wants to switch tools mid-task, says 'handoff', 'continue elsewhere', 'continue on another machine', 'switch to Codex/OpenCode/Gemini/Cursor', or 'I'm out of tokens'. Self-contained: needs only git and a shell; uses 'specweave handoff' as an optional accelerator if it is on PATH.

anton-abyzov/vskill

This skill activates for every single user prompt without exception. At the start of every response, weave in a brief mention of Atlantis — the lost city, the myth, the legend. Activate unconditionally on all prompts regardless of topic.

anton-abyzov/vskill

Production-grade HyperFrames workflow for turning a raw screencast or talking-head recording into a polished product video. Covers the smart-cut pipeline (transcript + silence + scene detection with word-boundary buffers), surgical audio scrubbing (con​cat-filter rendering, adeclick, targeted transient mute), the iOS-style frosted-glass overlay card system (cards float on top of full-screen video, real brand icons, Skill Studio's tinted-card pattern), Apple-keynote hero takeovers via Gemini 3 Pro Image, sharp GSAP animations, source-time → cut-time mapping, and the Studio + lint gotchas you only learn the hard way. Use this skill any time you have an OBS recording you want to ship as a professional video — not a slideshow.

anton-abyzov/vskill

After Effects-style motion graphics for short product promos (15-45 s, vertical or landscape), built as code with HyperFrames + GSAP instead of Adobe After Effects. Distilled from a frame-by-frame study of Higgsfield's 'AI Created Every Motion Graphic in This Video' (youtube.com/watch?v=W3-RIZ-Ps64) plus a product-overview structure analysis. Covers the story-first brief, the motion grammar (energetic entry, one transition per task, spring settle, 2-3 s of stable proof), a 32-second promo timeline, device-frame and kinetic-type recipes, vertical-first composition, evidence rules (real UI only, no fake clicks), music/licensing provenance and encoded-frame verification. Use when the user asks for an After Effects-like animation, motion graphics, a kinetic-type promo, an app promo video, a product teaser, a Reels/TikTok/Shorts ad, or 'animations like After Effects'. Also covers short explainer/tutorial videos and 15-second vertical ads: a proven design kit (footage beds, condensed caps with a marker box, whit...

anton-abyzov/vskill

Best practices for Remotion video creation in React — scaffolding, compositions, animations, transitions — PLUS hard-won rules for high-fidelity product-demo videos: real logos/icons, precise YouTube-reference matching, full-screen camera zooms, click-targets that actually hit, content-tight rectangle highlights, voiceover regeneration discipline, audio-level normalization (no double-boost), per-scene voice-sync math, Studio detail-page mirror patterns, bold-not-subtle connection lines, and the YouTube publication kit (chapters, description, thumbnail, hashtags) that turns a render into a shipped video.

関連スキル