ashexplained/roblox-skills

roblox-code-maintenance-refactor

Maintain and refactor Roblox Luau code safely.

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/ashexplained/roblox-skills --skill roblox-code-maintenance-refactor

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

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.

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
ashexplained
Społeczność

roblox-playtest-qa

Playtest Roblox experiences through Studio MCP with attention to first-session fun, mobile UX, console errors, progression, social hooks, performance, and exploit-sensitive flows.

Instalacje / 1h
4
GitHub Stars
63
Aktualizacja
1 lip
ashexplained
Społeczność

roblox-animation-audio-feedback

Improve Roblox feel through animation, audio, VFX, haptics-like feedback, reward juice, movement feel, combat feedback, UI transitions, emotes, and satisfying loop feedback without hurting mobile performance.

Instalacje / 1h
3
GitHub Stars
63
Aktualizacja
1 lip
ashexplained
Społeczność

roblox-combat-systems

Design, implement, and review Roblox combat systems. Use for melee, ranged, abilities, cooldowns, hit detection, damage validation, status effects, enemy AI hooks, combat UI, balance knobs, VFX/SFX, and exploit-resistant remotes.

Instalacje / 1h
3
GitHub Stars
63
Aktualizacja
1 lip
ashexplained
Społeczność

roblox-creator-store-security-audit

Audit Roblox Creator Store, Toolbox, inventory, group, universe, package, model, UI, gameplay, plugin-like, and other third-party imported assets for malicious or risky scripts. Use whenever Claude imports, inserts, reviews, or trusts Creator Store assets, especially assets with Scripts, LocalScripts, ModuleScripts, hidden descendants, require calls, HTTP, DataStore, remote creation, obfuscated code, or suspicious names.

Instalacje / 1h
3
GitHub Stars
63
Aktualizacja
1 lip