Menu
Studio Script Sync setup, troubleshooting, mode detection. Canonical filesystem sync path for Roblox development.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Service hierarchy, 7 foundational patterns, cross-platform input. Client-server architecture, module patterns, framework options.
Luau language fundamentals, type system, OOP, deprecation table, error patterns.
Roblox AnalyticsService: custom events, economy tracking, funnels, rate limits, event taxonomy.
Animations, particles, tweens, ContentProvider, visual effects.
Code review with security, performance, and monetization lenses for Roblox projects
DataStores, ProfileStore, session locking, data persistence patterns.
Based on SOC occupation classification
| name | roblox-sync |
| description | Studio Script Sync setup, troubleshooting, mode detection. Canonical filesystem sync path for Roblox development. |
| last_reviewed | "2026-05-21T00:00:00.000Z" |
| Tool | Setup steps | TeamCreate | Project file required |
|---|---|---|---|
| Studio Script Sync | 2 (toggle + right-click) | Yes | No |
| Rojo | 6+ (install aftman, install Rojo, project.json, install plugin, serve, connect) | No | Yes |
| Argon | 5 (install CLI, install plugin, init project, serve, connect) | No | Yes |
| Pesto | 4 (install CLI, install plugin, init, sync) | Partial | Yes |
~/projects/<game-name>/src/<container-name>/. Studio will mirror the script tree into that folder as .luau files.Does:
.luau file mirror for scripts (Script, LocalScript, ModuleScript)Doesn't:
.gitkeep)Every session, the agent detects the active mode:
.luau files exist): read/write/edit via filesystem. MCP only for verification, playtest, scene ops, asset insertion. Never read a script via MCP if its file exists on disk..luau files on disk): minimize reads, prefer run_code for inspection, batch edits behind ChangeHistoryService Recording. Recommend enabling sync.If MCP-only and project exceeds light-touch scope (>500 lines/module or >10 modules), proactively recommend Sync Mode before continuing.
.gitkeep.Script Sync puts .luau files on disk. Git works with files on disk. Use them together.
cd ~/projects/<game-name>
git init
git add .
git commit -m "initial sync"
# OpenCode
.opencode/
# Roblox build files (binary, don't track)
*.rbxl
*.rbxlx
*.rbxm
*.rbxmx
# OS
.DS_Store
Thumbs.db
git diff to show the user what changed. This is the review loop.git checkout -b refactor/combat-system.git commit. The user should see what's being committed.| Operation | Command | When |
|---|---|---|
| See what changed | git diff | Before committing |
| Stage changes | git add -A or git add <file> | Before committing |
| Commit | git commit -m "message" | After staging |
| See history | git log --oneline -10 | When user asks "what changed" |
| Undo last commit (keep changes) | git reset --soft HEAD~1 | When user wants to redo commit |
| Create branch | git checkout -b <name> | Before risky/experimental work |
| Switch branch | git checkout <name> | When switching context |
| Merge branch | git merge <name> | When experimental work is ready |
If git merge conflicts occur in .luau files, the agent should:
Detect presence of default.project.json (Rojo) or *.project.json with Argon-specific fields. If found: filesystem is already source of truth, operate normally on disk. Don't suggest switching to Script Sync.