agentleFS
arjun988arjun988/blender-skills/.claude/skills/hard-surface/SKILL.md

hard-surface

Skill2.2k starsChanged 4 months agoMITView on GitHub

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.

Adopted by

Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projectsWeek of Oct 25: 0 new projectsWeek of Nov 1: 0 new projectsWeek of Nov 8: 0 new projects
Sep 2026Oct 2026Nov 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 0 in all, so this is a hint, not a trend.

Who's talking about arjun988/blender-skills

The biggest 5 of 12 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 12

Talked about on GitHub (12 times).

On GitHub · 12

7 more on GitHub

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 10 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Prefer exact solver for mechanical work

    line 55
  2. Distinctive:

    Avoid booleans on curved surfaces without adequate topology

    line 56
  3. Distinctive:

    Use bevel weight or edge marks for selective beveling

    line 67
  4. Distinctive:

    Never bevel entire mesh uniformly on complex assets

    line 69
  5. Distinctive:

    Place panel lines at:

    line 79
  6. Distinctive:

    Keep greebles on separate mesh for easy toggle

    line 89
  7. Distinctive:

    Use array + random transform for scatter greebles

    line 91
  8. Distinctive:

    Keep modifier stack non-destructive until export

    line 143
  9. Distinctive:

    Use instancing for repeated mechanical detail

    line 144
  10. Distinctive:

    Verify silhouette at 45° increments

    line 145

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 TierBevel WidthSegments
Primary edges0.005–0.02m2–3
Panel lines0.001–0.003m1–2
Micro detail0.0005–0.001m1
  • 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 FeatureModeling Approach
Sheet metal bendBevel + slight inset
Weld seamThin raised strip or normal map
Bolt patternInstanced cylinder, hex inset
Vent grilleBoolean cut + array
Cable routingCurve + bevel object or geo nodes
Rubber gasketSeparate 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

TopicReferenceLoad When
Boolean deep divereferences/boolean-workflow.mdComplex cuts
Greeble libraryreferences/greeble-patterns.mdDetail pass
Pipeline../references/asset-pipeline.mdPhase context

Style Integration

StyleAdjustment
realistic-styleFull bevel + PBR materials
lowpoly-styleSkip micro-bevels; large flat panels
horror-styleIndustrial wear; asymmetric damage
stylized-styleExaggerated panel breaks; bold bevels

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.