agentleFS
AshExplainedAshExplained/roblox-skills/roblox-world-level-design/SKILL.md

roblox-world-level-design

Skill5 starsChanged 5 months agoMITView on GitHub

Design Roblox worlds, levels, hubs, zones, biomes, obbies, arenas, and exploration spaces. Use for spatial layout, landmarks, player flow, spawn design, objective placement, onboarding paths, traversal, sightlines, social spaces, performance-aware world layout, and guiding players without text.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 6 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use tall or distinct landmarks to orient players.

    line 26
  2. Distinctive:

    Keep important interactables visually louder than decoration.

    line 27
  3. Distinctive:

    Avoid clutter that hides objectives or enemies.

    line 28
  4. Distinctive:

    Avoid over-dense prop clusters in the first playable area.

    line 45
  5. Distinctive:

    Keep expensive particles, transparency, physics, and lights intentional.

    line 46
  6. Distinctive:

    Use occlusion, terrain shape, and zone gates to control visual complexity.

    line 47
  7. Very specific:

    Use character_navigation during Play mode to test routes and first-action time.

    line 52
  8. Very specific:

    Use execute_luau for measurements, markers, or layout adjustments.

    line 53
  9. Very specific:

    Check the layout's cost with roblox-performance-optimization, and confirm player flow and first-action clarity with roblox-game-ux and …

    line 69

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Roblox World Level Design

Goal

Build spaces that guide players naturally, support the core loop, and feel good on mobile.

Spatial Flow

Design for:

  • Spawn facing the first objective or landmark.
  • First action reachable within 10-30 seconds.
  • Clear routes using shape, color, lighting, motion, and landmarks.
  • Short loops that bring players back to rewards, upgrades, or social areas.
  • New zones that visibly tease future goals.
  • Safe space before challenge space.

Landmarks And Readability

  • Give each zone a readable silhouette and color identity.
  • Use tall or distinct landmarks to orient players.
  • Keep important interactables visually louder than decoration.
  • Avoid clutter that hides objectives or enemies.
  • Make paths understandable without walls of text.

Gameplay Placement

Place:

  • Objectives where players naturally look and move.
  • Rewards immediately after effort.
  • Shops and upgrades near loop return points.
  • Social spaces where players can show progress.
  • Bosses or challenges after preparation cues.
  • Hidden secrets off the main path, not on the onboarding path.

Performance-Aware Layout

  • Stream or stage distant content when possible.
  • Avoid over-dense prop clusters in the first playable area.
  • Keep expensive particles, transparency, physics, and lights intentional.
  • Use occlusion, terrain shape, and zone gates to control visual complexity.

MCP Workflow

  1. Inspect the world with search_game_tree, inspect_instance, and screen_capture.
  2. Use character_navigation during Play mode to test routes and first-action time.
  3. Use execute_luau for measurements, markers, or layout adjustments.
  4. Playtest after layout changes and check get_console_output.

Output

Return:

  • Player path.
  • Landmarks and guidance cues.
  • Objective and reward placement.
  • Social space plan.
  • Mobile and performance risks.
  • Playtest checks.

Next

Check the layout's cost with roblox-performance-optimization, and confirm player flow and first-action clarity with roblox-game-ux and roblox-playtest-qa.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.