Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/brockmartin/roblox-game-skill/llms.txt

Use this file to discover all available pages before exploring further.

Installing the Roblox Game Skill involves two independent steps: placing the skill directory where Claude Code can discover it, and — optionally — connecting Roblox Studio via an MCP server so Claude can read and write your project files directly. If you only want offline Luau code generation with copy-paste-ready scripts, you need nothing beyond the skill itself.

Install the Skill

1

Clone or download the repository

Clone the skill from GitHub into a convenient location on your machine:
git clone https://github.com/brockmartin/roblox-game-skill.git
Alternatively, download the ZIP from the GitHub releases page and unzip it.
2

Place the skill in your Claude Code skills directory

Move or copy the repository folder into the Claude Code skills directory. The skill must live at exactly this path so Claude Code can discover it automatically:
mkdir -p ~/.claude/skills
mv roblox-game-skill ~/.claude/skills/roblox-game
Your directory tree should now look like:
~/.claude/skills/roblox-game/
├── SKILL.md
├── references/
├── templates/
└── workflows/
3

Verify Claude Code picks up the skill

Open a new Claude Code session and type any Roblox-related prompt. The skill is automatically triggered by keywords like Roblox, Luau, simulator, tycoon, obby, and many more.Try:
What Roblox skills do you have available?
Claude should respond describing the Roblox Game Skill, its genre templates, and the detected MCP mode. If it doesn’t, confirm the folder is named exactly roblox-game and that SKILL.md is present at the root.

Connect Roblox Studio via MCP (Optional)

MCP Studio integration lets Claude read your project’s file tree, execute Luau code inside Studio, read the output console, control play mode, and perform autonomous building — all without leaving your Claude Code session. There are two server options depending on how much capability you want.
MCP Studio is entirely optional. In Offline mode the skill generates complete, copy-paste-ready Luau scripts with placement instructions. You can get a full game scaffolded without Studio ever being open.
The community MCP server provides the richest integration with 39 tools covering project exploration, autonomous building, iterative debugging, bulk operations, and Creator Store access.Capabilities include:
  • Browse the full file tree of your open Studio project
  • Execute Luau code and read results in real time
  • Search scripts with grep_scripts across your entire project
  • Create and manage builds with create_build
  • Insert models, manage assets, and batch-edit instances
Installation:
# Clone the community MCP server
git clone https://github.com/boshyxd/robloxstudio-mcp.git
cd robloxstudio-mcp
npm install
Then add it to your Claude Code MCP configuration (typically ~/.claude/mcp.json):
{
  "mcpServers": {
    "robloxstudio": {
      "command": "node",
      "args": ["/absolute/path/to/robloxstudio-mcp/index.js"]
    }
  }
}
Restart Claude Code and open Roblox Studio. The skill will auto-detect the 39-tool server and set MCP_MODE = "full".

MCP Mode Summary

ModeServerToolsBest For
Fullboshyxd/robloxstudio-mcp39Autonomous building, file-tree browsing, bulk operations
StandardRoblox/studio-rust-mcp-server6Code execution, model insertion, play-mode control
OfflineNone0Pure Luau generation — no Studio required
The skill detects which mode is available on every invocation and adapts all workflows, outputs, and instructions accordingly.

Verify the Installation

Once installed, try a few prompts to confirm the skill is working correctly: Test routing:
How do I save player data in Roblox?
The skill should load references/datastore-persistence.md and give you a thorough answer on DataStoreService, ProfileService, and pcall patterns. Test genre detection:
I want to build a tycoon game about running a pizza restaurant.
The skill should confirm the Tycoon genre, describe the template it will use, and offer to begin the 8-step new-game workflow. Test MCP awareness:
What MCP tools do you have available right now?
The skill should report the detected mode (Full, Standard, or Offline) and list the specific tools it found.
If Claude does not respond with Roblox-specific knowledge, check that the skill folder is named exactly roblox-game (not roblox-game-skill) and is located directly inside ~/.claude/skills/. The SKILL.md file must be present at the root of that folder.

Build docs developers (and LLMs) love