본문으로 건너뛰기
cccskills
무료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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구Blender
설치 방법 보기

포함된 파일(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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

RobLe3/cc-blender-skill1072026년 10월 13일 업데이트

RobLe3의 스킬 모두 보기

이 스킬의 문제 신고