roblox-studio-mcp
Use when working with Roblox Studio through built-in MCP for scripts, scenes, generated assets, input, or playtesting.
How do I install this agent skill?
npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-studio-mcpIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill integrates with Roblox Studio via MCP to manage scripts, generate assets, and conduct playtesting. It provides tools for executing Luau code and modifying project files, and it references a third-party open-source bridge as an alternative to official tools. Potential risks involve indirect prompt injection from user-provided content and execution of code within the game environment.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Roblox Studio MCP
When to Load
Load for Studio MCP work: scripts, scenes, assets, debugging, or playtesting. Skip for standalone code generation.
Quick Reference
Route by capability first. Two Studio MCP bridges exist: the official (built into Studio, closed-source) and chrrxs's (MIT). Route on tools/list (get_connected_instances/eval_*/multiplayer_* → chrrxs; list_roblox_studios + per-call studio_id → official) BEFORE bridge-specific bootstrap.
Bootstrap before mutation
- Identify the target via
list_roblox_studios(official) orget_connected_instances(chrrxs). - Pass the target's
studio_id(official) orinstance_id(chrrxs) on every tool call. get_studio_stateand confirm Edit/Client/Server availability.- Inspect the target tree and scripts before changing them.
Execution contract
discover → select Studio/context → inspect → mutate in bounded batches
→ read back → start play → evaluate live → evidence → clean up
Edit-time injection (multi_edit, Edit-context execute_luau) writes scripts; it never targets a running playtest. Live evaluation targets a running VM: start play, wait for the intended Client/Server VM, then evaluate there. A stopped VM is never a live-evaluation target. Pass datamodel_type only where the tool requires it; do not guess from a previous session.
Capabilities
Inspect (search_game_tree, inspect_instance, script_read, script_grep), edit/execute (multi_edit, execute_luau), assets (search_asset/insert_asset, generate_* with wait_job_finished, store_image/upload_image), play/evidence (start_stop_play, get_console_output, screen_capture, input simulation, subagent).
Reliability rules
execute_luauis stateless: re-acquire references every call.- Read before write; read back after every script, asset, or geometry mutation.
- Choose reuse vs generation vs native fallback before asset work.
- Call
wait_job_finishedbefore edits that depend on a generation job. - Command-size limits are bridge-specific. Split large scripts into separate bounded
multi_edit/execute_luauwrites (or supported multi-edit operations), then read back the full payload to verify. - If MCP is absent, provide offline Luau and state what was not verified.
Full tool mappings, live schemas, asset workflows, and recovery rules: references/full.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tabooharmony/roblox-brain/roblox-studio-mcp">View roblox-studio-mcp on skillZs</a>