Skip to main content
skill CX Codex

scenario-zbrush-hard-surface — Claude Code skill: install

The scenario-zbrush-hard-surface skill guides an agent through hard-surface work in ZBrush, from Boolean cuts to edge shaping. Use it for armor, mechanical parts, or game assets.

MIT 432 installs ★ 3,964 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a claude-code
Open on GitHub

What scenario-zbrush-hard-surface does

The skill lays out a hard-surface workflow: polygroups guide creasing, Dynamic Subdivision controls edge width, and Live Boolean handles cuts. It addresses issues such as holes after Make Boolean Mesh, uneven planes, and symmetry edits that disappear. Check edge width on a metal material, and feed Boolean operations clean meshes without coplanar faces.

The package includes scripts/zb_hardsurface.py for part operations and Boolean roles. Some actions rely on clicks or strokes; Knife, Clip, Trim, and Slice need workarounds. It requires scenario-zbrush-expert for the bridge, stroke handling, and review loop. The script has not been run in ZBrush, so its behavior there has not been verified.

What it helps with

  • set edge width with CreaseLvl and Dynamic Subdivision
  • prepare a mesh for Boolean operations
  • repeat fasteners with ArrayMesh or NanoMesh
  • repair symmetry after Mirror And Weld
  • separate panel parts with polygroups

Example prompts for the agent

  • Help me model a hard-surface sci-fi helmet in ZBrush and tune its edges with CreaseLvl.
  • Find why Make Boolean Mesh leaves holes and check the mesh before the Boolean.
  • Set up repeating fasteners with ArrayMesh and keep the cuts editable.

How to install scenario-zbrush-hard-surface

1Skills CLI (Vercel)

npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a claude-code

2Manually: put the files in place

~/.claude/skills/scenario-zbrush-hard-surface/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/scenario-zbrush-hard-surface/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about scenario-zbrush-hard-surface

How do I install scenario-zbrush-hard-surface in Claude Code?

Run npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a claude-code. The skill file is at ~/.claude/skills/scenario-zbrush-hard-surface/SKILL.md.

What does scenario-zbrush-hard-surface do?

It guides an agent through hard-surface modeling in ZBrush, including Boolean work, polygroups, edge shaping, and repeated details.

What does this skill require?

It depends on scenario-zbrush-expert for the bridge, stroke handling, and review loop. Some operations, including Knife and Slice, require clicks, strokes, or workarounds.

Source text

SKILL.md · MIT
---
name: scenario-zbrush-hard-surface
description: "Use when modeling hard surface in ZBrush 2026 (sci-fi helmet, weapon, prop, armor plates, mechanical parts, kitbash, vents, panel lines, bolts, concept to game asset), when using ZModeler, Dynamic Subdivision and creasing, Live Boolean, Knife, Clip, Slice or Trim curves, IMM, ArrayMesh, NanoMesh or Panel Loops, or when edges look razor sharp, a Make Boolean Mesh fails or leaves holes, planes look wobbly, Mirror And Weld erased an edit, or ZRemesher ruins a hard-surface part."
license: MIT
---

# ZBrush hard surface

Hard surface is judged as a result: it reads as manufactured when every edge is clearly straight or
clearly curved, planes carry an even highlight, edges are wide enough to catch light and every part
could be built (Plouffe, Klimer). The agent builds that language from deterministic operations
(primitives, Live Boolean stacks, polygroups as the crease plan, Dynamic Subdivision numbers,
ArrayMesh, Panel Loops) and uses clicks and strokes only where nothing else exists. If a sibling
skill named here is missing from your available skills, load it with `skill_get` (Scenario MCP) or
ask the user to install it (https://github.com/scenario-labs/skills#install); unattended, proceed
from tool schemas and flag the gap.

**REQUIRED BACKGROUND:** scenario-zbrush-expert (bridge, stroke engine, review loop, 2026 traps).
Toolkit: [`scripts/zb_hardsurface.py`](scripts/zb_hardsurface.py)
(`import sys; sys.path.insert(0, "<this skill>/scripts"); import zb_hardsurface as hs`, then
`hs.hs_call("new_part", "cube")`), built on the lead's `zb_ops`, `zb_review`, `zb_audit` and
`zb_stroke`. Nothing in it has run in ZBrush yet.

## Stance (the expert delta)

- **Polygroups are the crease plan.** Groups By Normals at 45 degrees (33 catches softer planes, 60
  misses edges), Mirror And Weld, UnCreaseAll, Crease PG (Pavlovich; Plouffe). Crease first, a loop
  only where the falloff must be local. Crease PG after later edits recreases borders you softened
  on purpose: regroup, or crease by angle.
- **The gap SmoothSubdiv minus CreaseLvl sets the edge.** 0 reads razor, "very CG"; the closer
  CreaseLvl sits to SmoothSubdiv, the tighter the edge, so 4/3 is tighter than 4/2
  (`hs.edge_width`). Pavlovich works at 3/2 and bakes 4/2; Plouffe keeps CreaseLvl 3 over a razor 4
  and calls 2 too soft. Deciding condition: render both under metal, keep the widest edge that still
  looks planned.
- **QGrid is for boxy blocks** (it facets arcs). Curved spans take Smooth Subdiv plus Crease
  Tolerance, tuned per span: 22 held Pavlovich's arch; too low creases the arc's small angles.
- **Booleans need clean inputs** (Live Boolean doc; Pavlovich): watertight, no coplanar faces,
  similar density, low Dynamic levels, nothing partly hidden. DSDiv on, one Start group per separate
  part, then ZRemesher Detect Edges at Half. Creases, UVs, levels and layers die in the boolean;
  polygroups survive.
- **Keep cuts and repeats live.** ArrayMesh the cutter, not the result. Instanced fasteners
  (NanoMesh, ArrayMesh) make a late "flathead, not Phillips" one Edit Mesh swap; per-seat imports
  cost one call per seat.
- **Straight or curved, never in between** (Plouffe). Polish planes, then edges, then corner
  softness, sharp to smooth; never mix sharp and round edges close together; one cavity along a
  border sells a separate plate.
- **Function and camera set the detail** (Klimer): how it is made, where power flows, one fastener
  family, repeated angles identical. Validate twice in engine: the block (500 to 40k polys) with the
  rig, then a decimated high under 1M points. Unseen interiors and undersides stay filled or simple,
  sold by dark AO (Pavlovich).
- **Micro detail waits for sign-off, on 3D layers** (Klimer): a negative strength carves in,
  duplicating doubles, and a layer dies with any topology change, so layers come after the last
  boolean, remesh or Apply [added].
- **Mirror And Weld always copies negative X onto positive X.** Good half on +X: Deformation Mirror
  first (Pavlovich, Plouffe). Slice, Trim and BRadius ignore symmetry, so every one-sided edit ends
  here.

## What the agent can and cannot do here

| Deterministic (script it)                                                                                                                                                                | Click or stroke [verify]                                                                                                                                  | GUI only, or substitute                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Primitives, Unify, placement (`new_part`, `place`, `import_part`); Live Boolean roles (`set_roles`, `roles_from_groups`), DSDiv, Make Boolean Mesh, Show Coplanar and Show Issues        | ZModeler: a saved brush or 2026 preset holding the action and crease option, one `canvas_action` at `click_target` (a drag the first time; a tap replays) | Clip, Trim, Slice, Knife (Ctrl+Shift drag; `press_key` is broken): boolean cutters, `fitted_split_groups`, DynaMesh Groups on a group outline, a ZScript `IKeyPress` wrapper (scenario-zbrush-automation) |
| Dynamic Subdiv, CreaseLvl, CTolerance, Crease PG, Crease Bevel, Apply                                                                                                                    | NanoMesh insert: one click on a face of the target group, or on a front-facing plane (the shipped macro's routine)                                        | Gizmo deformers: Deformation sliders on an axis-aligned part                                                                                                                                              |
| Groups By Normals, Mirror And Weld, Panel Loops, GroupsLoops, ArrayMesh, NanoMesh sliders, MeshFromBrush (`fastener_from_brush`), masks (`mask_fillet`), ZRemesher, DynaMesh, Decimation | IMM: a synthesized Dots stroke, or Curve Mode on script curves; `imm_ready` first                                                                         | Retopo brush, Mask By Polypaint dialog, freehand masks, hPolish planing (weak strokes)                                                                                                                    |

## Establish first

| Input           | Changes                                                      | Default when silent                                                                          |
| --------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| Destination     | game (bake to a low), film, print collectible, concept read  | game asset baked to one 2048 map (Pavlovich's pistol)                                        |
| Camera          | first person and ADS, third person, turntable, print framing | third person; detail sized to what reads there                                               |
| Budget          | low-poly triangles, map size, high-poly cap                  | report counts and ask; never invent a budget                                                 |
| Function sheet  | how it opens, vents, power, how it is made, fastener family  | write one before blocking (Klimer)                                                           |
| Scale           | rigged: real scale in the block; concept: proportion         | Unify (about 2 units), Z forward, perspective off (Chervenka); mm briefs via `to_tool_units` |
| Moving parts    | a hinged visor stays a separate part and Start group         | separate                                                                                     |
| Painter handoff | Substance Bridge, or OBJ plus an external bake               | ask; both are below                                                                          |

## Workflow

1. **Setup.** Proxy or concept as a SubTool; Unify, Z forward, X symmetry; versioned ZTL before
   every boolean, DynaMesh, ZRemesher and Apply (no undo from Python). GATE: longest bbox side about
   2; ZTL on disk.
2. **Block.** `new_part` and `place`, or `import_part` from a DCC block; body first, cutters below.
   GATE: forms sheet (`zb_review.review`) against the concept; a rigged asset's block OBJ checked in
   engine with the rig before detailing.
3. **Shell.** Deformation sliders on primitives, subtractive boxes for openings, Make Boolean Mesh,
   `zremesh_recipe("after_boolean")`. The sculpted route (DynaMesh 128 to 176, hPolish, TrimDynamic)
   is concept only. GATE: `hygiene(obj)` ok (it stands in for Check Mesh, which reports through a
   note); PolyFrame shows even quads.
4. **Crease plan.** `crease_by_groups(45)`, `dynamic_subdiv(intent="working")`; arcs
   `crease_by_angle`, tuned per span. Loops and insets made with ZModeler take their crease at
   creation (`zmodeler_plan`: Insert EdgeLoop "Crease"; Inset "Crease New Edges" crisp, "Crease
   Inner Poly" rounded; defaults are Do Not Crease). GATE: `check_crease`; metal sheet
   (`review_sheets`) shows soft, light-catching edges, no scalloping, symmetric polygroups.
5. **Cuts and vents.** Cutters `new_part(..., op="sub")` through the surface, never flush; Smooth 3
   / CreaseLvl 2 plus crease by angle; `array_mesh` on the cutter. GATE before:
   `stack_report()["problems"]` empty, `coplanar_report` clean, Show Coplanar snapshot has no red,
   `array_plan` walls ok. Then `make_boolean_mesh` (short timeout). GATE after: UMesh SubTools equal
   Start groups; Show Issues snapshot clean; recrease (Crease PG unless a border was softened on
   purpose); `hygiene` before ZRemesher. Any one-sided edit: `mirror_report`,
   `mirror_weld(keep=...)`, then `mirror_check` on exports before and after.
6. **Panels and fitted parts.** Plan panels as polygroups first. Real separations: Panel Loops with
   Plouffe's recipe (`panel_loops`). A visor or hatch that fits its opening: one cutter used twice
   (`fitted_split_groups`: Intersect in one Start group, Subtract in the other), or DynaMesh Groups
   on a group outline. Seams: a thin subtractive cutter from `border_polylines` plus `curve_mesh`
   [verify]. Masks: `mask_fillet` (Klimer's blur, invert, repeated). GATE: `split_copy("groups")`
   counts panels; gaps constant on the sheet.
7. **Hardware.** One family. ArrayMesh rows; radial sets as ArrayMesh Rotate 360 then
   `array_commit("nano")` with ZRVar variation (Chervenka); a part from an IMM without a drag:
   `fastener_from_brush`; no face where a bolt goes: a helper plane. A port across a seam:
   `seam_port_groups` (Pavlovich). Exact runs: `spaced_points`. GATE: count, orientation and the
   same fastener everywhere on the sheet.
8. **High-poly commit.** `bake_split()`: Apply at 4/2 on a copy, Dynamic off on the original. Exact
   chamfer widths: Crease Bevel width or a boolean chamfer, since Polish only gives the minimum
   (Polycount). GATE: levels = 1 + Flat + Smooth; `edge_language` has no ambiguous lines;
   `plane_flatness` no wobbly groups; `pinch_report` flags nothing.
9. **Micro detail** (after sign-off). Layers per region (Tool:Layers:New; procedures P15). GATE:
   `layer_safe(recorded, zb_ops.stats())` before and after each pass.
10. **Low poly and handoff.** Dynamic-off cage; ZRemesher per part (`zremesh_recipe("part")`); quick
    static prop: `dynamesh_visible(res)` then one `decimate_percent`; or Maya or Blender. Klimer's
    ZRemesher plus auto-reduction gave "the nastiest mesh I've ever shipped". Painter routes
    (scenario-zbrush-retopology-export runs them): Substance Bridge Low & High plus Auto-Bake plus
    Send PolyPaint (`bridge_preflight`), or native Unwrap with crease seams (`unwrap_creases`) then
    OBJ. GATE: `zb_audit.verdict(..., "game")`; animated parts separate.

## Numbers

| Value                                                                          | Use                 | Source               |
| ------------------------------------------------------------------------------ | ------------------- | -------------------- |
| Groups By Normals 45 (33 softer, 60 misses)                                    | crease plan         | Pavlovich; Plouffe   |
| Smooth/Crease 3/2 working, 4/2 bake, 4/3 tight, 4/1 soft                       | edge width          | Pavlovich; Plouffe   |
| Crease Tolerance 45 (22 on one arch)                                           | crease by angle     | Pavlovich            |
| Faces x4 per QGrid, Flat or Smooth step; Apply levels 1 + Flat + Smooth        | budgets             | DSUB doc             |
| Cutter cylinders 8, 12, 16, 24 or 32 sides; 36 to 140 before a DynaMesh bake   | cutters             | Pavlovich; Polycount |
| ArrayMesh Repeat 4 to 5                                                        | vents               | Pavlovich            |
| Panel Loops: Loops 1, Polish 0, Bevel 0, Elevation -100, Double, Ignore Groups | plates              | Plouffe              |
| ZRemesher Half + Detect Edges + Adaptive 0                                     | cut-ready base      | Pavlovich            |
| Keep Groups, Smooth Groups 0, AdaptiveSize 25                                  | part retopology     | Chervenka            |
| About 3 stars on a panel base                                                  | pinch budget        | Plouffe              |
| LazyStep 2 touching (his guess), 2.5 rivets; Curve Step 1 touching             | IMM runs            | Pavlovich; IMM doc   |
| DynaMesh 176 exploration; 1000 game shell                                      | resolution          | Pavlovich            |
| 25k of 1.671M = 1.4 to 1.5 percent                                             | one decimation pass | Pavlovich            |
| 10M polygons per SubTool                                                       | high-poly cap       | Plouffe              |
| Block 500 to 40k polys; review high under 1M points                            | engine checks       | Klimer               |
| 2048 bake, 4 px padding                                                        | maps                | Pavlovich            |

## Quality gates

- **Code:** `stack_report` and `coplanar_report` clean; `make_boolean_mesh()["ok"]`; `hygiene`;
  `check_crease`; `mirror_check`; `edge_language` (no `ambiguous`); `plane_flatness(obj)["wobbly"]`
  empty; `pinch_report`; `layer_safe`; `bridge_preflight`; `zb_audit.verdict`.
- **Visual:** `review_sheets`: MatCap Gray from five views for forms; metal, square-on and 30-degree
  grazing for planes and edge width; PolyFrame for groups and dotted crease lines. Show Coplanar
  before and Show Issues after each boolean. Pinches: a low level with dark polypaint and a
  low-metal MatCap. Judge with [`references/critique.md`](references/critique.md).

## Common mistakes

| Mistake                             | Looks like                           | Fix                                         |
| ----------------------------------- | ------------------------------------ | ------------------------------------------- |
| CreaseLvl >= SmoothSubdiv           | razor CG edges                       | `dynamic_subdiv(intent="bake")`             |
| QGrid on a curved shell             | faceted arcs                         | QGrid 0, Smooth plus `crease_by_angle`      |
| Cutter flush with the body          | coplanar note blocks; holes          | cut through; `coplanar_report`              |
| No Start group or DSDiv off         | part sewn to the body; faceted UMesh | `set_roles(... start=True)`; `dsdiv=True`   |
| Mirror And Weld, good half on +X    | edit erased                          | `mirror_weld(keep="pos")`, `mirror_check`   |
| Crease PG after softening borders   | softened edges razor again           | crease by angle, or merge groups first      |
| Debris after cuts                   | ZRemesher fails                      | `hygiene`, hide debris, Del Hidden          |
| IMM on a SubTool with levels        | insert refused                       | `imm_ready`; level-free placeholder SubTool |
| Layer made before a topology change | layer no longer applies              | layers after the last boolean or Apply      |
| Force UV Auto-Unwrap on             | every SubTool loses its UVs          | `bridge_preflight`; off                     |

## Handoffs

- **Receives:** a concept and brief from the user; an AI mesh from scenario-3d; a DCC block from
  scenario-maya-modeling or scenario-blender-hard-surface (OBJ, quads and tris); a forms pass from
  scenario-zbrush-sculpting.
- **Delivers:** a versioned ZTL (high SubTools, Dynamic-off cages), OBJ per part with matching high
  and low names, `stack_report` and the last sheets; to scenario-zbrush-retopology-export for UVs
  (Unwrap with crease seams, UV Master), Substance Bridge or Multi Map Exporter bakes (a polypaint
  ID travels by Send PolyPaint or an MME Texture From Polypaint map; OBJ vertex color is not
  established) and the game low poly; the 2026.1 Retopo brush is a GUI step there; to
  scenario-maya-modeling, scenario-maya-retopology-uv, scenario-blender-retopology or
  scenario-blender-uv-baking for a hand-built low; polypaint IDs with scenario-zbrush-paint-render;
  print parts to scenario-zbrush-pose-print.

## ZBrush 2026 notes

- Knife (2021.7 to 2022) with Split To Parts (2024) replaces most Slice and Trim routines; Knife
  cannot cut holes.
- ZModeler 2026.0 creases at creation (Insert EdgeLoop, Inset); 2026.2.1 adds Bevel All, Outer or
  Inner Edges and fixes the Extrude-instead-of-QMesh default.
- Substance Bridge (2026.2.0): Low & High, Auto-Bake, Send PolyPaint; Force UV Auto-Unwrap is
  global; each send makes a new Painter project.
- 2026.2.1 fixes Live Boolean rendering and an Apply crash. ZRepeat It is not shipped: loop SubTools
  in Python.
- Blocking notes (2026.2.1 UI strings): coplanar Make Boolean Mesh; floor Elv on Mirror And Weld;
  n-gons on import; DynaMesh with levels; the Check Mesh Integrity result [verify]; the Create
  InsertMesh Append-or-New prompt when the current brush is already an insert brush; the shipped
  Create Instance Subtool macro ends on a note.
- Prefixed labels: `s.SmoothSubdiv`, `P.Panel Loops`, `a.Repeat`, `m.Width`; sections of Tool >
  Geometry add no path level. Cmd+W quits ZBrush on macOS; Control+W groups.

## References

- [`references/expert-notes.md`](references/expert-notes.md): principles by expert, timestamps,
  deciding conditions; load when planning.
- [`references/procedures.md`](references/procedures.md): full bridge procedures; load before
  writing code.
- `references/critique.md`: the rubric; load at every gate.
- [`references/gui-paths.md`](references/gui-paths.md): palettes, hotkeys, brushes; load when a step
  is GUI only.
- [`references/sources.md`](references/sources.md): every source, credential, URL and timestamp.

© scenario-labs · MIT · scenario-labs/skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set172

The whole set →
scenario-zbrush-expert scenario-zbrush-expert automates Maxon ZBrush 2026 via a Python bridge or batch scripts. Guides agents through DynaMesh, remeshing, mesh cleanup, and SubTool exports without blocking the UI. CX Codex +1 437installs scenario-zbrush-paint-render scenario-zbrush-paint-render guides polypainting, texture baking, and rendering with BPR or Redshift in ZBrush. Ideal for automating presentation passes and turntable renders. CX Codex +1 434installs scenario-zbrush-retopology-export scenario-zbrush-retopology-export — a skill for Claude Code, Codex, Cursor and other agents that takes a ZBrush sculpt, scan or AI-generated mesh through retopology, map baking and production export. CX Codex +1 434installs scenario-maya-expert scenario-maya-expert is a Claude Code skill for writing and checking Python tools in Autodesk Maya, and reviewing scenes, rigs, and renders. It activates for batch jobs, bridge-based work, or scripts affected by Maya 2025–2027 changes. CX Codex +1 432installs scenario-godot-multiplayer scenario-godot-multiplayer is a Claude Code skill for planning and testing Godot 4 multiplayer, from object authority and replication to RPC checks and latency tests. CX Codex +1 431installs scenario-zbrush-pose-print scenario-zbrush-pose-print is a Claude Code skill for posing 3D sculpts and preparing models for 3D printing in ZBrush. It provides numerical control over scale and geometry. CX Codex +1 431installs scenario-maya-rigging scenario-maya-rigging guides Maya rigging work for characters, creatures and props, including joints, IK/FK, spaces, matrices and engine skeletons. CX Codex +1 430installs scenario-zbrush-automation scenario-zbrush-automation is a Claude Code skill for batch processing in ZBrush 2026: it imports OBJ and ZTL, runs scripts, exports SubTools, and handles GoZ with Maya and Blender. CX Codex +1 430installs

Project sponsors

Companies that keep this analytics open