Skip to main content
skill CX Codex

blender-clothing — Claude Code skill: what it does, how to install

blender-clothing — a Claude Code skill for generating game-ready clothing directly in Blender 5.3. It extracts patterns from body meshes, transfers vertex weights, and cleans up clipping artifacts.

MIT 416 installs ★ 2,624 updated 2026-11-13

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

What blender-clothing does

The bundled scripts/garment.py extracts body surfaces using vertex groups or a vertical coordinate span. It displaces geometry outward along vertex normals using --offset and applies Solidify for fabric thickness while preserving body UV maps. Weights transfer through nearest-polygon interpolation, automatically normalized and capped to maximum bone influences.

Running with --drape triggers a classic cloth simulation across a set number of frames to bake gravity folds, pinning the top 8% boundary. The --morphs flag duplicates body shape keys onto the garment via Surface Deform in the rest pose, then discards the modifier so armatures do not double-deform vertices during playback.

Offsets and thickness use metric values, making an unapplied object scale break dimensions. Bodies exceeding 50k vertices need a decimated collision proxy to keep cloth solver runs responsive. The script also reports intersecting vertices across evaluated poses to catch clipping before export.

What it helps with

  • extract fitted shirts or armor from body vertex regions
  • transfer and normalize skin weights from an armature
  • bake matching body morph shape keys onto garments
  • detect fabric poke-through on posed character rigs

Example prompts for the agent

  • Extract a shirt from Torso vertex group and mask covered skin: scripts/garment.py -- --body Body --group Torso --name Shirt --hide-body
  • Generate draped pants across Z coordinates 0.45 to 1.05: scripts/garment.py -- --body Body --zmin 0.45 --zmax 1.05 --name Pants --offset 0.01 --drape 40 --morphs
  • Check the current rig pose for mesh penetration: scripts/garment.py -- --check Shirt --body Body

How to install blender-clothing

1Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-clothing -a claude-code

2Manually: put the files in place

~/.claude/skills/blender-clothing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/blender-clothing/

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

Questions about blender-clothing

How to install blender-clothing in Claude Code?

Run npx skills add EL4CTEO/blender-skills --skill blender-clothing -a claude-code. The skill definition drops into ~/.claude/skills/blender-clothing/SKILL.md.

What does blender-clothing do?

It automates game garment authoring inside Blender 5.3, extracting meshes, transferring skinning, simulating draping, and auditing poke-through.

What are the prerequisites for blender-clothing?

You need Blender 5.3 with applied object transforms on your character body. Models over 50k vertices require a low-poly proxy mesh for cloth collision.

Source text

SKILL.md · MIT
---
name: blender-clothing
description: Game clothing in Blender 5.3 - garments from body regions (ease offset, thickness), skin-weight transfer, hiding covered body faces, cloth-sim draping for folds, body-morph shape keys on garments, layered clothing, pose-aware poke-through checks, sim-to-game-mesh cleanup. Use for shirts, pants, armor, outfits, layered or swappable clothing.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Clothing

The execution model is in `blender-core`. The rig and weights are in `blender-character-rigging`, classic cloth settings in `blender-simulation`, and Roblox layered clothing cages in `blender-export-pipelines` (references/roblox.md).

## One call each
```
scripts/garment.py -- --body Body --group Torso --name Shirt --hide-body
scripts/garment.py -- --body Body --zmin 0.45 --zmax 1.05 --name Pants --offset 0.01 --drape 40 --morphs
scripts/garment.py -- --body Body --group Torso --name Armor --offset 0.02 --thickness 0.008
scripts/garment.py -- --check Shirt --body Body          # pose the rig first: checks the current pose
```

## How pros build game clothing
1. **Shape**: start from the body (extract + offset) for fitted clothes, or from flat patterns sewn by cloth sim (Marvelous Designer or Blender cloth with sewing springs) for loose ones. Simulate on the body in its **rest pose** (A/T).
2. **Game mesh**: retopo the high/sim result to clean, even quads with loops at the joints (elbows, knees, shoulders get 3 loops), then UV it. Bake folds into normal maps (`blender-texture-baking`) so the low mesh stays light.
3. **Skin**: copy weights from the body (same bones, same influences), clean them (limit 4, normalize, drop < 0.001), then blend toward smoother weights only on loose parts (skirts, coats) and add extra bones for those.
4. **Hide what's covered**: delete body faces under the garment (save tris, stop poke-through) or mask them per outfit. Keep one ring of skin under cuffs and collars.
5. **Verify in motion**: stress poses (`blender-character-rigging` `stress_poses.py`), then `--check` in each. Fix by easing (offset), smoothing the body there, weight tweaks, or hiding.

## garment.py
- Region: `--group` (body vertex group, weight > 0.5) or a world `--zmin/--zmax` band. The faces are copied in world space and pushed out along the vertex normals by `--offset` (ease: 5–10 mm fitted cotton, 10–20 mm jackets, 15–30 mm armor). Then `Solidify` adds `--thickness` (2–4 mm fabric, 5–10 mm leather/armor), growing outward. UVs carry over from the body.
- Weights: Data Transfer (`POLYINTERP_NEAREST`, all groups by name), applied, limited to `--max-influences`, normalized and cleaned. The body's Armature modifier is added and parented to the rig.
- `--hide-body`: `Hidden_<name>` vertex group (the region shrunk by one ring) + an inverted Mask modifier on the body. Swappable outfits toggle masks. For export, delete those faces on a body copy instead.
- `--drape N`: classic cloth (cotton-ish: mass 0.15, tension 15, bending 0.5, quality 8). The top 8% is pinned, the body collides at 3 mm, it settles N frames, then the result is applied. That gives gravity folds on loose areas. Use 30–60 frames.
- `--morphs`: for each body shape key, a same-named garment shape key, via Surface Deform bound in the rest pose and applied as a shape key per morph. Engines drive body and garment keys together (fat/thin, muscle, breathing). Measured: a 30% body morph pokes through 346 verts. With the matching garment key, 0.
- **Poke check** (also run at the end of every build): casts along each body vertex normal. If the garment is hit inward before outward (or sits < 0.5 mm away), it's poke-through. Verts that hit no garment within 0.1 m aren't covered and are ignored. It reports `covered_verts`, `poke_verts` and `poke_max_m`, uses the **evaluated** pose, and respects the body masks.

## Layered clothing
- Order from the skin out: underwear/base → shirt → vest → jacket → armor. Each layer offsets from the one below (run `garment.py --body Shirt` for a vest over the shirt) and copies weights from the body, not from the layer below.
- Interpenetration between layers in motion usually comes from mismatched weights. Copying all layers from the same body keeps them moving together.
- Roblox layered clothing needs `<Name>_InnerCage` + `<Name>_OuterCage` built from Roblox's template cages (same vert order/UVs). Other engines (UE Mutable/Unity) blend shape keys or use body-hiding masks. Same principle.

## Gotchas
- `shape_key_add()` creates keys at value 1.0 (measured). Set `.value = 0` when authoring morphs from Python.
- Surface Deform for **morphs only**: if left live together with an Armature modifier, the pose is applied twice. `--morphs` removes it after baking the keys.
- Apply the body's scale before building. Offsets and thickness are in meters.
- Cloth sims need the body's collision mesh at a modest resolution. Decimate a proxy for the collision if the body is > 50k verts.
- Run `blender-asset-qa` on the final garment (z-fighting with the body, floating parts, normals) and check its tris against `blender-game-optimization` budgets.

© blender-agent-skills · MIT · EL4CTEO/blender-skills

Similar skills

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

From the same set28

The whole set →
blender-time-of-day blender-time-of-day — a skill for Claude Code that automates lighting and atmosphere in Blender 5.3. It configures sky settings, sun positioning, fog, and compositor grades based on time or mood presets. CX Codex +1 489installs blender-weather-fx The blender-weather-fx Claude Code skill builds weather effects for Blender 5.3 scenes. Ask for rain, snow, wet streets, puddles, dust or lightning to add the matching effects. CX Codex +1 476installs blender-addon-development The blender-addon-development Claude Code skill helps build and fix Blender extensions. It comes into play when editing an add-on, tool, or UI. CX Codex +1 463installs blender-stylized-npr The blender-stylized-npr Claude Code skill sets up stylized NPR shading, outlines, and Grease Pencil work in Blender. It applies to anime, cartoon, comic, and cel-shaded assets, including models prepared for game engines. CX Codex +1 458installs blender-texturing blender-texturing — a skill for Claude Code that automates smart material layering and texture authoring in Blender 5.3. Runs when adding wear, grime, or decals to 3D assets. CX Codex +1 431installs blender-environment-kits The blender-environment-kits Claude Code skill builds game environments in Blender 5.3, from terrain and biomes to modular kits. It activates for tasks such as making levels, forests, buildings, or dungeons. CX Codex +1 424installs blender-hair-grooming blender-hair-grooming — a skill for Claude Code that automates hair, fur, and beard creation in Blender using curves and procedural nodes. CX Codex +1 387installs blender-video-editing blender-video-editing is a Claude Code skill that automates video editing and motion tracking in Blender 5.3 with Python scripts. It runs on every render cut or camera solve. CX Codex +1 360installs

Project sponsors

Companies that keep this analytics open