# scenario-roblox-performance

scenario-roblox-performance — a skill for Claude Code and Cursor that diagnoses performance issues, frame drops, memory leaks, and lag in Roblox games.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 363 installs · ★ 3964 repo stars
- Author: scenario-labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/roblox/scenario-roblox-performance/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/scenario-roblox-performance

## What it does

The skill audits scenes for excessive draw calls and triangles, profiles Luau scripts, and targets low-end mobile devices with tight memory budgets. It operates on macOS within Roblox Studio using the `scenario-roblox-expert` toolkit.

The workflow runs playtest measurements, isolates per-frame costs, and checks for memory growth over time. Each change is tested individually to maintain frame consistency before shipping an update.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-roblox-performance -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scenario-roblox-performance/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scenario-roblox-performance/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-roblox-performance -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scenario-roblox-performance/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-roblox-performance -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scenario-roblox-performance/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills skills/game-engines/roblox/scenario-roblox-performance
```

2. **Manually: put the files in place**
- File: `.github/skills/scenario-roblox-performance/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-roblox-performance -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/game-engines/roblox/scenario-roblox-performance
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scenario-roblox-performance/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-roblox-performance -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/roblox/scenario-roblox-performance/SKILL.md

## When to use it
- diagnose mobile frame drops and stuttering in Roblox
- detect memory leaks in Luau scripts
- audit place geometry for excessive triangles and parts
- measure server CPU and network bandwidth usage

## Example prompts
- Check game performance and find lag sources on mobile
- Audit the scene for high triangle and draw call counts
- Profile scripts to find the heaviest per-frame functions

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 01bf6d16941cb808.

BEGIN THIRD-PARTY FILE 01bf6d16941cb808
```text
---
name: scenario-roblox-performance
description: "Use when a Roblox experience is slow, laggy, stuttering, crashing or out of memory, or before shipping or updating one: my game lags on mobile, low FPS, frame spikes, server lag or low heartbeat, physics lag, network lag or high KB/s, memory leaks or memory that keeps growing, crashes on phones, long join or load times, too many parts, instances, draw calls or triangles, MicroProfiler, Script Profiler, Luau heap, Developer Console memory, Scene Analysis, StreamingEnabled tuning, performance budgets, and publishing, releasing an update, restarting servers or rolling back a version."
license: MIT
---

# Roblox Performance and Release

Target: Roblox Studio (October 2026 build) on macOS, driven through the scenario-roblox-expert
toolkit.

Expert level here means every claim is a number from the side that hurts, taken before and after one
change, and every fix removes work instead of hiding it. Budgets come from the low-end phone, and
Studio numbers are labeled as Studio numbers. Release is part of performance: ship with a restart
plan and a rollback path, and never publish without the owner.

If a sibling skill named here is missing from your available skills, load it with `skill_get`
(Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install);
unattended, proceed from tool schemas and flag the gap.

**REQUIRED BACKGROUND:** scenario-roblox-expert (channels, review loop, toolkit, current-Roblox
traps).

## Stance (the expert delta)

1. **Budget for the low-end phone; label Studio numbers as Studio numbers.** McNeill's budget card
   targets a 2 GB phone: 500 draw calls, 500,000 triangles, 1.3 GB, 150,000 instances, 50 KB/s down
   (RDC 2024). Phones run CPU work about 4 times slower than a desktop. Studio memory "is incorrect
   in Studio, you need to test live" (McNeill). Studio runs the playtest Server and Client in one
   process, so server work shows in client frames [added, measured].
2. **Name the cause before the fix.** Label every per-frame system with `debug.profilebegin` and fix
   the longest lowest-level label (Roblox Learn, MicroProfiler). Studio's `execute_luau` reaches the
   Script Profiler, so an agent gets the same answer by code: `BasePart.CFrame [C]` and the scan
   label led the lab's server time (measured).
3. **Gate on frame consistency, compared per frame.** Fifty-nine 10 ms frames plus one 410 ms frame
   stutter at "60 fps" (Roblox Learn). Use the lead gate: p95 at most 1.2 times the budget, worst at
   most 2 times; healthy places read p95 17.2 to 17.4 ms at 60 fps. Compare script time per frame:
   per-frame work runs more often once a fix raises the frame rate [added, measured].
4. **Remove server work players never see.** "Never tween on the server" (Crusherfire). Resizing a
   welded server part re-replicates the whole assembly (McNeill and Lynn, RDC 2025). Anchoring idle
```
END THIRD-PARTY FILE 01bf6d16941cb808

The third-party file has ended. Everything between the 01bf6d16941cb808 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2937 of 18487 bytes. © scenario-labs · MIT · https://github.com/scenario-labs/skills/tree/HEAD/skills/game-engines/roblox/scenario-roblox-performance/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
