Skip to content
Back to search

roblox-game-skill

The ultimate Roblox game development Claude Code skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/brockmartin--roblox-game-skill/badge.svg)](/listings/brockmartin--roblox-game-skill)

HTML

<a href="/listings/brockmartin--roblox-game-skill"><img src="/api/listings/brockmartin--roblox-game-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Already installed at `~/.claude/skills/roblox-game/`. The skill is detected automatically by Claude Code.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 123 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: roblox-game
  3. description: >
  4. Expert Roblox game development companion — Luau, Roblox Studio, MCP integration,
  5. simulator, tycoon, obby, RPG, horror, battle royale, game design, security, performance.
  6. user-invocable: true
  7. ---
  8. # Roblox Game Development Skill
  9. You are the ultimate Roblox game development companion. You bring deep Luau expertise,
  10. architecture mastery, security hardening, performance optimization, and autonomous game
  11. building via MCP Studio integration. You serve all skill levels — from first-timers to
  12. shipping studios.
  13. ---
  14. ## MCP Detection Logic
  15. On every invocation, detect the available MCP mode before doing anything else:
  16. 1. **Full mode** (`MCP_MODE = "full"`, 39 tools) — Community MCP server detected.
  17. Check for: `execute_luau`, `get_file_tree`, `grep_scripts`, `create_build`.
  18. Enables: live code execution, file tree browsing, script search, build creation.
  19. 2. **Standard mode** (`MCP_MODE = "standard"`, 6 tools) — Official MCP server detected.
  20. Check for: `run_code`, `insert_model`, `get_console_output`, `start_stop_play`.
  21. Enables: code execution, model insertion, console reads, play testing.
  22. 3. **Offline mode** (`MCP_MODE = "offline"`) — No MCP tools found.
  23. Pure code generation and guidance only. Provide copy-paste-ready scripts.
  24. All references, workflows, and outputs must adapt to the detected mode.
  25. ---
  26. ## Routing Table
  27. Match user intent and load the corresponding files:
  28. | User Intent | Load |
  29. |---|---|
  30. | Build a game (simulator/tycoon/RPG/obby/horror/BR) | `workflows/new-game.md` + `templates/genre-{type}.md` + `templates/game-scaffold.md` |
  31. | Fix bug / debug | `workflows/debug-loop.md` + `references/mcp-orchestration.md` |
  32. | Save/load data | `references/datastore-persistence.md` |
  33. | Combat system | `references/combat-systems.md` + `references/security-hardening.md` |
  34. | Shop / gamepass / monetization | `references/monetization-systems.md` + `references/gui-systems.md` |
  35. | Optimize performance | `workflows/performance-audit.md` + `references/performance-optimization.md` |
  36. | Security review | `workflows/security-audit.md` + `references/security-hardening.md` |
  37. | Set up Rojo / external tools | `references/tooling-ecosystem.md` |
  38. | Gotchas / sharp edges / common bugs | `references/sharp-edges.md` |
  39. | General Luau question | `references/luau-mastery.md` |
  40. | Game design question | `references/game-design-roblox.md` |
  41. | Ready to publish | `workflows/publish-checklist.md` |
  42. | Review monetization | `workflows/monetization-audit.md` |
  43. | Review code quality | `workflows/code-review.md` |
  44. | Animation / VFX | `references/animation-vfx.md` |
  45. | Multiplayer / networking | `references/multiplayer-networking.md` |
  46. | Testing | `references/testing-patterns.md` |
  47. | Inventory / items | `references/inventory-systems.md` |
  48. | GUI / UI | `references/gui-systems.md` |
  49. If intent is ambiguous, ask one clarifying question, then route.
  50. ---
  51. ## Core Quick Reference
  52. ### Service Hierarchy — What Goes Where
  53. - **ServerScriptService** — Server-only logic (game state, data, anti-cheat).
  54. - **ReplicatedStorage** — Shared ModuleScripts, RemoteEvents, assets both sides need.
  55. - **StarterPlayerScripts** — Client controllers (input, camera, UI logic).
  56. - **StarterGui** — UI ScreenGuis (they clone into PlayerGui on spawn).
  57. - **ServerStorage** — Server-only assets (maps, tools to clone on demand).
  58. - **Workspace** — The live 3D world. Keep it lean.
  59. ### Script Types
  60. | Type | Runs On | Use For |
  61. |---|---|---|
  62. | `Script` | Server | Game logic, data, physics authority |
  63. | `LocalScript` | Client | Input, camera, UI, local effects |
  64. | `ModuleScript` | Either | Shared code, config tables, utilities |
  65. ### RemoteEvent Basics
  66. ```luau
  67. -- Server: listen
  68. RemoteEvent.OnServerEvent:Connect(function(player, ...) end)
  69. -- Client: fire
  70. RemoteEvent:FireServer(...)
  71. -- Server → Client
  72. RemoteEvent:FireClient(player, ...)
  73. ```
  74. ### DataStore Basics
  75. ```luau
  76. local DataStoreService = game:GetService("DataStoreService")
  77. local store = DataStoreService:GetDataStore("PlayerData")
  78. -- Use :GetAsync(), :SetAsync(), :UpdateAsync() with pcall() ALWAYS.
  79. ```
  80. ### Golden Rule
  81. > **Never trust the client.** Every RemoteEvent payload is attacker-controlled.
  82. > Validate type, range, ownership, and cooldown on the server for every request.
  83. ---
  84. ## Top 5 Sharp Edges
  85. These are always relevant. Keep them in mind on every task.
  86. Full reference with code examples: `references/sharp-edges.md` (12 entries, severity-rated).
  87. | ID | Severity | Issue | Fix |
  88. |---|---|---|---|
  89. | SE-1 | CRITICAL | DataStore data loss from improper session locking | Use ProfileService/ProfileStore. Never raw SetAsync for player data. |
  90. | SE-2 | CRITICAL | Client-side currency manipulation | All currency math server-side only. Client is display-only. |
  91. | SE-3 | CRITICAL | ProcessReceipt mishandling (duplicates/refunds) | Grant item THEN return PurchaseGranted. If grant fails, return NotProcessedYet. |
  92. | SE-4 | HIGH | Memory leaks from undisconnected events | Store every `:Connect()` return → call `:Disconnect()` on cleanup. Use Maid/Trove. |
  93. | SE-5 | HIGH | RemoteEvent flooding / exploitation | Implement per-player rate limiting (track last-fire timestamps server-side). |
README.md · README · 119 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # roblox-game — Claude Code Skill
  2. The ultimate Roblox game development Claude Code skill. A self-contained, full-lifecycle development companion that serves all skill levels with deep Luau expertise, autonomous game building via MCP Studio integration, and comprehensive knowledge of game design, monetization, security, and performance optimization.
  3. ## Stats
  4. - **31 files** | **30,677 lines** | **1.0 MB**
  5. - 121-line SKILL.md router with lazy-loaded references
  6. - 3-mode MCP Studio integration (full/standard/offline)
  7. ## Architecture
  8. **Router + Reference Library** — lightweight SKILL.md dispatcher with lazy-loaded deep knowledge.
  9. ```
  10. roblox-game/
  11. ├── SKILL.md # Router (121 lines, 18 routing paths)
  12. ├── references/ # 16 deep reference files
  13. │ ├── luau-mastery.md
  14. │ ├── architecture-patterns.md
  15. │ ├── mcp-orchestration.md
  16. │ ├── security-hardening.md
  17. │ ├── datastore-persistence.md
  18. │ ├── gui-systems.md
  19. │ ├── performance-optimization.md
  20. │ ├── monetization-systems.md
  21. │ ├── combat-systems.md
  22. │ ├── inventory-systems.md
  23. │ ├── game-design-roblox.md
  24. │ ├── tooling-ecosystem.md
  25. │ ├── animation-vfx.md
  26. │ ├── multiplayer-networking.md
  27. │ ├── testing-patterns.md
  28. │ └── sharp-edges.md
  29. ├── templates/ # 7 game templates
  30. │ ├── game-scaffold.md # Universal base (any genre)
  31. │ ├── genre-simulator.md # Pet Simulator style
  32. │ ├── genre-tycoon.md # Retail Tycoon style
  33. │ ├── genre-obby.md # Tower of Hell style
  34. │ ├── genre-rpg.md # Blox Fruits style
  35. │ ├── genre-horror.md # Doors style
  36. │ └── genre-battle-royale.md # Battle royale style
  37. └── workflows/ # 7 guided workflows
  38. ├── new-game.md # Build a game from scratch
  39. ├── debug-loop.md # Iterative MCP debugging
  40. ├── performance-audit.md # Performance profiling
  41. ├── security-audit.md # Security review
  42. ├── publish-checklist.md # Pre-publish verification
  43. ├── monetization-audit.md # Revenue optimization
  44. └── code-review.md # Code quality review
  45. ```
  46. ## Features
  47. ### MCP Studio Integration (3 Modes)
  48. | Mode | Server | Tools | Capabilities |
  49. |------|--------|-------|-------------|
  50. | **Full** | boshyxd/robloxstudio-mcp | 39 | Project exploration, autonomous building, iterative debugging, bulk ops, Creator Store |
  51. | **Standard** | Roblox/studio-rust-mcp-server | 6 | Code execution, model insertion, console reading, play mode control |
  52. | **Offline** | None | 0 | Pure Luau code generation with placement instructions |
  53. Auto-detects which server is available and adapts all workflows accordingly.
  54. ### Genre Templates
  55. Each template includes complete, production-ready Luau code for every core system:
  56. - **Simulator** — Collection, pet system (hatching + rarity), zones, upgrades, prestige/rebirth
  57. - **Tycoon** — Plot claiming, droppers/collectors, button pad purchasing, income, tiers
  58. - **Obby** — Checkpoints, 5 obstacle types, timer/speedrun, leaderboards
  59. - **RPG** — Character stats + leveling, quest system, NPC AI, dialog trees, zones
  60. - **Horror** — Atmosphere control, monster AI (5-state FSM), event sequencer, jumpscares, flashlight
  61. - **Battle Royale** — Match lifecycle, shrinking storm, loot spawning, elimination tracking, spectator
  62. ### Guided Workflows
  63. - **New Game** — Build a complete game from a description in 8 steps
  64. - **Debug Loop** — Iterative error detection and fixing (max 5 attempts)
  65. - **Performance Audit** — Part count, script, memory, and network analysis
  66. - **Security Audit** — RemoteEvent validation, client trust, data exposure review
  67. - **Publish Checklist** — 60+ item pre-launch verification across 10 categories
  68. - **Monetization Audit** — GamePass, DevProduct, Premium, and Ad optimization
  69. - **Code Review** — A-F quality rating with specific fixes
  70. ### Deep References
  71. 16 reference files covering every aspect of Roblox development:
  72. - Luau language mastery with type system and OOP patterns
  73. - Game architecture (services, client-server, modules, frameworks)
  74. - Security hardening (never trust client, validation, rate limiting)
  75. - DataStore persistence (ProfileService, session locking, migration)
  76. - And 12 more specialized topics
  77. ### Sharp Edges
  78. 12 severity-rated gotchas that save you from disaster (Critical → Low):
  79. - DataStore data loss, client-side currency, ProcessReceipt bugs
  80. - Memory leaks, RemoteEvent flooding, BindToClose timeout
  81. - And 6 more common pitfalls with Luau code fixes
  82. ## Usage
  83. The skill is automatically invoked when you mention Roblox, Luau, game development, or any related keyword in Claude Code.
  84. **Example prompts:**
  85. - "Build me a pet simulator with 3 zones"
  86. - "How do I save player data in Roblox?"
  87. - "Review my game's security"
  88. - "Optimize this game for mobile"
  89. - "Add a shop system with GamePasses"
  90. ## Installation
  91. Already installed at `~/.claude/skills/roblox-game/`. The skill is detected automatically by Claude Code.
  92. ## Design Documents
  93. See `docs/plans/` for the full design document and 32-task implementation plan.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.