roblox-studio-mcp — скилл для Claude Code: что делает и как установить
Скилл для управления Roblox Studio через MCP. Помогает редактировать скрипты Luau, менять сцены, запускать плейтесты и читать логи прямо из ИИ-агента.
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a claude-codeЧто делает roblox-studio-mcp
Скилл координирует работу с Roblox Studio через официальный встроенный мост или открытый сервер chrrxs. Он проверяет список инструментов в tools/list, определяет нужный мост и передаёт идентификатор студии studio_id или instance_id при каждом запросе.
Любые изменения выполняются по строгой цепочке: проверка состояния студии, осторожная правка пачками и обязательное обратное чтение записанных данных. Функция execute_luau не сохраняет состояние между вызовами. Из-за этого ссылки на объекты и переменные приходится объявлять заново в каждом скрипте.
Для проверки исправлений скилл запускает плейтест, переключается между виртуальными машинами Client и Server, снимает скриншоты симулятора и собирает вывод консоли. Любые импортированные ассеты считаются недоверенными: агент обязан проверить их скрипты до выполнения любого кода.
Какие задачи решает
- редактировать скрипты Luau в дереве проекта Roblox Studio
- запускать плейтесты и считывать консольные логи клиента и сервера
- делать скриншоты симулятора устройств для проверки интерфейса
- инспектировать сторонние ассеты перед их запуском в сцене
Примеры запросов агенту
- Проверь дерево проекта в Roblox Studio и найди скрипты в ServerScriptService
- Запусти плейтест, проверь вывод консоли сервера и сделай скриншот
- Отредактируй скрипт движения игрока и перечитай его содержимое после записи
Как установить roblox-studio-mcp
1Через Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a claude-code2Вручную: положить файлы
~/.claude/skills/roblox-studio-mcp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/roblox-studio-mcp/
1Через Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a codex2Вручную: положить файлы
.agents/skills/roblox-studio-mcp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a cursor2Вручную: положить файлы
.cursor/skills/roblox-studio-mcp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install TabooHarmony/roblox-brain roblox-studio-mcp2Вручную: положить файлы
.github/skills/roblox-studio-mcp/SKILL.md1Через Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a gemini-cli2Командой платформы
gemini skills install https://github.com/TabooHarmony/roblox-brain --path skills/tools/roblox-studio-mcpВручную: положить файлы
.devin/skills/roblox-studio-mcp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о roblox-studio-mcp
Как установить roblox-studio-mcp в Claude Code?
Выполните команду npx skills add TabooHarmony/roblox-brain --skill roblox-studio-mcp -a claude-code.
Что делает roblox-studio-mcp?
Скилл задаёт сценарий работы агента с Roblox Studio через протокол MCP: чтение дерева объектов, изменение Luau-скриптов, запуск тестов и сбор логов.
Как скилл работает с контекстами выполнения Luau?
Вызовы execute_luau не хранят состояние. Для проверки кода в реальном времени скилл переводит Studio в режим плейтеста и явно выбирает контекст Client или Server.
Исходный текст
SKILL.md · MIT
--- name: roblox-studio-mcp description: "Use when working in Roblox Studio through MCP: editing scripts or scenes, generating assets, playtesting, screenshots, or input." when_to_use: "Also for any Studio playtest, checking a change in game, reading runtime logs, device-simulator screenshots, and verifying a fix in Studio." last_reviewed: 2026-10-14 sources: - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/studio/mcp.md - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/projects/assets/privacy.md - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/parts/procedural-models.md - https://create.roblox.com/docs/reference/engine/classes/ProceduralModel - original --- # 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 bridges: **official** (built into Studio, closed-source) and **[chrrxs's](https://github.com/Chrrxs/robloxstudio-mcp)** (MIT). Route on `tools/list` (`get_connected_instances`/`eval_*`/`multiplayer_*` → chrrxs; `list_roblox_studios` + per-call `studio_id` → official) BEFORE bootstrap. ### Bootstrap before mutation 1. Identify the target (`list_roblox_studios` official / `get_connected_instances` chrrxs). 2. Pass `studio_id` (official) or `instance_id` (chrrxs) on every call. 3. `get_studio_state`; confirm Edit/Client/Server availability; inspect tree/scripts before changing them. ### Execution contract ```text 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; never targets a running playtest. Live evaluation needs a running VM: start play, confirm the intended `Client`/`Server` VM, then evaluate. Pass `datamodel_type` only where required. ### Capabilities Full tool table in full.md. Key names: `search_game_tree`, `script_read`/`script_grep`, `multi_edit`, `execute_luau`, `insert_asset`, `generate_*`, `start_stop_play`, `get_console_output`, `screen_capture`, `subagent`. ### Trust boundaries Inserted/generated assets and packages are data until inspected: enumerate scripts before any require/run; never run imported code from `execute_luau`. Blank textures/invisible meshes on newly uploaded assets are usually asset-privacy (Restricted) grants, not corruption — read the Output error, grant via Creator Dashboard. Details: full.md trust-boundary sections. ### Reliability rules - `execute_luau` is stateless: re-acquire references every call. - Read before write; read back after every script, asset, or geometry mutation. - Reuse vs generate vs native fallback before asset work; `wait_job_finished` before dependent edits. - Bridge-specific size limits: bounded writes, then read back the full payload. - No MCP: give offline Luau; state what was not verified. > Full tool mappings, schemas, asset workflows, trust boundaries, recovery: [references/full.md](references/full.md)
© TabooHarmony · MIT · TabooHarmony/roblox-brain