el4cteo/blender-skills

blender-asset-qa

Mandatory review gate for any mesh or asset created or edited in Blender.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/el4cteo/blender-skills --skill blender-asset-qa

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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).

  1. 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.
  2. 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.
  1. 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 (rig_check.py)
ground_z ≠ 0asset floats or sinksmove the origin to the bottom and set z = 0 (props)
faces on empty/missing slotmaterial removed or index out of rangeassign a material; engines show grey/magenta
feeds [...] but is sRGBnormal/roughness/metal/AO map tagged as colorimage.colorspace_settings.is_data = True (Non-Color)
missing texture filebroken path, unpackedrelink (blender-scene-setup path cleanup) or pack
unused slot / Non-Color base colorleftovers, wrong tagremove 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.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
el4cteo
커뮤니티

blender-environment-kits

Game environments in Blender 5.3 - terrain from noise or heightmaps (erosion, terraces, play areas, slope/height materials, 16-bit heightmaps + splat maps for UE/Unity), biome scatter by slope/height/mask with Poisson spacing, modular kit metrics and validation (grid, pivots, seams, texel density). Use for levels, landscapes, forests, modular buildings, dungeons.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-geometry-nodes

Geometry Nodes in Blender 5.3 - fields, domains, attributes, instancing, zones (simulation/repeat/for-each), closures/bundles, lists, SDF grids, node tools, baking, plus a JSON-to-node-tree builder and socket inspector. Use for scattering, procedural assets/environments, parametric tools and modifier inputs.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-lighting-lookdev

Lighting, cameras and look-dev in Blender 5.3 - studio 3-point and product lighting, HDRI environments, sun/sky exteriors, interiors, light linking, physically based light units, camera focal lengths/composition/DOF, cyclorama backdrops, looping turntables for asset presentation. Use when presenting assets, setting up scenes for rendering, or judging materials under consistent light.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일
el4cteo
커뮤니티

blender-rendering

Render with Blender 5.3 Cycles/EEVEE/Workbench - quality presets, GPU setup, adaptive sampling, denoising, light paths, color management (AgX, Khronos PBR Neutral, ACES), PNG/EXR/MP4 output, passes, the 5.0 compositor API, CLI and multi-camera batch rendering. Use for any still, animation or turntable render.

1시간 설치 수
4
GitHub Stars
2.5천
업데이트
11월 17일