blender-asset-validation

Blender Asset Validation

Read the shared execution guidance once per task for autonomous decisions, evidence cadence, and long-task continuity.

Validate both the authored scene and the exported deliverable. A clean export or low triangle count is not proof of visual or functional quality.

Run deterministic inspection

Prefer the blender_inspect_asset MCP tool when available. Otherwise run:

$env:BLENDER_EXECUTABLE = "C:\path\to\Blender\blender.exe"
& $env:BLENDER_EXECUTABLE `
  --background --factory-startup `
  --python "<skill-root>\scripts\inspect_asset.py" -- `
  --input "<asset-path>" --output "<output-dir>\metrics.json"

Inspect:

• evaluated vertices, edges, polygons, and triangles;
• authored versus evaluated geometry density and refinement modifiers;
• smooth versus flat-shaded polygon ratios;
• UV-bearing meshes, node-based materials, image textures, and authored lights;
• mesh objects, materials, actions, frame ranges, and hierarchy;
• dimensions and world bounds;
• invalid coordinates, degenerate faces, loose elements, boundary and non-manifold edges;
• connected components per mesh;
• non-default transforms and missing material assignments.

Interpret metrics using references/quality-gates.md. Do not apply printing-only topology rules to every game asset.

Render evidence

The default presentation: "auto" selects a studio background using a constant-material luminance hint: dark for bright assets, light for very dark assets, neutral slate otherwise. The CLI equivalent is --presentation auto. Use neutral, dark, or light to override. Light power and camera framing scale with asset dimensions; the tool resets authored lighting and grading. Keep a separate authored beauty render when the original lighting is part of the requested result.

Open the first hero image before accepting the presentation. If material color is washed out, shadows hide the form, or the silhouette merges into the backdrop, rerender with a better preset. Automatic selection is a starting point; it cannot infer texture-driven color, transparent appearance, or art direction. Offer two useful options when they serve different goals, such as dark studio and light catalog. Do not generate all presets routinely. Present a polished hero image first, with multiview evidence available for inspection.