Menu
Studio Script Sync setup walkthrough. Canonical sync path for roblox-pi. Sacrificial layer if Roblox swaps the feature.
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.
Based on SOC occupation classification
DataStores, ProfileStore, session locking, data persistence patterns.
Animations, particles, tweens, ContentProvider, visual effects.
GUI systems, layout, responsiveness, cross-platform UI. ScreenGuis, UIListLayout, constraint-based design.
Luau language fundamentals, type system, OOP, deprecation table, error patterns.
ProcessReceipt correctness, prompt APIs, purchase reconciliation, session-lock interaction.
Server-authoritative networking, RemoteEvent validation, rate limiting, exploit prevention, security hardening.
| name | roblox-sync |
| description | Studio Script Sync setup walkthrough. Canonical sync path for roblox-pi. Sacrificial layer if Roblox swaps the feature. |
| 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"
# Pi
.pi/
# 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.