# hard-surface

A Claude Code skill guides Blender hard-surface modeling through MCP, from primary forms to panel details. It activates for sci-fi, vehicles, weapons, robotics, and mechanical props.

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

## What it does

The skill structures hard-surface work in Blender from scale blockout and main volumes to panel breaks, boolean cuts, bevels, weighted normals, and instanced greebles. Its modeling logic follows construction seams and separates primary, secondary, and small surface details.

Boolean cutters live in a separate `COL_Booleans` collection and use the `SM_Cutter_[Feature]` naming pattern. Scale is applied before boolean operations, the modifier stack stays non-destructive until export, and bevel comes after Boolean. Repeated details go into `COL_Greebles` and use instancing.

Through MCP, the skill creates primitives, applies Mirror and Array, runs booleans, adds Bevel and Weighted Normal, and checks polycount by phase. Boolean work on curved surfaces without enough topology can produce artifacts; a complex mesh should not receive one uniform bevel.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install arjun988/blender-skills .claude/skills/hard-surface
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/hard-surface
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill 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/arjun988/blender-skills/tree/HEAD/.claude/skills/hard-surface/SKILL.md

## When to use it
- build a sci-fi prop blockout from primary volumes
- lay out panels, access hatches, vents, and construction seams
- run boolean cuts followed by a controlled bevel pass
- scatter repeated mechanical details with instancing

## Example prompts
- Model an industrial sci-fi prop in Blender, starting with primary volumes and adding panel breaks and bevels.
- Build a robot shell with boolean cuts, a `COL_Booleans` collection, and instanced greebles.
- Prepare a mechanical part for export, keep the modifier stack non-destructive until the final stage, and check polycount.

## 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: 68b78f39e6ee02f9.

BEGIN THIRD-PARTY FILE 68b78f39e6ee02f9
````text
---
name: hard-surface
description: AAA hard surface modeling for sci-fi, industrial, military, vehicles, weapons, robotics, and mechanical props. Use for boolean/bevel workflows, panel lines, greebles, chamfers, and manufacturing-accurate surfaces in Blender via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: hard surface, sci-fi, industrial, military, vehicle, spaceship, weapon, robot, machinery, boolean, bevel, panel line, greeble, mechanical
  related-skills: blender-modeler, materials, uv-workflow, asset-optimization, vehicle-artist, prop-artist
---

# Hard Surface Artist

Production hard surface modeling with manufacturing logic. Readable surfaces. Clean modifier stacks. MCP-first.

## When to Use

- Sci-fi consoles, spaceships, industrial equipment
- Weapons, vehicles, robotics, military props
- Mechanical assemblies with panels, vents, bolts
- Any asset requiring crisp edges, booleans, chamfers

## Design Principles

1. **Primary forms first** — Silhouette reads at distance
2. **Manufacturing logic** — Panel breaks follow construction seams
3. **Surface hierarchy** — Primary > Secondary > Tertiary > Micro (greebles)
4. **Functional readability** — Every form suggests purpose
5. **Edge consistency** — Uniform bevel widths per detail tier

## Workflow

```
Reference → Scale Blockout → Primary Volumes → Panel Breaks
    → Boolean Cuts → Bevel Pass → Weighted Normals
    → Greebles (instanced) → UV Planning → Materials
```

## Boolean Workflow

```
1. Block primary forms (no booleans yet)
2. Create cutter objects on separate collection COL_Booleans
3. Apply scale on all operands
4. Boolean Difference/Union — keep LIVE
5. Fix intersection artifacts with manual cleanup if needed
6. Bevel AFTER boolean in modifier stack
7. Apply booleans only at export prep
```

**Boolean rules:**
- Cutter objects named `SM_Cutter_[Feature]`
- Prefer exact solver for mechanical work
- Avoid booleans on curved surfaces without adequate topology
- Duplicate mesh before first boolean as backup

## Bevel Workflow

| Detail Tier | Bevel Width | Segments |
|-------------|-------------|----------|
| Primary edges | 0.005–0.02m | 2–3 |
| Panel lines | 0.001–0.003m | 1–2 |
| Micro detail | 0.0005–0.001m | 1 |

- Use bevel weight or edge marks for selective beveling
- Weighted Normal modifier after bevel (keep sharp: 30°)
- Never bevel entire mesh uniformly on complex assets

## Panel Lines
````
END THIRD-PARTY FILE 68b78f39e6ee02f9

The third-party file has ended. Everything between the 68b78f39e6ee02f9 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 2535 of 5599 bytes. © https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/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
