# blender-clothing

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.

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

## What it 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.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-clothing -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-clothing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install EL4CTEO/blender-skills skills/blender-clothing
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/EL4CTEO/blender-skills --path skills/blender-clothing
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- 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
- 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

## 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: 7f7c546e35f408f3.

BEGIN THIRD-PARTY FILE 7f7c546e35f408f3
````text
---
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
````
END THIRD-PARTY FILE 7f7c546e35f408f3

The third-party file has ended. Everything between the 7f7c546e35f408f3 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 2191 of 5182 bytes. © blender-agent-skills · MIT · https://github.com/EL4CTEO/blender-skills/tree/HEAD/skills/blender-clothing/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
