Skip to main content
skill CX Codex

hard-surface — Claude Code skill: Blender hard-surface modeling

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.

MIT 630 installs ★ 4,589 updated 2026-11-06

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

What hard-surface 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.

What it helps with

  • 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 for the agent

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

How to install hard-surface

1Skills CLI (Vercel)

npx skills add arjun988/blender-skills --skill hard-surface -a claude-code

2Manually: put the files in place

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

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

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

Questions about hard-surface

How do I install hard-surface in Claude Code?

Run npx skills add arjun988/blender-skills --skill hard-surface -a claude-code, then check ~/.claude/skills/hard-surface/SKILL.md.

What does hard-surface do?

The skill lays out a Blender workflow for hard-surface assets, covering primary forms, boolean cuts, bevels, panel details, normals, and greebles. It also includes rules for mechanical, vehicle, weapon, and sci-fi assets.

What does hard-surface require?

The workflow is built for Blender through MCP. MCP handles primitive creation, modifier and boolean operations, detail instancing, and polycount checks.

Source text

SKILL.md · MIT
---
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

Techniques (prefer non-destructive):
1. Inset faces + slight extrude inward
2. Knife cuts on flat panels
3. Boolean with thin cutter boxes
4. Normal map detail for distant panels

Place panel lines at:
- Structural boundaries
- Access hatches, maintenance points
- Material transitions
- Manufacturing seam locations

## Greebles

- Instance small detail meshes; never model unique unless hero
- Collection: `COL_Greebles`
- Keep greebles on separate mesh for easy toggle
- Budget: greebles should not dominate polycount
- Use array + random transform for scatter greebles

## Hard Edge Management

```
Sharp edges → Mark Sharp or Bevel Weight = 1.0
Soft transitions → Bevel Weight = 0.0–0.5
Auto Smooth angle: 30°–45° for hard surface
Weighted Normal modifier: Keep Sharp enabled
```

## Manufacturing Reference

| Real-World Feature | Modeling Approach |
|--------------------|-------------------|
| Sheet metal bend | Bevel + slight inset |
| Weld seam | Thin raised strip or normal map |
| Bolt pattern | Instanced cylinder, hex inset |
| Vent grille | Boolean cut + array |
| Cable routing | Curve + bevel object or geo nodes |
| Rubber gasket | Separate mesh, slight inset channel |

## Vehicle / Spaceship Specifics

> Prefer **vehicle-artist** for cars, ships, aircraft, and mechs. Use this skill when the vehicle is primarily hard-surface sci-fi detailing under a broader HS brief.

- Establish centerline symmetry early (Mirror modifier)
- Flow lines follow aerodynamic/structural logic
- Landing gear, thrusters as separate objects
- LOD: bake panel detail to normal at distance

## Weapon Specifics

- Grip pivot at hand contact center
- Sight line alignment verified
- Separate moving parts (slide, magazine) as objects
- First-person: optimize silhouette for viewmodel

## MCP Integration

Execute via MCP:
1. Create blockout primitives
2. Apply mirror/array modifiers
3. Execute boolean operations
4. Apply bevel and weighted normal
5. Instance greeble collections
6. Query polycount per phase

## Constraints

### MUST DO
- Maintain manufacturing plausibility
- Keep modifier stack non-destructive until export
- Use instancing for repeated mechanical detail
- Verify silhouette at 45° increments
- Apply scale before booleans

### MUST NOT DO
- Boolean on unsubdivided curved surfaces without support
- Uniform bevel on entire complex mesh
- Model every bolt uniquely
- Skip weighted normals on hard surface
- Exceed polycount budget with micro-detail

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Boolean deep dive | `references/boolean-workflow.md` | Complex cuts |
| Greeble library | `references/greeble-patterns.md` | Detail pass |
| Pipeline | `../references/asset-pipeline.md` | Phase context |

## Style Integration

| Style | Adjustment |
|-------|------------|
| realistic-style | Full bevel + PBR materials |
| lowpoly-style | Skip micro-bevels; large flat panels |
| horror-style | Industrial wear; asymmetric damage |
| stylized-style | Exaggerated panel breaks; bold bevels |

© https://github.com/arjun988 · MIT · arjun988/blender-skills

Similar skills

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

From the same set57

The whole set →
prop-artist prop-artist — a skill for Claude Code, Codex, and others that models grounded, readable props and furniture. The agent manages scale, silhouettes, and detail tiers based on real-world reference logic. CX Codex +1 656installs camera-cinematography The camera-cinematography skill for Claude Code manages camera framing, lens selection, and movement animation in Blender. It runs when setting up cinematic sequences or planning shot layouts. CX Codex +1 653installs geometry-nodes geometry-nodes — a skill for Claude Code and other platforms that automates procedural system creation in Blender. It enables asset generation and instancing pipelines via MCP. CX Codex +1 640installs lighting Configures cinematic and game lighting in Blender via MCP. Sets up three-point rigs, HDRI maps, volumetrics, and mood lighting. CX Codex +1 636installs procedural-modeling The procedural-modeling skill for Claude Code manages procedural 3D asset generation in Blender via MCP. It configures Geometry Nodes setups for rocks, buildings, roads, and cables, preparing meshes for game export. CX Codex +1 622installs archviz archviz — a skill for Claude Code and Codex guides architectural visualization in Blender over MCP. Enforces real-world dimensions, camera framing, realistic materials, and final rendering. CX Codex +1 619installs sculpting sculpting — a skill for Claude Code guides high-frequency surface detailing in Blender via MCP. It handles brush selection, Dyntopo, and Multiresolution passes before baking or retopology. CX Codex +1 615installs stylized-style The stylized-style Claude Code skill guides stylized art direction in Blender. It activates for non-photorealistic games and animation, including toon rendering and hand-painted textures. CX Codex +1 608installs

Project sponsors

Companies that keep this analytics open