# roblox-asset-import

roblox-asset-import is a Claude Code skill that checks Roblox model imports for scale, pivots, collision, textures, and triangle budgets. It handles FBX, GLB, and OBJ tasks.

- 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-asset-import/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-asset-import

## What it does

roblox-asset-import reviews 3D assets before they reach Roblox Studio and sets the import rules for units, pivots, collision, textures, and triangle counts. It covers FBX, GLB, OBJ, rigged meshes, and PBR texture sets. The workflow needs the source files, their intended use, and a target device class. It also reads `LihFolk Vault V2` from the plugin directory through an absolute path.

After import, the skill checks pivots, collision flags, transparent colliders, texture dimensions, mesh counts, and mesh reuse. Decorative parts are kept non-colliding, while simple invisible `Part` colliders can handle floors and walls. The library rigs have not been test-imported into Studio, so the workflow calls for testing one rig first.

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- import an FBX, GLB, or OBJ at the intended scale
- find why a Roblox asset arrives too large or too small
- reset a misplaced pivot on an uploaded model
- choose collision settings for props, floors, and walls
- audit triangles, textures, and rigs after import

## Example prompts
- Import `asset.fbx` into Roblox and check its scale, pivot, and collision settings.
- Find out why `character.glb` arrives too large and fix the issue before the Studio import.
- Audit `weapon.obj` for excess triangles, UVs, materials, and PBR settings.

## Similar
- [threejs-asset-pipeline](https://affpapa.org/en/nevibecode/skills/threejs-asset-pipeline.md) — skill · 6500 installs
- [asset-pipeline](https://affpapa.org/en/nevibecode/skills/asset-pipeline.md) — skill · 2000 installs
- [godot-asset-generator](https://affpapa.org/en/nevibecode/skills/godot-asset-generator.md) — skill · 1000 installs
- [blender-asset-qa](https://affpapa.org/en/nevibecode/skills/blender-asset-qa.md) — skill · 765 installs
- [asset-optimization](https://affpapa.org/en/nevibecode/skills/asset-optimization.md) — skill · 720 installs
- [asset-audit](https://affpapa.org/en/nevibecode/skills/asset-audit.md) — skill · 702 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
