CheshireJCat/create-3d-model-skill / skills/create-3d-model/references/modules/reference-analysis-validator
reference-analysis-validator
VerifiedMeasure and validate supplied reference images, wireframes, texture atlases, and Blender renders before declaring a reconstruction 1:1. Use when an asset must match a template, when visual feedback says the output is off, when part counts must be exact, or before exporting a brand mascot/logo reconstruction. Pairs with reference-to-3d, contour-to-mesh, orthographic-registration, atlas-uv-fitting, and Blender MCP.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| references/metrics-and-thresholds.md | markdown | 1.5 KB |
| scripts/reference_manifest_compiler.pyexecutable | script | 5.2 KB |
| scripts/render_overlay_validator.pyexecutable | script | 4.0 KB |
SKILL.md
View on GitHub---
name: reference-analysis-validator
description: Measure and validate supplied reference images, wireframes, texture atlases, and Blender renders before declaring a reconstruction 1:1. Use when an asset must match a template, when visual feedback says the output is off, when part counts must be exact, or before exporting a brand mascot/logo reconstruction. Pairs with reference-to-3d, contour-to-mesh, orthographic-registration, atlas-uv-fitting, and Blender MCP.
when_to_use: Any 1:1 reference/model validation task involving masks, overlays, part counts, centroids, bounding boxes, SSIM/IoU, source manifests, or fail-before-export gates.
allowed-tools: Read Bash Glob Grep execute_blender_code get_scene_info get_object_info
---
# Reference Analysis Validator
This skill converts “looks close” into measurable gates. For brand/logo/mascot work, **do not model or export until a source manifest and validation thresholds exist**.
## Required outputs
Create these in the asset output folder:
- `reference_manifest.json` — classified source files, expected parts, thresholds.
- `source_analysis/*.json` — image metadata, masks/components/landmarks.
- `validation/front_overlay_reference.png` — reference and render overlay.
- `validation/front_mask_validation.json` — IoU/SSIM/bbox/centroid report.
## Workflow
1. Classify sources: front, side, back, top, texture atlas, decals, maps, lightmap, aura/context.
2. Build/refresh `reference_manifest.json` with hard expected counts and view roles.
3. Extract masks/components from each source using `scripts/reference_manifest_compiler.py` or existing analyzers.
4. Render model from matching orthographic camera with reference planes hidden.
5. Compare reference mask vs render mask using `scripts/render_overlay_validator.py`.
6. Refuse final export if hard gates fail.
## Modality rule
Compare like with like. A wireframe edge mask compared against a shaded beauty render gives misleadingly low IoU. For hard gates, render a flat silhouette/matte pass from Blender or compare reference edges to render edges. Use `render_overlay_validator.py --reference-mode ... --render-mode ...` when the source and render need different mask extraction modes.
## Default validation gates
- primary structural part count: exact.
- front silhouette IoU: target >= 0.90 for rigid/logotype shapes; >= 0.82 acceptable for first mascot reconstruction pass.
- bbox center drift: <= 12 px at 1024 px validation size.
- bbox size drift: <= 3% of image dimension.
- face/eye/smile landmark drift: <= 2% of image dimension when landmarks are defined.
## Failure policy
If a repeated mismatch occurs, record the measured failure, then route to the missing specialty skill:
- wrong silhouette → `contour-to-mesh`
- wrong depth/side/back → `orthographic-registration`
- wrong textures → `atlas-uv-fitting`
- wrong whole workflow → `mascot-logo-reconstruction`
## Read when needed
- `references/metrics-and-thresholds.md` for metric definitions and recommended gates.
## Sources distilled
Official/library docs to prefer while extending this skill:
- OpenCV contour features: moments, area, perimeter, bounding rectangles.
- OpenCV shape matching / Hu moments.
- OpenCV homography and geometric transforms.
- scikit-image SSIM for perceptual comparison.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |