unity-probuilder
Model editable meshes with ProBuilder for blockout
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-probuilderIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions and examples for modeling and blockout in Unity using ProBuilder. It defines a set of tools for geometric manipulation within the Unity editor and includes heuristics for spatial design. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity ProBuilder Skills
Editable ProBuilder meshes, not ordinary primitive GameObjects; best for blockout, level geometry and procedural mesh refinement. Parameters come from the schema (GET /skills/schema?category=ProBuilder&wire=v2); execution and dryRun rules: root SKILL.md. Spatial heuristics, furniture and extended examples: reference/modeling.md.
When to use
- Blocking out levels, rooms or props
- Building or editing ProBuilder geometry, or prototyping shapes in the editor
Rules
- Batch first: use
probuilder_create_batchwhen creating 2 or more shapes. - Blockout order: major volumes first, then check traversal and scale, then face edits, vertex edits, and finally colours or materials.
- Target by
entityId(the only id on Unity 6000.4+),name,instanceIdorpath. PreferentityIdwhen several objects share a name. - Create and modify skills are
FullAuto: under Approval they need a grant. Queries (probuilder_get_info,probuilder_get_vertices) run directly. probuilder_combine_meshesis a Delete operation: refused under Approval and Auto.probuilder_delete_facesis onlyModifyand is grantable.- Without
com.unity.probuilder, every skill returns a package-missing diagnostic instead of running; tell the user. - Run
probuilder_get_infobefore face edits andprobuilder_get_verticesbefore vertex edits. - Mesh rebuilds (
ToMeshandRefresh) are handled by the skills; do not add a manual rebuild step. - Give a MeshCollider on physics-driven props a convex mesh.
Pitfalls
- Regular meshes do not become ProBuilder meshes automatically.
probuilder_set_materialassigns one material or quick colour to the whole object;probuilder_set_face_materialassigns to selected faces.
Routing
- Ordinary primitives without editable topology →
gameobject_create. - Material assets and shaders →
materialmodule. Lights →lightmodule; keep geometry creation here.
Skills Overview
| Skill | Purpose |
|---|---|
probuilder_create_shape / probuilder_create_batch | Parametric shape (Cube, Sphere, Cylinder, Cone, Torus, Prism, Arch, Pipe, Stairs, Door, Plane), one or many |
probuilder_extrude_faces | Extrude selected faces |
probuilder_delete_faces | Delete faces by index |
probuilder_merge_faces | Merge faces into one |
probuilder_flip_normals | Reverse face direction |
probuilder_detach_faces | Split faces from shared vertices |
probuilder_bevel_edges | Chamfer edges |
probuilder_extrude_edges | Extrude edges outward |
probuilder_bridge_edges | Bridge two edges with a new face |
probuilder_subdivide | Add detail by subdivision |
probuilder_conform_normals | Make normals point consistently outward |
probuilder_move_vertices | Offset vertices by a delta |
probuilder_set_vertices | Set absolute vertex positions |
probuilder_get_vertices | Query vertex positions |
probuilder_weld_vertices | Merge close vertices |
probuilder_project_uv | Box-project UVs |
probuilder_set_face_material | Assign a material to selected faces |
probuilder_set_material | Assign a whole-object material or quick colour |
probuilder_combine_meshes | Merge several meshes (Delete metadata) |
probuilder_get_info | Face, vertex and material statistics |
probuilder_center_pivot | Centre or reposition the pivot |
DO NOT (common hallucinations):
probuilder_create_meshdoes not exist: useprobuilder_create_shape.probuilder_edit_facedoes not exist: useprobuilder_extrude_faces,probuilder_delete_faces,probuilder_merge_facesand the other face skills.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-probuilder">View unity-probuilder on skillZs</a>