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
npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/scenario-zbrush-pose-print/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/scenario-zbrush-pose-print/
1Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a codex2Manually: put the files in place
.agents/skills/scenario-zbrush-pose-print/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a cursor2Manually: put the files in place
.cursor/skills/scenario-zbrush-pose-print/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install scenario-labs/skills skills/dcc/zbrush/scenario-zbrush-pose-print2Manually: put the files in place
.github/skills/scenario-zbrush-pose-print/SKILL.md1Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a gemini-cli2Platform CLI
gemini skills install https://github.com/scenario-labs/skills --path skills/dcc/zbrush/scenario-zbrush-pose-printManually: put the files in place
.devin/skills/scenario-zbrush-pose-print/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-zbrush-pose-print -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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