unity-probuilder

Create and edit ProBuilder meshes for Unity level blockout and greyboxing.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-probuilder-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-probuilder
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/probuilder
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-probuilder-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building level geometry in Unity by hand is slow when you need editable meshes for blockout and greyboxing. This Skill lets you create, edit, and refine ProBuilder meshes directly through skill calls, covering shapes, faces, edges, vertices, UVs, and materials without manual editor work. ## Core Features & Use Cases - Parametric Shape Creation: Create cubes, spheres, cylinders, stairs, arches, and more individually or in batches with probuilder_create_shape and probuilder_create_batch. - Topology Editing: Extrude, delete, merge, and detach faces, bevel and bridge edges, and move or weld vertices for ramps, slopes, and irregular silhouettes. - Materials and Querying: Assign quick colors or material assets to whole objects or selected faces, and inspect meshes with probuilder_get_info and probuilder_get_vertices. - Use Case: Block out a platformer level by batch-creating floors and platforms, verifying jump distances against gameplay scale rules, then cutting a ramp with vertex edits and color-coding platforms by gameplay role. ## Quick Start Ask the AI to block out a simple level with a ground plane, two platforms, and a ramp using ProBuilder, then color the platforms blue.

Frequently Asked Questions about unity-probuilder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create ProBuilder shapes in Unity from a script?

Use probuilder_create_shape with a shape type like Cube, Cylinder, or Stairs plus size and position parameters. For multiple shapes, probuilder_create_batch accepts an items array and an optional default parent in one call.

How do I make a ramp or slope with ProBuilder?

Create a Cube, call probuilder_get_vertices to identify the correct topology, then use probuilder_move_vertices with vertex indexes and a deltaY offset to lower one end. Vertex edits are the standard way to build ramps and irregular silhouettes.

Does this work without the ProBuilder package installed?

No. Every skill returns a package-missing diagnostic when com.unity.probuilder is not installed. Install the ProBuilder package through Unity Package Manager before using any create or edit operations.

What is the difference between probuilder_set_material and probuilder_set_face_material?

probuilder_set_material applies a material or quick RGB color to the entire object, while probuilder_set_face_material targets selected faces by index. Use face-level assignment for multi-material meshes and object-level for quick prototype coloring.

Why does probuilder_combine_meshes return MODE_FORBIDDEN?

probuilder_combine_meshes is marked with Modify and Delete operations, which blocks it in SemiAuto modes. It only runs under Bypass mode or after you add it to the Allowlist; the grant flow returns MODE_FORBIDDEN otherwise.

When should I use ProBuilder instead of regular GameObject primitives?

Use ProBuilder when you need editable topology for level geometry, blockout, or mesh refinement. For ordinary primitive objects without editable topology, use gameobject_create instead, since regular meshes do not become ProBuilder meshes automatically.