roblox-code-maintenance-refactor
/roblox-code-maintenance-refactor
Maintain and refactor Roblox Luau code safely. Use for technical debt, dead code removal, module boundaries, naming cleanup, duplicate logic, dependency review, regression prevention, and long-term codebase health.
- Author
- AshExplained ↗
- Repository
- roblox-skills ↗
- Licence
- MIT
- Last repository change
- 01.07.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 01.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Maintain and refactor Roblox Luau code safely. Use for technical debt, dead code removal, module boundaries, naming cleanup, duplicate logic, dependency review, regression prevention, and long-term codebase health.
Original author description
Maintain and refactor Roblox Luau code safely. Use for technical debt, dead code removal, module boundaries, naming cleanup, duplicate logic, dependency review, regression prevention, and long-term codebase health.
How it works
- Goal
- Refactor Rules
- Targets
- Finding Deepening Opportunities
- MCP Workflow
- Output
- Next
SKILL.md preview
--- name: roblox-code-maintenance-refactor description: Maintain and refactor Roblox Luau code safely. Use for technical debt, dead code removal, module boundaries, naming cleanup, duplicate logic, dependency review, regression prevention, and long-term codebase health. --- # Roblox Code Maintenance Refactor ## Goal Improve code health without changing player-facing behavior accidentally. ## Refactor Rules - Read before editing. - Keep changes scoped. - Preserve remote contracts unless intentionally migrating. - Avoid mixing behavior changes with cleanup. - Playtest after meaningful refactors. - Check console output. ## Targets - Duplicated constants and reward formulas. - Large scripts with mixed responsibilities. - Client/server boundary confusion. - Dead remotes, stale UI paths, unused modules. - Repeated event connection patterns. - Unclear names around valuable state. - Magic numbers that should be balance tables. ## Finding Deepening Opportunities Beyond obvious cleanup, hunt for **shallow modules** to deepen — where the interface is nearly as complex as the implementation, so callers carry complexity that should be hidden. - Where does understanding one concept require bouncing between many tiny scripts? - Where were pure helpers extracted only for tidiness, but the real bugs live in how they're called (no locality)? - Where do client and server share a responsibility that leaks across the remote boundary? Apply the **deletion test** to anything you suspect is shallow: if deleting it just moves complexity around, inline it; if deleting it would scatter the same complexity across many call sites, keep it and give it a small, stable interface named from the game's vocabulary. Present each opportunity as: files involved · the friction today · the proposed change · the benefit (locality + testability). Don't propose new indirection for a single implementation. See `roblox-luau-architecture` for the deep-module model. ## MCP Workflow 1. Use `script_grep` to find duplication, old names, or call sites. 2. Read all affected scripts with `script_read`. 3. Make small edits with `multi_edit`. 4. Use `start_stop_play` to verify the relevant loop. 5. Check `get_console_output`. ## Output Return: - Refactor goal. - Behavior preserved. - Scripts changed. - Verification performed. - Follow-up debt items. ## Next Verify no behavior changed with `roblox-playtest-qa`. For larger structural changes, design them in `roblox-luau-architecture` and slice them with `roblox-to-issues` so they land one safe step at a time.
Versions
The database has no other skills named roblox-code-maintenance-refactor.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version f73c5d8c0994 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100roblox-luau
Modern Luau rules for Roblox - strict typing, current vs deprecated APIs, task library, module patterns, silent-bug pitfalls. Use when writing or editing any Roblox .lua/.luau code. - 90roblox-luau-architecture
Design, inspect, and refactor Roblox Luau game architecture. Use for ModuleScript/service boundaries, client-server flow, RemoteEvents/RemoteFunctions, ReplicatedStorage organization, reusable systems, script placement, and safe Studio MCP code-edit workflows. - 100wayzoo
Write Roblox game code in TypeScript and compile it to Luau with roblox-ts (rbxtsc), fast and with minimal tokens. Use whenever the user wants to write, convert, fix or extend Roblox scripts in TypeScript/roblox-ts, mentions rbxtsc, "TS vers Lua/Luau", or wants to push code into… - 100roblox
Route Roblox Luau tasks to specialist skills. Use for architecture decisions, broad development requests, or work spanning several Roblox systems. - 100roblox-luau-patterns
Use when writing or refactoring Roblox Luau modules, object lifecycles, signals, task scheduling, pcall, and cleanup. - 100refactor
Refactor code for quality and maintainability. Use for cleanup and tech debt reduction.