Skip to main content
skill CX Codex

scenario-zbrush-pose-print — Claude Code skill: posing and print prep

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.

MIT 431 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-pose-print -a claude-code
Open on GitHub

What scenario-zbrush-pose-print does

Works with ZBrush's core tools: Transpose Master for deformation transfer, TPoseMesh to preserve topology across SubTools, masks and Gizmo for sculpting poses. Emphasizes measurable decisions—envelope scale, joint angles, wall thickness in millimeters, file dimensions in STL and 3MF. Handles different workflows: SLA resin, FDM plastic, molding and casting. Routes around API gaps where the SDK hides mask data and press_key is inaccessible in 2026 builds.

Depends on scenario-zbrush-expert skill for stroke engine and review loop. If missing, the skill requests it via skill_get (Scenario MCP) or asks the user to install from GitHub. Grounded in practice by Gaboury, Munoz Gomez, Plouffe and Bennett: vertex order must stay stable during pose transfer, never hollow the final sculpt (shell a copy instead), enforce 1 mm minimum walls, reserve polygon density for visible detail.

What it helps with

  • pose a character so it reads and stands without deformation loss
  • transfer the pose to all SubTools while keeping mesh topology intact
  • measure and validate wall thickness, plan cuts and alignment keys
  • export parts in STL or 3MF at correct millimeter scale for the printer
  • decide between hollowing methods for lighter models and resin savings

Example prompts for the agent

  • Pose this character at full height, target size 300 mm, weapon in hand
  • Prepare for Formlabs resin: check 0.85 mm walls, plan three-part split with keys
  • Validate export scale and decimate each part to fit the bed, report final sizes

How to install scenario-zbrush-pose-print

1Skills CLI (Vercel)

npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a claude-code

2Manually: put the files in place

~/.claude/skills/scenario-zbrush-pose-print/SKILL.md

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

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

Questions about scenario-zbrush-pose-print

How do I install scenario-zbrush-pose-print in Claude Code?

Run npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a claude-code, then check ~/.claude/skills/scenario-zbrush-pose-print/SKILL.md.

What does scenario-zbrush-pose-print do?

It guides sculpting poses with measured geometry—envelope size, joint angles, vertex order—then prepares models for 3D print: validates wall thickness in millimeters, plans part cuts with alignment keys, and exports STL/3MF files at correct scale.

What prerequisite skill does this need?

Requires scenario-zbrush-expert for stroke engine and canvas workflows. If not installed, this skill will request it via skill_get or prompt the user to install from GitHub.

Source text

SKILL.md · MIT
---
name: scenario-zbrush-pose-print
description: 'Use when posing a sculpt or preparing it for 3D printing in ZBrush: "pose this character", Transpose Master, TPoseMesh, Gizmo posing with masks, ZSphere rig, Proxy Pose, weapon in the hand, stretching after posing, "3D print this", 1/6 scale statue, miniature, resin or FDM, hollowing, wall thickness, drain holes, keys and pins, cutting into parts, 3D Print Hub, Scale Master, Decimation Master, STL or 3MF, size in millimeters.'
license: MIT
---

# ZBrush posing and 3D print

Expert level means a pose that stands and reads, transferred onto every SubTool without losing a
level, and print parts whose size, walls, fits and cavities were measured in millimeters on the
exported files. The stance: turn every decision into a number the agent can check (scale, point
order, joint angles, walls, gaps), keep the pose reversible, use strokes only for cleanup. 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).

## Stance (the expert delta)

- **Gaboury: scale is the first decision.** SubTool number one is a box at the client's size;
  nothing may clip out of it, and the whole tool resizes in one step because sizes change late (6 in
  with 15 points of articulation became 4 in with 8). Agent form: `brief_box`, `zb_print.envelope`,
  `set_export_scale(target_mm)`.
- **Munoz Gomez: pose at the lowest level, several SubTools through Transpose Master, the pose on a
  3D Layer.** Plates and carried props (weapon, shield, staff) stay IN the TPose mesh as rigid
  pieces (Auto Groups, one group per loose piece, masked whole); Move Topological clears
  intersections. Plouffe forbids deforming primitives, not moving them rigidly: never pull a carried
  prop out and re-place it with one rotation.
- **Maxon doc: two things destroy a transfer:** a partially hidden SubTool (Vertex Mismatch) and
  Gizmo 3D deformers on the TPose mesh (they reorder points; SubTools die on TPose>SubT). Pavlovich:
  "The order of the vertices is very important." Start from a clean project, save the ZPR while a
  TPose mesh exists (the Transpose Master data lives there).
- **Plouffe: parts that bend together need the same polygon size at level 1** (mask blur spreads per
  polygon). Re-place bolts and discs after bending. Spend detail only where the final size and
  viewing distance show it.
- **Pavlovich: DynaMesh without levels = Proxy Pose plus a ZSphere rig.** Location beats size,
  helpers hold volume, rotate only.
- **Gaboury: never hollow the 9M sculpt.** Shell a light DynaMesh copy (128 was enough for a 9 in
  car), keep its inner wall, Polish it, subtract it from the untouched detailed part in Live
  Boolean. Create Shell Thickness is not millimeters: measure.
- **Bennett (Hasbro): 1 mm minimum wall (0.85 mm was flagged), 0.5 mm edges, 0.12 mm fit offset for
  Formlabs parts;** thin walls are thickened from the inside so the outside does not change.
- **Gaboury: decimate by eye** (about 1M per mesh is plenty; 10k to 20k triangles can still print);
  masks on the detail that matters (face, hands) steer Decimation Master; pre-process again after
  any edit; vent every cup on SLA.

## Establish first

| Input                                                                 | Why it changes the plan                                                                                                                                                                          | Default when the brief is silent                                                           |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Process: resin (SLA, MSLA), FDM, molded or cast                       | walls, clearance, hollowing, shrink (Hasbro sculpts PVC at 104 %); molds add Hasbro's rules: touching fingers lock the mold, Group Front shows the parting line, Draw Draft Analysis shows draft | resin, direct print                                                                        |
| Size: ratio and real height, envelope W x H x D, base included or not | export scale, brief box, feature floor                                                                                                                                                           | 1/6 = standing height / 6 (1,800 mm gives 300 mm), measured on the rest pose               |
| Printer volume, slicer caps                                           | splits (Gaboury split a car for the Form 2 bed); polycount or file caps (his example: 50 MB)                                                                                                     | ask; report each part's size                                                               |
| Parts: one piece or kit, glued or pegged                              | cuts and keys (Carratala plans cuts while sculpting)                                                                                                                                             | natural breaks (collar, belt, cuffs, weapon at the hand), two keys per glued joint [added] |
| Pose source; alternate poses                                          | route and layers                                                                                                                                                                                 | one layer per pose                                                                         |
| Deliverable                                                           | STL has no units; 3MF declares them                                                                                                                                                              | STL and 3MF per part in mm, JSON report                                                    |

## Posing without a mouse

The artists' default (Ctrl+click a polygroup, drag a Gizmo ring) is a canvas gesture. The SDK cannot
read mask data, and `press_key` is documented but marked "Does not work, hidden for now" in the
installed 2026 stub (with `canvas_click` it is reported unreliable, Maxon forum). Routes by
determinism:

| Route                                                             | When                                           | How                                                                                                                                                                        | Status                                                      |
| ----------------------------------------------------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| A. Numeric external rig (Munoz Gomez's Blender route, made exact) | humanoids, extreme or many poses               | TPoseMesh, `export_tpose`, `loose_pieces` weighted rigidly to one bone each, scenario-blender-rigging poses by angle and returns the same order, `import_pose`, TPose>SubT | deterministic; guards tested offline                        |
| B. ZSphere rig by code                                            | in ZBrush, organic, or DynaMesh via Proxy Pose | joints from polygroup borders, `zs_build`, forward kinematics `zs_pose`                                                                                                    | FK tested; bound mesh following API edits [verify live_p02] |
| C. Whole-SubTool rigid moves                                      | a base, a stand, a prop added after posing     | `rotate_subtool_matrix` (X, Y, Z) plus `translate_subtool`, the carrier's whole transform, corrected from exports                                                          | math tested; signs [verify live_p03, p08]                   |
| D. Mask plus Gizmo or action line                                 | cleanup by a computer-use agent or a human     | Ctrl+click group, Alt pivot, drag                                                                                                                                          | weak for this agent                                         |

Weak without a human: gesture design, Plouffe's hand-painted gradient masks, large fold redesign.
Seam smoothing and Move Topological have agent forms in `procedures.md` P6, still [verify].

## Workflow

`zb_pose.call("name", ...)` runs inside ZBrush; `zb_print` runs on exported OBJs; full code in
[`references/procedures.md`](references/procedures.md).

0. **Intake.** Versioned ZTL, `inventory()`, target and envelope in mm. GATE: every SubTool named,
   unique, with points and levels.
1. **Scale.** `set_export_scale`, `export_parts`, `check_scale`, then `brief_box` (hidden while
   exporting). GATE: height within 0.5 % [added], one export scale on every part (a part appended
   from another ZTool arrives at another scale), `envelope` ok, named dimensions checked with
   `caliper`.
2. **Pose prep.** `clean_project` (ZTL saved, default project, Load Tool); polygroup every segment,
   plates and props left as loose pieces; `preflight_tpose`. GATE: preflight ok, density spread
   under 2x [added]. No levels: scenario-zbrush-retopology-export or Proxy Pose.
3. **Pose.** `tpose_mesh(layer=True, groups=True)` with props and plates visible, `export_tpose`
   (the order reference), `save_project`; route A or B, center first, parents before children,
   rotations only; no Gizmo deformers. GATE: `rigid_pieces` ok, `follows` puts each carried prop
   where its carrier took it (0.5 mm [added]), `piece_interference` empty or listed for P6,
   `tpose_to_subtools(expected, rest_obj)` passes its order guard and point counts, `rigid_delta`
   within 2 degrees of the plan [added], `balance` stands or a base is planned; review sheet:
   silhouette and weight read (Plouffe: an unstable pose "destroys the entire work").
4. **Fix deformation.** New layer at the top level. Seam first while the rest is protected (Munoz
   Gomez smooths and moves before clearing the mask); then volumes and folds re-sculpted for the new
   pose (tension from the stretched joint, compression on the inner bend [added]); re-place
   primitives; Move Topological on pieces; pose-specific detail on a pose-only layer, because layers
   blend linearly. GATE: `stretch_report` near the rest pose, `piece_interference` ok, Polyframe
   tiles.
5. **Breakdown.** Parts at natural breaks; merge what prints as one (Live Boolean union or DynaMesh
   on light copies: Hasbro engineers on decimated meshes). Molded: loops, parting line, draft. GATE:
   each part closed, fits the build volume.
6. **Hollow when asked.** `hollow_copy` (insert inside, DynaMesh about 128, Create Shell),
   `keep_inner_shell`, Live Boolean: detailed part start, inner shell, drain and vents subtract;
   thin ends stay solid. Too thin: move the cutter inward, never the outside. GATE: `thickness` p01
   at the wall target, no sealed cavity for resin, `outer_drift` ok, vents at cups.
7. **Cut and key.** Cutter QCube in Live Boolean or a polygroup split then Close Holes [added];
   `plan_keys`; socket = peg grown by 2 x clearance. GATE: `clearance` median at target, no
   interference; one key pair test-printed before the kit (Gaboury).
8. **Decimate.** Unique names; per-SubTool budgets, masks before Pre-process (`mask="cavity"`
   [added]), pre-process after any edit. GATE: faces within budget, `deviation` p99 under the
   printer's XY resolution [added], close-ups before and after.
9. **Deliver.** STL and 3MF per part in mm, `print_report(..., envelope_mm=...)`, a review tile at
   real size (detail under the process floor is backfilled, fused or left to paint: Hasbro). GATE:
   `print_report["ok"]`, every "to look at" item looked at, unit stated.

## Numbers

| Item                 | Value                                                          | Source                          |
| -------------------- | -------------------------------------------------------------- | ------------------------------- |
| Minimum wall         | 1 mm; 0.85 flagged                                             | Hasbro, PVC and Formlabs copies |
| Edges after trimming | 0.5 mm; about 0.2 mm floats away                               | Hasbro                          |
| Fit offset           | 0.12 mm (Formlabs); Inflate 2 gave it in his ZTool             | Hasbro, calibrate per ZTool     |
| Shell copy           | DynaMesh 64 too low, 128 enough (9 in car); Thickness 4 then 6 | Gaboury                         |
| From Thickness       | Min 1, Max 5 once scaled to mm                                 | Maxon doc                       |
| Decimation           | about 1M per mesh; 2.7M to 545k at 20 % unchanged; 8k faceted  | Gaboury                         |
| Decimation quality   | 40 to 100 % near identical, 2 to 40 % visible                  | Maxon doc                       |
| Scale with shrink    | height / 12 + 4 % for a 6 in PVC figure                        | Hasbro                          |
| Proxy Pose skin      | Adaptive Skin Density 1, DynaMesh Resolution 0                 | Pavlovich                       |

## Quality gates

- **Measured** (`zb_print` on OBJs in mm): watertight, volume, thin-wall share (0.2 % of samples
  [added]), sealed cavities, floating shells, height, envelope, one export scale, build volume,
  clearance, balance, faces, outer drift. Pose: point order, `rigid_pieces`, `follows`,
  `piece_interference`, `rigid_delta`, `stretch_report`.
- **Visual** (scenario-zbrush-expert `zb_review.review`, MatCap Gray, five views): gesture and
  balance; joints with Polyframe; primitives round; the grip closed around the handle; the brief box
  shown once; From Thickness on a copy; every listed spot; decimated close-ups. Judge with
  [`references/critique.md`](references/critique.md).

## Common mistakes

| Mistake                                                                   | What it looks like                                                | Fix                                                                                            |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Top-level pose, rough mask, mask cleared too early                        | stretched, overlapping polygons                                   | lowest level, blurred mask, Smooth and Move the seam before clearing (Munoz Gomez)             |
| Carried prop pulled out of the TPose mesh, turned by one angle afterwards | a sword beside a raised, bent hand; `interference` 0 still passes | keep it in the TPose mesh as a rigid piece; else the carrier's whole transform, gate `follows` |
| Partly hidden SubTool at TPoseMesh                                        | Vertex Mismatch                                                   | `preflight_tpose` (ShowPt on all)                                                              |
| Gizmo deformer on the TPose mesh                                          | destroyed SubTools; a point count check misses a reorder          | rotations or rigs; the order guard refuses the transfer                                        |
| Session closed with a TPose mesh, no ZPR                                  | no way back to the SubTools                                       | `save_project` right after TPoseMesh                                                           |
| Neutral-pose detail shown on the pose                                     | soft, stretched detail at bends                                   | refine on a pose-only layer (linear blend)                                                     |
| Create Shell numbers read as mm; insert touching the surface              | wrong walls; one joined piece                                     | measure `thickness`; insert inside, drain as a cutter                                          |
| Wall thickened from outside                                               | the sculpt drifts                                                 | move the cutter inward, check `outer_drift`                                                    |
| Mask or edit after Pre-process                                            | decimation ignores it                                             | pre-process again (the wrapper always does)                                                    |
| No clearance on keys                                                      | "20 discs to sand before noon" (Hasbro)                           | 0.12 mm offset, measured, test print                                                           |
| STL without a unit                                                        | 150 mm printed as 150 in                                          | say mm, or ship 3MF                                                                            |

## Handoffs

- **Receives** from scenario-zbrush-sculpting, scenario-zbrush-character-creature,
  scenario-zbrush-stylized or scenario-zbrush-hard-surface: a versioned ZTL with named SubTools,
  levels (or a DynaMesh for Proxy Pose), polygroups per part, the last review sheet; from
  scenario-zbrush-retopology-export, a projected stack when a sculpt had no levels.
- **Sends** to scenario-blender-rigging or scenario-maya-expert: the TPose OBJ and a plan (joints,
  angles, rigid pieces per bone), expecting the same vertex order back.
- **Delivers** posed sculpts (layers, ZTL, ZPR, sheets) to scenario-zbrush-paint-render; print
  packages (STL and 3MF in mm, report, sheets, part and key list) to the user or the printer.

## ZBrush 2026 notes

- Proxy Pose (2023.1) is in Tool > Geometry. Transpose Master still ships ("inactive after a file
  save" fixed in 2025.2); its data lives in the ZPR. The doc's clean project, DefaultCube.ZPR, is
  not in the 2026.2.1 install: `Lightbox/Projects/DefaultProject.ZPR` is used [verify].
- 3D Print Hub has Export to 3MF (errors fixed in 2026.2.1). Update Size Ratios and Scale Master Set
  Scene Scale open dialogs: use the export scale route.
- From Thickness (2026.2.1 labels Min Thickness, Max Thickness, Ball or Ray) asks "Too many
  polygons... proceed?" above Max Thickness Polygons; that note stalls the bridge, so
  `from_thickness` refuses first.
- Live Boolean drops UVs, creases, 3D layers and masks on the result: boolean the print copy.
  Decimation Master and Transpose Master are ZScript plugins: check that control returns (live_p01,
  p07). Cmd+W quits ZBrush on macOS.

## References

- `references/procedures.md`: bridge procedures with full code (scale and brief box, clean project,
  Transpose Master, three rig routes, fixes, hollow chain, keys, masked decimation, delivery). Load
  before driving ZBrush.
- [`references/expert-notes.md`](references/expert-notes.md): principles by expert with timestamps
  and deciding conditions. Load when planning a pose or a kit.
- `references/critique.md`: the rubric for pose, deformation and print parts. Load at every gate.
- [`references/gui-paths.md`](references/gui-paths.md): palettes, buttons, hotkeys for a
  computer-use agent or a human.
- [`references/sources.md`](references/sources.md): sources, credentials, timestamps, revisions.
- [`scripts/zb_pose.py`](scripts/zb_pose.py) (inside ZBrush) and
  [`scripts/zb_print.py`](scripts/zb_print.py) (agent side, numpy): offline tests in
  `tests/code/zbrush-pose-print/`; live tests `live_p01` to `live_p08` not yet run in ZBrush.

© 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-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-zbrush-hard-surface 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. 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-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 scenario-maya-animation scenario-maya-animation is a Claude Code skill for planning and inspecting character or prop animation in Maya through Python, including motion cycles, dialogue shots, lip sync, and mocap cleanup. CX Codex +1 429installs scenario-maya-deformation scenario-maya-deformation is a Claude Code skill that helps set up character skinning in Maya and fix deformation artifacts, including during skin binding, weight painting, blend shape creation, or deformation tests. CX Codex +1 428installs

Project sponsors

Companies that keep this analytics open