EL4CTEO/blender-skills / skills/blender-asset-qa
blender-asset-qa
VerifiedMandatory 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.1 KB |
| scripts/_bpyx.py | script | 4.4 KB |
| scripts/qa_check.py | script | 19.8 KB |
| scripts/review_shots.py | script | 6.3 KB |
scripts/review_shots.py
View on GitHub"""Render a multi-angle review contact sheet (headless-safe Workbench) for visual QA.
Modes: solid (studio light + cavity), random (color per object/part -> spot detached
parts), wire (black wireframe over solid -> topology), material (texture/material colors).
Usage:
blender -b f.blend -P review_shots.py -- [--objects A B] [--out //review.png]
[--views front right back left top three_quarter] [--mode solid|random|wire|material] [--res 512]
MCP: prefer the `look` tool; this script is for agents without live viewport access.
Returns {"sheet": path, "views": [paths]} - open the PNG with your image reader.
"""
import math
import os
import sys
import tempfile
import bpy
import numpy as np
from mathutils import Vector
sys.path.insert(0, os.path.dirname(__file__))
import _bpyx as bx # noqa: E402
DIRS = {"front": (0, -1, 0.15), "back": (0, 1, 0.15), "right": (1, 0, 0.15), "left": (-1, 0, 0.15),
"top": (0, -0.001, 1), "bottom": (0, 0.001, -1), "three_quarter": (1, -1, 0.6)}
def _bounds(obs):
bpy.context.view_layer.update() # bound_box is stale on freshly built objects
pts = [o.matrix_world @ Vector(c) for o in obs for c in o.bound_box]
lo = Vector((min(p.x for p in pts), min(p.y for p in pts), min(p.z for p in pts)))
hi = Vector((max(p.x for p in pts), max(p.y for p in pts), max(p.z for p in pts)))
return (lo + hi) / 2, max((hi - lo).length / 2, 1e-3)
def run(objects=None, out="", views=None, mode="solid", res=512, **_):
bx.object_mode()
obs = bx.objects(objects, types=("MESH", "CURVE", "FONT", "SURFACE", "CURVES", "VOLUME"))
if not obs:
raise ValueError("nothing to render")
views = views or ["front", "right", "top", "three_quarter"]
sc = bpy.context.scene
out = bpy.path.abspath(out) if out else os.path.join(
os.path.dirname(bpy.data.filepath) or tempfile.gettempdir(), "review_sheet.png")
os.makedirs(os.path.dirname(out) or ".", exist_ok=True)
# snapshot settings we touch, restore after
r, sh = sc.render, sc.display.shading
saved = dict(engine=r.engine, rx=r.resolution_x, ry=r.resolution_y, pct=r.resolution_percentage,
fp=r.filepath, cam=sc.camera, light=sh.light, color=sh.color_type,
cavity=sh.show_cavity, outline=sh.show_object_outline, transp=r.film_transparent)
hidden = {o: o.hide_render for o in sc.objects}
temp = []
try:
for o in sc.objects:
o.hide_render = o not in obs
r.engine = "BLENDER_WORKBENCH"
r.resolution_x = r.resolution_y = res
r.resolution_percentage = 100
r.film_transparent = False
r.image_settings.media_type = "IMAGE"
r.image_settings.file_format = "PNG"
sh.light = "STUDIO"
sh.show_cavity = mode in ("solid", "wire")
sh.show_object_outline = True
sh.color_type = {"random": "RANDOM", "material": "MATERIAL", "wire": "OBJECT"}.get(mode, "SINGLE")
if mode == "wire":
wire_t = _bounds(obs)[1] * 0.006
for o in obs:
if o.type != "MESH":
continue
w = o.copy()
w.data = o.data
w.modifiers.new("QA_Wire", "WIREFRAME").thickness = wire_t
w.color = (0, 0, 0, 1)
sc.collection.objects.link(w)
temp.append(w)
o.color = (0.8, 0.8, 0.8, 1)
cam_data = bpy.data.cameras.new("QA_Cam")
cam_data.lens = 50
cam = bpy.data.objects.new("QA_Cam", cam_data)
sc.collection.objects.link(cam)
temp.append(cam)
sc.camera = cam
center, radius = _bounds(obs)
fov = 2 * math.atan(cam_data.sensor_width / (2 * cam_data.lens))
dist = radius / math.sin(fov / 2) * 1.05
cam_data.clip_end = dist * 4
cam_data.clip_start = dist / 1000
paths = []
for v in views:
d = Vector(DIRS[v] if isinstance(v, str) else v).normalized()
cam.location = center + d * dist
cam.rotation_euler = (-d).to_track_quat("-Z", "Y").to_euler()
p = os.path.splitext(out)[0] + f"_{v}.png"
r.filepath = p
bpy.ops.render.render(write_still=True)
paths.append(p)
# tile into a contact sheet
imgs = []
for p in paths:
im = bpy.data.images.load(p, check_existing=False)
a = np.empty(res * res * 4, dtype=np.float32)
im.pixels.foreach_get(a)
imgs.append(a.reshape(res, res, 4))
bpy.data.images.remove(im)
n = len(imgs)
cols = n if n <= 3 else 2 if n == 4 else 3 # 1-3 views in one row: no empty cells
rows = math.ceil(n / cols)
sheet = np.empty((rows * res, cols * res, 4), dtype=np.float32)
sheet[:] = imgs[0][0, 0] # unused cells take the render background, not white
for i, a in enumerate(imgs):
rr, cc = rows - 1 - i // cols, i % cols # pixel rows are bottom-up
sheet[rr * res:(rr + 1) * res, cc * res:(cc + 1) * res] = a
im = bpy.data.images.new("QA_Sheet", cols * res, rows * res, alpha=True)
im.pixels.foreach_set(sheet.ravel())
im.filepath_raw = out
im.file_format = "PNG"
im.save()
bpy.data.images.remove(im)
finally:
for o in temp:
data = o.data if o.type == "CAMERA" else None
bpy.data.objects.remove(o)
if data:
bpy.data.cameras.remove(data)
for o, h in hidden.items():
o.hide_render = h
r.engine, r.resolution_x, r.resolution_y = saved["engine"], saved["rx"], saved["ry"]
r.resolution_percentage, r.filepath, sc.camera = saved["pct"], saved["fp"], saved["cam"]
r.film_transparent = saved["transp"]
sh.light, sh.color_type, sh.show_cavity = saved["light"], saved["color"], saved["cavity"]
sh.show_object_outline = saved["outline"]
return {"ok": True, "sheet": out, "views": paths, "layout": f"{cols}x{rows}", "order": views}
if __name__ == "__main__":
p = bx.add_common(bx.parser(__doc__), save=False)
p.add_argument("--out", default="")
p.add_argument("--views", nargs="*", default=None, choices=list(DIRS))
p.add_argument("--mode", default="solid", choices=["solid", "random", "wire", "material"])
p.add_argument("--res", type=int, default=512)
bx.cli(run, p)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |