roblox-skills-setup

このマシンにRobloxスキルをセットアップする

このパックのスキルは、別の人のコンピューターで作成されました。ゲームの保存場所、Blenderの場所、アニメーションするリグ、収集したVFXの保存先など、マシン固有の情報は、各スキルのSKILL.mdと同じ場所にあるLOCAL.mdに記録されています。各スキルは、最初にLOCAL.mdを読み込みます。このスキルではユーザーと一緒にそれらのファイルを作成するため、手作業で編集する必要はありません。

LOCAL.mdはユーザーのものです。共有するものにコピーしないでください。

ルール

• 推測せず、尋ねてください。 検出した内容をデフォルトとして提示し、ユーザーに確認または変更してもらいます。
• シークレットをファイルに書き込まないでください。 APIキーは環境変数に保存します。LOCAL.mdに記録するのは変数名だけです。変数の設定方法をユーザーに説明し、キーをチャットに貼り付けるよう求めないでください。
• 許可なくインストールしないでください。 不足しているツールの用途を説明し、リンクまたはコマンドを提示します。インストールするかどうかはユーザーが決めます。任意のツールは任意のままにします。
• 使うものだけ設定してください。 3Dモデルを使う予定がない場合は、Blenderをスキップします。Kaggleは絶対にセットアップしないでください。このスキルの使用は規約で禁止されています。スキップしたスキルのテンプレートはそのまま残るため、このスキルを再実行すれば後からセットアップできます。

ステップ1：マシンを確認する

python ~/.claude/skills/roblox-skills-setup/scripts/check_setup.py

表をユーザーに見せます。Studio MCPの行に、Claude Codeの設定ファイル内にないと表示されても、それだけで問題というわけではありません。別の方法で登録されていることがよくあります。重要なのは、ステップ5でのライブチェックです。その後、どの機能を使いたいか尋ねます。初めて使う人には、次の順番がわかりやすいでしょう。

1. コード（roblox-code）：Rojo、Wally、Lune、Selene、StyLua。無料です。最も簡単なのは、ツールチェーンマネージャーを使う方法です。Rokit（またはAftman）をインストールしてから、rokit add rojo-rbx/rojo、rokit add UpliftGames/wally、rokit add lune-org/lune、rokit add Kampfkarren/selene、rokit add JohnnyMorganz/StyLuaを実行します（リポジトリ名は変更されることがあるため、各プロジェクトのREADMEを確認してください）。スキャフォルダーは、これらをゲーム自体のツールチェーンファイルにも書き込みます。
2. Roblox Studio MCP。 Roblox Studioに同梱されている公式のものです。StudioでAssistant／MCP設定から有効にし、セットアップ画面の説明に従ってClaude Codeに追加します。claude mcp listで確認してください。Studioを操作するすべてのスキルでこのサーバーを使用します。一度に接続するStudioは1つにしてください。
3. UI、マップ、VFX、SFX：PythonとStudioのみです。
4. 3Dモデルとアニメーション：Blender 4.x。3Dモデルには、メッシュの生成にGPUも必要です（HF_TOKENを設定したHugging Face Spaceを使用）。Kaggleは使用しないでください。この用途は規約で禁止されており、アカウント停止の事例もあります。モデルを使う前にroblox-3d-model/references/licences.mdを読んでください。一部のモデルライセンスでは、特定の地域での使用や商用利用が除外されています。
5. 永続的なアップロード（任意）：アセットのアップロード権限がある無料のRoblox Open Cloud APIキーをROBLOX_API_KEYに設定し、ROBLOX_USER_IDも用意します。これがなくても、Studioセッション内ではアセットを使用できます。

ステップ2：環境変数（ユーザーが設定）

OSに応じた設定方法を伝え、完了したという返答を待ちます。

• Windows（PowerShell）：setx ROBLOX_API_KEY "paste-here"を実行してから、ターミナルとClaude Codeを再起動します。
• macOS／Linux：~/.zshrcまたは~/.bashrcにexport ROBLOX_API_KEY="paste-here"を追加してから、新しいターミナルを開きます。

check_setup.pyを再実行すると、値は表示されずに「set」と報告されます。

Step 3: 各 LOCAL.md を作成する

ユーザーがインストールを希望するスキルごとに、その LOCAL.template.md を読み込み、ユーザーと相談しながら各値を設定して（検出されたデフォルト値を最初に提示）、同じフォルダーに LOCAL.md を作成します。スキルが必要な情報を見つけられるよう、テンプレートの見出しはそのまま残してください。テンプレートにマシン設定は不要と記載されている場合は、スキップしてください。そのスキルはインストール済みの状態で利用できます。 提示するデフォルト値の例：

設定	提示するデフォルト値
ゲームフォルダー	~/Projects/Roblox-Games（ユーザーが同意したら作成します。スクリプトはデフォルトでここを参照するか、ROBLOX_GAMES_HOME が指す場所を参照します）
Blender	check_setup.py が検出したパス
VFX ライブラリ	~/Roblox-VFX-Library（必ずスキルフォルダーの外に置きます）
SFX のメモ／候補	~/Roblox-SFX
R15 / R6 リグ .blend	ユーザーに確認してください。デフォルト値はありません。無料で公開されているリグも使えます

ユーザーの好み（アートスタイル、好きな色、絶対に使いたくないものなど）があれば、各 LOCAL.md の末尾に短い ## My preferences セクションを追加します。スキルはこの内容を読み取ります。

Step 4: VFX ライブラリ（意外に思われることがあるため説明してください）

roblox-vfx にはエフェクトが含まれていません。これは、利用する権利のある VFX パックから独自のライブラリを作成するための収集ツールです。

1. Creator Store で好みの無料 VFX パックを探し、Get をクリックして自分のインベントリに追加します。この作業は意図的に手動で行います。Studio では、無料であってもアカウントが所有していないアセットを読み込めないためです。
2. テスト用のプレースを開き、Toolbox のインベントリからパックを挿入します。
3. roblox-vfx を使って、Claude に「このプレースの VFX を収集して」と依頼します。Studio から各エミッターのプロパティを読み取り、ライブラリフォルダーに JSON レシピとして保存した後、分類します。これにより、「氷のリング」「火の爆発」のように検索できるようになります。
4. 公開するゲームでエフェクトを使う前に、各パック固有の利用規約を確認してください。

Step 5: スモークテスト

ユーザーが設定した内容を実行し、合否を正直に報告します：

• Code：roblox-code で使い捨てのプロジェクトをスキャフォールドし、4 つのゲート（ビルド、テスト、リント、フォーマット）を実行します。新規スキャフォールドでは、4 つすべてが成功するはずです。
• Map：roblox-map フォルダーで python scripts/prove.py minimal を実行します。RESULT: WARN が表示されることを想定してください（P11 のみ。空きスペースは 2 階建てのテストマップでは正常です）。続いて python scripts/plan.py minimal --prove -o plan.png を実行し、画像を開きます。
• UI：roblox-ui フォルダーで python scripts/ui_build.py examples/coin_hud.json --out build を実行し、build/CoinHud.png を開きます。続いて python scripts/verify_ui.py examples/coin_hud.json を実行すると、失敗数が 0 と表示されるはずです。
• Studio：Studio を開いた状態で、MCP 経由で get_studio_state を依頼します。
• Blender：LOCAL.md に記載されたパスから blender --version を実行します。

次に、ユーザーに使い始める方法を案内します。作りたいゲームの種類を指定して /create-roblox-game を実行するか、任意のスキル名を 1 つ指定します。

再実行

いつでも安全に実行できます。既存の LOCAL.md を上書きする場合は、変更内容をユーザーに示して承諾を得てからにしてください。