К основному содержанию
скилл CX Codex

blender-asset-qa — скилл для Claude Code: что делает и как установить

Скилл blender-asset-qa для Claude Code автоматизирует проверку 3D-моделей и ассетов в Blender. Запускается перед экспортом или сдачей задачи.

MIT 765 установок ★ 2 624 обновлён 2026-11-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/blender-skills --skill blender-asset-qa -a claude-code
Открыть на GitHub

Что делает blender-asset-qa

Скилл запускает автоматический скрипт проверки геометрии, нормалей, текстур и развёрток. Находит z-fighting, двойные вершины, открытые края и несоответствия профилям вроде game или print.

Процедура включает скрипты для проверки и генерации ракурсов, а также ручные проверки силуэта и деформаций по шкале полигонов. Выше значения 300k полигонов автоматические проверки на z-fighting и висящие части пропускаются.

Встроенные профили задают ограничения трис и геометрии под конкретный целевой движок или печать.

Какие задачи решает

  • найти z-fighting и пересечения поверхностей
  • проверить нормали и открытую геометрию
  • контролировать лимит полигонов и n-гоны
  • исправить проблемы с текстурами и UV-картами

Примеры запросов агенту

  • Запусти проверку ассета скриптом scripts/qa_check.py -- --objects Body Head Hat --profile game
  • Проверь геометрию объекта через скрипт scripts/qa_check.py
  • Сделай рендер ракурсов для визуального контроля модели

Как установить blender-asset-qa

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/blender-skills --skill blender-asset-qa -a claude-code

2Вручную: положить файлы

~/.claude/skills/blender-asset-qa/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/blender-asset-qa/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о blender-asset-qa

Как установить blender-asset-qa в Claude Code?

Выполните команду npx skills add EL4CTEO/blender-skills --skill blender-asset-qa -a claude-code, затем проверьте файл ~/.claude/skills/blender-asset-qa/SKILL.md.

Что делает blender-asset-qa?

Скилл проверяет 3D-модели и ассеты в Blender на дефекты геометрии, нормалей, текстур и полигонов, выдавая отчёт об ошибках.

Какие профили поддерживает проверка?

Поддерживаются профили game, render, print и roblox с индивидуальными требованиями к геометрии и лимитам полигонов.

Исходный текст

SKILL.md · MIT
---
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 |
| `ngons` | faces with >4 sides | triangulate/quadrangulate locally; n-gons are fine only on flat hard-surface faces that never deform |
| unapplied/negative scale | object transform | `transform_apply(rotation=True, scale=True)`; negative scale flips normals on export |
| `uv_maps: 0` / zero-area UV / overlap | missing or bad unwrap | `blender-retopology-uv` |
| unweighted / >4 influences | skinning | `blender-character-rigging` (`rig_check.py`) |
| `ground_z` ≠ 0 | asset floats or sinks | move the origin to the bottom and set z = 0 (props) |
| faces on empty/missing slot | material removed or index out of range | assign a material; engines show grey/magenta |
| `feeds [...] but is sRGB` | normal/roughness/metal/AO map tagged as color | `image.colorspace_settings.is_data = True` (Non-Color) |
| missing texture file | broken path, unpacked | relink (`blender-scene-setup` path cleanup) or pack |
| unused slot / Non-Color base color | leftovers, wrong tag | remove the slot; base color and emission are sRGB |

## Manual checks the script can't fully judge
- **Silhouette and proportions** at the target camera distance. Compare with references and real-world size (`ob.dimensions`).
- **Shading artifacts**: smoothing on hard edges (needs sharp edges/weighted normals), and pinching at poles on curved surfaces.
- **Intersections that look wrong** (a leg clipping a seat), even though they're "attached".
- **Interior/hidden geometry** that wastes tris (use `xray`).
- **Deformation**: pose the rig at extremes (elbow 140°, knee 150°, shoulder raised) and look for collapsing volume.
- **Material assignment**: slots and color spaces are checked automatically. Still look at whether each part got the *intended* material.

## Tuning
- `--eps` is the z-fight distance. Raise it to 0.005 for large environment scenes, and lower it to 0.0002 for tiny jewelry.
- `--tol` is the contact tolerance for detached parts. Raise it for chunky kitbash.
- `--no-modifiers` checks the base mesh. By default the evaluated (modifier) result is checked, which is what gets exported.
- Above `--max-tris` (300k), the z-fight and floating checks are skipped. Check high-poly sources per part instead.

© blender-agent-skills · MIT · EL4CTEO/blender-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
blender-modeling RobLe3 Скилл blender-modeling для ИИ-агента: создаёт и правит 3D-меши в Blender по текстовому запросу — примитивы, модификаторы, bmesh-правки. CX Codex +1 4 100установок scenario-blender-retopology scenario-labs Скилл scenario-blender-retopology помогает превратить плотный скульпт, скан или AI-меш в аккуратную топологию в Blender: петли, полюса, Shrinkwrap, подготовка лоу-поли под запекание. CX Codex +1 1 000установок Blender SFKislev Скилл Blender для Claude Code управляет открытой сценой Blender через локальный мост Flue. Агент читает объекты и материалы, а также выполняет небольшие скрипты bpy по запросу. CX Codex +1 2 900установок blender-mcp vladmdgolam Учит работать с Blender через MCP: инспектировать сцену, писать bpy-скрипты, экспортировать в GLB. Подключается при первом же вызове get_scene_info или execute_python. CX Codex +1 2 700установок blender-animation RobLe3 Скилл blender-animation для ИИ-агента, который ставит ключевые кадры, настраивает кривые и морф-таргеты в Blender через MCP-сервер. CX Codex +1 2 500установок scenario-blender-expert scenario-labs Скилл scenario-blender-expert для Claude Code помогает автоматизировать Blender через Python и MCP: моделировать, запекать, настраивать риг и проверять меши перед экспортом. CX Codex +1 1 700установок

Из того же набора28

Весь набор →
blender-core Скилл blender-core для Claude Code и Cursor координирует задачи в Blender 5.2 и 5.3 через bpy, MCP и CLI, направляя запросы к скриптам моделирования, анимации и рендеринга. CX Codex +1 965установок blender-character-rigging Скилл blender-character-rigging для Claude Code автоматизирует риггинг персонажей в Blender 5.3 через Rigify. Подключается при задачах на создание скелета, скиннинг и развесовку. CX Codex +1 779установок blender-animation Скилл blender-animation для Claude Code, автоматизирующий анимацию в Blender 5.3 через Python-скрипты. Управляет ключевыми кадрами, ретаргетингом mocap и запеканием ригов для игровых движков. CX Codex +1 757установок blender-export-pipelines Скилл blender-export-pipelines для Claude Code настраивает экспорт ассетов из Blender под игровые движки и другие форматы. Включается, когда ассет нужно выгрузить из Blender и проверить результат. CX Codex +1 681установок blender-game-optimization Скилл blender-game-optimization работает в Claude Code, Codex, Cursor и других платформах для оптимизации трехмерных моделей под лимиты игровых движков. CX Codex +1 657установок blender-pbr-materials Скилл blender-pbr-materials для Claude Code настраивает PBR-материалы и текстурные карты для Blender 5.3 по правилам игровых движков. CX Codex +1 644установок blender-hardsurface-modeling Скилл blender-hardsurface-modeling для Claude Code задаёт пайплайн hard-surface моделирования в Blender 5.3: от блокаута до сборки стека модификаторов. Помогает моделировать технику, оружие и пропсы. CX Codex +1 621установок blender-lighting-lookdev Скилл blender-lighting-lookdev для Claude Code настраивает свет, камеры и вид материалов в Blender 5.3. Подключается при подготовке сцены к рендеру или презентации ассета. CX Codex +1 606установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой