Communitygithub.com

Gertie

小さなシーンファイルからチェック済みのLottie JSONとアニメーションSVG、さらにGIF、動画、複数シーンのフィルム(字幕・音楽付き)を生成します。アイコン、ローダー、ロゴスティング、ステッカー、短いループ向け。ブラウザでレンダリングし、フレームごとに出力を比較し、QAに合格しないシーンは引き渡しません。

Gertie とは?

Gertieは、開発者が記述する小さなシーンファイル(.gertie.json)をコンパイルし、Lottie JSONとアニメーションSVGという2つのベクター出力を生成するスキルです。さらに、GIF、APNG、WebP、WebM、ProRes、HEVC、MP4などのラスター形式へのエクスポートや、複数シーンの動画(字幕・トランジション・音楽付き)の構築、ASCIIテキストアニメーションにも対応しています。最大の特徴は、QAコマンド(`node scripts/gertie.mjs qa`)がブラウザ上でLottieとSVGをそれぞれレンダリングし、フレームごとにピクセル単位で比較してパリティをチェックする点です。エラーや警告(ループのジャンプ、はみ出し、同期の問題など)があればコードと修正方法が示され、ゼロエラーになるまで自動チェックを繰り返します。Claude Code、Cursor、CodexなどのAIエージェントが品質を担保しながらアニメーションを生成したい場合に最適で、品質レベル(icon/character/scene)に基づくプロファイリング機能も備えています。

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

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

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

ドキュメント

Gertie は何をしますか?

Gertieは、あなたが書いた小さなシーンファイルを完成したアニメーションに変換します。出力は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を読んでください。シーンごとに1ファイル書き、その後.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は1つのグループの3つ以上の子が同じループを同調して実行していることを意味し、機械的に見えます:グループにphase付きのstaggerを与えるか、各エントリに独自のphaseを与えてください。E-R-PARITYはLottieとSVGが異なって見えることを意味し、2つの出力のうち1つが間違っています:フレーム、ノード、差分画像(outputs.parity)を特定します。そのノードのアニメーションを単純化して原因を見つけ、それがGertieのバグである場合はユーザーに伝えてください。

  5. 目視確認する。 outputs.sheetで指定されたコンタクトシート画像を開きます。8フレームが順番に表示され、各フレームにはフレーム番号と時間がラベル付けされ、透明部分がわかるようにチェッカーボード上に描画されています。正しいものが存在するか、色が正しいか、フレーム間の動きが理にかなっているか、何も切れたり重なったりしていないかを確認します。正しくない場合はシーンを編集してステップ3に戻ります。目視修正は3ラウンドで停止します。タイミングのデバッグ時には--sheet-frames 16を使用して詳細を確認してください。

  6. 品質基準に対して測定する 簡単なアイコンを超えるものの場合。シーンのトップレベル`

関連スキル