Communitygithub.com

hacimertgokhan/geomotion

Crea animaciones dibujadas a mano y en ebullición a partir de formas simples, exportables como SVG animado, Lottie JSON, HTML o enlaces compartibles.

¿Qué es geomotion?

geomotion es una herramienta experta en animación que transforma especificaciones JSON (keyframes con listas de formas) en animaciones con estilo dibujado a mano, perfectas para iconos animados, cargadores, ilustraciones en movimiento, logotipos animados, estados vacíos o de éxito, y animaciones tipo boceto. Su principal característica es el efecto "boiling" (re-ink ~12 veces por segundo) que hace que las líneas parezcan trazadas a mano, y el morphing suave entre formas con el mismo `id` en diferentes keyframes. Soporta múltiples formas geométricas (círculos, rectángulos, líneas, polilíneas, estrellas, blobs, espirales, arcos, paths SVG) y ofrece opciones de entrada/salida como `draw`, `pop`, `fade`, `grow` y `cut`, además de paletas de colores predefinidas y easings. La herramienta se puede usar a través de herramientas MCP (guiado, presets, renderizado, enlaces compartidos), línea de comandos (CLI) con Node 18+, o directamente escribiendo el spec y generando un enlace al reproductor/estudio. Los usuarios pueden comenzar desde una amplia galería de presets (interfaz, naturaleza, comunicación, ideas, personajes, abstractos, movimiento) y personalizarlos. Las animaciones se pueden exportar en múltiples formatos (SVG, Lottie, HTML) o compartir mediante enlace, y se pueden incrustar fácilmente en sitios web mediante un componente web personalizado.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace geomotion?

gemotion convierte un spec JSON (una lista de keyframes, cada uno con una lista de formas) en una animación dibujada a mano. Las formas con el mismo id se transforman entre keyframes; las líneas mantienen un efecto de "ebullición" (re-ink ~12×/s), dando la sensación de estar trazadas a mano.

Sitio y estudio: https://hacimertgokhan.github.io/geomotion · Repo: https://github.com/hacimertgokhan/geomotion

Flujo de trabajo

  1. Elige una ruta (usa la primera disponible):
    • Herramientas MCP (geomotion_guide, geomotion_get_preset, geomotion_render, geomotion_share_link): llama a geomotion_guide una vez, luego renderiza.
    • CLI (Node 18+ con red): npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html
    • Sin herramientas: escribe el spec, luego ejecuta python scripts/link.py spec.json (en esta carpeta de skill) para obtener un enlace al reproductor/studio que el usuario puede abrir, editar y exportar.
  2. Empieza desde un preset cuando uno se acerque (ver catálogo abajo) y adapta ids, posiciones, colores.
  3. Escribe el spec siguiendo las reglas de abajo. Valida (MCP geomotion_validate o geomotion check spec.json).
  4. Entrega: rutas de archivo y/o el enlace del reproductor. Menciona el enlace del estudio para que puedan ajustarlo. Ofrece una versión transparente (transparent: true o "both") si la animación irá en un sitio web.

Elementos esenciales del spec

{
  "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 }
    ] }
  ]
}
  • Keyframe: hold (segundos que se muestra), duration (morph al siguiente keyframe), ease.
  • Tipos de forma: circle {cx,cy,r}, ellipse {cx,cy,rx,ry}, rect {x,y,w,h,radius?} o {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} (grados, 0 = derecha, sentido horario), path {d} (cualquier path SVG).
  • Opciones de forma: id (coincide entre keyframes —siempre establecerlo), fill, stroke (color o false), width, opacity, enter/exit (grow | pop | draw | fade | cut), delay (0–0.95, escalonado), ease, transform {translate, rotate, scale, origin}, misregister: false para puntos sólidos pequeños.
  • Nombres de paleta: ink, slate, ivory, paper, oat, kraft, clay, coral, fig, sky, cactus, olive, heather, sun, white (o cualquier hex).
  • Easings: linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.

Reglas de diseño para que se vea bien

  1. Lienzo de 1200×1200, margen ~120 px, 2–5 formas en negrita por pose. Los detalles pequeños se ven mal.
  2. Tinta para todos los contornos, uno o dos colores de relleno de acento por pose (oat, clay, sun, sky, cactus, coral).
  3. Cuenta una historia a través de los ids: el mismo elemento se transforma (sun → moon, envelope → paper plane, dot → heart).
  4. Escalona con delay 0 / 0.15 / 0.3; usa "enter": "draw" para líneas que deban sentirse escritas, "pop" para llegadas divertidas.
  5. Holds 0.5–1.2 s, morphs 0.5–1.2 s. inOutCubic = tranquilo, inOutBack/outBack = divertido, outElastic = gelatinoso.
  6. Rotaciones > 30° entre dos keyframes hacen que las líneas corten esquinas — divide rotaciones grandes en varios keyframes (ver los presets spinner, gears, orbit).
  7. Puntos sólidos (ojos, puntos de escritura): "stroke": false, "fill": "ink", "misregister": false.

Catálogo de presets (puntos de partida)

  • interfaz: loader, spinner, success, error, toggle, bell, search
  • naturaleza: sunrise, sprout, rain, night, sea
  • comunicación: chat, send, like, connect
  • ideas: idea, growth, target, gears, house
  • personajes: smile, ghost, sparkle
  • abstracto: drift, orbit, kaleido, pebbles
  • movimiento: bounce, pendulum, jelly

Cualquier preset se abre directamente: https://hacimertgokhan.github.io/geomotion/play/#preset=<nombre> (añade &bg=0 para fondo transparente) o en el estudio: /studio/#preset=<nombre>.

Incrustar en un sitio 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>   <!-- la parte #s=… de un enlace compartido -->

Skills relacionados