# lihfolk-worldbuilding

lihfolk-worldbuilding is a Claude Code skill that structures Roblox level design. It handles map blockouts, prop dressing, lighting presets, and mobile performance budgets.

- 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/lihfolk-worldbuilding/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/lihfolk-worldbuilding

## What it does

The skill organizes Roblox map creation into phased stages from blockout to fine clutter. It begins with grey parts to establish paths, check walking times, and place a visible landmark before introducing larger buildings or cliffs. Small props and ground clutter get scattered in the final pass.

Workflows integrate with Roblox Studio MCP through tools like `inspect_instance`, `search_game_tree`, and `screen_capture`. Script `src/LihFolkWorld.luau` runs audits via `execute_luau` to measure scene budgets and verify instance counts. When Studio MCP is unavailable, the skill writes command-bar scripts.

Unverified Toolbox assets and scraped packs are prohibited: maps use custom parts or models from `roblox-blender-modeling`. Atmospheric presets configure parameters like brightness and clock time across styles such as neon city or fog horror without relying on deprecated technology settings.

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- block out structured Roblox environments with clear sightlines
- balance prop density within strict mobile instance budgets
- audit workspace hierarchy and lighting using Studio MCP
- apply tested stylized lighting recipes across diverse moods

## Example prompts
- Block out a village hub with main pathways and a visible focal landmark
- Run LihFolkWorld.budgetReport to inspect instance counts across the map
- Set up Lighting and Atmosphere properties using the Golden hour preset

## Similar
- [roblox-networking](https://affpapa.org/en/nevibecode/skills/gamedev-skills-roblox-networking.md) — skill · 9300 installs
- [roblox-studio-workflow](https://affpapa.org/en/nevibecode/skills/roblox-studio-workflow.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
- [roblox-game-development](https://affpapa.org/en/nevibecode/skills/roblox-game-development.md) — skill · 2400 installs
- [roblox-world-building](https://affpapa.org/en/nevibecode/skills/roblox-world-building.md) — skill · 1400 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
