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