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.
Badge for your README
Markdown
[](/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
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)
- ---
- name: roblox-game
- description: >
- Expert Roblox game development companion — Luau, Roblox Studio, MCP integration,
- simulator, tycoon, obby, RPG, horror, battle royale, game design, security, performance.
- user-invocable: true
- ---
- # Roblox Game Development Skill
- You are the ultimate Roblox game development companion. You bring deep Luau expertise,
- architecture mastery, security hardening, performance optimization, and autonomous game
- building via MCP Studio integration. You serve all skill levels — from first-timers to
- shipping studios.
- ---
- ## MCP Detection Logic
- On every invocation, detect the available MCP mode before doing anything else:
- 1. **Full mode** (`MCP_MODE = "full"`, 39 tools) — Community MCP server detected.
- Check for: `execute_luau`, `get_file_tree`, `grep_scripts`, `create_build`.
- Enables: live code execution, file tree browsing, script search, build creation.
- 2. **Standard mode** (`MCP_MODE = "standard"`, 6 tools) — Official MCP server detected.
- Check for: `run_code`, `insert_model`, `get_console_output`, `start_stop_play`.
- Enables: code execution, model insertion, console reads, play testing.
- 3. **Offline mode** (`MCP_MODE = "offline"`) — No MCP tools found.
- Pure code generation and guidance only. Provide copy-paste-ready scripts.
- All references, workflows, and outputs must adapt to the detected mode.
- ---
- ## Routing Table
- Match user intent and load the corresponding files:
- | User Intent | Load |
- |---|---|
- | Build a game (simulator/tycoon/RPG/obby/horror/BR) | `workflows/new-game.md` + `templates/genre-{type}.md` + `templates/game-scaffold.md` |
- | Fix bug / debug | `workflows/debug-loop.md` + `references/mcp-orchestration.md` |
- | Save/load data | `references/datastore-persistence.md` |
- | Combat system | `references/combat-systems.md` + `references/security-hardening.md` |
- | Shop / gamepass / monetization | `references/monetization-systems.md` + `references/gui-systems.md` |
- | Optimize performance | `workflows/performance-audit.md` + `references/performance-optimization.md` |
- | Security review | `workflows/security-audit.md` + `references/security-hardening.md` |
- | Set up Rojo / external tools | `references/tooling-ecosystem.md` |
- | Gotchas / sharp edges / common bugs | `references/sharp-edges.md` |
- | General Luau question | `references/luau-mastery.md` |
- | Game design question | `references/game-design-roblox.md` |
- | Ready to publish | `workflows/publish-checklist.md` |
- | Review monetization | `workflows/monetization-audit.md` |
- | Review code quality | `workflows/code-review.md` |
- | Animation / VFX | `references/animation-vfx.md` |
- | Multiplayer / networking | `references/multiplayer-networking.md` |
- | Testing | `references/testing-patterns.md` |
- | Inventory / items | `references/inventory-systems.md` |
- | GUI / UI | `references/gui-systems.md` |
- If intent is ambiguous, ask one clarifying question, then route.
- ---
- ## Core Quick Reference
- ### Service Hierarchy — What Goes Where
- - **ServerScriptService** — Server-only logic (game state, data, anti-cheat).
- - **ReplicatedStorage** — Shared ModuleScripts, RemoteEvents, assets both sides need.
- - **StarterPlayerScripts** — Client controllers (input, camera, UI logic).
- - **StarterGui** — UI ScreenGuis (they clone into PlayerGui on spawn).
- - **ServerStorage** — Server-only assets (maps, tools to clone on demand).
- - **Workspace** — The live 3D world. Keep it lean.
- ### Script Types
- | Type | Runs On | Use For |
- |---|---|---|
- | `Script` | Server | Game logic, data, physics authority |
- | `LocalScript` | Client | Input, camera, UI, local effects |
- | `ModuleScript` | Either | Shared code, config tables, utilities |
- ### RemoteEvent Basics
- ```luau
- -- Server: listen
- RemoteEvent.OnServerEvent:Connect(function(player, ...) end)
- -- Client: fire
- RemoteEvent:FireServer(...)
- -- Server → Client
- RemoteEvent:FireClient(player, ...)
- ```
- ### DataStore Basics
- ```luau
- local DataStoreService = game:GetService("DataStoreService")
- local store = DataStoreService:GetDataStore("PlayerData")
- -- Use :GetAsync(), :SetAsync(), :UpdateAsync() with pcall() ALWAYS.
- ```
- ### Golden Rule
- > **Never trust the client.** Every RemoteEvent payload is attacker-controlled.
- > Validate type, range, ownership, and cooldown on the server for every request.
- ---
- ## Top 5 Sharp Edges
- These are always relevant. Keep them in mind on every task.
- Full reference with code examples: `references/sharp-edges.md` (12 entries, severity-rated).
- | ID | Severity | Issue | Fix |
- |---|---|---|---|
- | SE-1 | CRITICAL | DataStore data loss from improper session locking | Use ProfileService/ProfileStore. Never raw SetAsync for player data. |
- | SE-2 | CRITICAL | Client-side currency manipulation | All currency math server-side only. Client is display-only. |
- | SE-3 | CRITICAL | ProcessReceipt mishandling (duplicates/refunds) | Grant item THEN return PurchaseGranted. If grant fails, return NotProcessedYet. |
- | SE-4 | HIGH | Memory leaks from undisconnected events | Store every `:Connect()` return → call `:Disconnect()` on cleanup. Use Maid/Trove. |
- | 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)
- # roblox-game — Claude Code Skill
- 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.
- ## Stats
- - **31 files** | **30,677 lines** | **1.0 MB**
- - 121-line SKILL.md router with lazy-loaded references
- - 3-mode MCP Studio integration (full/standard/offline)
- ## Architecture
- **Router + Reference Library** — lightweight SKILL.md dispatcher with lazy-loaded deep knowledge.
- ```
- roblox-game/
- ├── SKILL.md # Router (121 lines, 18 routing paths)
- ├── references/ # 16 deep reference files
- │ ├── luau-mastery.md
- │ ├── architecture-patterns.md
- │ ├── mcp-orchestration.md
- │ ├── security-hardening.md
- │ ├── datastore-persistence.md
- │ ├── gui-systems.md
- │ ├── performance-optimization.md
- │ ├── monetization-systems.md
- │ ├── combat-systems.md
- │ ├── inventory-systems.md
- │ ├── game-design-roblox.md
- │ ├── tooling-ecosystem.md
- │ ├── animation-vfx.md
- │ ├── multiplayer-networking.md
- │ ├── testing-patterns.md
- │ └── sharp-edges.md
- ├── templates/ # 7 game templates
- │ ├── game-scaffold.md # Universal base (any genre)
- │ ├── genre-simulator.md # Pet Simulator style
- │ ├── genre-tycoon.md # Retail Tycoon style
- │ ├── genre-obby.md # Tower of Hell style
- │ ├── genre-rpg.md # Blox Fruits style
- │ ├── genre-horror.md # Doors style
- │ └── genre-battle-royale.md # Battle royale style
- └── workflows/ # 7 guided workflows
- ├── new-game.md # Build a game from scratch
- ├── debug-loop.md # Iterative MCP debugging
- ├── performance-audit.md # Performance profiling
- ├── security-audit.md # Security review
- ├── publish-checklist.md # Pre-publish verification
- ├── monetization-audit.md # Revenue optimization
- └── code-review.md # Code quality review
- ```
- ## Features
- ### MCP Studio Integration (3 Modes)
- | Mode | Server | Tools | Capabilities |
- |------|--------|-------|-------------|
- | **Full** | boshyxd/robloxstudio-mcp | 39 | Project exploration, autonomous building, iterative debugging, bulk ops, Creator Store |
- | **Standard** | Roblox/studio-rust-mcp-server | 6 | Code execution, model insertion, console reading, play mode control |
- | **Offline** | None | 0 | Pure Luau code generation with placement instructions |
- Auto-detects which server is available and adapts all workflows accordingly.
- ### Genre Templates
- Each template includes complete, production-ready Luau code for every core system:
- - **Simulator** — Collection, pet system (hatching + rarity), zones, upgrades, prestige/rebirth
- - **Tycoon** — Plot claiming, droppers/collectors, button pad purchasing, income, tiers
- - **Obby** — Checkpoints, 5 obstacle types, timer/speedrun, leaderboards
- - **RPG** — Character stats + leveling, quest system, NPC AI, dialog trees, zones
- - **Horror** — Atmosphere control, monster AI (5-state FSM), event sequencer, jumpscares, flashlight
- - **Battle Royale** — Match lifecycle, shrinking storm, loot spawning, elimination tracking, spectator
- ### Guided Workflows
- - **New Game** — Build a complete game from a description in 8 steps
- - **Debug Loop** — Iterative error detection and fixing (max 5 attempts)
- - **Performance Audit** — Part count, script, memory, and network analysis
- - **Security Audit** — RemoteEvent validation, client trust, data exposure review
- - **Publish Checklist** — 60+ item pre-launch verification across 10 categories
- - **Monetization Audit** — GamePass, DevProduct, Premium, and Ad optimization
- - **Code Review** — A-F quality rating with specific fixes
- ### Deep References
- 16 reference files covering every aspect of Roblox development:
- - Luau language mastery with type system and OOP patterns
- - Game architecture (services, client-server, modules, frameworks)
- - Security hardening (never trust client, validation, rate limiting)
- - DataStore persistence (ProfileService, session locking, migration)
- - And 12 more specialized topics
- ### Sharp Edges
- 12 severity-rated gotchas that save you from disaster (Critical → Low):
- - DataStore data loss, client-side currency, ProcessReceipt bugs
- - Memory leaks, RemoteEvent flooding, BindToClose timeout
- - And 6 more common pitfalls with Luau code fixes
- ## Usage
- The skill is automatically invoked when you mention Roblox, Luau, game development, or any related keyword in Claude Code.
- **Example prompts:**
- - "Build me a pet simulator with 3 zones"
- - "How do I save player data in Roblox?"
- - "Review my game's security"
- - "Optimize this game for mobile"
- - "Add a shop system with GamePasses"
- ## Installation
- Already installed at `~/.claude/skills/roblox-game/`. The skill is detected automatically by Claude Code.
- ## Design Documents
- See `docs/plans/` for the full design document and 32-task implementation plan.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.