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.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/roble3/cc-blender-skill --skill closed-surface-uv-coverage

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
roble3
社区

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

1小时安装量
3
GitHub Stars
178
最近更新
10月12日
roble3
社区

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

1小时安装量
3
GitHub Stars
178
最近更新
10月12日
roble3
社区

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 /

1小时安装量
4
GitHub Stars
178
最近更新
10月12日
roble3
社区

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

1小时安装量
4
GitHub Stars
178
最近更新
10月12日