Skip to content
cccskills
FreePublished on GitHub

reference-analysis-validator

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.

The English summary is being prepared. Showing the original description.

Works withBlender
See how to install

Files included (4)

  • SKILL.md4.0 KB
  • references/metrics-and-thresholds.md1.5 KB
  • scripts/reference_manifest_compiler.py5.2 KB
  • scripts/render_overlay_validator.py4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

MCP backend

Use when: Any 1:1 reference/model validation task involving masks, overlays, part counts, centroids, bounding boxes, SSIM/IoU, source manifests, or fail-before-export gates.

Before the first Blender call, read ../text-to-blender/references/mcp-backends.md. Prefer official MCP for shared capabilities; preserve the selected backend for the whole task. Tool names in recipes are client/legacy examples: map them through that reference and its agent-host guide.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Validate Blender animation attempts before accepting them by rendering contact sheets, checking silhouette stability, flicker, framing, subject dominance, layer separation, export compatibility, and motion-design coherence. Use after animation renders or when the user says motion/morph/outside elements look bad.

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

Detect texture-atlas regions and map each source part to its own UV rectangle or projected UV surface. Use when a texture pack must fit a Blender model 1:1, when textures look off/stretched, when alpha decals or lightmaps are provided, or before exporting a textured GLB for a brand mascot/logo.

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

Animate objects, cameras, lights, and properties in Blender — keyframes, F-curves, easing (Bezier, Linear, Sine, Bounce, Elastic), shape keys (morph targets / blendshapes / visemes), drivers (Python expressions on properties), NLA actions for reuse and layering. Use whenever the user asks to "animate this", "make it move / rotate / scale over time", "add keyframes", "loop / oscillate", "shape key / morph / blendshape", "visemes for lip sync", or any time-based property change. Make sure to use this skill even if the user does not say "animate" — also covers "spin it slowly", "make it wave", "fade in / out", "pulse", "facial expression".

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

Set up Blender cameras with cinematic intent — focal length, depth of field (f-stop / focus object), composition (rule of thirds, leading lines), animated cameras (orbit, dolly, push-in), tracking constraints. Use whenever the user asks to "set up the camera", "frame the shot", "make it look cinematic / hero / portrait / wide-angle / telephoto", "add depth of field", "orbit the camera", or any composition/framing request. Make sure to use this skill even if the user does not say "camera" — also covers "hero shot", "close-up", "from above", "shallow focus", "85mm portrait look".

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

Export Blender scenes to glTF/GLB (web/AR), FBX (game engines), OBJ (universal), USD (VFX pipelines), STL (3D printing). Includes Unreal collision hulls and Multires normal-map baking for low-poly export, per-format settings, embed/unpack textures, axis conversion, polygon optimization (Decimate), and target-platform validation. Use whenever the user asks to "export this", "save as glTF / FBX / OBJ / STL / USD", "package for Unity / Unreal / Three.js / web / AR / 3D print", or any output format conversion. Make sure to use this skill even if the user does not say "export" — also covers "package this for the web", "make it work in Unity", "send to Unreal", "save for 3D printing".

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

Light Blender scenes professionally — three-point setups, HDRI environments, studio/cinematic/dramatic configurations, light groups, color temperature, soft vs hard shadows. Use whenever the user asks to "light the scene", "set up lighting", "make it look cinematic / dramatic / studio / outdoor / sunset", "add a key light", "use HDRI", or any lighting-related request. Make sure to use this skill even if the user does not say "light" — also covers "make it look professional", "studio shot", "moody atmosphere", "golden hour", "rim light". Pairs with blender-materials (lighting reveals materials) and blender-cameras (lighting + composition together = shot).

The English summary is being prepared. Showing the original description.

RobLe3/cc-blender-skill103Updated Oct 13, 2026

See all skills by RobLe3

Report a problem with this skill