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
npx skills add arjun988/blender-skills --skill hard-surface -a claude-codeWhat 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_Booleanscollection, 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-code2Manually: put the files in place
~/.claude/skills/hard-surface/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hard-surface/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill hard-surface -a codex2Manually: put the files in place
.agents/skills/hard-surface/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill hard-surface -a cursor2Manually: put the files in place
.cursor/skills/hard-surface/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/hard-surface2Manually: put the files in place
.github/skills/hard-surface/SKILL.md1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill hard-surface -a gemini-cli2Platform CLI
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/hard-surfaceManually: put the files in place
.devin/skills/hard-surface/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill hard-surface -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 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