substance-3d-texturing

• Grupo: 3D / WebGL
• Cuándo se activa: Texturizado PBR con Substance 3D para web
• Se instala: Opcional: llega con un paquete de skills.

Skill de terceros

Original de claudedesignskills (Claude Skills Project, licencia MIT), copiado tal cual. Senzu añade encima esta capa en castellano; el original no se modifica.

Documentación completa upstream (inglés): SKILL.upstream.md (506 líneas). No la leas entera: usa el mapa y lee solo la sección que necesites (Read con offset/limit o Grep).

Cuándo usar / cuándo NO

• Usar: exportar texturas PBR (baseColor, normal, metallicRoughness, AO) desde Substance Painter para Three.js, Babylon.js o glTF.
• Usar: automatizar exportaciones con la API Python de Painter (batch, resolución por asset, presets personalizados, plugin al guardar).
• Usar: reducir peso de texturas para web/móvil (canales ORM, JPEG para baseColor, presupuesto de memoria).
• NO usar: modelado, LOD o exportación de mallas → blender-web-pipeline; materiales y carga en el motor → threejs-webgl / react-three-fiber / babylonjs-engine.

Lectura mínima por tarea

Tarea	Lee solo
Empezar un proyecto/starter	SKILL.upstream.md L58-93 (§1. Basic Web Export) + assets/export_templates/
Exportación por lotes con Python	L95-166 (§2-3) + scripts/batch_export.py + references/python_api_reference.md
Preset personalizado / canales ORM	L168-216 (§4) + L396-416 (§Channel Packing) + scripts/generate_export_preset.py
Usar texturas en R3F, Babylon o glTF	L314-376 (§Integration Patterns)
Depurar / rendimiento	L377-428 (§Performance Optimization) + L429-488 (§Common Pitfalls) + scripts/web_optimizer.py

Mapa de SKILL.upstream.md

Líneas	Sección	Para qué
8-17	Overview	Alcance: autoría PBR, export web, automatización Python
18-55	Core Concepts	Canales PBR metallic/roughness, presets integrados, resoluciones recomendadas
58-94	1. Basic Web Export (Three.js/Babylon.js)	Export manual y MeshStandardMaterial con los mapas
95-142	2. Batch Export with Python API	export_project_textures con config JSON para todos los texture sets
143-167	3. Resolution Override per Asset	sizeLog2 distinto por texture set mediante filter
168-217	4. Custom Export Preset (Separate Channels)	Definir exportPresets con mapas y canales propios
218-244	5. Mobile-Optimized Export	JPEG en baseColor, PNG en mapas de datos, 512 px
245-279	6. glTF/GLB Integration	Config para glTF 2.0 y referencia en el JSON del material
280-313	7. Event-Driven Export Plugin	Auto-export al guardar con event.DISPATCHER
314-376	Integration Patterns	useTexture en R3F, PBRMaterial en Babylon, pipeline glTF + Draco
377-428	Performance Optimization	Presupuesto de memoria, compresión, empaquetado ORM, mipmaps
429-488	Common Pitfalls	Espacio de color, normales Y+/Y-, orden de canales, padding, AO con uv2
489-506	Resources / Related Skills	Índice de recursos y skills relacionadas

Recursos

• references/python_api_reference.md — API Python completa de Substance Painter (export, textureset, resource, event).
• references/export_presets.md — catálogo de presets integrados y personalizados.
• references/pbr_channel_guide.md — significado y rangos de cada canal PBR.
• scripts/batch_export.py — exporta todos los texture sets con preset PBR Metallic Roughness; se ejecuta DENTRO de Painter (File → Python → Execute Script o como plugin).
• scripts/generate_export_preset.py — genera JSON de preset personalizado: py -3 scripts/generate_export_preset.py (interactivo o con flags; python3 en Linux/macOS).
• scripts/web_optimizer.py — redimensiona y convierte texturas exportadas (baseColor a JPEG, informe de ahorro): py -3 scripts/web_optimizer.py --help.
• assets/export_templates/ — presets JSON listos: gltf_standard, threejs_optimized, babylonjs_pbr, web_orm_packed, mobile_webgl.

Reglas duras

• Por defecto 1024×1024 para web; 2048 solo en assets hero; nunca 4K en web. Presupuesto: ~100-150 MB desktop, ~30-50 MB móvil.
• Siempre paddingAlgorithm: "infinite" para evitar líneas en las costuras UV.
• baseColor en sRGB (texture.colorSpace = THREE.SRGBColorSpace); mapas de datos (normal, metallic, roughness) en PNG sin pérdida y en espacio lineal.
• Orden de canales glTF: G = roughness, B = metallic (R libre o AO en ORM). Normales en formato OpenGL (Y+), igual que glTF.
• AO en Three.js requiere uv2; en Babylon activa useAmbientOcclusionFromMetallicTextureRed.

Integración con el stack del proyecto

• Detecta el stack como indica la skill front-activation/skill-router (senzu/senzu.json → package.json). Esta skill es agnóstica del framework (produce archivos de textura); el consumo depende del motor: React → react-three-fiber (useTexture), vanilla/Vue/Astro → threejs-webgl o babylonjs-engine.