Communitygithub.com

video2dsprite (Grok Build 専用)

2Dキャラクター静止画から、より密度の高いアニメーションスプライトを生成します。imagine_text_to_imageでベース画像を作成→imagine_image_to_videoでモーション生成→ffmpegでフレーム抽出→マゼンタクロマキー処理→ストリップ/グリッド/GIFとして出力します。

video2dsprite (Grok Build 専用) とは?

このスキルは、Grok Build環境でのみ動作する「video2dsprite」です。ユーザーが提供する2Dキャラクターの静止画、またはimagine_text_to_imageで新規生成したベース画像を元に、imagine_image_to_videoでその場で走る・歩くなどのループモーションを生成します。生成された動画からffmpegとPillowを用いてフレームを抽出し、マゼンタ(#FF00FF)背景のクロマキー処理で透過化、指定されたフレーム数(デフォルト8, 16, 24, 48)で均等サンプリングし、水平ストリップ、グリッド、ループGIFとして出力します。主なユースケースは、より滑らかなラン/ウォークサイクルや中間ポーズの密な生成を求める場合で、`generate2dsprite`が提供するような crisp なピクセルシートとは異なり、ビデオ由来の密度と滑らかさが特徴です。Grok Build以外のランタイム(Codex, Claudeなど)では利用不可で、その場合は代替として`generate2dsprite`を推奨します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/video2dsprite

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

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

ドキュメント

video2dsprite (Grok Build 専用) は何をしますか?

ベースとなる2Dキャラクター画像から、Grok Build のネイティブ動画ツールを使用して高密度アニメーションスプライトに変換します。

App-builder / Grok 環境

アイテム値
スキルディレクトリ.grok/skills/video2dsprite/
スクリプトpython3 .grok/skills/video2dsprite/scripts/video2dsprite.py …
動画ツールimagine_image_to_video — 1つのベース file_path をアニメーション化(存在確認)
検査read_file でスチル/フレームを確認し、動画のパスを報告
依存関係ffmpeg + Pillow + numpy(app-builder イメージにプリインストール済み)
出力先/workspace 下の assets/sprites/video2dsprite/<name>/
デフォルトプロダクション向けの本格スプライトには generate2dsprite を推奨。本スキルは高密度モーションパス
ベース静止画 → imagine_image_to_video(その場モーション)→ フレーム抽出 → クロマキー → サンプリング/ノーマライズ → ストリップ / グリッド / GIF

プラットフォームゲート(最初に読んでください)

ランタイムサポート?
Grok Build (xAI)はい — 画像生成 + 画像→動画ツールが必要
Codex / Claude / その他エージェントいいえ — Grok の動画ツールがありません。このスキルは Grok Build 専用であることを伝え、代わりに $generate2dsprite を提案してください

厳密なツール名ではなく、機能でゲートを判断してください。 画像生成は imagine_text_to_image / imagine_image_to_image として、動画は imagine_image_to_video または(レガシー)generate_video として表示されます。ツールリストにある方の組み合わせを使用してください。画像→動画ツールがまったくない場合のみ、停止して説明してください。コードでフレームを描画してモーションを偽装しないでください。

このスキルはオプションの高密度モーションパスです。$generate2dsprite を置き換えるものではありません:

$generate2dsprite を使用する場合…$video2dsprite を使用する場合…
鮮明なピクセルシート、固定グリッド、アイデンティティが重要なキャラクターより密度の高い中間ポーズ / より滑らかなループを求める場合
攻撃/キャストボディシート、プロップパック、エンジンアトラス動画出力 → フレーム → スプライト を試したい場合
ほとんどのゲームスプライトのプロダクション標準ユーザーが明示的に動画 → フレーム → スプライトを要求した場合

動画はピクセルをソフトにし、アイデンティティをドリフトさせ、クロマフリンジを残します。常に品質確認を行い、プロダクション用キャラクターの場合は、ユーザーが動画ルックを希望しない限り、$generate2dsprite を優先してください。

パラメータ

ユーザーリクエストから推測:

  • subject: キャラクター/クリーチャーの説明、または既存の静止画へのパス
  • action: run | walk | idle | attack | カスタムモーションフレーズ
  • view: 通常 side(横スクロール)。topdown は困難です — 警告し、カメラを固定
  • duration: 6(デフォルト)または 10 秒
  • frame_counts: エクスポートする高密度セット、デフォルト 8,16,24,48
  • cell_size: 出力スプライトセル、デフォルト 128
  • anchor: feet(横方向移動のデフォルト) | center
  • bg: ソリッド #FF00FF(クロマキーに必須)
  • name: 出力スラグ
  • out_dir: 作業フォルダ(デフォルト ./sprites/video2dsprite/<name>/ またはプロジェクト相対)

エージェントルール

  1. Grok専用。 非Grokランタイムでは、簡単な説明 + $generate2dsprite 代替案を示して拒否する。
  2. 静止画→動画、テキスト→動画単独は不可。 フレーム1を imagine_text_to_image(プロンプトから、または参照 file_path から)でクリーンな静止画として準備する。その後、その静止画の file_path を使用して imagine_image_to_video を呼び出す。
  3. その場でのモーション。 ランニング/ウォーキングはその場で、固定方向を向いて行うようにプロンプトする。カメラパン、背景スクロール、シーンチェンジなし。被写体はおおよそ中央に留まる。
  4. ソリッドマゼンタ背景をベースに設定し、動画プロンプトでも保持する(#FF00FF / ピュアマゼンタ)。フラッドフィルクロマキーに必須。
  5. PIL/Canvasでアートをでっち上げない。 ベースアートは imagine_text_to_image またはユーザー/ローカルの静止画から。スクリプトは後処理のみ行う。
  6. 実験的な出力をゲームに入れない(ユーザーが統合を依頼した場合を除く)。
  7. ゲーム用途には1つの移動サイクルを推奨。 6秒のマルチサイクルクリップ全体からの密なサンプリングはプレビュー用に適しています。エンジンシート用には、視覚的な品質確認後、オプションで1サイクル(12~16フレーム)を再サンプリングします。
  8. 絶対パスを報告する — 動画、クリーンフレーム、ストリップ、プレビューGIFのパスをすべて出力後に報告。

ワークフロー

1. 計画

最小限の有用な実行を選択:

  • 横方向のラン/ウォークループ → このスキル
  • マルチアクションキャラクターキット → アクションごとに $generate2dsprite を引き続き使用。移動目的のみ動画を使用(リクエストされた場合)
  • FX / プロジェクタイル / プロップパック → $generate2dsprite、動画は不使用

以下を作成:

<out_dir>/
  base/
  video/
  frames-raw/
  frames-clean/
  sprite/          # デフォルト8フレームセット + 高密度 x16/x24/x48
  prompt-used.txt
  pipeline-meta.json
  README.txt

2. ベース静止画の作成

オプション:

  • A. 既存のスプライト: 画像を読み込み、必要に応じてソリッド #FF00FF 上に合成し、そのサンドボックスパスを imagine_image_to_image / imagine_image_to_video に渡す
  • B. 新しいキャラクター: imagine_text_to_image をソリッドマゼンタ背景、全身、横方向、中央配置で使用
  • C. 参照に合わせる: 参照 file_path で imagine_image_to_image を使用し、マゼンタ上に移動してアイデンティティを維持

ベース要件:

  • 全身が表示され、十分なマゼンタマージンがあること
  • ラン/ウォーク用の横方向ビュー(プロファイルまたは3/4側面)、足は下3分の1付近
  • プロジェクトに参照がある場合、同じアートスタイルであること
  • テキスト、UI、透かし、2番目のキャラクターがないこと

返された file_path をコピーして <out_dir>/base/<name>-base.png として保存。動画呼び出し用にベースの file_path を保持しておく。

正確な画像プロンプトを prompt-used.txt に書き込む。

3. imagine_image_to_video でアニメーション化

Grok imagine_image_to_video を呼び出す:

  • ソースパス: <ベース静止画 file_path>(T2I / I2I によって返されたサンドボックスパス)
  • duration: 6(デフォルト)または 10
  • resolution_name: 480p(ユーザーが 720p を要求した場合を除く)
  • prompt: 1つの短い現在形ショット(references/prompt-rules.md を参照)

プロンプト内の必須モーション制約:

  • 被写体はその場でラン/ウォーク(トレッドミルスタイル)
  • カメラは固定 — パン、ズーム、軌道移動なし
  • 背景はフラットなソリッドマゼンタのまま
  • アイデンティティ、コスチューム、パレットはショット全体で安定
  • 単一の連続アクションのみ

返された動画 file_path を <out_dir>/video/<name>-<duration>s.mp4 にコピーする。

動画ツールが利用できない場合は停止(プラットフォームゲート)。

4. 抽出 + クロマ + サンプリング(ローカルスクリプト)

プロセッサを実行(ffmpeg + Pillow + numpy):

python3 .grok/skills/video2dsprite/scripts/video2dsprite.py process \
  --video <out_dir>/video/<name>-6s.mp4 \
  --out-dir <out_dir> \
  --name <name> \
  --frame-counts 8,16,24,48 \
  --cell-size 128 \
  --body-height 100 \
  --foot-y 118 \
  --fps 0

注意:

  • --fps 0 = デコードされたすべてのフレームを抽出(ソースfpsを使用)
  • マゼンタフラッドフィル(コーナーから)+ デスピル
  • --frame-counts の各カウントに対して均等サンプリング
  • 足正規化セル、水平ストリップ、グリッド、カウントごとのループGIF

オプション: 既存のクリーンフレームから高密度セットのみを再サンプリング:

python3 .grok/skills/video2dsprite/scripts/video2dsprite.py sample \
  --clean-dir <out_dir>/frames-clean \
  --out-dir <out_dir> \
  --frame-counts 16,24,48 \
  --cell-size 128

5. 品質確認

視覚的に確認:

  • プレビューGIFが大きなポップなしでループする
  • マゼンタが除去されている(ソリッドピンクブロックなし); フリンジは許容されるか、再キーイング
  • 足が安定したベースラインに留まっている(切り抜き不良による跳ねがない)
  • アイデンティティがおおよそ安定している(顔/服が毎フレーム変化しない)
  • アクションがその場で行われている(フレーム外にスライドしない)
  • ゲーム用: 1つのカウントを選択(多くの場合16または24)、または1つの真のサイクルをカット

アイデンティティが大きくドリフトするか、ピクセルが柔らかすぎる場合は、プロダクションシートには $generate2dsprite にフォールバックし、動画セットはモーションリファレンスとしてのみ保持する。

6. 納品

パスのみを報告する(ユーザーがゲームに組み込むよう依頼した場合を除く):

  • 動画: video/*.mp4
  • 高密度スプライト: sprite/x16|x24|x48/
  • ストリップ / グリッド / GIF: sprite/run-strip-N.png, run-grid-N.png, run-preview-N.gif
  • メタ: pipeline-meta.json

要求されない限り、ゲームコードを変更しない。

デフォルト

  • 時間: 6秒
  • アクション: 右向きのその場サイドラン
  • エクスポートカウント: 8, 16, 24, 48
  • セル: 128²、ボディ高さ ~100、足位置 y≈118
  • 背景: #FF00FF
  • マルチリファレンスよりも単一アセットの imagine_image_to_video を優先(必要に応じて imagine_text_to_image でマルチリファレンスを合成)

トレードオフ(ユーザーに一度伝えること)

長所: より密度の高い中間フレーム → 4~8個の個別生成ポーズよりも滑らかに感じられることが多い。 短所: ピクセルがソフト、アイデンティティドリフト、クロマフリンジ、マルチサイクル6秒クリップは完全な1ループではない、アセットが重い。 経験則: 8→16→24 で通常滑らかさが向上。48は多くの場合、効果が薄い。145の生フレームはサンプリング用であり、すべてをランタイムで使用するわけではない。

リソース

他のスキルとの関係

  • $generate2dsprite — プライマリシートパイプライン(Codex + Grok、画像生成が存在する場合)
  • $generate2dmap — マップ。ここでは使用しない
  • $video2dsprite — Grok Build 専用のモーション高密度化パス
  • $game-asset-core / $game-animation-frames — ループ/フリップテスト/モーションルールとエンジン対応デフォルト。サンドボックス実行には引き続きこのスキルのスクリプトを使用(マゼンタベース + クロマ)。自由形式の背景色は使用しない

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate production-oriented 2D game maps with `imagine_text_to_image`: RPG/top-down maps, side-scroller parallax stages, tilemaps, layered raster maps, prop packs, collision zones, and walkable areas. Use when building browser games that need real map art (not pure code-drawn tiles), layered props, or map collision metadata. Triggers on "map", "level", "stage", "tilemap", "overworld", "dungeon", "side scroller background", "prop pack", "2D map".

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Call the xAI API (Grok) from this app's server code using the injected XAI_API_KEY: chat/LLM features, image and video generation (Imagine), and voice (text-to-speech). Use when the app needs any "AI" / "assistant" / "chatbot" / "Grok" functionality, runtime image/video generation, or speech. Triggers on "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI instead).

関連スキル