How do I install the Texture Driven Mesh Fitting skill?

Run npx skillmds@latest add cheshirejcat/texture-driven-mesh-fitting in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Texture Driven Mesh Fitting safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Texture Driven Mesh Fitting?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Texture Driven Mesh Fitting free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Texture Driven Mesh Fitting?

CheshireJCat (@cheshirejcat) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Texture Driven Mesh Fitting by cheshirejcat

Name: Texture Driven Mesh Fitting
Rating: 4.2 (5 reviews)
Author: CheshireJCat

Texture Driven Mesh Fitting

Reshape source-locked mesh boundaries so the geometry fits texture-atlas or decal contours 1:1 before final UV/material work. Use when textures look off because the model behind them does not match the source texture region, or when the mesh must adapt to the texture instead of stretching the texture onto an approximate mesh.

CheshireJCat Updated Sep 22, 2026

File contents

Texture-Driven Mesh Fitting

This skill fixes the common failure: a texture is mapped correctly, but the mesh silhouette underneath is wrong. The mesh adapts to the source contour; the texture is not stretched to hide a wrong mesh.

Preconditions

Structural parts are segmented (source-part-segmentation).
Each part has a contour/mask and, if textured, an atlas region (atlas-uv-fitting).
The object is source-locked in front X/Z before depth is added.
Canonical view policy is resolved (multiview-constraint-solver) if views conflict.

Workflow

Extract source contour from the texture/wireframe region.
Extract current mesh boundary in the same projected coordinate space.
Build ordered contour correspondence by arc length, named landmarks, or seam/control points.
Move boundary vertices to source contour positions.
Move interior vertices by smooth interpolation, piecewise-affine warp, or thin-plate-spline style deformation.
Preserve UV parameterization by remapping boundary-fitted local coordinates into the atlas rectangle.
Re-render overlay; do not proceed to look-dev until texture-region silhouette passes.

Acceptance gates

Per-part source/product bbox center and size within tolerance.
Boundary maximum sample error below tolerance after normalization.
Texture atlas region does not visibly bleed outside the fitted mesh in front view.
Named landmarks (leaf_tip, base_left, base_right, face_corner, etc.) pass landmark-fit-repair.

Hard rules

If a texture crop has a different silhouette than the mesh, reshape the mesh first.
Do not use global UV stretching to hide geometry mismatch.
Boundary fitting must happen before side-depth/crown deformation.
Do not tune material/light to compensate for geometry/UV misfit.

Scripts

scripts/contour_correspondence_report.py reports bbox, centroid, and sampled contour deltas between a source mask and a render/object mask.

Sources distilled

Piecewise-affine/landmark warping gives a practical mesh deformation model.
Thin-plate-spline style deformation is appropriate for smooth mascot/logo surfaces when landmarks are sparse.
Blender mesh vertices/UV layers can be edited directly; BMesh is useful for cleanup after deformation.

---name: texture-driven-mesh-fittingdescription: Reshape source-locked mesh boundaries so the geometry fits texture-atlas or decal contours 1:1 before final UV/material work. Use when textures look off because the model behind them does not match the source texture region, or when the mesh must adapt to the texture instead of stretching the texture onto an approximate mesh.---# Texture-Driven Mesh FittingThis skill fixes the common failure: a texture is mapped correctly, but the mesh silhouette underneath is wrong.The mesh adapts to the source contour; the texture is not stretched to hide a wrong mesh.## Preconditions- Structural parts are segmented (`source-part-segmentation`).- Each part has a contour/mask and, if textured, an atlas region (`atlas-uv-fitting`).- The object is source-locked in front X/Z before depth is added.- Canonical view policy is resolved (`multiview-constraint-solver`) if views conflict.## Workflow1. Extract source contour from the texture/wireframe region.2. Extract current mesh boundary in the same projected coordinate space.3. Build ordered contour correspondence by arc length, named landmarks, or seam/control points.4. Move boundary vertices to source contour positions.5. Move interior vertices by smooth interpolation, piecewise-affine warp, or thin-plate-spline style deformation.6. Preserve UV parameterization by remapping boundary-fitted local coordinates into the atlas rectangle.7. Re-render overlay; do not proceed to look-dev until texture-region silhouette passes.## Acceptance gates- Per-part source/product bbox center and size within tolerance.- Boundary maximum sample error below tolerance after normalization.- Texture atlas region does not visibly bleed outside the fitted mesh in front view.- Named landmarks (`leaf_tip`, `base_left`, `base_right`, `face_corner`, etc.) pass `landmark-fit-repair`.## Hard rules- If a texture crop has a different silhouette than the mesh, reshape the mesh first.- Do not use global UV stretching to hide geometry mismatch.- Boundary fitting must happen before side-depth/crown deformation.- Do not tune material/light to compensate for geometry/UV misfit.## Scripts- `scripts/contour_correspondence_report.py` reports bbox, centroid, and sampled contour deltas between a source mask and a render/object mask.## Sources distilled- Piecewise-affine/landmark warping gives a practical mesh deformation model.- Thin-plate-spline style deformation is appropriate for smooth mascot/logo surfaces when landmarks are sparse.- Blender mesh vertices/UV layers can be edited directly; BMesh is useful for cleanup after deformation.

Frequently asked questions