Communitygithub.com

evalix098/tiktoklive

ブラウザゲーム用のプレイヤー視認型操作サイン:WASD、乗り物、飛行、FPSマウスルック、そして最もよくある障害(A/D反転)。出荷前にAが左に曲がることを確認するための必須操作セルフテストと小さなテストインターフェース。レースだけでなく、移動、操縦、飛行、運転、戦車、ボート、メック、ドローン、飛行機、カート、三人称追従カメラを持つあらゆるゲームにロード可能。「controls」「WASD」「inverted」「steer」「flight」「airplane」「kart」「vehicle」「yaw」「roll」「pitch」「mouse look」「A/D」でトリガー。

tiktoklive とは?

このスキルは、ゲーム内のプレイヤー向け操作サイン、特にWASDや矢印キーを使用した移動・操縦・飛行において、左右・上下の動作が画面上でプレイヤーの直感と一致することを保証します。最も一般的な障害である A/D 反転(左を押すと右を向く)を防止するため、ハードルール、ジャンル別マッピング(FPS、地上/水上車両、固定翼機、ヘリ/ドローン/6DOF、2D横スクロール)、および必須のセルフテストを提供します。スキルは、Three.js の右手系・Y軸上方向の座標系をベースに、チェイスカメラ後方から見たときに A/左矢印で画面上のノーズ(機首)またはバンクが左に動くことを要求します。自動化されたテストインターフェース(window.__controlsTest)と agent-browser CLI を使用したバッチテスト手順を含み、出荷前に操作反転を確実に検出・修正します。このスキルは、Claude Code、Cursor、Codex などの AI エージェントがゲームの操作入力を実装する際の参照として使用されます。

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

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

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

ドキュメント

操作(プレイヤー視認サイン — 反転出荷禁止)

WASD、矢印キー、追従カメラ、または飛行機を使用するあらゆるゲームで、移動/操縦/飛行コードを書く前に必ず最初から最後まで読むこと。 このスキルをスキップして racing-kart や fps だけを開いては いけません。これらのジャンルファイルは、このサインを既に理解していることを前提としています。A/D 反転は、乗り物や飛行デモで最も一般的な出荷ブロッカーです。

building-games(ループ、カメラ、3D オリエンテーション)および building-games/references/input.md(キーダウン状態、ゲームパッド、タッチ)と組み合わせて使用します。このスキルは、左/右/上がプレイヤーにとって何を意味するか、および それをどのように証明するか を担当します。


0. ハードルール(違反したらビルド失敗)

  1. プレイヤー視認の左/右が絶対基準です。 移動する乗り物の 後方 / 追跡 カメラから見て:
    • A / ← → ノーズ(またはバンク)が画面上で 左に曲がる
    • D / → → ノーズ(またはバンク)が画面上で 右に曲がる
  2. FPS の横移動を乗り物の操縦に流用しないでください。 FPS の「D → +右ベクトル」は地上平面での 位置 移動です。乗り物の A/D は ヨー(またはロール)レート であり、横移動オフセットではありません。両者を混同することが A/D 反転の最大の原因です。
  3. 完了と言う前に、コントロールセルフテスト(§5)を必ず実行しなければなりません。 スクリーンショットだけの QA は不十分です。A が右に曲がる場合は、操縦/ロールの符号を反転 し、再テストしてから出荷してください。新しい座標系を発明しないでください。

1. 共通 3D ベース(どこでもこれを使用)

three.js: 右手系、+Y 上、メッシュは +Z 方向、カメラは −Z 方向を見ます。

XZ 平面上のヨーのみの方位(地上車両、歩行型、ほとんどのアーケード乗り物):

// yaw = 0 でワールド −Z 方向; +yaw は +Y 軸周りの反時計回り(ノーズは −X 方向へ移動)
forward = (-sin(yaw), 0, -cos(yaw))
right   = ( cos(yaw), 0, -sin(yaw))   // = normalize(cross(forward, worldUp))

乗り物の 後方 にチェイスカメラがある場合(カメラは position - forward * dist 付近):

プレイヤーが見るワールド(このベース)入力
ノーズ左+yawA / ← は +yaw を生成しなければならない(飛行機の場合は同等の左バンク)
ノーズ右−yawD / → は −yaw を生成しなければならない

ベースが異なる場合は、一貫性のある ペアを 1 つだけ維持してください。ただし、上記の プレイヤー視認 行は必須です。


2. ジャンルマップ

2a. FPS / 徒歩(横移動、操縦ではない)

W = +forward, S = −forward, D = +right, A = −right   // 位置、ヨーではない
mouse: yaw -= movementX * sens; pitch -= movementY * sens; pitch をクランプ

ボディヨーは視点用。移動はヨーのみを使用(歩行にピッチを適用しないこと)。

2b. 地上 / 水上車両(カート、バイク、ジェットスキー、ボート、戦車、ローバー、スノーモービル)

heading/yaw と前進 speed を持つアーケードボディ:

// 入力(キー保持 → 毎フレームのアクション)
let steer = 0; // -1..+1、プレイヤー視認
if (keys.has('KeyA') || keys.has('ArrowLeft'))  steer += 1;  // 左
if (keys.has('KeyD') || keys.has('ArrowRight')) steer -= 1;  // 右
// オプション: steer = clamp(steer + gamepadX, -1, 1) 同じ符号規則で

// 積分 (speedFactor ~ 0..1 は |speed| による)
const reverse = speed >= 0 ? 1 : -1; // 後退時も左ホイールは左に感じられる
 yaw += steer * turnRate * speedFactor * reverse * dt;

// 方位に沿って移動
const fx = -Math.sin(yaw), fz = -Math.cos(yaw);
position.x += fx * speed * dt;
position.z += fz * speed * dt;

よくあるバグ(コピー禁止):

// 間違い — これが実際に A/D 反転を出荷させる原因
if (KeyA) steer -= 1;
if (KeyD) steer += 1;
yaw += steer * turnRate * dt;  // A → −yaw → 追跡カメラでノーズ右

すでに KeyA → steer-- と書いてしまった場合、キーマッピングを交換する か、積分時に一度だけ符号を反転させる(yaw += -steer * …)かして、その後 §5 を実行してください。二重反転(キー+積分+メッシュバンク)はしないでください。

2c. 固定翼飛行(飛行機、グライダー、ラジコン機)

入力アクションプレイヤーの期待
A / ←ロール左(エルロン)左翼ダウン / 左バンク
D / →ロール右右翼ダウン / 右バンク
W / ↑ピッチ(1 つのスキームを選択し、HUD にラベル表示)通常は機首下げ または 引き起こし — 一貫性を保つ
S / ↓逆ピッチ
Q / Eヨー / ラダー(オプション)Q 左、E 右
  • A/D は横移動ではなく、「FPS 記号による地上操縦」でもありません。
  • ロールは乗り物の ローカル前方軸 に適用し、A で左バンク となる符号にします。メッシュが逆向きにバンクする場合は、ロール適用(または A/D → ロールマッピング)の 1 つ の符号を反転させ、ベース全体は反転させないでください。
  • 協調旋回: 正のバンクは、チェイス/外部カメラでバンク方向と一致する旋回を生成する必要があります。

2d. ヘリ / ドローン / 6DOF

開始オーバーレイにスキームを文書化します。最低限:

  • 個別キーによるスロットル/高度は、1 回の押下で「常に上」になってはいけません(保持状態または明示的な上/下を使用)。
  • 横移動/ヨー: 乗り物の水平フレームで A 左、D 右(プレイヤー視認)。

2e. 2D 横スクロール / プラットフォーマー

D / → は画面上で 右に移動。A / ← は画面上で 左に移動。重力が反転するのは、ジャンルが明示的に上下逆の場合のみ。


3. カメラは一致しなければならない

  • チェイスカメラ: desired = craftPos + up*height + forward*(-followDist); lerp; lookAt(craft)。
  • forward は移動とカメラの 両方 で 1 回 計算し、カメラパスで反対のヨー符号で再構築しないでください。
  • デバッグ順序: (1) キーが認識される → (2) 符号が正しい(§5) → (3) カメラが一致する。

4. 入力配管(簡潔に)

  • キーは keydown/keyup で event.code を使用して Set で追跡し、blur / visibilitychange でクリアします。ゲームループ内で dt を使用して移動し、キーハンドラ内では移動しないでください。
  • キーボード + タッチ + ゲームパッドを アクション(throttle、steer、pitch、roll、…)に統合します。building-games/references/input.md を参照。
  • タッチ: 左スティック = 移動/操縦、右 = アクション。ターゲットサイズは 44px 以上。

5. 必須コントロールセルフテスト(「完了」の前に)

A/D を使用する乗り物では、スクリーンショットだけでは 不十分 です。

5a. プレイヤー視認チェックリスト(すべての乗り物 / 飛行ビルド)

前進中(速度が微小値より大きい)、後方からのチェイスカメラで:

キー押下約 0.5 秒以内に確認すべきこと
Aノーズまたはバンクが画面上で 左に動く
Dノーズまたはバンクが画面上で 右に動く
W(地上)速度が上がる / 向いている方向に移動する
S(地上)ブレーキまたは後退(設計通り)

A が失敗した場合: 操縦/ロールの符号を 1 回 反転し、A と D の両方を再テストしてください。

5b. 最小テストインターフェース(これを実装する)

あなた自身(および自動 QA)が非公開のクロージャを推測せずに符号を証明できるように、小さなフックを公開します:

// 例: src/game/controlsTest.ts — dev/QA 専用で問題ありません
export type ControlsProbe = {
  getYaw: () => number;       // ラジアン; または getHeading()
  getSpeed: () => number;
  /** 実際のキーの代わりに保持アクションを注入します。両方とも、変更するまで適用されたままになります。
   *  そのため §5c はフレーム間でキーを保持し、最後にクリアできます。 */
  setSteer?: (v: number) => void; // -1..1、本番と同じ符号
  setKeys?: (codes: string[]) => void; // 次の呼び出しまで保持されます。`[]` でクリア
};

declare global {
  interface Window {
    __controlsTest?: ControlsProbe;
  }
}

import.meta.env.DEV または ?qa=1 フラグが設定されている場合、ゲームループから window.__controlsTest を配線します。

5c. 自動化スモークテスト(実行する)

§5b のプローブをプリインストールされた agent-browser CLI で駆動します。これが最初の手順であり、手書きスクリプトではありません。スローされた eval は非ゼロで終了します。単に偽値の場合は非ゼロになりません。そのため、スローしてアサートします。1 つの batch として実行します(動詞ごとに 1 回ではなく、1 回の CLI 呼び出し)。JSON を標準入力で受け取ります。--bail は最初の失敗ステップで停止し、非ゼロで終了します。

agent-browser batch --bail <<'JSON'   # find のラベルは大文字小文字を区別: snapshot -i からコピー
[["open","http://127.0.0.1:8080/"],
 ["find","text","Start","click"],
 ["eval","if (!window.__controlsTest?.setKeys) throw Error('no §5b probe: add setKeys')"],
 ["eval","__controlsTest.setKeys(['KeyW'])"],
 ["wait","600"],
 ["eval","if (__controlsTest.getSpeed() <= 0.1) throw Error('W: no move')"],
 ["eval","(async () => { const t = __controlsTest, y0 = t.getYaw(); t.setKeys(['KeyW','KeyA']); await new Promise(r => setTimeout(r, 300)); t.setKeys(['KeyW']); const d = t.getYaw() - y0, w = Math.atan2(Math.sin(d), Math.cos(d)); if (w < -0.05) throw Error('A turns RIGHT — inverted, got ' + w.toFixed(2)); if (w <= 0.05) throw Error('A barely turned (' + w.toFixed(2) + ') — hold longer or check the sim is running'); return 'A ok' })()"],
 ["eval","__controlsTest.setKeys([])"],
 ["screenshot","/workspace/screenshots/controls.png"],
 ["close"]]
JSON

keydown ではなく、プローブを通じてキーを保持してください — agent-browser keydown は §4 の Set に到達しないため、正しいゲームが壊れていると読み取られます。プローブに setKeys がありませんか?追加するか(§5b)、または自分でキーイベントをディスパッチしてください。ブラウザ QA リファレンスの Keys ノートにメカニズムと形式があります。

保持は 1 つの eval の 内側 にあります: コマンドに分散すると、コマンドの実行時間だけ保持され、Math.atan2(Math.sin(d), Math.cos(d)) での ±π ラップは、π 以上回転した乗り物を反対方向に回転していると読み取ります。IIFE はステップを再実行可能に保つものです — ベアの const d = … は 2 回目に「既に宣言されています」で失敗し、async は保持をページ時間で実行させるものです。D についても同様に、'KeyD' を使用し、両方の比較を反転させて(w > 0.05 は反転、w >= -0.05 はわずか)、JSON がエスケープを必要としないように一重引用符で囲みます。飛行機の場合は ロール をアサートします: A ⇒ 左バンク。

A turns RIGHT は符号エラーです: 1 つ の符号を反転して再実行してください。 A barely turned は符号エラーではありません — 乗り物は正しい方向に動いていますが、300 ms で 0.05 ラジアン未満です。これはボートや重いローバーが行うことです。保持時間を延ばすか、シミュレーションが実行されていることを確認し、何も反転しないでください。その他の非ゼロ終了 — プローブなし、デーモンの停止 — はチェックが実行されなかったことを意味します: 最初にメッセージを読んでください。最初のフローの前に、ブラウザ QA リファレンス AGENTS.md のリンクを読んでください。動詞、引数の形状、およびフォールバックがそこにあります。

5d. やってはいけないこと

  • 「D で内部変数が増加する」だけをテスト しないでください。
  • FPS の「−Z 方向を向いているときに D → +X」を乗り物の合格条件として使用 しないでください。
  • 修正時にメッシュバンク、カメラ、操縦をすべて一度に反転 しないでください。1 つ の符号を変更し、再テストしてください。

6. 完了基準(操作)

  • 移動 / 操縦 / 飛行コードを書く 前に このスキルを開きました。
  • ジャンルマップを選択し(§2)、スタート画面 / HUD ラベルがそれと一致しています。
  • チェイスカメラ A/D プレイヤー視認テストに 合格しました(§5a)。
  • window.__controlsTest(または同等のもの)が dev/QA で利用可能で、1 回使用されました。
  • ロール / 操縦入力に対して反転したバンクメッシュはありません。
  • キーは保持状態 + dt スケーリングされています。単一の Space タップによる粘着スラストは、意図的かつラベル表示されている場合を除き、ありません。

どのボックスもチェックされていない場合、ゲームは 完了していません。

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

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

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

関連スキル