Communitygithub.com

evalix098/tiktoklive

プロダクション向け2Dゲームマップを生成します。RPG/トップダウンマップ、横スクロールパララックスステージ、タイルマップ、レイヤーラスターマップ、プロップパック、衝突ゾーン、歩行可能エリアを、`imagine_text_to_image` を使用して作成します。ブラウザゲームで本格的なマップアート(コード描画タイルではない)、レイヤープロップ、またはマップ衝突メタデータが必要な場合に使用します。「map」「level」「stage」「tilemap」「overworld」「dungeon」「side scroller background」「prop pack」「2D map」でトリガーされます。

tiktoklive とは?

このスキルは、AIエージェント(例:Claude Code、Grok)がテキストから画像生成機能を活用して、プロダクション品質の2Dゲームマップを生成するためのパイプラインを提供します。主にブラウザベースのゲーム(Phaser、TanStack)を対象とし、タイルマップ、シーンマップ、横スクロールステージ、グリッドマップ、ルームチャンク、ベイクドシーンなど、ゲームの種類や要件に応じて最適なマップモードを自動選択します。重要なのは、単なる一枚絵ではなく、衝突判定ゾーン、プロップ配置、スクリプトフックなどのメタデータを伴った、実際にプレイ可能なマップを生成することです。アートはすべて`imagine_text_to_image`で生成され、プロンプトはエージェントが記述します。また、生成されたアセットはレイヤー構造(ベース、プロップ、衝突、イベントゾーン)で管理され、`extract_prop_pack.py`や`compose_layered_preview.py`などのスクリプトで処理されます。このスキルは、キャラクターやスプライトの生成(`generate2dsprite`)とは明確に分離されており、マップはあくまでゲーム世界の基盤とそのメタデータを提供します。

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

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

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

ドキュメント

Generate2dmap

App-builder / Grok 環境

項目値
スキルディレクトリ / スクリプト.grok/skills/generate2dmap/、python3 .grok/skills/generate2dmap/scripts/<script>.py … で実行
画像ツールimagine_text_to_image / imagine_image_to_image(パスベース。imagine を参照)。出力の確認は PNG パスに対して read_file を使用(Codex view_image ではない)
生成画像のパスimagine_text_to_image → サンドボックス file_path → assets/map/ にコピー。Pillow はプリインストール済み
デフォルトの engine_targetこの TanStack ブラウザサンドボックスでは raw_canvas または Phaser。ユーザーが明示的に希望する場合のみ Godot/Unity/Tiled を使用
関連スキルgenerate2dsprite(キャラクター/FX スプライト。プロップパックではこのスキルの抽出スクリプトを引き続き使用)、building-games、imagine

最初にパイプラインを決定する

ゲームの要件を満たす最小のプレイ可能なマップバンドルを構築します。まずプロダクトレベルの map_mode を選択し、次に低レベルの軸(visual_model、runtime_object_model、collision_model、engine_target)を決定します。

  • tile_mode — 編集可能なタイル/グリッドマップ: ポケモンのようなルート、トップダウンRPGの町、プラットフォーマーのタイルマップ、または既にTiled/LDtk/Godot/Unity/Phaserタイルマップを使用しているプロジェクト。
  • scene_mode — 基本ベースと個別のプロップ: タワーディフェンス、サバイバーズのようなアリーナ、居心地の良いトップダウンショーケースマップ。
  • side_scroll_mode — パララックス横スクロールステージ: ロックマンのような、アクションプラットフォーマー、メトロイドヴァニアの部屋、ランナー、ベルトスクロールアクション。
  • grid_mode — ルール重視のグリッド: 戦術RPG、工場/オートメーション、ボード/カードバトラーのビルドグリッド。
  • room_chunk_mode — モジュラー式の部屋/チャンク: ローグライクダンジョン、メトロイドヴァニアネットワーク、プロシージャルアセンブリ。
  • baked_scene_mode — 明示的にフラットでプレイ不可のシーンのみ: タイトル/メニュー画面、戦闘背景、ビジュアルノベルのシーン、コンセプトアート。

ユーザー指定のパラメータがあればそれを使用し、それ以外の場合は既存のゲーム、カメラ、衝突要件、マップスケール、編集要件から最も軽量なプレイ可能パイプラインを推測します。モードと軸が矛盾する場合、モードのプレイ可能/編集可能な契約が優先されます。ジャンルルーティング、モードごとの軸デフォルト、プリセット、およびエスカレーションヒューリスティックについては references/map-strategies.md を参照してください。選択が明白でない場合は必ずこれを読んでください。

プレイ可能なマップは、決して1枚のベイク画像ではありません。 プレイ可能なマップ、レベル、ステージ、部屋、試作品、またはエンジンシーンを示唆するリクエストの場合、成果物はゲームプレイのジオメトリとオブジェクトを個別のレイヤー、プロップ、タイル/オブジェクトデータ、衝突、ゾーン、またはエンジンネイティブのシーンノードとして公開しなければなりません。ベイク画像は背景、参照、またはプレビューのアーティファクトとして使用される場合がありますが、ランタイムマップとしては使用されません。ただし、ユーザーが明示的にフラットな背景のみを要求した場合は除きます。

シーンとマップのみ。 キャラクター、敵、ボス、NPC、プレイヤー、弾丸、アニメーションスプライトはここでは生成しないでください。これらは $generate2dsprite に属します。マップはシーンフック(スポーンマーカー、パトロール/エンカウントゾーン、アリーナ入り口、ゲート、出口、カメラトリガー)を メタデータ として持ちます。描画されたアートとしては持ちません。

アートは画像生成から作成し、プロンプトはあなたが書く

  • imagine_text_to_image が、ベースマップ、パララックスプレート、参照、プロップシート、タイルセットアートのデフォルトのアートソースです。デフォルトの art_style は clean_hd(ハンドペイントHD、シャープで読みやすい形状、低テクスチャノイズ、ドット感なし)。pixel_inspired または retro_pixel は要求された場合のみ使用します。
  • すべてのクリエイティブなプロンプトはあなた自身が書いてください。 スクリプトはアセンブル、スライス、クロマキー、クロップ、検証、プレビュー合成、JSON/エンジンファイルの出力を行いますが、クリエイティブなプロンプトを書いたり、最終的なアートを描画したりすることは決してありません。プレースホルダー/プロシージャルアートは、ユーザーが明示的にプレースホルダー、備品、デバッグマップ、足場を要求した場合のみ使用します。タイルエンジンをターゲットとする場合、最初にタイルセットアートを生成し、その後スクリプトでレイヤー、衝突、ゾーン、シーンワイヤリングのみを行います。
  • 実行時に新しいビジュアルアセットが作成された場合は、各プロンプトをそのアセットの隣に <asset>.prompt.txt として保存します(または明示的なマニフェストフィールドに記録します)。
  • 参照の受け渡しはファイルパスであり、文章ではありません。 以前の画像をベースに構築するには、そのサンドボックス file_path を imagine_image_to_image に渡し(read_file で内容を確認できるようにします)、保持する具体的な特徴(カメラフレーミング、地平線、道路/水域の形状、地形の境界、出入り口、ランドマーク)を指定します。ファイル名、「マップに基づく」、または単に会話内で画像が表示されているだけでは 「受け渡し」とはみなされません。その場合は、一旦停止してパスを渡してください。

ランタイムオブジェクトをベースレイヤーに含めない

最初に生成されるベース/背景/基盤画像には、安定した非インタラクティブな基盤アートのみを含めます。すなわち、地面の素材、小道、道路、水、崖、床のパターン、車線、建造パッド、サイドビューの場合は空、遠景/中景の景色、シルエット、雰囲気、タイルマップの場合はタイルセットアートを編集可能なレイヤーとして配置します。そこに 高さのあるプロップ、建物、木、岩、木箱、標識、ドア、ゲート、アイテム、宝箱、チェックポイント、危険物、トラップ、タレット、はしご、前景オクルーダー、破壊可能オブジェクト、アクター、敵、NPC、UI、ラベル、または衝突、インタラクション、再利用、Yソート、アニメーション、個別のレンダリング順序を必要とするものは一切含めてはなりません。そのような画像が生成された場合は、基盤のみのベースを再生成するか、その画像を参照アーティファクトに格下げしてください。

参照モックアップはチェックポイントであり、成果物ではない

ドレスドリファレンス(トップダウン)とステージリファレンス(サイドビュー)は、ワールド内での配置を計画するためのものです。自然なゲームワールドオブジェクトまたは控えめなブロックアウトジオメトリを使用し、最大 9個の識別可能な表示オブジェクト候補(繰り返しは1カウント、配置メタデータで再帰)、注釈グラフィックはなし(丸、矢印、輪郭、ラベル、テキスト、吹き出し、凡例、測定線)、非視覚的メタデータ(スポーン、トリガー、パトロールヒント、カメラ境界)は後でシーンフックとして記述します。

参照モックアップを生成したら、そこで止まらないでください。 references/object-production-gate.md まで進めてください。両方の画像を read_file で再確認し、オブジェクトリストを構築し、最終的な個別オブジェクトを生成し、配置/衝突/シーンフックメタデータを記述し、QAプレビューを合成します。参照のみの出力は、ユーザーが明示的にコンセプトイメージを要求した場合を除き、不完全な実行です。

選択したパイプラインの詳細 — アセット生成前にこれらを開く

  • レイヤーラスターマップ → references/layered-map-contract.md(レイヤータイプ、ベースおよびプロップのプロンプトパターン、プロップメタデータ、レンダリング順序、衝突、QAチェックリスト)。
  • side_scroll_mode → references/side-scroll-stages.md:stage_canvas の決定、名前付き景観のみのパララックスレイヤー、およびプラットフォーム/オブジェクト作業前の必須のワールド内ステージリファレンス。
  • プロップまたはシーンオブジェクトの生成 → まず各オブジェクトを分類し、次に references/prop-pack-contract.md に従います。コンパクトなプロップのみが正方形のプロップパックを共有できます。プラットフォーム、床、橋、ゲート、建物、および衝突に沿ったものは、1つずつ、プラットフォームストリップ、カスタムワイドパック、またはタイル/オブジェクトレイヤーとして配置します。
  • パラメータ、ステップバイステップのワークフロー、extract_prop_pack.py / compose_layered_preview.py コマンド → references/pipeline.md。
  • パイプラインごとの成果物リストと検証チェックリスト → references/deliverables.md。マップ完了と判断する前に両方を実行してください。

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 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

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

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).

関連スキル