roblox-code-review — скилл для Claude Code: обзор кода и установка
Скилл roblox-code-review для Claude Code проверяет Roblox-код на уязвимости, потерю данных и ошибки жизненного цикла. Запускается при ревью PR или скрипта, аудите игры и обновлении устаревшего кода.
MIT 1 300 установок ★ 131 обновлён 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a claude-codeЧто делает roblox-code-review
Скилл проверяет код Roblox на ошибки безопасности, работы с данными, производительности и устаревшие API. Он проходит чек-лист по категориям и оценивает находки по степени серьёзности: от критических до низких. Каждую проблему нужно связать с файлом и строкой, описать её последствия и предложить исправление.
Проверка охватывает обработчики сетевых событий, сохранение данных, покупки, очистку ресурсов, работу с персонажами и фильтрацию пользовательского текста. Для устаревших и заменённых API есть карта изменений за 2026 год. При исправлении кода поведение сохраняют, кроме устранения самой ошибки, а затем повторяют подходящие проверки; для теста в Studio указан roblox-studio-mcp.
Какие задачи решает
- найти уязвимости в обработчиках RemoteEvent
- обнаружить риск потери данных при сохранении
- проверить утечки соединений и ошибки жизненного цикла
- выявить устаревшие API Roblox
Примеры запросов агенту
- Проведи ревью этого PR с Roblox-кодом и укажи серьёзность каждой проблемы.
- Проверь этот скрипт на эксплойты, утечки памяти и потерю данных.
- Найди устаревшие API в коде и предложи замену.
Как установить roblox-code-review
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a claude-code2Вручную: положить файлы
~/.claude/skills/roblox-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/roblox-code-review/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a codex2Вручную: положить файлы
.agents/skills/roblox-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a cursor2Вручную: положить файлы
.cursor/skills/roblox-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-code-review2Вручную: положить файлы
.github/skills/roblox-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-code-reviewВручную: положить файлы
.devin/skills/roblox-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о roblox-code-review
Как установить roblox-code-review в Claude Code?
Выполни npx skills add EL4CTEO/roblox-skills --skill roblox-code-review -a claude-code. Файл скилла находится по пути ~/.claude/skills/roblox-code-review/SKILL.md.
Что делает roblox-code-review?
Проверяет Roblox/Luau-код по категориям ошибок и выдаёт находки с уровнем серьёзности, файлом и строкой, последствиями и предложением исправления.
Какие проблемы проверяет roblox-code-review?
Среди проверок — безопасность сетевых обработчиков, сохранение данных и покупок, ошибки жизненного цикла, утечки памяти, фильтрация текста и устаревшие API.
Исходный текст
SKILL.md · MIT
---
name: roblox-code-review
description: Review Roblox/Luau code for exploits, data loss, memory leaks, performance problems, lifecycle bugs, policy issues, and deprecated or superseded APIs, using a severity-ranked checklist and the full 2026 deprecation map. Use when reviewing a PR or script, auditing a game before launch, modernizing legacy code, or asked what is wrong with some Roblox code.
---
# Roblox code review
Review in severity order. Report each finding with **file:line, severity, what breaks, and the fix**.
Verify claims against the code (and the engine reference when unsure) — don't pattern-match blindly.
## Severity guide
| Severity | Examples |
| --- | --- |
| **Critical** | Client-authoritative rewards/damage/currency; unvalidated remote args (NaN, instance spoofing); purchases granted outside `ProcessReceipt` or non-idempotent; data saved with `SetAsync` from multiple servers without session locking; secrets/API keys in replicated code; unfiltered player text shown to others. |
| **High** | Data loss paths (no `BindToClose`, saving default data after a failed load, no retry); memory leaks (connections, player-keyed tables); `InvokeClient`; per-frame remotes; infinite yields (`WaitForChild` without timeout on optional instances, `RemoteFunction` handlers that can yield forever); streaming-unsafe client indexing. |
| **Medium** | Deprecated/superseded APIs; `wait`/`spawn`/`delay`; polling loops; server-side tweens; missing `pcall` on network/yielding APIs; missing late-joiner handling; race conditions on `CharacterAdded`. |
| **Low** | Style, naming, missing types, magic numbers, dead code, minor inefficiencies. |
## Checklist
**Security** (`roblox-security`)
- Every `OnServerEvent`/`OnServerInvoke`: types checked with `typeof`, numbers `math.isfinite`, strings
length/UTF-8 checked, instances `IsA` + `IsDescendantOf(trusted)`, rate limited, context checked.
- No server-only logic, admin lists, or secrets in `ReplicatedStorage`/`StarterPlayer`/`Workspace`.
- `ProximityPrompt`/`ClickDetector`/`Touched` handlers re-validate distance/state on the server.
- Gameplay-critical unanchored parts are server-owned.
**Data** (`roblox-data-stores`)
- Session locking (ProfileStore or equivalent); `UpdateAsync` for read-modify-write; retries with backoff.
- `BindToClose` flushes saves in parallel; no saves of `Instance`/`Vector3`/mixed tables.
- Failed loads never overwritten with defaults; player-keyed tables cleared on leave.
- Keys stable (`User_{UserId}`), Studio uses a separate store/universe.
**Monetization** (`roblox-monetization`)
- Single `ProcessReceipt`; idempotent by `PurchaseId`; returns `PurchaseGranted` only after persisting.
- Pass perks checked on join **and** after in-session purchase; prices not hardcoded; paid random items
disclose odds and respect `PolicyService`.
**Correctness & lifecycle** (`roblox-architecture`)
- Handles players already in game (`for _, p in Players:GetPlayers()`) and characters already spawned.
- Per-character state rebuilt on respawn; per-player state cleaned on `PlayerRemoving`.
- No yields at module top level; no circular requires; one owner per piece of state.
- Deferred-event safe (doesn't rely on handlers running synchronously).
- Client code streaming-safe (`WaitForChild`/nil checks for `Workspace` content).
**Performance** (`roblox-performance`)
- No per-frame `FindFirstChild`/`GetDescendants`/`Instance.new`; params objects reused.
- Event-driven instead of polling; think loops throttled and staggered.
- Tweens and cosmetic effects on clients; remotes batched/throttled; payloads minimal.
- Connections disconnected / instances destroyed; no unbounded caches.
**Text & safety** (`roblox-text-chat`)
- All player-authored text shown to others filtered server-side (`FilterStringAsync`), fail closed.
- Chat uses `TextChatService`; public editable text rate-limited (≥ 1 minute).
**Modern API usage**
- `task.*`, `*Async` variants, `Raycast`, mover constraints, `PivotTo`, `Animator:LoadAnimation`,
`TextChatService`, `UIDragDetector`, `workspace` collision-group APIs, `CreatePath`+`ComputeAsync`.
- Full map of deprecated and superseded members: [references/deprecated-apis.md](references/deprecated-apis.md).
**Code quality** (`roblox-luau`)
- `--!strict` with typed public APIs; services via `GetService`; no `_G`/`shared`.
- Clear module boundaries; config separated from logic; tests for pure logic (`roblox-testing`).
## Output format
```text
## Summary
<2–3 sentences: overall risk, the most important fixes>
## Findings
1. [Critical] src/server/Shop.server.luau:42 — Price read from client argument.
Impact: exploiters buy anything for 0 coins. Fix: look up ITEMS[itemId].price on the server.
2. [High] ...
## Modernization (optional)
- Replace `wait()` → `task.wait()` (12 occurrences) ...
```
Offer to apply fixes; when fixing, keep behavior identical except for the bug, and re-run the relevant
checks (type check, tests, Studio playtest via `roblox-studio-mcp`).
© EL4CTEO · MIT · EL4CTEO/roblox-skills