blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,261 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: material-quality-checker
|
|
3
|
+
description: Validate PBR material sanity, texture budgets, and web/runtime compatibility per material before render or export.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# material-quality-checker
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run a focused pass/warn/fail check on each material in the scene against PBR sanity, texture budgets, and consumer-stack compatibility — without expanding into lighting or composition concerns.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- enumerate every material referenced in the scene plan or measured scene
|
|
13
|
+
- check PBR sanity (albedo range, normal map sign, roughness/metallic plausibility)
|
|
14
|
+
- check texture budget (resolution, count, format)
|
|
15
|
+
- check consumer-stack compatibility (KHR extensions, unsupported features for chosen target)
|
|
16
|
+
- emit per-material verdicts + a top-line status
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
- before render
|
|
20
|
+
- before GLB export
|
|
21
|
+
- after a material change request
|
|
22
|
+
- as a sub-check during full quality review
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- upstream lookdev and material planning → use `../lighting-material-plan/SKILL.md` (use lighting-material-plan)
|
|
27
|
+
- lighting validation → use `../lighting-quality-checker/SKILL.md` (use lighting-quality-checker)
|
|
28
|
+
- composition / camera validation → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
|
|
29
|
+
- broad pass/warn/fail scene readiness → use `../scene-readiness/SKILL.md` (use scene-readiness)
|
|
30
|
+
- web integration and viewer handoff → use `../glb-web-handoff/SKILL.md` (use glb-web-handoff)
|
|
31
|
+
- to fix or edit materials (this skill validates and emits remediation hints only; it never edits) → use `../lighting-material-plan/SKILL.md` (this skill validates and emits remediation hints only; it never edits)
|
|
32
|
+
<!-- blendops:generated:end exclusions -->
|
|
33
|
+
|
|
34
|
+
## Trigger phrases
|
|
35
|
+
<!-- blendops:generated:start triggers -->
|
|
36
|
+
- "are the materials okay"
|
|
37
|
+
- "check PBR sanity"
|
|
38
|
+
- "texture budget for materials"
|
|
39
|
+
- "will the materials work in Three.js"
|
|
40
|
+
<!-- blendops:generated:end triggers -->
|
|
41
|
+
|
|
42
|
+
## Prerequisites / readiness
|
|
43
|
+
- material list known (from scene plan or measured scene)
|
|
44
|
+
- consumer stack target known (Cycles render / Eevee preview / GLB → web)
|
|
45
|
+
- texture budget pinned (typically from `mobile-glb-budget`)
|
|
46
|
+
|
|
47
|
+
## Input schema
|
|
48
|
+
|
|
49
|
+
### Required inputs
|
|
50
|
+
|
|
51
|
+
| Input | Why it is required |
|
|
52
|
+
|---|---|
|
|
53
|
+
| Material list | Determines scope of the check |
|
|
54
|
+
| Consumer target | Cycles vs Eevee vs glTF imposes different rules |
|
|
55
|
+
| Texture budget | Drives texture-resolution and count checks |
|
|
56
|
+
|
|
57
|
+
### Optional inputs
|
|
58
|
+
|
|
59
|
+
| Input | Use |
|
|
60
|
+
|---|---|
|
|
61
|
+
| Existing render reference | Allows visual cross-check |
|
|
62
|
+
| Variant list | Configurator materials need separate variant rows |
|
|
63
|
+
|
|
64
|
+
### Assumptions to confirm
|
|
65
|
+
- Albedo / base-color textures are sRGB; data textures (normal, roughness, metallic, AO) are linear.
|
|
66
|
+
- Normal maps follow OpenGL convention (`+Y` up) for glTF-bound exports.
|
|
67
|
+
- Shader graph is glTF-export-compatible if export is in scope.
|
|
68
|
+
- Principled BSDF sockets are resolved by name (not position); version-dependent socket assumptions are marked in Notes.
|
|
69
|
+
|
|
70
|
+
## Output schema
|
|
71
|
+
|
|
72
|
+
### Primary output
|
|
73
|
+
A per-material verdict table: name, type (PBR / non-PBR / variant), albedo state, normal state, roughness/metallic state, texture count + resolution sum, consumer-stack compatibility, verdict (Pass / Warn / Fail), notes.
|
|
74
|
+
|
|
75
|
+
### Secondary output
|
|
76
|
+
- top-line status (Pass / Warn / Fail) computed from rows (separate from runtime/artifact truth states)
|
|
77
|
+
- worst-offender highlighting (one or two materials to fix first)
|
|
78
|
+
- remediation hint per Fail row (advisory only, without performing the fix)
|
|
79
|
+
|
|
80
|
+
### Evidence / caveat output
|
|
81
|
+
- Artifact status defaults to `Not Produced` unless concrete output evidence exists.
|
|
82
|
+
- Truth states are downgrade-only (never upgrade without recorded evidence) and remain strictly separate from per-material `Pass / Warn / Fail` validation verdicts.
|
|
83
|
+
|
|
84
|
+
```txt
|
|
85
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
86
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
87
|
+
Evidence used: <links, paths, logs, or "none">
|
|
88
|
+
Limitations: <known gaps>
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Required laws
|
|
92
|
+
- `../../laws/evidence-before-done.md`
|
|
93
|
+
- `../../laws/non-blender-user-language.md`
|
|
94
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
95
|
+
- `../../laws/official-runtime-only.md`
|
|
96
|
+
|
|
97
|
+
## Official runtime boundary
|
|
98
|
+
|
|
99
|
+
This skill validates plans or measured scene snapshots. It never modifies materials, runs Blender, or exports a GLB. If actual material values are needed, rely on a measured scene description (plan output, runtime tool snapshot) — never invent values.
|
|
100
|
+
|
|
101
|
+
For runtime path attribution, see `../../docs/runtime-stack-strategy.md`.
|
|
102
|
+
|
|
103
|
+
## Operating procedure
|
|
104
|
+
1. Read the material list from scene plan or measured scene.
|
|
105
|
+
2. For each material, evaluate PBR sanity rules (see `references/pbr-sanity-rules.md`).
|
|
106
|
+
3. Evaluate texture budget per material against pinned budget.
|
|
107
|
+
4. Evaluate consumer-stack compatibility (see `references/consumer-stack-rules.md`).
|
|
108
|
+
5. Assign per-material verdict; collect notes.
|
|
109
|
+
6. Compute top-line status (any Fail → Fail; any Warn → Warn; otherwise Pass).
|
|
110
|
+
7. Highlight worst offenders; emit remediation hints.
|
|
111
|
+
8. Hand off to `scene-readiness` (broader review) or `render-export-evidence` (next runtime step).
|
|
112
|
+
|
|
113
|
+
## Decision tree
|
|
114
|
+
|
|
115
|
+
```txt
|
|
116
|
+
Albedo pure white (1,1,1)?
|
|
117
|
+
→ Warn (real-world materials rarely are)
|
|
118
|
+
Albedo pure black (0,0,0)?
|
|
119
|
+
→ Warn (likely error; even charcoal is ~0.04)
|
|
120
|
+
Roughness = 0?
|
|
121
|
+
→ Warn (perfect mirror very rare)
|
|
122
|
+
Metallic between 0 and 1 (not 0 or 1)?
|
|
123
|
+
→ Warn (PBR metallic is binary in physical sense)
|
|
124
|
+
Normal map sign or convention unknown?
|
|
125
|
+
→ Warn until verified
|
|
126
|
+
Texture above per-tier cap?
|
|
127
|
+
→ Fail
|
|
128
|
+
Material count above pinned cap?
|
|
129
|
+
→ Fail (whole-scene)
|
|
130
|
+
Unsupported shader node for chosen export?
|
|
131
|
+
→ Fail (e.g. OSL nodes for glTF)
|
|
132
|
+
Unsupported shader feature for glTF export (OSL custom shaders, unbaked procedural noise/wave/voronoi, or drivers on material values)?
|
|
133
|
+
→ Fail
|
|
134
|
+
Uses KHR glTF extensions (unlit, transmission, volume, ior, specular, clearcoat, emissive_strength, anisotropy, iridescence, variants) without consumer-stack confirmation?
|
|
135
|
+
→ Warn (escalate to Fail if target consumer explicitly lacks support)
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Playbooks
|
|
139
|
+
|
|
140
|
+
### Playbook A: Single hero product, glTF export
|
|
141
|
+
Hard rules: 4-channel ORM (Occlusion / Roughness / Metallic) packed; sRGB albedo; OpenGL normal; ≤ 4 materials; KHR extensions only if consumer stack confirmed.
|
|
142
|
+
|
|
143
|
+
### Playbook B: Configurator with variants
|
|
144
|
+
Each variant row separately checked; share material slots where possible; verify `KHR_materials_variants` consumer support.
|
|
145
|
+
|
|
146
|
+
### Playbook C: Cycles-only render (no GLB)
|
|
147
|
+
Looser texture format rules (EXR / Float allowed); still check albedo / normal / roughness sanity; ignore glTF-only constraints.
|
|
148
|
+
|
|
149
|
+
## Mode handling
|
|
150
|
+
|
|
151
|
+
### Text-only mode
|
|
152
|
+
Verdicts based on plan / spec only; mark `Artifact status: Not Produced`.
|
|
153
|
+
|
|
154
|
+
### Runtime-ready mode
|
|
155
|
+
Verdicts based on measured scene snapshot; cite tool used. Never upgrade to `Verified` without recorded measurement.
|
|
156
|
+
|
|
157
|
+
### Blocked runtime mode
|
|
158
|
+
Skip rows that depend on measurement; mark explicitly.
|
|
159
|
+
|
|
160
|
+
## Validation checklist
|
|
161
|
+
- [ ] Every material listed
|
|
162
|
+
- [ ] PBR sanity columns filled (sRGB albedo, linear data textures, OpenGL `+Y` normal for glTF)
|
|
163
|
+
- [ ] Principled BSDF sockets verified by name (version-dependent sockets marked)
|
|
164
|
+
- [ ] Texture budget compared to pinned cap
|
|
165
|
+
- [ ] Consumer-stack compatibility and KHR extensions checked
|
|
166
|
+
- [ ] Per-material verdict assigned (`Pass / Warn / Fail`, kept separate from truth states)
|
|
167
|
+
- [ ] Top-line status derived from rows
|
|
168
|
+
- [ ] Worst offenders highlighted
|
|
169
|
+
- [ ] Remediation hints advisory only (no material edits performed)
|
|
170
|
+
- [ ] Honest downgrade-only evidence label (`Artifact status: Not Produced` default without concrete output evidence)
|
|
171
|
+
|
|
172
|
+
## Pass / Warn / Fail rubric
|
|
173
|
+
|
|
174
|
+
| Verdict | Criteria |
|
|
175
|
+
|---|---|
|
|
176
|
+
| Pass | All materials pass sanity + budget + consumer compatibility; no Warns escalating to Fail. |
|
|
177
|
+
| Warn | One or more materials have plausibility flags (white albedo, edge metallic) but no hard violations. |
|
|
178
|
+
| Fail | Any material exceeds texture budget, uses unsupported features for chosen export, or violates per-tier caps. |
|
|
179
|
+
|
|
180
|
+
## Failure handling
|
|
181
|
+
- Missing texture file → Fail with path note.
|
|
182
|
+
- Invented values without measurement → refuse; produce empty rows + ask for plan or measurement.
|
|
183
|
+
- User pushes for "Pass" without checks → restate requirement, do not relabel.
|
|
184
|
+
|
|
185
|
+
## Troubleshooting
|
|
186
|
+
|
|
187
|
+
| Problem | Response |
|
|
188
|
+
|---|---|
|
|
189
|
+
| Material visible in viewport but missing from list | Confirm linked vs appended status; re-check measured scene snapshot. |
|
|
190
|
+
| Roughness, metallic, normal, or AO texture looks wrong | Verify color space is linear (not sRGB); add Warn/Fail with remediation hint. |
|
|
191
|
+
| Normal map looks inverted in glTF viewer | Verify OpenGL (`+Y` up) convention; add Warn until convention confirmed. |
|
|
192
|
+
| GLB export fails or drops material features | Check for OSL custom shaders, unbaked procedural nodes (`noise`, `wave`, `voronoi`), or drivers on material values; add Fail with node/driver names. |
|
|
193
|
+
| KHR extension appearance missing in target viewer | Confirm consumer support for `unlit`, `transmission`, `volume`, `ior`, `specular`, `clearcoat`, `emissive_strength`, `anisotropy`, `iridescence`, or `variants`. |
|
|
194
|
+
| Value lands on the wrong shader input | Socket was resolved by index across Blender versions; re-resolve Principled BSDF inputs by name. |
|
|
195
|
+
|
|
196
|
+
## Best practices
|
|
197
|
+
- Pair every Fail with the rule that triggered it.
|
|
198
|
+
- Mark Warn rows that escalate to Fail when consumer is mobile (e.g. 4K texture warns on desktop, fails on mobile).
|
|
199
|
+
- Cite consumer stack in every verdict.
|
|
200
|
+
- Resolve Principled BSDF inputs by name across Blender versions; never by position.
|
|
201
|
+
- Keep this skill narrow — do not creep into lighting or composition.
|
|
202
|
+
|
|
203
|
+
## Good examples
|
|
204
|
+
- "Albedo (0.04, 0.04, 0.04), Roughness 0.4 (linear), Metallic 0, ORM packed 1024², GLB-compatible. Verdict: Pass."
|
|
205
|
+
|
|
206
|
+
## Bad examples
|
|
207
|
+
- "Materials look fine." — no per-material rows, no verdicts.
|
|
208
|
+
- "Verified PBR" — without a sanity rule cited.
|
|
209
|
+
|
|
210
|
+
## User-facing response template
|
|
211
|
+
|
|
212
|
+
```txt
|
|
213
|
+
Consumer target: <Cycles / Eevee / glTF mobile / glTF desktop>
|
|
214
|
+
Texture budget cap: <N MP total>
|
|
215
|
+
|
|
216
|
+
| Material | Type | Albedo | Normal | Rough/Met | Tex count + res | Consumer | Verdict | Notes |
|
|
217
|
+
|---|---|---|---|---|---|---|---|---|
|
|
218
|
+
| <name> | PBR | <state> | <state> | <state> | <N x Wpx> | <ok/warn/fail> | Pass/Warn/Fail | <note> |
|
|
219
|
+
|
|
220
|
+
Top-line: <Pass / Warn / Fail>
|
|
221
|
+
Worst offenders: <list 1-2>
|
|
222
|
+
Remediation hints: <advisory hints per Fail/Warn row, no edits performed>
|
|
223
|
+
Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
|
|
224
|
+
Artifact status: <Not Produced | Produced | Verified | Failed>
|
|
225
|
+
Evidence used: <links, paths, logs, or "none">
|
|
226
|
+
Limitations: <gaps>
|
|
227
|
+
Next: <scene-readiness | render-export-evidence | glb-web-handoff | lighting-material-plan>
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
## Anti-patterns
|
|
231
|
+
- Performing material edits inside this skill.
|
|
232
|
+
- Inventing values to make rows pass.
|
|
233
|
+
- Resolving shader sockets by index instead of by name.
|
|
234
|
+
- Assuming a Principled socket exists on every Blender version.
|
|
235
|
+
- Marking Verified without measurement.
|
|
236
|
+
- Mixing lighting / composition checks here.
|
|
237
|
+
|
|
238
|
+
## Cross-skill handoff
|
|
239
|
+
<!-- blendops:generated:start handoffs -->
|
|
240
|
+
- [retry] Upstream lookdev & material planning → `../lighting-material-plan/SKILL.md`
|
|
241
|
+
- [upstream_reference] Mobile/web texture budget definition → `../mobile-glb-budget/SKILL.md`
|
|
242
|
+
- [progression] Broad readiness review → `../scene-readiness/SKILL.md`
|
|
243
|
+
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
244
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
245
|
+
- [progression] Polycount budget → `../polycount-budget-checker/SKILL.md`
|
|
246
|
+
- [progression] Render / GLB export evidence → `../render-export-evidence/SKILL.md`
|
|
247
|
+
- [progression] Web handoff → `../glb-web-handoff/SKILL.md`
|
|
248
|
+
<!-- blendops:generated:end handoffs -->
|
|
249
|
+
|
|
250
|
+
## Non-goals
|
|
251
|
+
- Edit materials.
|
|
252
|
+
- Generate shader code.
|
|
253
|
+
- Replace `scene-readiness` (this skill is one of its inputs).
|
|
254
|
+
- Run Blender.
|
|
255
|
+
|
|
256
|
+
## References
|
|
257
|
+
- `references/pbr-sanity-rules.md`
|
|
258
|
+
- `references/texture-budget-rules.md`
|
|
259
|
+
- `references/consumer-stack-rules.md`
|
|
260
|
+
- `../../laws/evidence-before-done.md`
|
|
261
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "material-quality-checker",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "quality-validators",
|
|
6
|
+
"role": "pbr-and-shader-portability-validator",
|
|
7
|
+
"purpose": "Validate PBR material sanity, texture budgets, and web/runtime compatibility per material before render or export.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"are the materials okay",
|
|
11
|
+
"check PBR sanity",
|
|
12
|
+
"texture budget for materials",
|
|
13
|
+
"will the materials work in Three.js"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "upstream lookdev and material planning",
|
|
18
|
+
"delegateTo": "lighting-material-plan",
|
|
19
|
+
"reason": "use lighting-material-plan"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "lighting validation",
|
|
23
|
+
"delegateTo": "lighting-quality-checker",
|
|
24
|
+
"reason": "use lighting-quality-checker"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "composition / camera validation",
|
|
28
|
+
"delegateTo": "composition-quality-checker",
|
|
29
|
+
"reason": "use composition-quality-checker"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "broad pass/warn/fail scene readiness",
|
|
33
|
+
"delegateTo": "scene-readiness",
|
|
34
|
+
"reason": "use scene-readiness"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "web integration and viewer handoff",
|
|
38
|
+
"delegateTo": "glb-web-handoff",
|
|
39
|
+
"reason": "use glb-web-handoff"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "to fix or edit materials (this skill validates and emits remediation hints only; it never edits)",
|
|
43
|
+
"delegateTo": "lighting-material-plan",
|
|
44
|
+
"reason": "this skill validates and emits remediation hints only; it never edits"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "material_and_shader_inventory",
|
|
51
|
+
"type": "array",
|
|
52
|
+
"description": "Principled BSDF parameter ranges, texture maps, UV channels, and normal map conventions"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "target_consumption_surface",
|
|
56
|
+
"type": "string",
|
|
57
|
+
"description": "Whether materials target offline Cycles/Eevee rendering or glTF 2.0 PBR web export"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "texture_memory_budget",
|
|
63
|
+
"type": "object",
|
|
64
|
+
"description": "Maximum texture resolution and VRAM budget from mobile-glb-budget"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"pbr_material_verdict_table",
|
|
71
|
+
"gltf_shader_portability_risks",
|
|
72
|
+
"material_remediation_steps"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "lighting-material-plan",
|
|
83
|
+
"type": "retry",
|
|
84
|
+
"label": "Upstream lookdev & material planning",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "quality.domain",
|
|
89
|
+
"operator": "equals",
|
|
90
|
+
"value": "material"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"field": "quality.verdict",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": "Fail"
|
|
96
|
+
}
|
|
97
|
+
]
|
|
98
|
+
},
|
|
99
|
+
"retryPolicy": {
|
|
100
|
+
"maxAttempts": 2,
|
|
101
|
+
"exitCondition": {
|
|
102
|
+
"all": [
|
|
103
|
+
{
|
|
104
|
+
"field": "quality.verdict",
|
|
105
|
+
"operator": "in",
|
|
106
|
+
"value": [
|
|
107
|
+
"Pass",
|
|
108
|
+
"Warn"
|
|
109
|
+
]
|
|
110
|
+
}
|
|
111
|
+
]
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"target": "mobile-glb-budget",
|
|
117
|
+
"type": "upstream_reference",
|
|
118
|
+
"label": "Mobile/web texture budget definition",
|
|
119
|
+
"when": {
|
|
120
|
+
"all": [
|
|
121
|
+
{
|
|
122
|
+
"field": "artifact.type",
|
|
123
|
+
"operator": "equals",
|
|
124
|
+
"value": "glb"
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
"field": "budget.pinned",
|
|
128
|
+
"operator": "equals",
|
|
129
|
+
"value": false
|
|
130
|
+
}
|
|
131
|
+
]
|
|
132
|
+
}
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"target": "scene-readiness",
|
|
136
|
+
"type": "progression",
|
|
137
|
+
"label": "Broad readiness review",
|
|
138
|
+
"when": {
|
|
139
|
+
"all": [
|
|
140
|
+
{
|
|
141
|
+
"field": "quality.domain",
|
|
142
|
+
"operator": "equals",
|
|
143
|
+
"value": "holistic"
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"field": "stage.current",
|
|
147
|
+
"operator": "equals",
|
|
148
|
+
"value": "quality_validation"
|
|
149
|
+
}
|
|
150
|
+
]
|
|
151
|
+
}
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"target": "lighting-quality-checker",
|
|
155
|
+
"type": "progression",
|
|
156
|
+
"label": "Lighting validation",
|
|
157
|
+
"when": {
|
|
158
|
+
"all": [
|
|
159
|
+
{
|
|
160
|
+
"field": "quality.domain",
|
|
161
|
+
"operator": "equals",
|
|
162
|
+
"value": "lighting"
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
"field": "quality.verdict",
|
|
166
|
+
"operator": "equals",
|
|
167
|
+
"value": "not_run"
|
|
168
|
+
}
|
|
169
|
+
]
|
|
170
|
+
}
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"target": "composition-quality-checker",
|
|
174
|
+
"type": "progression",
|
|
175
|
+
"label": "Composition validation",
|
|
176
|
+
"when": {
|
|
177
|
+
"all": [
|
|
178
|
+
{
|
|
179
|
+
"field": "quality.domain",
|
|
180
|
+
"operator": "equals",
|
|
181
|
+
"value": "composition"
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"field": "quality.verdict",
|
|
185
|
+
"operator": "equals",
|
|
186
|
+
"value": "not_run"
|
|
187
|
+
}
|
|
188
|
+
]
|
|
189
|
+
}
|
|
190
|
+
},
|
|
191
|
+
{
|
|
192
|
+
"target": "polycount-budget-checker",
|
|
193
|
+
"type": "progression",
|
|
194
|
+
"label": "Polycount budget",
|
|
195
|
+
"when": {
|
|
196
|
+
"all": [
|
|
197
|
+
{
|
|
198
|
+
"field": "quality.domain",
|
|
199
|
+
"operator": "equals",
|
|
200
|
+
"value": "polycount"
|
|
201
|
+
},
|
|
202
|
+
{
|
|
203
|
+
"field": "budget.verdict",
|
|
204
|
+
"operator": "equals",
|
|
205
|
+
"value": "Not Run"
|
|
206
|
+
}
|
|
207
|
+
]
|
|
208
|
+
}
|
|
209
|
+
},
|
|
210
|
+
{
|
|
211
|
+
"target": "render-export-evidence",
|
|
212
|
+
"type": "progression",
|
|
213
|
+
"label": "Render / GLB export evidence",
|
|
214
|
+
"when": {
|
|
215
|
+
"all": [
|
|
216
|
+
{
|
|
217
|
+
"field": "stage.current",
|
|
218
|
+
"operator": "equals",
|
|
219
|
+
"value": "post_execution_audit"
|
|
220
|
+
}
|
|
221
|
+
]
|
|
222
|
+
}
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"target": "glb-web-handoff",
|
|
226
|
+
"type": "progression",
|
|
227
|
+
"label": "Web handoff",
|
|
228
|
+
"when": {
|
|
229
|
+
"all": [
|
|
230
|
+
{
|
|
231
|
+
"field": "artifact.type",
|
|
232
|
+
"operator": "equals",
|
|
233
|
+
"value": "glb"
|
|
234
|
+
},
|
|
235
|
+
{
|
|
236
|
+
"field": "handoff.consumerStack",
|
|
237
|
+
"operator": "equals",
|
|
238
|
+
"value": "web_glb"
|
|
239
|
+
}
|
|
240
|
+
]
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
]
|
|
244
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Consumer stack compatibility rules
|
|
2
|
+
|
|
3
|
+
## glTF (web) consumer
|
|
4
|
+
|
|
5
|
+
### Allowed shader nodes (Blender → Principled BSDF subset)
|
|
6
|
+
- Principled BSDF (base color, metallic, roughness, normal, emission, alpha, IOR, clearcoat with KHR_materials_clearcoat)
|
|
7
|
+
- Material Output
|
|
8
|
+
- Image Texture (linked to one of the above)
|
|
9
|
+
- Normal Map (with strength = 1 for safe export)
|
|
10
|
+
|
|
11
|
+
### Version-safe socket access (Principled BSDF)
|
|
12
|
+
- Principled BSDF's input set changes across Blender versions (sockets such as Diffuse Roughness arrived after 4.0, shifting what sits behind each position). Access inputs by **name**, never by index (`inputs[7]`).
|
|
13
|
+
- On Blender 5.x some sockets (e.g. Subsurface IOR, Weight) ship disabled, and a disabled socket can break name-keyed lookups. Resolve by iterating `node.inputs` and matching `.name`; treat a missing or disabled socket as an optional feature, not an error.
|
|
14
|
+
- A recipe that hardcodes an input position or assumes a socket exists may attach values to the wrong slot on another Blender version. Mark any version-dependent assumption in the verdict Notes.
|
|
15
|
+
|
|
16
|
+
### Disallowed (or fragile) nodes for glTF export
|
|
17
|
+
- OSL (Open Shading Language) custom shaders → Fail
|
|
18
|
+
- Procedural noise / wave / voronoi (must be baked first) → Fail unless baked
|
|
19
|
+
- Drivers on material values → Fail (export does not capture driver state)
|
|
20
|
+
- Node groups with non-Principled outputs → Warn / Fail
|
|
21
|
+
|
|
22
|
+
### KHR extensions (need consumer confirmation)
|
|
23
|
+
- `KHR_materials_unlit` (flat / shadeless) — most consumers support
|
|
24
|
+
- `KHR_materials_transmission` — modern Three.js / Babylon support
|
|
25
|
+
- `KHR_materials_volume` — modern only
|
|
26
|
+
- `KHR_materials_ior` — modern only
|
|
27
|
+
- `KHR_materials_specular` — modern only
|
|
28
|
+
- `KHR_materials_clearcoat` — modern only
|
|
29
|
+
- `KHR_materials_emissive_strength` — modern only
|
|
30
|
+
- `KHR_materials_anisotropy` — limited support (verify)
|
|
31
|
+
- `KHR_materials_iridescence` — limited support
|
|
32
|
+
- `KHR_materials_variants` — required for configurator variant swaps
|
|
33
|
+
|
|
34
|
+
If any of the above is used, document the consumer's confirmed support level. Do not assume.
|
|
35
|
+
|
|
36
|
+
## Cycles render-only
|
|
37
|
+
|
|
38
|
+
Almost everything is allowed. Sanity rules still apply (PBR plausibility, color space). Texture format rules relax (EXR, Float OK).
|
|
39
|
+
|
|
40
|
+
## Eevee preview
|
|
41
|
+
|
|
42
|
+
Most Principled features supported (Blender 4.2+ Eevee Next). Some clearcoat / iridescence / volume effects approximated. Use Eevee preview as a rough check, not a final compatibility test for glTF.
|
|
43
|
+
|
|
44
|
+
## Multi-engine parity matrix (beyond Web glTF)
|
|
45
|
+
|
|
46
|
+
When a material plan spans non-web targets, flag target-specific constraints cleanly:
|
|
47
|
+
|
|
48
|
+
| Target stack | Texture packing | Normal convention | Alpha & tone calibration |
|
|
49
|
+
|---|---|---|---|
|
|
50
|
+
| **Web (Three.js / R3F / Babylon)** | ORM (`R=AO, G=Rough, B=Metal`) in `.glb` (WebP / KTX2) | OpenGL `+Y` up | Pair Blender `Khronos PBR Neutral` with `NeutralToneMapping` or match `AgX`; `MASK`/`DITHERED` preferred for foliage |
|
|
51
|
+
| **Unreal Engine 5 (FBX / glTF)** | `ORM` (`R=AO, G=Rough, B=Metal`), linear | DirectX `-Y` up (flip green channel vs OpenGL) | Avoid unbaked shader graphs; verify `Nanite` displacement / masked alpha rules |
|
|
52
|
+
| **Unity URP / HDRP (FBX)** | URP MetallicSmoothness (`RGB=Metal, A=1-Roughness`) | OpenGL `+Y` up | Triangulate FBX (`use_triangles`) so tangent space matches normal bakes |
|
|
53
|
+
| **Godot 4 (.glb)** | glTF ORM (`R=AO, G=Rough, B=Metal`) | OpenGL `+Y` up | Custom properties export as glTF `extras`; prefer standard Principled subset |
|
|
54
|
+
|
|
55
|
+
## Verdict guidance
|
|
56
|
+
|
|
57
|
+
- A material that uses only the Principled subset → likely Pass for glTF.
|
|
58
|
+
- A material with one KHR extension → Warn until consumer support confirmed.
|
|
59
|
+
- A material with OSL or driver → Fail for glTF.
|
|
60
|
+
|
|
61
|
+
## Related skill
|
|
62
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# PBR sanity rules
|
|
2
|
+
|
|
3
|
+
These are quick-fail / warn rules for catching common mistakes in PBR material values. They do not replace careful art direction — they catch obvious errors only.
|
|
4
|
+
|
|
5
|
+
## Albedo (base color) rules
|
|
6
|
+
|
|
7
|
+
| Value | Verdict | Why |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| (1, 1, 1) pure white | Warn | Real-world materials reflect ≤ 0.95 |
|
|
10
|
+
| (0, 0, 0) pure black | Warn | Even charcoal reflects ~0.04 |
|
|
11
|
+
| Above (0.95, 0.95, 0.95) | Warn | Likely too bright; clouds and snow are the closest exceptions |
|
|
12
|
+
| Below (0.04, 0.04, 0.04) | Warn | Likely too dark; reserved for soot |
|
|
13
|
+
| Saturated primary (1, 0, 0) | Warn | Pure RGB primaries are rare; investigate |
|
|
14
|
+
|
|
15
|
+
## Roughness rules
|
|
16
|
+
|
|
17
|
+
| Value | Verdict | Why |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| 0.0 | Warn | Perfect mirror; rare in real surfaces |
|
|
20
|
+
| 1.0 | Warn | Perfectly diffuse; most surfaces have some specular |
|
|
21
|
+
| Texture but constant | Warn | Likely intentional but cheaper as scalar |
|
|
22
|
+
| Texture stored in sRGB | Fail | Roughness is data, must be linear |
|
|
23
|
+
|
|
24
|
+
## Metallic rules
|
|
25
|
+
|
|
26
|
+
| Value | Verdict | Why |
|
|
27
|
+
|---|---|---|
|
|
28
|
+
| 0 (dielectric) | Pass | Default for plastic / wood / fabric |
|
|
29
|
+
| 1 (metal) | Pass | Default for raw metal |
|
|
30
|
+
| Between 0 and 1 (constant) | Warn | PBR metallic is binary in physics; intermediate values are non-physical |
|
|
31
|
+
| Texture with intermediate values | Warn | Acceptable for transitions (rust, chips); review |
|
|
32
|
+
| Texture stored in sRGB | Fail | Metallic is data, must be linear |
|
|
33
|
+
|
|
34
|
+
## Normal map rules
|
|
35
|
+
|
|
36
|
+
| Property | Required for glTF | Notes |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| Color space | Linear (Non-Color) | Never sRGB |
|
|
39
|
+
| Y axis convention | OpenGL `+Y` up | DirectX `-Y` requires inversion before export |
|
|
40
|
+
| Strength | Default 1.0 unless intentional | Strength != 1 may indicate baking issue |
|
|
41
|
+
| Tangent space | Tangent space (not object/world) | Object-space normals do not export to glTF |
|
|
42
|
+
|
|
43
|
+
## Occlusion / Roughness / Metallic packing (ORM)
|
|
44
|
+
|
|
45
|
+
For glTF, prefer ORM channel-packed:
|
|
46
|
+
- R = Occlusion
|
|
47
|
+
- G = Roughness
|
|
48
|
+
- B = Metallic
|
|
49
|
+
|
|
50
|
+
Saves draw calls and file size. Other packings exist but ORM is the glTF convention.
|
|
51
|
+
|
|
52
|
+
## Real-world PBR numeric lookup (Principled BSDF)
|
|
53
|
+
|
|
54
|
+
Use these calibrated starting ranges when reviewing material plans or snapshots (`Roughness` linear; `Base Color` calibrated, never clipped):
|
|
55
|
+
|
|
56
|
+
| Surface | Base Color (linear range) | Metallic | Roughness | IOR | Notes |
|
|
57
|
+
|---|---|---|---|---|---|
|
|
58
|
+
| Charcoal / Soot | `0.03–0.06` | `0.0` | `0.80–0.95` | `1.50` | Never pure `(0,0,0)` |
|
|
59
|
+
| Matte plastic / ABS | `0.05–0.75` | `0.0` | `0.35–0.65` | `1.46–1.55` | Add ±15–25% subtle roughness variation |
|
|
60
|
+
| Glossy lacquered plastic | `0.05–0.80` | `0.0` | `0.08–0.22` | `1.49` | Optional subtle Clearcoat (`Coat Weight`) |
|
|
61
|
+
| Unfinished / natural wood | `0.15–0.45` warm brown | `0.0` | `0.50–0.80` | `1.50` | Lacquered wood drops roughness to `0.15–0.30` |
|
|
62
|
+
| Brushed steel / iron | `(0.54, 0.56, 0.58)` | `1.0` | `0.25–0.45` | — | Use `Anisotropic` for directional brush lines |
|
|
63
|
+
| Chrome / mirror metal | `(0.55, 0.56, 0.56)` | `1.0` | `0.02–0.10` | — | Pure mirror `0.0` still flags Warn; use `0.02+` |
|
|
64
|
+
| Brushed aluminum | `(0.91, 0.92, 0.93)` | `1.0` | `0.20–0.40` | `1.39` | Metal tint sits cleanly below `0.95` |
|
|
65
|
+
| Gold | `(1.00, 0.77, 0.34)` | `1.0` | `0.10–0.35` | — | Saturated metallic tint, never diffuse yellow |
|
|
66
|
+
| Copper | `(0.95, 0.64, 0.54)` | `1.0` | `0.12–0.38` | — | Oxidized patina shifts to non-metallic green |
|
|
67
|
+
| Glass / crystal | `(0.95, 0.98, 1.00)` | `0.0` | `0.01–0.08` | `1.50–1.52` | Requires `Transmission Weight` + thickness check |
|
|
68
|
+
| Water (clear) | `(0.95, 0.98, 1.00)` | `0.0` | `0.01–0.05` | `1.333` | Refractive web viewers require `KHR_materials_transmission` |
|
|
69
|
+
| Fabric / cloth | `0.08–0.75` | `0.0` | `0.75–0.95` | `1.50` | Pair with `Sheen Weight` for velvet/cotton |
|
|
70
|
+
|
|
71
|
+
## Surface realism layering & shader hygiene (Blender 4.x / 5.x)
|
|
72
|
+
|
|
73
|
+
- **Flat roughness smells synthetic**: Flag uniform scalar roughness on hero props if variation (`±15–25%` micro breakup) is missing.
|
|
74
|
+
- **Physical wear stack**: Realistic weathered materials layer from inside out: **clean base → convex edge wear (metal/primer) → rust in cavities → crevice grime `(1 − AO)` → top-facing dust (`+Z` normal)**. For glTF/game targets, complex procedural masks must be baked to texture maps before export.
|
|
75
|
+
- **5.x API safety**: Treat `material.use_nodes` as legacy/deprecated in Blender 5.x (materials carry node trees natively), resolve `Principled BSDF` inputs by name (`Specular IOR Level`, `Coat Weight`, `Transmission Weight`), and verify transparency mode (`DITHERED` cutout vs `BLENDED` glass) matches consumer capability.
|
|
76
|
+
|
|
77
|
+
## Related skill
|
|
78
|
+
`../SKILL.md`
|