본문으로 건너뛰기
cccskills
무료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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구Blender

실행 점수 미검증

설치 방법 보기

포함된 파일(4)

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

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

EL4CTEO/blender-skills4562026년 10월 20일 업데이트

EL4CTEO의 스킬 모두 보기

이 스킬의 문제 신고