# roblox-performance-audit

roblox-performance-audit is a Claude Code skill that diagnoses bottlenecks, memory leaks, and network overhead in Roblox experiences using measured profiles.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 98 repo stars
- Author: LihFolk
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lihfolk-cy/v2-vault/tree/HEAD/skills/roblox-performance-audit/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/roblox-performance-audit

## What it does

The skill runs a disciplined performance loop across client and server environments. Every issue is isolated into compute delays, memory creep, or load times. It enforces baselines gathered on actual target devices such as budget mobile hardware, rejecting numbers taken solely from Roblox Studio.

Budgets target 60 fps on phones: 8 to 10 ms for rendering, 2 to 3 ms for engine physics, and 2 ms for custom client scripts. Server scripts target under 5 ms per heartbeat under full player capacity. Leaks are tracked by sampling memory growth slopes across repeated loops rather than single snapshots, isolating uncleaned event listeners, unmanaged player tables, and unconstrained caches.

The skill relies on the LihFolk Vault V2 documentation bundle stored in the plugin folder. Code modifications are blocked until MicroProfiler captures confirm the primary bottleneck.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add lihfolk-cy/v2-vault
```
In the agent chat (not a shell):
```text
/plugin install lihfolk@lihfolk
```
This installs the whole lihfolk plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add lihfolk-cy/v2-vault --skill roblox-performance-audit -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lihfolk-cy/v2-vault --skill roblox-performance-audit -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lihfolk-cy/v2-vault --skill roblox-performance-audit -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lihfolk-cy/v2-vault skills/roblox-performance-audit
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lihfolk-cy/v2-vault --skill roblox-performance-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lihfolk-cy/v2-vault --path skills/roblox-performance-audit
```

### Windsurf (Devin Desktop)

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

### 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/lihfolk-cy/v2-vault/tree/HEAD/skills/roblox-performance-audit/SKILL.md

## When to use it
- profile frame drops using MicroProfiler timers and custom labels
- track memory leak slopes across player respawns and zone transitions
- audit remote event traffic to avoid client replication bottlenecks
- enforce asset instance caps and texture sizing on mobile hardware

## Example prompts
- Audit client performance drops happening on mobile devices
- Inspect server memory growth over repeated match loops
- Check MicroProfiler labels against our 60 fps frame budget

## Similar
- [roblox-performance](https://affpapa.org/en/nevibecode/skills/roblox-performance.md) — skill · 3600 installs
- [scenario-roblox-performance](https://affpapa.org/en/nevibecode/skills/scenario-roblox-performance.md) — skill · 363 installs
- [roblox-testing](https://affpapa.org/en/nevibecode/skills/roblox-testing.md) — skill · 560 installs
- [roblox-input](https://affpapa.org/en/nevibecode/skills/roblox-input.md) — skill · 3100 installs
- [scenario-roblox-expert](https://affpapa.org/en/nevibecode/skills/scenario-roblox-expert.md) — skill · 411 installs
- [roblox-studio-workflow](https://affpapa.org/en/nevibecode/skills/roblox-studio-workflow.md) — skill · 9300 installs

From the same set: [lihfolk-cy/v2-vault](https://affpapa.org/en/nevibecode/by/lihfolk-cy/v2-vault.md) — 29 cards

---
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
