# blender-asset-qa

blender-asset-qa — a Claude Code skill for automated review of meshes and assets in Blender. Runs before export or delivery.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 765 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-asset-qa/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-asset-qa

## What it does

The skill runs an automated check script over Blender objects to catch z-fighting, inverted normals, open geometry, n-gons, and UV errors. It validates assets against profiles like game, render, print, or roblox.

The review workflow combines automated validation scripts with multi-angle visual checks and manual silhouette inspection. Above 300k triangles, heavy mesh checks are skipped to maintain performance.

Every finding maps directly to a specific fix or acceptance rule reported back in the final output.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- detect z-fighting and overlapping surfaces
- check normals and non-manifold geometry
- validate polygon limits and n-gons
- inspect UV maps and texture color spaces

## Example prompts
- Run the QA check script `scripts/qa_check.py -- --objects Body Head Hat --profile game`
- Check mesh topology using `scripts/qa_check.py`
- Render review shots with `scripts/review_shots.py -- --objects Body --mode random`

## 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: 33701bd3e0c17596.

BEGIN THIRD-PARTY FILE 33701bd3e0c17596
```text
---
name: blender-asset-qa
description: Mandatory review gate for any mesh or asset created or edited in Blender. Detects z-fighting, floating/detached parts, inverted or inconsistent normals, non-manifold/open geometry, degenerate faces, duplicate verts, n-gons, unapplied scale, UV problems, bad skin weights, material/texture errors, and renders multi-angle review sheets. Use before calling any modeling, export or delivery task done.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Asset QA (review gate)

Never assume a generated or edited mesh is correct. Check it with numbers, then look at it.

## Procedure
1. **Automated check**, passing one asset's objects together:
   `scripts/qa_check.py -- --objects Body Head Hat --profile game`
   Profiles: `game` (default), `render` (lenient), `print` (watertight required), `roblox` (20k tris/mesh, watertight, no n-gons, ≤4 influences).
2. **Fix every `errors` entry** (table below), then re-run until `"pass": true`. Each warning must be either fixed or explicitly accepted, with the reason reported to the user.
3. **Visual check, always**:
   - Live: MCP `look` with `mode="angles"` on the targets, once in `material`/`solid` shading and once in `wireframe`. Use `xray` for internals.
   - Headless: `scripts/review_shots.py -- --objects ... --mode random` (one color per object, which makes detached pieces obvious), then `--mode wire` for topology. Open the returned PNG.
4. Report: tris per object, issues fixed, and remaining accepted warnings.

## What each finding means → fix
| Finding | Cause | Fix |
|---|---|---|
| `zfighting` A<->B | two surfaces facing the same way within `--eps` (1 mm) that overlap | delete the hidden duplicate, or offset ≥ 2–5 mm along the normal, or boolean/merge them |
| `back_to_back` | faces touching with opposite normals (boxes glued face-to-face) | delete the hidden faces (wasted tris, bake artifacts) |
| `floating` | island/object not touching any other part within `--tol` | move it to make contact (snap), bridge it, or join and merge. If floating is intended (sparks, UI), check it separately |
| `enclosed` | part fully inside another, not touching (eyes, internal mechanics) | usually fine. Confirm it's intended |
| `inside_out_islands` | closed part with normals pointing in | `mesh.normals_make_consistent(inside=False)` on that part |
| `inconsistent_normals_edges` | neighbouring faces wound in opposite directions | recalc normals; if it persists, look for non-manifold seams |
| `nonmanifold_edges` / `wire_edges` | >2 faces per edge, or stray edges | dissolve/delete the extra faces; `delete_loose` |
| `boundary_edges` | open holes (bad for print/Roblox/bakes) | fill (`fill_holes`/`edge_face_add`) or cap |
| `degenerate_faces` / `zero_length_edges` | collapsed geometry | `dissolve_degenerate(threshold=1e-4)` |
| `duplicate_verts` | unwelded seams | `remove_doubles(threshold=1e-4)` (Merge by Distance); check UV seams after |
```
END THIRD-PARTY FILE 33701bd3e0c17596

The third-party file has ended. Everything between the 33701bd3e0c17596 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 2985 of 5185 bytes. © blender-agent-skills · MIT · https://github.com/EL4CTEO/blender-skills/tree/HEAD/skills/blender-asset-qa/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
