| name | landmark-fit-repair |
| description | Validate and repair source-locked Blender models using named landmarks such as leaf tips, shell corners, eyes, smile, rim thickness, aura center/radius, and view-specific depth markers. Use when bbox/IoU is insufficient and the model must align to templates at designed feature points. |
| when_to_use | Landmark validation, feature-point deltas, control-point repair, face/eye/smile alignment, leaf tip alignment, aura ring fitting, iterative recipe parameter updates. |
| allowed-tools | Read Bash Glob Grep mcp__blender__execute_blender_code mcp__blender__get_scene_info mcp__blender__get_object_info |
Landmark Fit Repair
Bbox and IoU are too coarse for final mascot/logo matching. This skill turns named feature drift into recipe edits.
Landmark classes
structural_tip: outer part tips and extrema;shell_corner: face/shell/rim corners;feature: eyes, smile, brows, decals;ring: aura center/radius/dots;depth_marker: side/back/top thickness markers.
Workflow
- Define a landmark JSON for the source reference.
- Detect or render corresponding product landmarks.
- Compare by name and view.
- Convert deltas into repair actions: move boundary control point, scale one component, shift feature curve, tune depth, or adjust aura radius.
- Rebuild from recipe; do not hand-edit final geometry without updating the recipe/manifest.
Hard gates
- No final export when named structural landmarks exceed tolerance.
- Face features must be validated separately from body silhouette.
- Aura/context landmarks must not affect base GLB acceptance.
Script
scripts/landmark_fit_report.py compares two named-landmark JSON files and emits repair deltas.
Landmark JSON schema
{
"schema": "landmarks.v1",
"image_size": [width, height],
"landmarks": [
{"view":"front", "name":"leaf_top_tip", "class":"structural_tip", "x":627, "y":130}
]
}
For part masks, generate initial landmarks from extrema: top/bottom/left/right, centroid, and contour inflection points. Then rename them to semantic names before repair.
