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