unity-probuilder

Create and edit ProBuilder meshes in Unity for level blockout and prototyping.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-probuilder-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-probuilder
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/probuilder
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-probuilder-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building level geometry and prototype shapes in Unity normally requires manual editor work or external modeling tools. This Skill lets an AI agent create, edit, and refine editable ProBuilder meshes programmatically, covering blockout, face and vertex editing, and material assignment. ## Core Features & Use Cases - Parametric Shape Creation: Create cubes, spheres, cylinders, stairs, arches, and more individually or in batch via probuilder_create_shape and probuilder_create_batch. - Topology Editing: Extrude, delete, merge, and detach faces, bevel and bridge edges, weld and move vertices, and subdivide meshes for detailed refinement. - Materials and Querying: Assign whole-object or per-face materials, apply quick prototype colors, and inspect mesh stats with probuilder_get_info and probuilder_get_vertices. - Use Case: Block out a playable level by batch-creating floors, platforms, and ramps, adjust a ramp's slope with vertex edits, then color-code platforms by gameplay role before art passes. ## Quick Start Ask the agent to block out a small test level in Unity using ProBuilder with a ground plane, two platforms, and a ramp colored by gameplay role.

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 edit ProBuilder faces and vertices in Unity?

Query the mesh first with probuilder_get_info or probuilder_get_vertices to identify indexes, then apply probuilder_extrude_faces, probuilder_delete_faces, probuilder_move_vertices, or probuilder_weld_vertices with the target name or instanceId.

Does this require the ProBuilder package installed in Unity?

Yes, the com.unity.probuilder package must be installed. When it is missing, every skill in the module returns a package-missing diagnostic instead of executing any mesh operation.

What is the difference between probuilder_set_material and probuilder_set_face_material?

probuilder_set_material assigns a material or quick RGB color to the entire object, while probuilder_set_face_material targets selected face indexes or a submesh. They are separate skills and not interchangeable.

Why does probuilder_combine_meshes return MODE_FORBIDDEN?

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

When should I use ProBuilder instead of regular GameObjects?

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