Communitygithub.com

hacimertgokhan/geomotion

Erstellen Sie handgezeichnete, sich verwandelnde Linienanimationen (kochende Tinte, Riso-ähnliche Füllungen) aus einfachen Formen und exportieren Sie sie als animierte SVG, Lottie JSON, HTML oder teilbare Links. Verwenden Sie dies, wenn der Benutzer ein animiertes Icon, einen Ladebalken, eine Illustration, eine Erklärbewegung, ein Logo-Intro, einen Leerzustand oder eine Erfolgsanimation, eine „handgezeichnete“ / „skizzenhafte“ / „doodle“ Animation wünscht oder nach geomotion fragt.

Was ist geomotion?

geomotion ist ein Tool, das aus einer JSON-Spezifikation handgezeichnete Animationen erzeugt. Die Spezifikation besteht aus einer Liste von Keyframes, die wiederum eine Liste von Formen enthalten. Formen mit derselben ID verwandeln sich (morphen) zwischen den Keyframes ineinander, während Linien durch ein „Boiling“-Verfahren (ca. 12×/s neu gezeichnet) stets den Eindruck erwecken, von Hand gezeichnet zu sein. Das Tool unterstützt verschiedene Plattformen und Ausgabeformate: Es kann über MCP-Tools (geomotion_guide, geomotion_render, geomotion_share_link), ein CLI (`npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html`) oder direkt über einen Player-Link (studio/play) genutzt werden. Die erzeugten Animationen können als SVG, Lottie JSON, HTML exportiert oder als direkter, teilbarer Link bereitgestellt werden. geomotion eignet sich besonders für animierte Icons, Ladebalken, Illustrationen, Erklärvideos, Logo-Intros, Leerzustands- oder Erfolgsanimationen und alle Arten von „handgezeichneten“ oder „skizzenhaften“ Animationen. Es bietet eine umfangreiche Palette an Formtypen (Kreise, Ellipsen, Rechtecke, Linien, Polygone, Sterne, Herzen, Blobs, Wellen, Spiralen, Bögen, SVG-Pfade) und eine breite Auswahl an Farben, Easing-Funktionen und Übergangseffekten (grow, pop, draw, fade, cut). Die Spezifikation ist einfach und flexibel gehalten, sodass sowohl einfache als auch komplexe Animationen schnell erstellt werden können. Die Integration in Webseiten erfolgt über ein HTML-Custom-Element `<geo-motion>`, das sowohl Presets als auch codierte Animationen unterstützt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht geomotion?

geomotion wandelt eine JSON-Spezifikation – eine Liste von Keyframes, die jeweils eine Liste von Formen enthalten – in eine handgezeichnete Animation um. Formen mit derselben id verwandeln sich (morphen) zwischen den Keyframes ineinander; Linien bleiben „kochend“ (ca. 12×/s neu gezeichnet), sodass das Ergebnis wie von Hand gezeichnet wirkt.

Website & Studio: https://hacimertgokhan.github.io/geomotion · Repository: https://github.com/hacimertgokhan/geomotion

Arbeitsablauf

  1. Wählen Sie einen Weg (verwenden Sie den ersten verfügbaren):
    • MCP-Tools (geomotion_guide, geomotion_get_preset, geomotion_render, geomotion_share_link): Rufen Sie geomotion_guide einmal auf, dann rendern.
    • CLI (Node 18+ mit Netzwerk): npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html
    • Ohne Werkzeuge: Schreiben Sie die Spezifikation, führen Sie dann python scripts/link.py spec.json (in diesem Skill-Ordner) aus, um einen Player-/Studio-Link zu erhalten, den der Benutzer öffnen, bearbeiten und exportieren kann.
  2. Beginnen Sie mit einem Preset, wenn es in der Nähe ist (siehe Katalog unten) und passen Sie IDs, Positionen, Farben an.
  3. Schreiben Sie die Spezifikation gemäß den folgenden Regeln. Validieren Sie (MCP geomotion_validate oder geomotion check spec.json).
  4. Liefern Sie ab: Dateipfade und/oder den Player-Link. Erwähnen Sie den Studio-Link, damit der Benutzer ihn anpassen kann. Bieten Sie eine transparente Version an (transparent: true oder "both"), wenn die Animation auf einer Website platziert wird.

Spezifikations-Grundlagen

{
  "name": "idee",
  "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": "glühbirne", "type": "circle", "cx": 600, "cy": 520, "r": 220, "fill": "oat" } ] },
    { "hold": 1.2, "shapes": [
      { "id": "glühbirne", "type": "circle", "cx": 600, "cy": 520, "r": 240, "fill": "sun" },
      { "id": "strahl", "type": "line", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
    ] }
  ]
}
  • Keyframe: hold (Anzeigedauer in Sekunden), duration (Morph-Zeit zum nächsten Keyframe), ease.
  • Formtypen: circle {cx,cy,r}, ellipse {cx,cy,rx,ry}, rect {x,y,w,h,radius?} oder {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} (Grad, 0 = rechts, im Uhrzeigersinn), path {d} (beliebiger SVG-Pfad).
  • Formoptionen: id (für Keyframes abgleichen – immer setzen), fill, stroke (Farbe oder false), width, opacity, enter/exit (grow | pop | draw | fade | cut), delay (0–0.95, Staffelung), ease, transform {translate, rotate, scale, origin}, misregister: false für kleine Vollkreise.
  • Palettennamen: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (oder beliebiger Hex-Code).
  • Easing-Funktionen: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.

Designregeln für ein gutes Aussehen

  1. 1200×1200 Leinwand, ca. 120 px Rand, 2–5 fette Formen pro Pose. Kleine Details wirken schlecht.
  2. Ink für jede Kontur, ein oder zwei Akzentfüllungen pro Pose (oat, clay, sun, sky, cactus, coral).
  3. Erzählen Sie eine Geschichte durch IDs: dasselbe Element verwandelt sich (Sonne → Mond, Umschlag → Papierflieger, Punkt → Herz).
  4. Staffeln mit delay 0 / 0.15 / 0.3; verwenden Sie "enter": "draw" für Linien, die wie geschrieben wirken sollen, "pop" für verspielte Ankünfte.
  5. Halten 0.5–1.2 s, Morph 0.5–1.2 s. inOutCubic = ruhig, inOutBack/outBack = verspielt, outElastic = wackelig.
  6. Drehungen > 30° zwischen zwei Keyframes führen zu abgeschnittenen Ecken – teilen Sie große Drehungen in mehrere Keyframes auf (siehe die Presets spinner, gears, orbit).
  7. Solide Punkte (Augen, Tipp-Punkte): "stroke": false, "fill": "ink", "misregister": false.

Preset-Katalog (Startpunkte)

  • Benutzeroberfläche: loader, spinner, success, error, toggle, bell, search
  • Natur: sunrise, sprout, rain, night, sea
  • Kommunikation: chat, send, like, connect
  • Ideen: idea, growth, target, gears, house
  • Charaktere: smile, ghost, sparkle
  • Abstrakt: drift, orbit, kaleido, pebbles
  • Bewegung: bounce, pendulum, jelly

Jedes Preset kann direkt geöffnet werden: https://hacimertgokhan.github.io/geomotion/play/#preset=<name> (fügen Sie &bg=0 für einen transparenten Hintergrund hinzu) oder im Studio: /studio/#preset=<name>.

Einbettung in eine Website

<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>   <!-- der #s=…-Teil eines Share-Links -->

Verwandte Skills