roblox-tooling — Claude Code skill: what it does, how to install
Helps configure and fix Roblox development toolchains: Rojo, Wally, pesde, Selene, StyLua, Lune, and CI/CD pipelines.
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a claude-codeWhat roblox-tooling does
The skill guides agent behavior across Roblox development tools, including Rojo, Wally, pesde, Selene, StyLua, and Lune. It defines how to manage packages, generate sourcemaps for luau-lsp, and pin tools using Rokit instead of the archived Aftman. It also covers CI setup, where logic, file, HTTP, and engine suites must be separated.
Source of truth comes first. An agent must distinguish between Roblox Studio and the local disk before touching any file. The rojo syncback command only pulls saved-place edits rather than running a live two-way sync, so running a dry run first is mandatory. For script writes via plugins or MCP, the toolchain requires ScriptEditorService:UpdateSourceAsync with ChangeHistoryService recordings to prevent clobbering open editor tabs.
In CI pipelines, StyLua and Selene run strictly in check mode to prevent silent file rewrites. CI gates depend on parsed test counts and output rather than plain exit codes.
What it helps with
- configure Rojo build rules and sourcemap generation for luau-lsp
- manage project dependencies and manifests using Wally or pesde
- enforce Selene linting and StyLua formatting in CI check mode
- update scripts safely inside Studio using ScriptEditorService
- pin project toolchain versions with Rokit
Example prompts for the agent
- Help me set up Rojo and pesde for a new Roblox project using Rokit for tool management.
- Fix our CI workflow so StyLua and Selene run in check mode without rewriting files.
- Show me how to run rojo syncback safely with a dry run before pulling Studio changes.
How to install roblox-tooling
1Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a claude-code2Manually: put the files in place
~/.claude/skills/roblox-tooling/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/roblox-tooling/
1Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a codex2Manually: put the files in place
.agents/skills/roblox-tooling/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a cursor2Manually: put the files in place
.cursor/skills/roblox-tooling/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TabooHarmony/roblox-brain roblox-tooling2Manually: put the files in place
.github/skills/roblox-tooling/SKILL.md1Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a gemini-cli2Platform CLI
gemini skills install https://github.com/TabooHarmony/roblox-brain --path skills/tools/roblox-toolingManually: put the files in place
.devin/skills/roblox-tooling/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about roblox-tooling
How do I install roblox-tooling in Claude Code?
Run npx skills add TabooHarmony/roblox-brain --skill roblox-tooling -a claude-code in your terminal.
What does roblox-tooling do?
It gives the coding assistant guidelines for managing Roblox tools like Rojo, Wally, and pesde while ensuring file-to-Studio synchronization stays predictable.
Which tool manager should be used for new projects?
The skill directs new projects to use Rokit because Aftman is archived, though Rokit can still read existing aftman.toml configuration files.
Source text
SKILL.md · MIT
--- name: roblox-tooling description: "Use when setting up or fixing Roblox tooling: Rojo, Wally, pesde, Selene, StyLua, Lune, Rokit, luau-lsp, tests, or CI/CD." when_to_use: "Also when sync or builds break, packages won't install, lint or format errors appear, or reviewing the project's toolchain." last_reviewed: 2026-10-14 sources: - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/reference/engine/classes/ScriptEditorService.yaml - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/reference/engine/classes/ChangeHistoryService.yaml - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/reference/engine/classes/InstanceFileSyncService.yaml - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/scripting/sync.md - https://raw.githubusercontent.com/Roblox/creator-docs/main/content/en-us/reference/engine/classes/Players.yaml - https://rojo.space/docs/ - https://wally.run/ - https://kampfkarren.github.io/selene/ - https://raw.githubusercontent.com/JohnnyMorganz/StyLua/master/README.md - https://lune-org.github.io/docs/ - https://raw.githubusercontent.com/LPGhatguy/aftman/main/README.md - https://raw.githubusercontent.com/rojo-rbx/rokit/main/README.md - https://raw.githubusercontent.com/rojo-rbx/rojo/v7.7.1/src/cli/syncback.rs - https://raw.githubusercontent.com/pesde-pkg/pesde/main/docs/src/content/docs/reference/manifest.mdx - https://raw.githubusercontent.com/JohnnyMorganz/luau-lsp/main/README.md - https://raw.githubusercontent.com/lest-luau/lest/main/docs/backends.md - https://raw.githubusercontent.com/lest-luau/lest/main/docs/continuous-integration.md - https://raw.githubusercontent.com/UpliftGames/wally/main/src/resolution.rs - https://create.roblox.com/docs/llms.txt - https://devforum.roblox.com/t/evolving-luau-oss-community-contributions-more/4566806 - original --- # roblox tooling ## When to Load Load for filesystem workflows, tool/package pins, linting, sourcemaps, and CI. ## Quick Reference - Rojo when files own the truth; Wally for manifests+lockfile (explicit realm). Pin tools via the project's manager; new projects lead with Rokit (Aftman archived, reads `aftman.toml`). - Selene + StyLua check-mode in CI (no silent rewrites); Lune for standalone Luau; Rojo sourcemap for editor tooling. - CI gates on parsed results and counts, not exit codes; split logic/file/HTTP/engine suites (full.md). **Source-of-truth first.** Know Studio vs files before editing; never assume sync. `rojo syncback` pulls saved-place edits, not live two-way sync — dry-run first. Don't impose optional tools. TestEZ archived: keep where used. **Script writes from plugin/MCP** go through `ScriptEditorService:UpdateSourceAsync` (raw `.Source` writes can clobber an open editor) + one `ChangeHistoryService` recording per bounded mutation. Script Sync conflicts resolve as Keep Studio vs Keep Disk — never assume either side wins. See full.md §§1b–1d. **Details:** `references/full.md` (setup, file layout, CI examples).
© TabooHarmony · MIT · TabooHarmony/roblox-brain
