roble3/cc-blender-skill

closed-surface-uv-coverage

Ensure textures and decals cover all visible surfaces of a closed or extruded Blender asset, especially front/back caps and sidewalls, instead of relying on partial projected planes, curves, or linework overlays.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/roble3/cc-blender-skill --skill closed-surface-uv-coverage

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

MCP backend

Use when: Full surface texture coverage, sidewall UVs, back cap UVs, closed mesh UV coverage audits, texture fill validation, side/back turntable QA, replacing projected overlays with real surface materials.

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.

Closed Surface UV Coverage

This skill prevents a common false pass: a model looks textured from the front because it has a projected front image or curve overlays, but the closed surface has untextured back caps or plain sidewalls when viewed in a spin/turntable.

Failure modes to catch

  • Back detail is only a floating plane or curve overlay, not a material/UV on the back surface.
  • Sidewalls have procedural color only; no side UV island, generated/object coordinate material, or baked strip.
  • A back projection covers only a center shape and leaves the actual silhouette/back mesh plain.
  • Side/back QA uses front-biased frames and misses edge-on/back-on samples.
  • Decorative HUD/aura is mistaken for surface texture coverage.

Required surface taxonomy

For extruded/logo-like assets, classify visible surfaces before look-dev:

  1. front_cap — canonical front texture/decal.
  2. back_cap — back texture, back linework, or baked/procedural fill mapped to the real back cap.
  3. sidewall — depth surface connecting front/back, with its own UV parameterization or procedural material.
  4. overlay_context — HUD/aura/circles; never counted as model surface coverage.

Workflow

  1. Audit current coverage: list mesh material slots, UV layers, image texture nodes, and face counts for front/back/side material indices.
  2. Reject overlay-only fixes: curves/planes may add rim accents, but they do not satisfy back/side fill unless the mesh surface beneath is also textured/materialized.
  3. Create per-surface UVs:
  • front/back caps: project local X/Z to UV 0–1 or map into a back/front atlas rectangle;
  • sidewall: map perimeter arc length to U and depth/front-back coordinate to V;
  • if a clean side texture is unavailable, use a generated procedural side material plus baked glow/edge strip and document it.
  1. Assign true surface materials: back cap and sidewall mesh faces must have material nodes, active UVs, and/or generated coordinates. Optional curves are accents only.
  2. Validate turntable frames: sample front, 45°, side/edge-on, back-on, opposite 45°, and rest. Back and side frames must show surface fill, not just outlines.

Acceptance gates

  • Back cap mesh faces have either an image/procedural material with a declared UV/generated coordinate policy, not only separate curves.
  • Sidewall mesh faces have a sidewall material with UV/generated coordinates and visible depth treatment.
  • Overlay/context collections are excluded from coverage counts.
  • QA contact sheet includes back and edge-on frames.
  • A surface_coverage_report.json states which surfaces are image-textured, procedural, baked, or intentionally plain.

Handoff

Use after geometry is locked and before final material/look/animation acceptance. It complements blender-uv-texturing and atlas-uv-fitting: those skills explain UV/material setup; this skill enforces complete visible-surface coverage.

Script

  • scripts/surface_texture_coverage_audit.py audits selected mesh objects for UV layers, material image nodes, face material counts, and overlay-only warning patterns.

Related by task

from this repository

More skills

All skills
roble3
Community

blender-animation

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 t

1h installs
3
GitHub stars
178
Updated
Oct 12
roble3
Community

blender-export

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

1h installs
3
GitHub stars
178
Updated
Oct 12
roble3
Community

blender-materials

Create and assign PBR materials in Blender via Principled BSDF — metals, glass, plastic, fabric, skin, organics. Covers physically-based material recipes with real-world values, Coat layer (varnish/car paint), Sheen (cloth), Subsurface scattering (skin/wax), Transmission (glass), and procedural patterns (wood grain, marble, fabric weave). Use whenever the user asks to "make it look like X material", "give it a metallic finish", "apply a wood texture", "make this glass / plastic / brushed steel /

1h installs
4
GitHub stars
178
Updated
Oct 12
roble3
Community

blender-modeling

Create and edit 3D meshes in Blender — primitives, hard-surface modeling, mesh operators, modifier stacks (Bevel, Subdivision, Boolean, Mirror, Array, Solidify), bmesh-level edits, retopology basics. Use whenever the user asks to "make/model/create/build a 3D object", "shape/sculpt this", "add a cube/sphere/cylinder/etc.", "extrude/inset/bevel this face", "add a modifier", or any geometry-creation request that isn't a wireframe trace. Make sure to use this skill even if the user does not say "mo

1h installs
4
GitHub stars
178
Updated
Oct 12