# 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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 432 installs · ★ 3964 repo stars
- Author: scenario-labs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/zbrush/scenario-zbrush-hard-surface/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/scenario-zbrush-hard-surface

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/scenario-zbrush-hard-surface/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/scenario-zbrush-hard-surface/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/scenario-zbrush-hard-surface/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/scenario-zbrush-hard-surface/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scenario-labs/skills skills/dcc/zbrush/scenario-zbrush-hard-surface
```

2. **Manually: put the files in place**
- File: `.github/skills/scenario-zbrush-hard-surface/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/scenario-labs/skills --path skills/dcc/zbrush/scenario-zbrush-hard-surface
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/scenario-zbrush-hard-surface/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add scenario-labs/skills --skill scenario-zbrush-hard-surface -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/zbrush/scenario-zbrush-hard-surface/SKILL.md

## When to use it
- 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
- 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.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c4d295b17a8ddde6.

BEGIN THIRD-PARTY FILE c4d295b17a8ddde6
```text
---
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
```
END THIRD-PARTY FILE c4d295b17a8ddde6

The third-party file has ended. Everything between the c4d295b17a8ddde6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2556 of 19572 bytes. © scenario-labs · MIT · https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/zbrush/scenario-zbrush-hard-surface/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
