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,30 @@
|
|
|
1
|
+
# Mobile-web GLB Budget Tiers
|
|
2
|
+
|
|
3
|
+
These are **planning ceilings**, not benchmarks. Always pair with measurement (`render-export-evidence` + `scene-readiness`) before claiming compliance.
|
|
4
|
+
|
|
5
|
+
## Tier table
|
|
6
|
+
|
|
7
|
+
| Tier | Triangles | GLB file (Draco) | Textures | Draw calls | Bones | Morph targets |
|
|
8
|
+
|---|---|---|---|---|---|---|
|
|
9
|
+
| Low-end Android (Snapdragon 4xx, 2GB RAM) | ≤ 25K | ≤ 2 MB | 2 × 512 px | ≤ 10 | ≤ 25 | 0 |
|
|
10
|
+
| Mid-mobile (mass-market 2024+) | ≤ 50K | ≤ 4 MB | 4 × 1024 px | ≤ 20 | ≤ 50 | ≤ 4 |
|
|
11
|
+
| High-mobile (flagship phones) | ≤ 100K | ≤ 8 MB | 6 × 2048 px | ≤ 50 | ≤ 100 | ≤ 8 |
|
|
12
|
+
| Desktop fallback | ≤ 250K | ≤ 20 MB | 8 × 2048 px | ≤ 100 | ≤ 200 | ≤ 16 |
|
|
13
|
+
|
|
14
|
+
## Context modifiers
|
|
15
|
+
|
|
16
|
+
- **AR viewer**: drop one tier (e.g. mid-mobile → low-end values).
|
|
17
|
+
- **Configurator with material variants**: +50% material count, but cap GLB at the tier's base.
|
|
18
|
+
- **Hero card / e-commerce**: tier values as-is.
|
|
19
|
+
- **Environment / scene with multiple objects**: budget the *whole scene*, not per-object.
|
|
20
|
+
|
|
21
|
+
## Headroom rule
|
|
22
|
+
|
|
23
|
+
Reserve 20% headroom against the hard cap. A "50K triangle" budget plan should aim for 40K and treat 50K as the absolute ceiling.
|
|
24
|
+
|
|
25
|
+
## Why per-tier numbers matter
|
|
26
|
+
|
|
27
|
+
A 50K-triangle GLB on a low-end Android can stutter; the same GLB on a flagship is trivial. Do not give a single global "mobile" number.
|
|
28
|
+
|
|
29
|
+
## Related skill
|
|
30
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Degradation Plan (drop order when over budget)
|
|
2
|
+
|
|
3
|
+
When a measured GLB exceeds budget, drop in this order. Stop as soon as the budget passes.
|
|
4
|
+
|
|
5
|
+
## Order of degradation
|
|
6
|
+
|
|
7
|
+
1. **Texture resolution** — halve the largest texture first (2048 → 1024 → 512). Cheapest visual loss for biggest file-size win.
|
|
8
|
+
2. **Texture count** — combine variant maps (roughness + metallic + AO) into one ORM channel-packed map.
|
|
9
|
+
3. **Mesh decimation** — apply a 50% decimation to the highest-triangle mesh in the scene.
|
|
10
|
+
4. **Sub-mesh hidden geometry** — remove faces never visible from the camera path.
|
|
11
|
+
5. **Morph target count** — drop secondary expressions / minor variants.
|
|
12
|
+
6. **Bone count** — bake unused bones into the mesh; clamp influences per vertex to 4.
|
|
13
|
+
7. **Material variants** — collapse near-duplicate materials into one.
|
|
14
|
+
8. **Animation channels** — bake long animations into shorter clips.
|
|
15
|
+
|
|
16
|
+
## Always-keep rule
|
|
17
|
+
|
|
18
|
+
Do not degrade if the result breaks the user's visual intent stated in the brief. If steps 1–4 cannot meet the budget, escalate to the user with options instead of silently degrading further.
|
|
19
|
+
|
|
20
|
+
## Record the degradation
|
|
21
|
+
|
|
22
|
+
Every degradation step taken must appear in the handoff report:
|
|
23
|
+
- step number
|
|
24
|
+
- before/after metric values
|
|
25
|
+
- visual impact note ("texture detail lost on close-up", "silhouette unchanged after step 3", etc.)
|
|
26
|
+
|
|
27
|
+
## Do not
|
|
28
|
+
|
|
29
|
+
- silently drop required materials
|
|
30
|
+
- silently drop animations the user asked for
|
|
31
|
+
- skip recording degradation steps in the handoff report
|
|
32
|
+
|
|
33
|
+
## Related skill
|
|
34
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Budget Violation Rules
|
|
2
|
+
|
|
3
|
+
When a measured GLB exceeds the pinned budget, treat the violation as a **handoff blocker** unless the user explicitly accepts the degradation.
|
|
4
|
+
|
|
5
|
+
## Block-handoff violations
|
|
6
|
+
|
|
7
|
+
| Metric | Block if … |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Triangle count | > 100% of cap |
|
|
10
|
+
| GLB file size | > 100% of cap |
|
|
11
|
+
| Single texture pixel area | > tier max (e.g. >1024² on mid-mobile) |
|
|
12
|
+
| Total texture pixel budget | > 150% of cap |
|
|
13
|
+
| Draw calls | > 100% of cap |
|
|
14
|
+
| Bones | > 100% of cap (skinning cost is non-linear) |
|
|
15
|
+
| Morph targets | > tier max (>0 on low-end Android) |
|
|
16
|
+
|
|
17
|
+
## Warn-only violations
|
|
18
|
+
|
|
19
|
+
| Metric | Warn if … |
|
|
20
|
+
|---|---|
|
|
21
|
+
| Triangle count | 80–100% of cap |
|
|
22
|
+
| GLB file size | 80–100% of cap |
|
|
23
|
+
| Distinct materials | 80–100% of cap |
|
|
24
|
+
| Animation channels | 80–100% of cap |
|
|
25
|
+
|
|
26
|
+
## Always-fail violations
|
|
27
|
+
|
|
28
|
+
These bypass any "user accepts" override because they break web playback:
|
|
29
|
+
|
|
30
|
+
- GLB references a missing texture file
|
|
31
|
+
- GLB exceeds 16-bit vertex index range without per-primitive split (some loaders fail)
|
|
32
|
+
- Animation references missing bone or morph target
|
|
33
|
+
- Texture format unsupported by `gltf` (e.g. EXR not converted)
|
|
34
|
+
|
|
35
|
+
## Reporting
|
|
36
|
+
|
|
37
|
+
Always report violations with:
|
|
38
|
+
- the offending metric, the measured value, the budgeted cap, the tier
|
|
39
|
+
- whether the violation is Block / Warn / Always-fail
|
|
40
|
+
- the suggested degradation step (see `degradation-plan.md`)
|
|
41
|
+
|
|
42
|
+
## Related skill
|
|
43
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# EVAL — output-format-decision
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply output-format-decision for a web hero output (PNG/WebP, sRGB, 1920×1080, alpha optional).
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- format chosen (PNG or WebP)
|
|
8
|
+
- 8-bit
|
|
9
|
+
- sRGB color space
|
|
10
|
+
- compression rule
|
|
11
|
+
- alpha rule
|
|
12
|
+
- caveats
|
|
13
|
+
- handoff to render-export-evidence
|
|
14
|
+
|
|
15
|
+
## Pass / Warn / Fail criteria
|
|
16
|
+
- Pass: 4-line format record + caveats + handoff
|
|
17
|
+
- Warn: ambiguous compression
|
|
18
|
+
- Fail: wrong format (EXR for web), missing bit depth, "any format" answer
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
- Consumer + color config header
|
|
22
|
+
- Output stream(s) with all 5 fields
|
|
23
|
+
- Caveats
|
|
24
|
+
|
|
25
|
+
## Sample failing response outline
|
|
26
|
+
- "Save as PNG"
|
|
27
|
+
- No bit depth or color space
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: output-format-decision
|
|
3
|
+
description: Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# output-format-decision
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Avoid mismatched output formats (e.g., JPEG for VFX, EXR for web, TIFF for social). Match format to consumer pipeline.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- name the consumer
|
|
13
|
+
- pick one format per output stream
|
|
14
|
+
- pin bit depth + compression + alpha rules
|
|
15
|
+
- emit a 4-line config
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- before render
|
|
19
|
+
- when consumer requires specific format
|
|
20
|
+
- when transparency / HDR / loss tolerance matters
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- raw modeling without rendering → use `../cycles-vs-eevee-decision/SKILL.md` (Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
25
|
+
- 3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff) → use `../glb-animation-handoff/SKILL.md` (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)
|
|
26
|
+
- verifying saved files on disk after rendering → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
|
|
27
|
+
<!-- blendops:generated:end exclusions -->
|
|
28
|
+
|
|
29
|
+
## Trigger phrases
|
|
30
|
+
<!-- blendops:generated:start triggers -->
|
|
31
|
+
- "PNG or JPEG"
|
|
32
|
+
- "do we need EXR"
|
|
33
|
+
- "what format for the web"
|
|
34
|
+
<!-- blendops:generated:end triggers -->
|
|
35
|
+
|
|
36
|
+
## Prerequisites / readiness
|
|
37
|
+
- consumer pipeline known
|
|
38
|
+
- color management decision made (`color-management-decision`)
|
|
39
|
+
|
|
40
|
+
## Input schema
|
|
41
|
+
|
|
42
|
+
### Required inputs
|
|
43
|
+
|
|
44
|
+
| Input | Why it is required |
|
|
45
|
+
|---|---|
|
|
46
|
+
| Consumer | Drives format choice per output stream |
|
|
47
|
+
| Color management config | Consumed from `color-management-decision` to align bit depth and container support |
|
|
48
|
+
| Transparency required? | Drives alpha channel and container choice (e.g., PNG/WebP/OpenEXR vs JPG) |
|
|
49
|
+
|
|
50
|
+
### Optional inputs
|
|
51
|
+
|
|
52
|
+
| Input | Use |
|
|
53
|
+
|---|---|
|
|
54
|
+
| File-size budget | Guides lossless vs lossy compression decision |
|
|
55
|
+
|
|
56
|
+
### Assumptions to confirm
|
|
57
|
+
- The consumer pipeline can read the chosen container/codec (verify if non-default).
|
|
58
|
+
- Lossy compression is acceptable when chosen.
|
|
59
|
+
|
|
60
|
+
## Output schema
|
|
61
|
+
|
|
62
|
+
### Primary output
|
|
63
|
+
A 4-line format record per output stream: format, bit depth, compression, alpha.
|
|
64
|
+
|
|
65
|
+
### Secondary output
|
|
66
|
+
- per-output stream rules
|
|
67
|
+
- caveats per choice
|
|
68
|
+
- evidence label
|
|
69
|
+
|
|
70
|
+
### Evidence / caveat output
|
|
71
|
+
|
|
72
|
+
```txt
|
|
73
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
74
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
75
|
+
Evidence used: <links, paths, logs, or "none">
|
|
76
|
+
Limitations: <known gaps>
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
* Default states for this decision skill: `Runtime status: Not Run`, `Artifact status: Not Produced`.
|
|
80
|
+
* Truth states are downgrade-only, never upgrade. Pinning a format never produces a file.
|
|
81
|
+
|
|
82
|
+
## Required laws
|
|
83
|
+
- `../../laws/evidence-before-done.md`
|
|
84
|
+
- `../../laws/non-blender-user-language.md`
|
|
85
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
86
|
+
- `../../laws/official-runtime-only.md`
|
|
87
|
+
|
|
88
|
+
## Official runtime boundary
|
|
89
|
+
|
|
90
|
+
Decision skill — does not run Blender. Pins format; operator applies to scene render output.
|
|
91
|
+
|
|
92
|
+
## Operating procedure
|
|
93
|
+
1. Identify consumer pipeline + consume color config from `color-management-decision`.
|
|
94
|
+
2. Select format per `references/format-decision-matrix.md`.
|
|
95
|
+
3. Pin bit depth + compression + alpha per output stream.
|
|
96
|
+
4. List stream rules and caveats.
|
|
97
|
+
5. Hand off format record to operator (and to `resolution-aspect-decision` if resolution is unpinned, or `render-export-evidence` once rendered).
|
|
98
|
+
|
|
99
|
+
## Decision tree
|
|
100
|
+
|
|
101
|
+
```txt
|
|
102
|
+
Web hero (consuming sRGB config)?
|
|
103
|
+
→ PNG (lossless) or WebP (lossy/lossless); 8-bit; alpha if needed
|
|
104
|
+
JPEG-only consumer?
|
|
105
|
+
→ JPG; 8-bit; no alpha; lossy quality 85-95
|
|
106
|
+
VFX / film pipeline (consuming Linear config)?
|
|
107
|
+
→ OpenEXR; 16-bit half float; ZIP compression; alpha as channel
|
|
108
|
+
Print?
|
|
109
|
+
→ TIFF; 16-bit; LZW or no compression; alpha optional per print prep
|
|
110
|
+
Social / mobile (WebP-first)?
|
|
111
|
+
→ WebP; 8-bit; alpha optional; lossy quality 85-90
|
|
112
|
+
HDR display delivery?
|
|
113
|
+
→ PNG 16-bit or OpenEXR; verify consumer supports HDR container
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Playbooks
|
|
117
|
+
|
|
118
|
+
### Playbook A: Web hero PNG
|
|
119
|
+
PNG, 8-bit per channel, lossless compression, alpha if needed (consumes color config from `color-management-decision`).
|
|
120
|
+
|
|
121
|
+
### Playbook B: VFX EXR
|
|
122
|
+
OpenEXR, 16-bit half float, ZIP compression, alpha as channel. Multi-pass support (consumes Linear config from `color-management-decision`).
|
|
123
|
+
|
|
124
|
+
### Playbook C: Mobile-first social
|
|
125
|
+
WebP, 8-bit, quality 85-90 compression, alpha optional (consumes color config from `color-management-decision`).
|
|
126
|
+
|
|
127
|
+
### Playbook D: Print
|
|
128
|
+
TIFF, 16-bit, LZW or no compression, alpha optional (consumes color config from `color-management-decision`; resolution owned by `resolution-aspect-decision`).
|
|
129
|
+
|
|
130
|
+
## Mode handling
|
|
131
|
+
|
|
132
|
+
### Text-only mode
|
|
133
|
+
Emit format record + per-stream rules + caveats (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
134
|
+
|
|
135
|
+
### Runtime-ready mode
|
|
136
|
+
Emit format record for the operator to apply in Blender render output settings. Pinning a format never produces or verifies a file; hand off post-render file verification to `render-export-evidence`.
|
|
137
|
+
|
|
138
|
+
### Blocked runtime mode
|
|
139
|
+
Emit format record only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
140
|
+
|
|
141
|
+
## Validation checklist
|
|
142
|
+
- [ ] Consumer + color config identified
|
|
143
|
+
- [ ] Format chosen
|
|
144
|
+
- [ ] Bit depth chosen
|
|
145
|
+
- [ ] Compression chosen
|
|
146
|
+
- [ ] Alpha rule explicit
|
|
147
|
+
- [ ] Caveats listed
|
|
148
|
+
|
|
149
|
+
## Pass / Warn / Fail rubric
|
|
150
|
+
|
|
151
|
+
| Verdict | Criteria |
|
|
152
|
+
|---|---|
|
|
153
|
+
| Pass | Format + bit depth + compression + alpha pinned; matches consumer; caveats listed. |
|
|
154
|
+
| Warn | Format pinned but compression / alpha ambiguous. |
|
|
155
|
+
| Fail | Wrong format for consumer (JPEG for VFX, EXR for web), missing bit depth, "any format" answer. |
|
|
156
|
+
|
|
157
|
+
## Failure handling
|
|
158
|
+
- Consumer unknown → ask once; if still unknown, default to PNG, 8-bit, lossless compression, alpha enabled (paired with upstream `color-management-decision`).
|
|
159
|
+
- Multiple consumers → define one format record per output stream (or pin the most restrictive format if single-stream delivery is required).
|
|
160
|
+
|
|
161
|
+
## Troubleshooting
|
|
162
|
+
|
|
163
|
+
| Problem | Response |
|
|
164
|
+
|---|---|
|
|
165
|
+
| File too large | Reduce bit depth, increase compression, or switch stream to WebP / JPG |
|
|
166
|
+
| HDR data lost | Switch container/bit depth to OpenEXR (16-bit half float) or PNG 16-bit |
|
|
167
|
+
| Alpha disappeared | Verify chosen format supports alpha (PNG / WebP / OpenEXR / TIFF yes; JPG no) |
|
|
168
|
+
| Color shift in delivered file | Hand off to `color-management-decision` to verify color config and consumer display transform |
|
|
169
|
+
|
|
170
|
+
## Best practices
|
|
171
|
+
- Define one format record per consumer output stream; never convert or re-encode files post-render.
|
|
172
|
+
- For web: use WebP or PNG based on consumer support and alpha/compression requirements.
|
|
173
|
+
- For VFX: always pin OpenEXR; never pin JPG or 8-bit PNG for compositing pipelines.
|
|
174
|
+
- Pass the pinned format record to `render-export-evidence` for post-render verification.
|
|
175
|
+
|
|
176
|
+
## Good examples
|
|
177
|
+
- "Web hero stream: PNG, 8-bit, lossless compression, alpha enabled (using upstream color config from `color-management-decision`)."
|
|
178
|
+
|
|
179
|
+
## Bad examples
|
|
180
|
+
- "Save as PNG." — missing bit depth, compression, and alpha rules.
|
|
181
|
+
|
|
182
|
+
## User-facing response template
|
|
183
|
+
|
|
184
|
+
```txt
|
|
185
|
+
Consumer: <web / VFX / print / social / mobile>
|
|
186
|
+
Color config: <reference color-management-decision output>
|
|
187
|
+
|
|
188
|
+
Output(s):
|
|
189
|
+
<stream>: <format>, <bit depth>, <compression>, <alpha>
|
|
190
|
+
|
|
191
|
+
Caveats: <list>
|
|
192
|
+
Limitations: <gaps>
|
|
193
|
+
Next: render-export-evidence
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
## Anti-patterns
|
|
197
|
+
- "Any format will work."
|
|
198
|
+
- JPEG for VFX.
|
|
199
|
+
- 8-bit for HDR delivery.
|
|
200
|
+
- Lossy compression where archival is required.
|
|
201
|
+
|
|
202
|
+
## Cross-skill handoff
|
|
203
|
+
<!-- blendops:generated:start handoffs -->
|
|
204
|
+
- [upstream_reference] Color management → `../color-management-decision/SKILL.md`
|
|
205
|
+
- [upstream_reference] Resolution & aspect ratio → `../resolution-aspect-decision/SKILL.md`
|
|
206
|
+
- [upstream_reference] Engine choice → `../cycles-vs-eevee-decision/SKILL.md`
|
|
207
|
+
- [progression] Render file verification → `../render-export-evidence/SKILL.md`
|
|
208
|
+
- [progression] 3D / GLB exports (out of scope here) (glb-animation-handoff) → `../glb-animation-handoff/SKILL.md`
|
|
209
|
+
- [boundary_delegation] 3D / GLB exports (out of scope here) (mobile-glb-budget) → `../mobile-glb-budget/SKILL.md`
|
|
210
|
+
- [progression] 3D / GLB exports (out of scope here) (glb-web-handoff) → `../glb-web-handoff/SKILL.md`
|
|
211
|
+
<!-- blendops:generated:end handoffs -->
|
|
212
|
+
|
|
213
|
+
## Non-goals
|
|
214
|
+
- Convert formats post-render.
|
|
215
|
+
- Run Blender.
|
|
216
|
+
- Compress / re-encode files.
|
|
217
|
+
|
|
218
|
+
## References
|
|
219
|
+
- `references/format-decision-matrix.md`
|
|
220
|
+
- `references/bit-depth-rules.md`
|
|
221
|
+
- `references/compression-tradeoffs.md`
|
|
222
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "output-format-decision",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "render-and-output-decisions",
|
|
6
|
+
"role": "still-animation-and-3d-format-selector",
|
|
7
|
+
"purpose": "Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"PNG or JPEG",
|
|
11
|
+
"do we need EXR",
|
|
12
|
+
"what format for the web"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "raw modeling without rendering",
|
|
17
|
+
"delegateTo": "cycles-vs-eevee-decision",
|
|
18
|
+
"reason": "Delegates out-of-scope requests to cycles-vs-eevee-decision"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)",
|
|
22
|
+
"delegateTo": "glb-animation-handoff",
|
|
23
|
+
"reason": "out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "verifying saved files on disk after rendering",
|
|
27
|
+
"delegateTo": "render-export-evidence",
|
|
28
|
+
"reason": "use render-export-evidence"
|
|
29
|
+
}
|
|
30
|
+
],
|
|
31
|
+
"inputs": {
|
|
32
|
+
"required": [
|
|
33
|
+
{
|
|
34
|
+
"name": "deliverable_channel_and_use",
|
|
35
|
+
"type": "string",
|
|
36
|
+
"description": "Downstream consumer surface (web hero image, compositing EXR pipeline, turntable video, interactive WebGL)"
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"name": "alpha_and_bit_depth_needs",
|
|
40
|
+
"type": "object",
|
|
41
|
+
"description": "Transparency (straight vs premultiplied alpha) and dynamic range (8-bit, 16-bit, 32-bit float) requirements"
|
|
42
|
+
}
|
|
43
|
+
],
|
|
44
|
+
"optional": [
|
|
45
|
+
{
|
|
46
|
+
"name": "file_size_ceiling",
|
|
47
|
+
"type": "string",
|
|
48
|
+
"description": "Optional delivery file size cap from mobile-glb-budget or web spec"
|
|
49
|
+
}
|
|
50
|
+
]
|
|
51
|
+
},
|
|
52
|
+
"outputs": {
|
|
53
|
+
"primary": [
|
|
54
|
+
"pinned_container_and_codec_spec",
|
|
55
|
+
"bit_depth_and_alpha_mode_record",
|
|
56
|
+
"color_space_and_export_verification_hooks"
|
|
57
|
+
],
|
|
58
|
+
"truthStatePolicy": {
|
|
59
|
+
"runtimeDefault": "Not Run",
|
|
60
|
+
"artifactDefault": "Not Produced",
|
|
61
|
+
"mutationRule": "downgrade_only"
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
"handoffs": [
|
|
65
|
+
{
|
|
66
|
+
"target": "color-management-decision",
|
|
67
|
+
"type": "upstream_reference",
|
|
68
|
+
"label": "Color management",
|
|
69
|
+
"when": {
|
|
70
|
+
"all": [
|
|
71
|
+
{
|
|
72
|
+
"field": "decision.colorLocked",
|
|
73
|
+
"operator": "equals",
|
|
74
|
+
"value": false
|
|
75
|
+
}
|
|
76
|
+
]
|
|
77
|
+
}
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
"target": "resolution-aspect-decision",
|
|
81
|
+
"type": "upstream_reference",
|
|
82
|
+
"label": "Resolution & aspect ratio",
|
|
83
|
+
"when": {
|
|
84
|
+
"all": [
|
|
85
|
+
{
|
|
86
|
+
"field": "decision.aspectLocked",
|
|
87
|
+
"operator": "equals",
|
|
88
|
+
"value": false
|
|
89
|
+
}
|
|
90
|
+
]
|
|
91
|
+
}
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
"target": "cycles-vs-eevee-decision",
|
|
95
|
+
"type": "upstream_reference",
|
|
96
|
+
"label": "Engine choice",
|
|
97
|
+
"when": {
|
|
98
|
+
"all": [
|
|
99
|
+
{
|
|
100
|
+
"field": "decision.engineLocked",
|
|
101
|
+
"operator": "equals",
|
|
102
|
+
"value": false
|
|
103
|
+
}
|
|
104
|
+
]
|
|
105
|
+
}
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
"target": "render-export-evidence",
|
|
109
|
+
"type": "progression",
|
|
110
|
+
"label": "Render file verification",
|
|
111
|
+
"when": {
|
|
112
|
+
"all": [
|
|
113
|
+
{
|
|
114
|
+
"field": "stage.current",
|
|
115
|
+
"operator": "equals",
|
|
116
|
+
"value": "post_execution_audit"
|
|
117
|
+
}
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
"target": "glb-animation-handoff",
|
|
123
|
+
"type": "progression",
|
|
124
|
+
"label": "3D / GLB exports (out of scope here) (glb-animation-handoff)",
|
|
125
|
+
"when": {
|
|
126
|
+
"all": [
|
|
127
|
+
{
|
|
128
|
+
"field": "artifact.hasAnimation",
|
|
129
|
+
"operator": "equals",
|
|
130
|
+
"value": true
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
"field": "stage.current",
|
|
134
|
+
"operator": "equals",
|
|
135
|
+
"value": "animation_handoff"
|
|
136
|
+
}
|
|
137
|
+
]
|
|
138
|
+
}
|
|
139
|
+
},
|
|
140
|
+
{
|
|
141
|
+
"target": "mobile-glb-budget",
|
|
142
|
+
"type": "boundary_delegation",
|
|
143
|
+
"label": "3D / GLB exports (out of scope here) (mobile-glb-budget)",
|
|
144
|
+
"when": {
|
|
145
|
+
"all": [
|
|
146
|
+
{
|
|
147
|
+
"field": "artifact.type",
|
|
148
|
+
"operator": "equals",
|
|
149
|
+
"value": "glb"
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"field": "budget.pinned",
|
|
153
|
+
"operator": "equals",
|
|
154
|
+
"value": false
|
|
155
|
+
}
|
|
156
|
+
]
|
|
157
|
+
}
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
"target": "glb-web-handoff",
|
|
161
|
+
"type": "progression",
|
|
162
|
+
"label": "3D / GLB exports (out of scope here) (glb-web-handoff)",
|
|
163
|
+
"when": {
|
|
164
|
+
"all": [
|
|
165
|
+
{
|
|
166
|
+
"field": "artifact.type",
|
|
167
|
+
"operator": "equals",
|
|
168
|
+
"value": "glb"
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"field": "handoff.consumerStack",
|
|
172
|
+
"operator": "equals",
|
|
173
|
+
"value": "web_glb"
|
|
174
|
+
}
|
|
175
|
+
]
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
]
|
|
179
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Bit-depth rules
|
|
2
|
+
|
|
3
|
+
## 8-bit (256 levels per channel)
|
|
4
|
+
|
|
5
|
+
- Default for web / mobile / standard delivery.
|
|
6
|
+
- Banding visible only in slow gradients (sky, smooth lighting).
|
|
7
|
+
- File size smallest.
|
|
8
|
+
|
|
9
|
+
## 10-bit (1024 levels per channel)
|
|
10
|
+
|
|
11
|
+
- HDR display delivery (HDR10, Dolby Vision).
|
|
12
|
+
- Smoother gradients.
|
|
13
|
+
- File size larger; consumer support not universal.
|
|
14
|
+
|
|
15
|
+
## 12-bit (4096 levels)
|
|
16
|
+
|
|
17
|
+
- Cinema / film mastering.
|
|
18
|
+
- Used in some intermediate codecs.
|
|
19
|
+
- Rarely needed for web / mobile.
|
|
20
|
+
|
|
21
|
+
## 16-bit (65536 levels)
|
|
22
|
+
|
|
23
|
+
- VFX / film working format.
|
|
24
|
+
- Print archival.
|
|
25
|
+
- Smooth gradients without banding.
|
|
26
|
+
- File size 2x of 8-bit; pipeline must support.
|
|
27
|
+
|
|
28
|
+
## 16-bit half float (OpenEXR)
|
|
29
|
+
|
|
30
|
+
- HDR data preserved (values > 1.0).
|
|
31
|
+
- Standard for VFX / film.
|
|
32
|
+
- Consumer must support EXR loader.
|
|
33
|
+
|
|
34
|
+
## 32-bit float (OpenEXR)
|
|
35
|
+
|
|
36
|
+
- Highest precision.
|
|
37
|
+
- Used for technical passes (depth, normal, motion vector).
|
|
38
|
+
- Massive file sizes; only when bit-depth is critical.
|
|
39
|
+
|
|
40
|
+
## When to upgrade bit depth
|
|
41
|
+
|
|
42
|
+
| Symptom | Solution |
|
|
43
|
+
|---|---|
|
|
44
|
+
| Banding in gradient | 8-bit → 10-bit or 16-bit |
|
|
45
|
+
| HDR clipped to white | 8-bit → EXR 16-bit half |
|
|
46
|
+
| Color shift after compositing | 8-bit → 16-bit working format |
|
|
47
|
+
| File-size acceptable | Stay at 8-bit |
|
|
48
|
+
|
|
49
|
+
## When to NOT upgrade
|
|
50
|
+
|
|
51
|
+
- Web hero where 8-bit is fine; bit depth bloats file with no perceived gain.
|
|
52
|
+
- Mobile where bandwidth matters.
|
|
53
|
+
- Archival of already-finished work; archive at delivery bit depth.
|
|
54
|
+
|
|
55
|
+
## Related skill
|
|
56
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# Compression tradeoffs
|
|
2
|
+
|
|
3
|
+
## Lossless
|
|
4
|
+
|
|
5
|
+
- PNG (DEFLATE)
|
|
6
|
+
- TIFF LZW
|
|
7
|
+
- WebP lossless
|
|
8
|
+
- OpenEXR ZIP / PIZ
|
|
9
|
+
- TGA RLE
|
|
10
|
+
|
|
11
|
+
Pro: pixel-exact recovery.
|
|
12
|
+
Con: file size ~30-70% of uncompressed.
|
|
13
|
+
|
|
14
|
+
When: hero deliverables, archival, intermediate passes.
|
|
15
|
+
|
|
16
|
+
## Lossy
|
|
17
|
+
|
|
18
|
+
- JPEG (DCT)
|
|
19
|
+
- WebP lossy
|
|
20
|
+
- AVIF
|
|
21
|
+
- HEIC
|
|
22
|
+
|
|
23
|
+
Pro: file size ~5-20% of uncompressed.
|
|
24
|
+
Con: pixel-exact recovery impossible; artifacts at low quality.
|
|
25
|
+
|
|
26
|
+
When: web mobile, social, sharing, draft previews.
|
|
27
|
+
|
|
28
|
+
## Per-format quality
|
|
29
|
+
|
|
30
|
+
| Format | Quality range | Practical sweet spot |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| JPG | 1-100 | 85-95 |
|
|
33
|
+
| WebP lossy | 1-100 | 85-90 |
|
|
34
|
+
| AVIF | 1-100 | 50-70 (more efficient than JPG) |
|
|
35
|
+
| HEIC | 1-100 | 70-85 |
|
|
36
|
+
|
|
37
|
+
Below 80 → visible artifacts on smooth gradients.
|
|
38
|
+
|
|
39
|
+
## Lossless tier comparison
|
|
40
|
+
|
|
41
|
+
| Format | Compression efficiency |
|
|
42
|
+
|---|---|
|
|
43
|
+
| PNG | Moderate |
|
|
44
|
+
| TIFF LZW | Moderate |
|
|
45
|
+
| WebP lossless | High (smaller than PNG for same content) |
|
|
46
|
+
| EXR PIZ | High for HDR float data |
|
|
47
|
+
|
|
48
|
+
## Choosing
|
|
49
|
+
|
|
50
|
+
- Hero / archival → lossless.
|
|
51
|
+
- Web hero where size matters → WebP lossless > PNG.
|
|
52
|
+
- Social / mobile → lossy WebP/JPG at quality 85-90.
|
|
53
|
+
- VFX → EXR ZIP/PIZ (still lossless, designed for float data).
|
|
54
|
+
|
|
55
|
+
## Anti-patterns
|
|
56
|
+
|
|
57
|
+
- JPEG for hero brand visual (artifacts on smooth gradients).
|
|
58
|
+
- Quality 50 lossy for portraits (compression rings around edges).
|
|
59
|
+
- Lossless for social-feed thumbnails (wasted bandwidth).
|
|
60
|
+
|
|
61
|
+
## Related skill
|
|
62
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Format decision matrix
|
|
2
|
+
|
|
3
|
+
| Consumer | Format | Bit depth | Color space | Compression | Alpha |
|
|
4
|
+
|---|---|---|---|---|---|
|
|
5
|
+
| Web hero | PNG | 8-bit | sRGB | Lossless | Optional |
|
|
6
|
+
| Web hero (modern browser) | WebP | 8-bit | sRGB | Quality 85-95 | Optional |
|
|
7
|
+
| JPEG-only | JPG | 8-bit | sRGB | Quality 85-95 | No |
|
|
8
|
+
| VFX / Film | OpenEXR | 16-bit half | Linear | ZIP | Channel |
|
|
9
|
+
| Print | TIFF | 16-bit | sRGB / soft-proof CMYK | LZW / None | Optional |
|
|
10
|
+
| Social / mobile | WebP / JPG | 8-bit | sRGB | Quality 85-90 | Optional |
|
|
11
|
+
| HDR display | PNG 16 / EXR | 16-bit | sRGB / Linear | Lossless | Optional |
|
|
12
|
+
| Game engine albedo | PNG / WebP | 8-bit | sRGB | Lossless / Quality 90+ | Optional |
|
|
13
|
+
| Game engine data (roughness, etc.) | PNG / WebP | 8-bit | Linear | Lossless | No |
|
|
14
|
+
| Animation video | MP4 / WebM | 8-bit | sRGB | H.264 / VP9 / AV1 | No |
|
|
15
|
+
|
|
16
|
+
## Why each row
|
|
17
|
+
|
|
18
|
+
- **Web hero**: PNG default; WebP for smaller files; no JPG for hero (artifacting).
|
|
19
|
+
- **VFX / Film**: EXR mandatory; lossy formats lose HDR data and downstream grade headroom.
|
|
20
|
+
- **Print**: TIFF preserves bit depth for print prep tools.
|
|
21
|
+
- **Social / mobile**: WebP wins on size; JPG fallback.
|
|
22
|
+
- **HDR display**: PNG 16 or EXR; verify consumer supports HDR.
|
|
23
|
+
- **Game engine**: PNG / WebP per channel role; verify engine-specific texture import settings.
|
|
24
|
+
- **Animation video**: MP4 H.264 default; WebM VP9 / AV1 for modern browsers.
|
|
25
|
+
|
|
26
|
+
## Anti-patterns
|
|
27
|
+
|
|
28
|
+
- JPEG for VFX (loses HDR + introduces compression artifacts).
|
|
29
|
+
- EXR for web (overkill, large file, browser support inconsistent).
|
|
30
|
+
- 8-bit for HDR delivery (banding visible).
|
|
31
|
+
- Lossy compression on archival masters.
|
|
32
|
+
|
|
33
|
+
## Related skill
|
|
34
|
+
`../SKILL.md`
|