Skip to main content
skill CX Codex

asset-optimization — Claude Code skill: what it does, how to install

The asset-optimization Claude Code skill checks and optimizes Blender 3D assets before export using MCP scene queries. Runs geometry audits, cleans topology, generates LOD meshes, and writes validation reports.

MIT 720 installs ★ 4,589 updated 2026-11-06

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

What asset-optimization does

The tool audits geometry, materials, and UV layouts inside Blender before engine export. It compares triangle counts against budgets, merges duplicate vertices, strips loose geometry, and fixes non-manifold edges.

The workflow enforces naming conventions such as SM_ prefixes for static meshes, MAT_ for materials, and COL_Collision for collision shapes. It requires UV packing efficiency above 75%. It also generates LOD0 through LOD3 meshes using planar or collapse Decimate modifiers.

Operation relies on a running MCP connection linked to the Blender scene. Without an active MCP bridge, the agent cannot query polycounts or run automated cleanup steps.

What it helps with

  • audit triangle count and material slots against production budgets
  • clean up interior faces, duplicate vertices, and non-manifold geometry
  • verify UV packing efficiency above 75 percent
  • generate LOD0 to LOD3 mesh variants using Decimate modifiers
  • output per-object scene validation reports before export

Example prompts for the agent

  • Audit asset polycount and material budgets before export
  • Run a geometry cleanup and generate LOD meshes for this object
  • Validate the Blender scene naming and UV packing efficiency

How to install asset-optimization

1Skills CLI (Vercel)

npx skills add arjun988/blender-skills --skill asset-optimization -a claude-code

2Manually: put the files in place

~/.claude/skills/asset-optimization/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/asset-optimization/

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

Questions about asset-optimization

How to install asset-optimization in Claude Code?

Run npx skills add arjun988/blender-skills --skill asset-optimization -a claude-code in your terminal.

What does asset-optimization do?

It audits Blender assets via MCP, checks triangle and material budgets, repairs non-manifold topology, and creates LOD variants.

What is required to run asset-optimization?

It requires Blender and an active MCP server connection to allow the AI agent to query scene data and perform geometry cleanup.

Source text

SKILL.md · MIT
---
name: asset-optimization
description: Validates and optimizes Blender assets for polycount, topology, UV efficiency, material count, naming, collections, and game-ready performance. Use before export on all production assets via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: optimize, optimization, polycount, LOD, cleanup, performance, game ready, validate, triangle count
  related-skills: export-pipeline, blender-modeler, uv-workflow
---

# Asset Optimization

Enforce budgets. Clean geometry. Game-ready validation gate before export.

## When to Use

- Before every export
- After modeling complete
- LOD generation
- Scene-wide performance audit
- Pre-delivery validation

## Workflow

```
Audit → Identify Issues → Fix → Re-Audit → LOD Generation → Validation Report
```

## Audit Checklist

Run via MCP scene queries where possible:

### Geometry
- [ ] Triangle count vs budget (`../references/polycount-budgets.md`)
- [ ] Duplicate vertices merged
- [ ] Loose geometry removed
- [ ] Non-manifold fixed
- [ ] Interior faces deleted
- [ ] Applied transforms (scale 1,1,1)

### UVs
- [ ] Pack efficiency > 75%
- [ ] Texel density consistent
- [ ] No unintended overlaps

### Materials
- [ ] Count within budget
- [ ] No unused slots
- [ ] Names follow `MAT_` convention

### Organization
- [ ] All objects named `SM_` prefix
- [ ] Collections organized per convention
- [ ] Collision meshes in `COL_Collision`

## Optimization Techniques

| Issue | Fix |
|-------|-----|
| Over budget | Remove unseen geo, decimate, bake detail |
| High triangle count on flat surfaces | Reduce subdiv/bevel segments |
| Many draw calls | Merge materials; atlas textures |
| Repeated geometry | Convert to instances |
| Heavy modifiers | Apply and merge strategically |

## LOD Generation

```
LOD0: Full detail (hero)
LOD1: 50% tris — remove micro-bevels, small greebles
LOD2: 25% tris — decimate modifier; preserve silhouette
LOD3: 10% tris — impostor/card or simple proxy
```

Naming: `SM_Asset_LOD0`, `SM_Asset_LOD1`, etc.

Use Decimate modifier:
- Planar mode for hard surface
- Collapse mode for organic
- Always verify silhouette after decimate

## Modifier Cleanup

Before export:
1. Apply stack OR export with modifiers per engine support
2. Remove unused modifiers
3. Collapse mirror/array if instances not needed
4. Document which modifiers remain live

## Scene Audit Report Template

```markdown
## Optimization Report: [Asset/Scene]

**Total Triangles:** [count] (budget: [target])
**Draw Calls (materials):** [count]
**Objects:** [count]
**Issues Fixed:** [list]

### Per-Object Breakdown
| Object | Tris | Materials | Status |
|--------|------|-----------|--------|
| SM_... | ... | ... | PASS/FAIL |
```

## MCP Integration

1. Query polycount per object via MCP
2. Query material count via MCP
3. Run cleanup operations via MCP
4. Generate LOD duplicates via MCP
5. Validate naming conventions via MCP scene tree

## Constraints

### MUST DO
- Run full validation before export
- Document polycount in production brief
- Create LODs for hero assets in games
- Fix all non-manifold before export
- Output validation report

### MUST NOT DO
- Export without budget check
- Decimate deforming meshes without testing
- Remove collision proxies
- Skip naming convention validation
- Optimize hero face/hands below animation needs

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Full validation | `../references/validation-checklist.md` | Final gate |
| Polycount budgets | `../references/polycount-budgets.md` | Budget setting |
| LOD strategies | `references/lod-strategies.md` | LOD creation |

© https://github.com/arjun988 · MIT · arjun988/blender-skills

Similar skills

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

From the same set57

The whole set →
rigging Skill for automated production rigging in Blender via MCP. Used before animation tasks to handle armatures, constraints, and weight painting. CX Codex +1 747installs blender-modeler blender-modeler — a skill for Claude Code and other platforms handling 3D modeling in Blender via MCP. It manages geometry, modifier stacks, and scene organization. CX Codex +1 745installs character-artist The character-artist skill for Claude Code builds AAA character models with animation-ready topology in Blender via MCP. CX Codex +1 738installs materials The materials skill automates PBR and stylized material creation in Blender via MCP. It is triggered during look development, procedural shader design, and production asset preparation. CX Codex +1 708installs environment-artist The environment-artist Claude Code skill guides game environment work in Blender, from modular buildings and terrain to vegetation and scene composition. It applies to architecture, interiors, exteriors, and level art. CX Codex +1 697installs animation This skill automates game-ready animation workflows in Blender. It activates when defining keyframes for characters or mechanical objects. CX Codex +1 675installs uv-workflow uv-workflow — a skill that automates UV unwrapping in Blender via MCP. Runs when preparing meshes for texturing and game engine export. CX Codex +1 672installs qa-review qa-review — a skill for Claude Code reviews Blender assets with viewport screenshots, checklists, and naming audits. It runs before export or handoff and after major modeling or lookdev milestones. CX Codex +1 672installs

Project sponsors

Companies that keep this analytics open