# roblox-debugging

roblox-debugging is a Claude Code skill that enforces a structured diagnosis flow for Luau codebases. It activates during desync issues, race conditions, physics glitches, and live server errors.

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

## What it does

The skill organizes Luau troubleshooting into explicit steps: symptom classification, reproducible test cases, bisection, and stress-tested verification. It halts code modifications until the failure steps and failure rate are documented.

Operation depends on the LihFolk Vault V2 documentation folder bundled inside the plugin directory. The workflow prevents masking bugs with arbitrary `task.wait` delays or blanket nil checks.

The procedure inspects server and client states independently, validates DataStore budgets without cache, and tracks assembly network ownership. Every accepted patch requires a permanent guard assertion and verified runs under latency.

## 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-debugging -a claude-code
```

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/roblox-debugging/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-debugging
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/roblox-debugging/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-debugging/SKILL.md

## When to use it
- isolate client-server desynchronization in Luau scripts
- trace root causes behind Infinite yield warnings
- fix execution order races during character spawning
- debug physics vibration and network ownership transfer issues

## Example prompts
- Debug an Infinite yield warning appearing in the output log
- Players rubber-band when boarding moving assemblies on live servers
- DataStore values roll back after leaving the session, trace the failure

## Similar
- [roblox-studio-workflow](https://affpapa.org/en/nevibecode/skills/roblox-studio-workflow.md) — skill · 9300 installs
- [roblox-testing](https://affpapa.org/en/nevibecode/skills/roblox-testing.md) — skill · 560 installs
- [scenario-roblox-expert](https://affpapa.org/en/nevibecode/skills/scenario-roblox-expert.md) — skill · 411 installs
- [roblox-networking](https://affpapa.org/en/nevibecode/skills/gamedev-skills-roblox-networking.md) — skill · 9300 installs
- [roblox-building](https://affpapa.org/en/nevibecode/skills/roblox-building.md) — skill · 4200 installs
- [roblox-lighting](https://affpapa.org/en/nevibecode/skills/roblox-lighting.md) — skill · 3900 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
