Communitygithub.com

Gertie

작은 씬 파일을 작성하여 Lottie JSON 및 애니메이션 SVG로 컴파일하고, GIF, 비디오, 다중 씬 필름(자막, 음악 포함)까지 제작합니다. 아이콘, 로더, 로고 스팅, 스티커, 짧은 루프에 사용됩니다. 브라우저에서 렌더링하고 프레임별로 출력을 비교하며, QA를 통과하지 못한 씬은 전달하지 않습니다.

Gertie란 무엇인가요?

Gertie는 사용자가 작성한 작은 씬 파일을 Lottie JSON 및 애니메이션 SVG 형식의 완성된 애니메이션으로 변환하는 AI 에이전트 스킬입니다. 이 스킬은 씬 작성, 컴파일, 유효성 검사, 품질 관리(QA)를 모두 처리하며, GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 등 다양한 형식으로 내보내기를 지원하고, Telegram, Discord, Slack, WhatsApp 같은 플랫폼에 맞춰 제한 사항을 고려한 내보내기도 가능합니다. 또한 여러 씬을 자막, 전환 효과, 배경 음악과 함께 하나의 비디오로 구성하거나 ASCII 텍스트 애니메이션을 제작할 수 있습니다. Gertie는 브라우저 기반 렌더링을 통해 Lottie와 SVG 출력을 프레임별로 비교하고, 품질 검사(프로파일링)를 통해 경로, 색상, 키프레임, 이징 등의 지표를 측정하여 설정된 품질 등급(아이콘, 캐릭터, 씬)을 충족하는지 확인합니다. QA 과정에서 단 하나의 오류라도 발견되면 결과물을 전달하지 않으며, 오류 수정을 위한 구체적인 코드, 경로, 메시지, 수정 방법을 제공합니다. Claude Code, Cursor, Codex 등의 AI 코딩 도구에서 사용할 수 있으며, Node.js 환경과 브라우저, ffmpeg가 필요할 수 있습니다.

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

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

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

문서

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

Gertie는 사용자가 작성한 작은 씬(scene) 파일을 완성된 애니메이션으로, Lottie JSON 및 애니메이션 SVG 형태로 변환합니다. 무엇을 그리고 어떻게 움직일지 사용자가 결정합니다. Gertie는 이를 컴파일, 확인 및 렌더링합니다.

이 버전은 씬 작성, 컴파일, 유효성 검사 및 품질 검사를 모두 다루며, 두 가지 출력 형식과 함께 GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 및 .lottie 아카이브로 내보내거나, Telegram, Discord, Slack, WhatsApp 등 플랫폼의 제한에 맞춰 바로 내보낼 수 있습니다. 또한 스토리보드에서 자막, 전환 효과, 음악이 포함된 다중 씬 비디오를 제작하고, 텍스트 문자(ASCII) 애니메이션을 만들 수 있습니다. 내보내기 전에 references/export.md를, 비디오 제작 전에 references/video.md를, ASCII 애니메이션 제작 전에 references/ascii.md를 읽으십시오.

규칙

  1. Lottie JSON을 직접 작성하지 마십시오. 씬 파일을 작성하고 컴파일하십시오.
  2. qa를 통과하여 오류가 없는 결과물만 제시하십시오.
  3. 첫 번째 씬을 작성하기 전에 references/scene.md를 읽으십시오. 이를 건너뛰면 모델이 존재하지 않는 필드를 임의로 생성합니다.
  4. 사용자가 SVG를 제공한 경우, 다시 그리지 말고 임포트하십시오: references/import.md를 읽으십시오.
  5. 사용자가 Lottie 파일을 제공한 경우, references/lottie.md를 읽으십시오. 손으로 다시 작성하지 마십시오.
  6. 사용자가 PNG 또는 JPEG 로고, 아이콘 또는 평면 일러스트레이션을 제공한 경우, 트레이스하십시오: references/trace.md를 읽으십시오. 질감이 있는 그림이나 사진이며 사용자가 약간의 움직임(깜빡임, 고개 기울이기, 배경 떠다니기)을 원하는 경우, references/cutout.md를 읽으십시오.
  7. 사용자가 비디오나 GIF를 보여주며 "이렇게 움직이는 것"을 원하는 경우, references/motion-reference.md를 읽으십시오.
  8. 사용자가 여러 씬(인트로, 릴, 설명, 광고)으로 구성된 비디오에 자막, 전환 효과 또는 음악을 원하는 경우, references/video.md를 읽으십시오. 씬당 하나의 파일을 작성한 다음 .story.json을 작성하고 story 명령을 실행하십시오.
  9. 사용자가 ASCII 또는 텍스트 문자 애니메이션(README 배너, 터미널 로더, 레트로 스타일, 문자나 점으로 구성된 조밀하고 다채로운 클립)을 원하거나, 모방할 ASCII 클립을 보여주는 경우 references/ascii.md를 읽으십시오. 이는 자체 씬 파일(.ascii.json)과 명령어를 가진 별도의 엔진입니다. 단순한 주제: 텍스트 파일에 프레임을 작성하거나 생성하십시오. 조밀하거나 부드러운 것: 벡터 씬을 만들고 qa를 통과시킨 다음 레시피로 변환하십시오. 여러 움직이는 요소: 레이어를 사용하십시오. 클립을 모방하려면: ascii probe로 그리드와 색상을 확인하십시오. 큰 모양을 문자로 직접 그리지 마십시오.
  10. 몇 개의 도형 이상의 것(캐릭터, 일러스트레이션, 씬)을 그리기 전에, references/artwork.md를 읽으십시오: 빌드 순서, 곡선 경로, 음영, 팔레트, 캔버스 크기. 기본 도형이나 단색으로만 구성된 씬은 W-ART-PRIMITIVE 및 W-ART-FLAT 경고를 발생시킵니다.
  11. 단순한 회전이나 슬라이드를 넘어서는 키프레임을 작성하기 전에, 특히 캐릭터의 경우 references/motion.md를 읽으십시오. 수동 키프레임 대신 모션 프리셋과 리그 프리셋을 사용하십시오: 이들은 애니메이션에 이징, 예비 동작, 오버슈트, 스쿼시를 제공합니다.

워크플로우

  1. 요청을 이해하십시오. 주제, 움직임, 크기, 루프 여부를 결정하십시오. 누락된 답변이 결과를 바꿀 경우에만 질문하십시오. 그렇지 않으면 기본값(512x512 캔버스, 30fps, 2초, 루프, 투명 배경)을 사용하십시오.

  2. 씬 작성: <name>.gertie.json 파일로 작성하십시오. 사용자가 SVG를 제공한 경우 먼저 node scripts/gertie.mjs import <file.svg> --json을 실행하고 결과를 포함시키십시오(references/import.md 참조). 시간은 초 단위입니다. 나중에 작성된 노드가 이전 노드 위에 그려집니다. 적합한 경우 객체에 motion 프리셋을 적용하십시오. 캐릭터의 경우 리그를 구축하고 리그 프리셋을 사용하십시오(references/motion.md 참조).

  3. 확인: 이 스킬 폴더 안의 scripts/gertie.mjs 스크립트를 실행하십시오:

    node scripts/gertie.mjs qa <name>.gertie.json --json
    

    이 명령은 씬을 컴파일하고, 출력을 검증하며, 브라우저에서 샘플 프레임을 렌더링하고 렌더링 검사를 실행합니다. 파일은 씬 옆에 있는 out/ 폴더에 생성됩니다: <name>.lottie.json, <name>.svg, <name>.sheet.png. 검사는 Lottie와 SVG를 각각 렌더링하여 프레임별로 비교합니다.

  4. 모든 진단을 수정하십시오. 각 진단에는 code, 씬 내 path, message, fix가 포함됩니다. 수정 방법을 적용하고 씬을 편집한 후 qa를 다시 실행하십시오. 먼저 오류를 수정한 다음 경고를 읽으십시오. W-LOOP-JUMP 및 W-R-LOOP는 루프가 눈에 띄게 끊어짐을 의미합니다. W-R-CLIPPED는 캔버스 가장자리에서 무언가 잘렸음을 의미합니다. W-SYNC는 한 그룹의 세 개 이상의 자식이 동일한 루프를 동기화된 상태로 실행하여 기계적으로 보임을 의미합니다: 그룹에 phase가 있는 stagger를 주거나 각 항목에 자체 phase를 부여하십시오. E-R-PARITY는 Lottie와 SVG가 다르게 보여 두 출력 중 하나가 잘못되었음을 의미합니다: 프레임, 노드 및 차이 이미지(outputs.parity)를 명시합니다. 해당 노드의 애니메이션을 단순화하여 원인을 찾고, Gertie의 버그인 경우 사용자에게 알리십시오.

  5. 눈으로 확인하십시오. outputs.sheet에 명시된 접촉 시트(contact sheet) 이미지를 여십시오. 각 프레임 번호와 시간이 표시된 8개의 프레임이 체커보드 위에 그려져 투명도를 확인할 수 있습니다. 올바른 요소가 있는지, 색상이 올바른지, 프레임 간 움직임이 자연스러운지, 잘리거나 겹치는 부분이 없는지 확인하십시오. 올바르지 않으면 씬을 편집하고 3단계로 돌아가십시오. 시각적 수정은 최대 3회까지 수행하십시오. 타이밍 디버깅 시 더 자세히 보려면 --sheet-frames 16을 사용하십시오.

  6. 품질 기준 측정: 빠른 아이콘 이상을 만들 때는 씬의 최상위 `

관련 스킬