Skip to content
cccskills
FreePublished on GitHub

blender-asset-qa

Mandatory review gate for any mesh or asset created or edited in Blender. Detects z-fighting (coplanar overlaps), floating/detached parts, inverted or inconsistent normals, non-manifold/open geometry, degenerate faces, duplicate verts, n-gons, unapplied scale, UV problems, bad skin weights, and renders multi-angle review sheets. Use before calling any modeling, export or delivery task done.

The English summary is being prepared. Showing the original description.

Works withBlender

Run score Not tested

See how to install

Files included (4)

  • SKILL.md4.6 KB
  • scripts/_bpyx.py4.4 KB
  • scripts/qa_check.py16.2 KB
  • scripts/review_shots.py6.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

FindingCauseFix
zfighting A<->Btwo surfaces facing the same way within --eps (1 mm) that overlapdelete the hidden duplicate, or offset ≥ 2–5 mm along the normal, or boolean/merge them
back_to_backfaces touching with opposite normals (boxes glued face-to-face)delete the hidden faces (wasted tris, bake artifacts)
floatingisland/object not touching any other part within --tolmove it to make contact (snap), bridge it, or join and merge. If floating is intended (sparks, UI), check it separately
enclosedpart fully inside another, not touching (eyes, internal mechanics)usually fine. Confirm it's intended
inside_out_islandsclosed part with normals pointing inmesh.normals_make_consistent(inside=False) on that part
inconsistent_normals_edgesneighbouring faces wound in opposite directionsrecalc normals; if it persists, look for non-manifold seams
nonmanifold_edges / wire_edges>2 faces per edge, or stray edgesdissolve/delete the extra faces; delete_loose
boundary_edgesopen holes (bad for print/Roblox/bakes)fill (fill_holes/edge_face_add) or cap
degenerate_faces / zero_length_edgescollapsed geometrydissolve_degenerate(threshold=1e-4)
duplicate_vertsunwelded seamsremove_doubles(threshold=1e-4) (Merge by Distance); check UV seams after
ngonsfaces with >4 sidestriangulate/quadrangulate locally; n-gons are fine only on flat hard-surface faces that never deform
unapplied/negative scaleobject transformtransform_apply(rotation=True, scale=True); negative scale flips normals on export
uv_maps: 0 / zero-area UV / overlapmissing or bad unwrapblender-retopology-uv
unweighted / >4 influencesskinningblender-character-rigging (weights_check.py)
ground_z ≠ 0asset floats or sinksmove the origin to the bottom and set z = 0 (props)

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: every face has the intended material, with no default grey slots.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Write Blender 5.2 add-ons as extensions - blender_manifest.toml, operators/panels/menus/property groups/preferences, bpy.props rules after 5.0, undo/redo, modal and timer patterns, gpu drawing (no bgl), bundling Python wheels, CLI validate/build/install, testing headless, extensions platform publishing. Use when creating or fixing a Blender add-on, tool, or UI.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

Animation in Blender 5.2 - slotted/layered actions and the channelbag API, Python keyframing, F-curves, game loops, NLA clips, pose library, mocap/BVH retargeting via constraints, baking control rigs to export skeletons, root motion, per-clip export. Use for any keyframe, action, NLA, mocap, or animation-export task.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

Character rigging in Blender 5.2 - Rigify metarig fit/generate, bone naming/roll/collections, DEF/MCH/control layers, IK/FK, robust skinning (heat + proxy fallback), weight-painting rules, correctives, engine game skeletons (Unity, Unreal, Roblox R15), rig validation and deformation stress tests. Use for armature, skinning or weights tasks.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

Foundation for any Blender 5.2+ task an agent drives - running bpy via MCP (live) or headless CLI, context overrides, locale-safe node lookup, enum discovery, 5.x API changes, verification. Use first for any Blender, bpy, .blend or 3D-asset request; routes to the specialized blender-* skills.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

Export from Blender 5.2 with verified presets - Roblox (FBX/glTF, cages, R15, SurfaceAppearance), Unity (FBX, Humanoid), Unreal (FBX skeletal, Nanite, UCX), Godot/web (GLB, meshopt/Draco, WebP), USD. Scale/axes, smoothing, tangents, leaf bones, clips, batch export, post-export verification. Use whenever an asset leaves Blender.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

Facial rigs and shape keys in Blender 5.2 - ARKit 52 blendshapes, visemes for lip-sync, sculpting expressions, splitting symmetric shapes into Left/Right, mirroring, corrective and combination shapes, drivers and control rigs, bone+blendshape hybrids, export to engines (Unity, Unreal, Roblox dynamic heads, VRM/web). Use for faces, expressions, lip-sync, or any shape-key work.

The English summary is being prepared. Showing the original description.

EL4CTEO/blender-skills456Updated Oct 20, 2026

See all skills by EL4CTEO

Report a problem with this skill