Communitygithub.com

hacimertgokhan/geomotion

シンプルな図形から手描き風のモーフィングラインアニメーション(ボイルインク、リソグラフ風塗りつぶし)を作成し、アニメーションSVG、Lottie JSON、HTML、または共有可能なリンクとしてエクスポートします。アニメーションアイコン、ローダー、イラスト、説明モーション、ロゴスティング、空の状態や成功アニメーション、「手描き」「スケッチ」「落書き」アニメーション、またはgeomotionがリクエストされたときに使用します。

geomotion とは?

geomotionは、JSON形式のスペック(各キーフレームが図形リストで構成される)を、手描き風のアニメーションに変換するツールです。同じ `id` を持つ図形はキーフレーム間でモーフィングし、線は常に「沸騰」するように(約12回/秒で再描画)動くため、まるで手でトレースしたような印象を与えます。MCPツール、CLI、またはPythonスクリプト経由で利用でき、MCP環境では `geomotion_guide`、`geomotion_get_preset`、`geomotion_render`、`geomotion_share_link` の各ツールが使用可能です。出力形式はアニメーションSVG、Lottie JSON、HTMLファイル、またはブラウザ上で編集・エクスポート可能なプレイヤーリンクです。デザインルールとして、1200×1200のキャンバス、適切なマージン、各ポーズに2〜5個の太い図形、インク色の輪郭と1〜2色のアクセント塗りつぶしが推奨されており、プリセットカタログにはローダー、スピナー、成功/エラー、トグル、ベル、検索などのインターフェース要素や、自然、コミュニケーション、アイデア、キャラクター、抽象モーションなど幅広いカテゴリが用意されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hacimertgokhan/geomotion/tree/HEAD/skills/geomotion

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

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

ドキュメント

geomotion は何をしますか?

gcomotionは、JSON スペック(各キーフレームが図形のリスト)を手描き風のアニメーションに変換します。 同じ id を持つ図形はキーフレーム間でモーフィングし、線は常に「沸騰」するように(約12回/秒で再描画)動くため、結果はまるで手でトレースしたような印象を与えます。

サイト&スタジオ:https://hacimertgokhan.github.io/geomotion · リポジトリ:https://github.com/hacimertgokhan/geomotion

ワークフロー

  1. ルートを選択(利用可能なものを優先):
    • MCPツール(geomotion_guide、geomotion_get_preset、geomotion_render、geomotion_share_link):最初に geomotion_guide を呼び出し、その後レンダリングします。
    • CLI(Node 18以上、ネットワーク接続必須):npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html
    • ツールなし:スペックを作成し、python scripts/link.py spec.json(このスキルフォルダ内)を実行すると、ユーザーが開いて編集・エクスポートできるプレイヤー/スタジオリンクが生成されます。
  2. 近いプリセットから開始(以下のカタログを参照)、id、位置、色を調整します。
  3. 以下のルールに従ってスペックを記述します。バリデーションを行います(MCPでは geomotion_validate、CLIでは geomotion check spec.json)。
  4. 納品:ファイルパスまたはプレイヤーリンクを提示します。ユーザーが調整できるようにスタジオリンクも記載します。アニメーションがウェブサイト上に配置される場合は、透過バージョン(transparent: true または "both")を提案します。

スペックの基本

{
  "name": "idea",
  "size": [1200, 1200],
  "fps": 24, "boil": 12, "loop": true,
  "background": "ivory",
  "hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
  "style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
  "keyframes": [
    { "shapes": [ { "id": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "oat" } ] },
    { "hold": 1.2, "shapes": [
      { "id": "bulb", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sun" },
      { "id": "ray", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
    ] }
  ]
}
  • キーフレーム:hold(表示秒数)、duration(次のキーフレームへのモーフ時間)、ease。
  • 図形タイプ:circle {cx,cy,r}、ellipse {cx,cy,rx,ry}、rect {x,y,w,h,radius?} または {cx,cy,w,h}、 line {from,to}、polyline {points,closed?}、polygon {points}、regular {cx,cy,r,sides}、 triangle {cx,cy,r}、star {cx,cy,r,inner?,points?}、heart {cx,cy,size}、blob {cx,cy,r,seed?}、 crescent {cx,cy,r,thickness?,angle?}、wave {from,to,amplitude?,waves?,phase?}、spiral {cx,cy,r,turns?}、 arc {cx,cy,r,start,end}(度単位、0=右、時計回り)、path {d}(任意のSVGパス)。
  • 図形オプション:id(キーフレーム間で一致させる — 常に設定)、fill、stroke(色または false)、 width、opacity、enter/exit(grow | pop | draw | fade | cut)、delay(0〜0.95、連続)、 ease、transform {translate, rotate, scale, origin}、misregister: false(小さな塗りつぶしドット用)。
  • パレット名:ink、slate、ivory、paper、oat、kraft、clay、coral、fig、sky、cactus、olive、heather、sun、white(または任意の16進数カラーコード)。
  • イージング:linear、in/out/inOut Quad·Cubic·Sine、inOutQuart、outExpo、inOutExpo、outBack、inOutBack、outElastic、outBounce。

見栄えを良くするデザインルール

  1. 1200×1200のキャンバス、約120pxのマージン、ポーズごとに2〜5個の太い図形。細かいディテールは読みづらくなります。
  2. すべての輪郭にインク色、ポーズごとに1つまたは2つのアクセント塗りつぶし(oat、clay、sun、sky、cactus、coral)。
  3. idを使ってストーリーを語る:同じ要素が変形する(sun → moon、envelope → paper plane、dot → heart)。
  4. delay を 0 / 0.15 / 0.3 でずらし、線には "enter": "draw"(書いているように感じさせる)、遊び心のある登場には "pop" を使用。
  5. ホールドは0.5〜1.2秒、モーフは0.5〜1.2秒。inOutCubic は落ち着いた印象、inOutBack/outBack は遊び心、outElastic はゼリーのような動き。
  6. 2つのキーフレーム間で30°を超える回転は線が角を落とす原因になります — 大きな回転は複数のキーフレームに分割します(spinner、gears、orbit プリセットを参照)。
  7. 塗りつぶしドット(目、タイピングドット):"stroke": false, "fill": "ink", "misregister": false。

プリセットカタログ(開始点)

  • インターフェース:loader、spinner、success、error、toggle、bell、search
  • 自然:sunrise、sprout、rain、night、sea
  • コミュニケーション:chat、send、like、connect
  • アイデア:idea、growth、target、gears、house
  • キャラクター:smile、ghost、sparkle
  • 抽象:drift、orbit、kaleido、pebbles
  • モーション:bounce、pendulum、jelly

任意のプリセットは直接開けます:https://hacimertgokhan.github.io/geomotion/play/#preset=<name> (透過背景の場合は &bg=0 を追加)またはスタジオ:/studio/#preset=<name>。

Webサイトへの埋め込み

<script type="module" src="https://hacimertgokhan.github.io/geomotion/src/embed.js"></script>
<geo-motion preset="success" transparent style="width:160px"></geo-motion>
<geo-motion code="z…"></geo-motion>   <!-- 共有リンクの #s=… の部分 -->

関連スキル