Communitygithub.com

geomotion

간단한 도형으로 손으로 그린 듯한 모핑 선 애니메이션(잉크 끓는 효과, 리소 스타일 채움)을 만들고, 애니메이션 SVG, Lottie JSON, HTML 또는 공유 링크로 내보냅니다. 사용자가 애니메이션 아이콘, 로더, 일러스트레이션, 설명 모션, 로고 스팅, 빈 상태(empty-state) 또는 성공 애니메이션, '손그림'/'스케치'/'낙서' 애니메이션을 원하거나 geomotion을 요청할 때 사용합니다.

geomotion란 무엇인가요?

geomotion은 JSON **스펙**(키프레임 목록, 각 키프레임은 도형 목록)을 기반으로 손으로 그린 듯한 애니메이션을 생성합니다. 같은 `id`를 가진 도형은 키프레임 간에 서로 모핑되며, 선은 초당 약 12회 '끓는(boiling)' 효과(재잉크)를 유지하여 손으로 그린 듯한 촉감을 줍니다. 이 스킬은 개발자, 디자이너, AI 에이전트 사용자가 아이콘, 로더, 일러스트레이션, 로고 모션, 빈 상태(empty-state) 애니메이션 등에 사용할 수 있는 독특한 '손그림' 느낌의 모션을 빠르게 프로토타이핑하고 내보낼 때 유용합니다. MCP 도구, CLI(`npx -y github:hacimertgokhan/geomotion`), 또는 Python 스크립트를 통해 배포 없이도 사용할 수 있습니다. 핵심은 간단한 원, 사각형, 선, 다각형, 패스 등의 도형을 JSON으로 정의하고, 각 도형에 `id`를 부여해 키프레임 간 모핑을 지정하는 것입니다. 색상 팔레트, 이징(easing), 엔터/종료 효과, 변형(transform) 등 풍부한 옵션을 제공합니다. 최종적으로 애니메이션 SVG, Lottie JSON, HTML 파일 또는 플레이어/스튜디오 공유 링크로 결과물을 전달할 수 있으며, `<geo-motion>` 웹 컴포넌트로 웹사이트에 손쉽게 임베드할 수 있습니다. 시작점으로 사용할 수 있는 다양한 프리셋(loader, spinner, success, error, toggle, bell, search 등)이 마련되어 있어, 빠르게 원하는 애니메이션에 가깝게 커스터마이징할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hacimertgokhan/geomotion/tree/HEAD/skills/geomotion

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

geomotion은(는) 무엇을 하나요?

geomotion은 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 또는 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. 모든 외곽선은 ink, 포즈당 하나 또는 두 개의 악센트 채움색(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. 두 키프레임 사이의 회전이 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>.

웹사이트에 임베드하기

<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=… 부분 -->

관련 스킬