blender-asset-qa
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
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- blender-asset-qa
- license
- MIT
- metadata
- { "author": "blender-agent-skills", "version": "1.2.0" }
- 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.
02 资源文件 3
- 脚本scripts/_bpyx.py4.4 KB
- 脚本scripts/qa_check.py19.0 KB
- 脚本scripts/review_shots.py6.1 KB
03 SKILL.md 正文
Asset QA (review gate)
Never assume a generated or edited mesh is correct. Check it with numbers, then look at it.
Procedure
- Automated check, passing one asset's objects together:
scripts/qa_check.py -- --objects Body Head Hat --profile gameProfiles:game(default),render(lenient),print(watertight required),roblox(20k tris/mesh, watertight, no n-gons, ≤4 influences). - Fix every
errorsentry (table below), then re-run until"pass": true. Each warning must be either fixed or explicitly accepted, with the reason reported to the user. - Visual check, always:
- Live: MCP
lookwithmode="angles"on the targets, once inmaterial/solidshading and once inwireframe. Usexrayfor internals. - Headless:
scripts/review_shots.py -- --objects ... --mode random(one color per object, which makes detached pieces obvious), then--mode wirefor topology. Open the returned PNG.
- Live: MCP
- 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
--epsis the z-fight distance. Raise it to 0.005 for large environment scenes, and lower it to 0.0002 for tiny jewelry.--tolis the contact tolerance for detached parts. Raise it for chunky kitbash.--no-modifierschecks 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.
04 同仓库更多 Skills
blender-workflow-recipes
End-to-end Blender 5.2 playbooks chaining the blender-* skills with QA gates - game props (mid-poly, high-to-low), game characters (sculpt/AI mesh to rigged, animated export), Roblox props/accessories/avatars, AI or downloaded asset cleanup, procedural environments, web/AR assets, product turntables, mood/weather shots (night, rain, snow, fog). Use for complete multi-stage asset requests.
blender-weather-fx
Weather effects in Blender 5.2 - looping Geometry Nodes rain, snow, dust, ash and embers with ground hits and splashes, wet surfaces, puddles with animated ripples, wall streaks, snow cover (shader + real snow geometry), storm lightning with multi-stroke flashes and bolts, engine-ready weather masks. Use for rain, storm, snow, wet street, puddle, dust or ember scenes.
blender-video-editing
Video in Blender 5.2 - Video Sequencer edits from Python (clips, image sequences, crossfades, titles, music fades, proxies, color management, H.264/AAC output) and motion tracking (feature detection, camera solve, scene orientation, tripod and plane tracking, stabilization) for VFX shots. Use to cut renders/footage together or match-move a camera.
blender-time-of-day
Time of day and atmosphere in Blender 5.2 - measured sky + sun for dawn, morning, noon, golden hour, sunset, blue hour, overcast, night/moonlight with stars and city glow, exposure balance, height fog from visibility, god rays, Cycles vs EEVEE volumes, compositor grade, stylized moods (cyberpunk neon, horror, underwater, desert). Use for any day/night, sunset, foggy or mood lighting scene.
blender-texturing
Texture authoring in Blender 5.2 - smart-material layers (edge wear, cavity grime, dust, rust, roughness breakup) from curvature/AO masks, z-fight-safe decal and sticker placement, trim sheets, tiling + vertex-color blends, texture painting, baking the look to game texture sets. Use when a material needs wear, dirt, a decal, trims or hand painting, not just wiring.
blender-texture-baking
Bake texture maps in Blender 5.2 Cycles - high-to-low normal maps with cage/extrusion, AO, curvature, ID, thickness, base color/roughness/metallic from procedurals, ORM packing, OpenGL vs DirectX, margins, GPU baking, fixing skewing/waviness/seams. Use when transferring sculpt or high-poly detail to game meshes or converting procedural materials to textures.