blendops 0.0.0-stage → 1.0.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 +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -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 +72 -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/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 +99 -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 +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -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,254 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: color-management-decision
|
|
3
|
+
description: Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# color-management-decision
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Avoid the most common Blender color mistake: rendering with the wrong color space and then "fixing" it in post. Pick the color management strategy upfront based on the consumer's color pipeline.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- Identify the consumer pipeline (`web sRGB` / `film/VFX ACES linear` / `game engine` / `print` / `GLB-Three.js`).
|
|
13
|
+
- Pin the 4-line render color config: `Display Device`, `View Transform`, `Look`, and `Sequencer`.
|
|
14
|
+
- Define per-output color transforms if multiple outputs exist.
|
|
15
|
+
- Emit the 4-line config record, caveats, truth states (`Not Run` / `Not Produced`), and handoff.
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- before render / lookdev pass
|
|
19
|
+
- when consumer color pipeline is known
|
|
20
|
+
- when a previous render had unexpected color shifts
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- Post-render color grading or soft-proofing (handled by compositor / DCC after render). → use `../output-format-decision/SKILL.md` (Delegates out-of-scope requests to output-format-decision)
|
|
25
|
+
- Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker). → use `../material-quality-checker/SKILL.md` (Delegates out-of-scope requests to material-quality-checker)
|
|
26
|
+
- Selecting file formats or bit depths (output-format-decision). → use `../output-format-decision/SKILL.md` (Delegates out-of-scope requests to output-format-decision)
|
|
27
|
+
- Choosing the render engine (cycles-vs-eevee-decision). → use `../cycles-vs-eevee-decision/SKILL.md` (Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
28
|
+
- Monitor hardware calibration (out of scope). → use `../material-quality-checker/SKILL.md` (Delegates out-of-scope requests to material-quality-checker)
|
|
29
|
+
- Raw modeling without lookdev (color management does not affect geometry accuracy). → use `../cycles-vs-eevee-decision/SKILL.md` (Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
30
|
+
<!-- blendops:generated:end exclusions -->
|
|
31
|
+
|
|
32
|
+
## Trigger phrases
|
|
33
|
+
<!-- blendops:generated:start triggers -->
|
|
34
|
+
- "what color space"
|
|
35
|
+
- "Filmic vs Standard"
|
|
36
|
+
- "ACEScg for our pipeline"
|
|
37
|
+
- "colors look weird"
|
|
38
|
+
<!-- blendops:generated:end triggers -->
|
|
39
|
+
|
|
40
|
+
## Prerequisites / readiness
|
|
41
|
+
- Consumer pipeline known (`web sRGB`, `film/VFX ACES linear`, `game engine`, `print`, or `GLB-Three.js`).
|
|
42
|
+
- Target output list known (or handed off from `output-format-decision`).
|
|
43
|
+
|
|
44
|
+
## Input schema
|
|
45
|
+
|
|
46
|
+
### Required inputs
|
|
47
|
+
|
|
48
|
+
| Input | Why it is required |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Consumer pipeline | Determines `Display Device`, `View Transform`, `Look`, and `Sequencer` (`web sRGB`, `film/VFX ACES linear`, `game engine`, `print`, `GLB-Three.js`) |
|
|
51
|
+
| Target output list | Identifies which outputs need per-output color transform rules (file format ownership stays in `output-format-decision`) |
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
|
|
55
|
+
| Input | Use |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Brand color spec | Add caveat on verifying brand color appearance under the chosen `View Transform` and `Look` |
|
|
58
|
+
| Existing scene color config | Identify mismatches causing unexpected color shifts |
|
|
59
|
+
|
|
60
|
+
### Assumptions to confirm
|
|
61
|
+
- The user knows the consumer pipeline (or is willing to confirm it before pinning).
|
|
62
|
+
- "Just looks good" is not a valid target; explicit consumer pipeline match is required.
|
|
63
|
+
|
|
64
|
+
## Output schema
|
|
65
|
+
|
|
66
|
+
### Primary output
|
|
67
|
+
A 4-line config record: `Display Device`, `View Transform`, `Look`, `Sequencer`.
|
|
68
|
+
|
|
69
|
+
### Secondary output
|
|
70
|
+
- Per-output color transform rules when multiple outputs are planned
|
|
71
|
+
- Caveats per choice
|
|
72
|
+
- Truth-state and evidence block
|
|
73
|
+
|
|
74
|
+
### Evidence / caveat output
|
|
75
|
+
|
|
76
|
+
```txt
|
|
77
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
78
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
79
|
+
Evidence used: <links, paths, logs, or "none">
|
|
80
|
+
Limitations: <known gaps>
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Rules:
|
|
84
|
+
|
|
85
|
+
* Default `Artifact status` is `Not Produced`.
|
|
86
|
+
* Truth states are downgrade-only, never upgrade.
|
|
87
|
+
* Pinning a color config never produces a render (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
88
|
+
|
|
89
|
+
## Required laws
|
|
90
|
+
- `../../laws/evidence-before-done.md`
|
|
91
|
+
- `../../laws/non-blender-user-language.md`
|
|
92
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
93
|
+
- `../../laws/official-runtime-only.md`
|
|
94
|
+
|
|
95
|
+
## Official runtime boundary
|
|
96
|
+
|
|
97
|
+
Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
98
|
+
|
|
99
|
+
## Operating procedure
|
|
100
|
+
1. Identify the consumer pipeline (`web sRGB`, `film/VFX ACES linear`, `game engine`, `print`, or `GLB-Three.js`).
|
|
101
|
+
2. Map the pipeline to the 4-line scene render color config (see `references/pipeline-mapping.md`).
|
|
102
|
+
3. Pin `Display Device`, `View Transform`, `Look`, and `Sequencer`.
|
|
103
|
+
4. Document per-output color transforms if multiple outputs are required.
|
|
104
|
+
5. List pipeline caveats and delegate adjacent scopes (`material-quality-checker` for material texture spaces, `output-format-decision` for file formats, `cycles-vs-eevee-decision` for engine choice, `glb-web-handoff` for GLB web delivery, `render-export-evidence` for post-render verification).
|
|
105
|
+
|
|
106
|
+
## Decision tree
|
|
107
|
+
|
|
108
|
+
```txt
|
|
109
|
+
Web (sRGB)?
|
|
110
|
+
-> Display Device: sRGB | View Transform: Filmic or AgX (Standard for flat unlit color) | Look: None | Sequencer: sRGB
|
|
111
|
+
Film / VFX with ACES (linear)?
|
|
112
|
+
-> Display Device: sRGB | View Transform: AgX or Filmic (for viewport preview) | Look: None | Sequencer: sRGB | Per-output transform: scene-linear for linear handover (file format owned by output-format-decision)
|
|
113
|
+
Game engine?
|
|
114
|
+
-> Display Device: sRGB | View Transform: Standard | Look: None | Sequencer: sRGB | Hand off per-material texture color-space validation to material-quality-checker
|
|
115
|
+
Print?
|
|
116
|
+
-> Display Device: sRGB | View Transform: Filmic or AgX | Look: None | Sequencer: sRGB | Caveat: CMYK conversion/soft-proofing belongs to external print prep / DCC outside this skill
|
|
117
|
+
GLB-Three.js?
|
|
118
|
+
-> Display Device: sRGB | View Transform: Filmic or AgX | Look: None | Sequencer: sRGB | Caveat: match with Three.js outputColorSpace via glb-web-handoff; delegate texture space checks to material-quality-checker
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## Playbooks
|
|
122
|
+
|
|
123
|
+
### Playbook A: Web hero (web sRGB)
|
|
124
|
+
- `Display Device`: sRGB
|
|
125
|
+
- `View Transform`: Filmic (or AgX)
|
|
126
|
+
- `Look`: None (or Medium High Contrast if requested)
|
|
127
|
+
- `Sequencer`: sRGB
|
|
128
|
+
- Per-output transform: Bake display/view transform into display-referred web output (format owned by `output-format-decision`).
|
|
129
|
+
|
|
130
|
+
### Playbook B: Film / VFX ACES linear
|
|
131
|
+
- `Display Device`: sRGB
|
|
132
|
+
- `View Transform`: AgX
|
|
133
|
+
- `Look`: None
|
|
134
|
+
- `Sequencer`: sRGB
|
|
135
|
+
- Per-output transform: Preserve scene-linear data without baked view transform for VFX turnover (format owned by `output-format-decision`).
|
|
136
|
+
|
|
137
|
+
### Playbook C: Game engine
|
|
138
|
+
- `Display Device`: sRGB
|
|
139
|
+
- `View Transform`: Standard
|
|
140
|
+
- `Look`: None
|
|
141
|
+
- `Sequencer`: sRGB
|
|
142
|
+
- Per-output transform: Keep ungraded display transform; hand off per-material texture color-space checks to `material-quality-checker`.
|
|
143
|
+
|
|
144
|
+
### Playbook D: GLB-Three.js
|
|
145
|
+
- `Display Device`: sRGB
|
|
146
|
+
- `View Transform`: Filmic (or AgX)
|
|
147
|
+
- `Look`: None
|
|
148
|
+
- `Sequencer`: sRGB
|
|
149
|
+
- Per-output transform: Align Blender viewport lookdev transform with target Three.js `outputColorSpace = SRGBColorSpace` via `glb-web-handoff`; hand off material texture color-space validation to `material-quality-checker`.
|
|
150
|
+
|
|
151
|
+
## Mode handling
|
|
152
|
+
|
|
153
|
+
### Text-only mode
|
|
154
|
+
Emit the 4-line config record, per-output transforms, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
155
|
+
|
|
156
|
+
### Runtime-ready mode
|
|
157
|
+
Emit the 4-line config record, per-output transforms, and caveats for the operator to apply in Blender scene render properties. Because this skill never runs Blender and pinning a config never produces a render, keep `Runtime status: Not Run` and `Artifact status: Not Produced` until `render-export-evidence` evaluates actual output.
|
|
158
|
+
|
|
159
|
+
### Blocked runtime mode
|
|
160
|
+
Emit the 4-line config record, per-output transforms, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
161
|
+
|
|
162
|
+
## Validation checklist
|
|
163
|
+
- [ ] Consumer pipeline identified (`web sRGB`, `film/VFX ACES linear`, `game engine`, `print`, or `GLB-Three.js`)
|
|
164
|
+
- [ ] All 4 lines pinned (`Display Device`, `View Transform`, `Look`, `Sequencer`)
|
|
165
|
+
- [ ] Per-output color transform rules specified when multiple outputs exist
|
|
166
|
+
- [ ] Caveats listed and no subjective "looks good" verdict used
|
|
167
|
+
- [ ] Truth states set to `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only; pinning never produces a render)
|
|
168
|
+
- [ ] No role blur into per-material texture spaces (`material-quality-checker`), file formats (`output-format-decision`), engine choice (`cycles-vs-eevee-decision`), post-render grading, or monitor calibration
|
|
169
|
+
|
|
170
|
+
## Pass / Warn / Fail rubric
|
|
171
|
+
|
|
172
|
+
| Verdict | Criteria |
|
|
173
|
+
|---|---|
|
|
174
|
+
| Pass | Pipeline-correct 4-line config pinned; per-output color transforms explicit; role boundaries respected; truth states accurately set (`Not Run` / `Not Produced`). |
|
|
175
|
+
| Warn | 4-line config pinned accurately, but a minor caveat for one output transform or downstream handoff is incomplete. |
|
|
176
|
+
| Fail | Wrong pipeline match (e.g., baking a display-referred `View Transform` into a linear VFX turnover); missing any of the 4 config lines; skipped per-output rules; upgrading truth states on a pinned config; crossing into texture validation, format selection, engine choice, post-grading, or monitor calibration; "looks good" verdict. |
|
|
177
|
+
|
|
178
|
+
## Failure handling
|
|
179
|
+
- Pipeline unknown: ask once; if still unspecified, state assumption and default to `web sRGB` (`Display Device: sRGB`, `View Transform: Filmic`, `Look: None`, `Sequencer: sRGB`).
|
|
180
|
+
- Mixed pipelines from the same scene (e.g., `web sRGB` preview + `film/VFX ACES linear` turnover): specify distinct per-output color transform rules so the operator applies each transform per output pass without mixing baked and scene-linear color spaces.
|
|
181
|
+
|
|
182
|
+
## Troubleshooting
|
|
183
|
+
|
|
184
|
+
| Problem | Response |
|
|
185
|
+
|---|---|
|
|
186
|
+
| Highlights clip or colors look washed out in lit scenes | Verify `View Transform` is `Filmic` or `AgX` rather than `Standard` for high-dynamic-range lighting. |
|
|
187
|
+
| Colors appear overly contrasty | Set `Look` to `None`, or compare `Filmic` vs `AgX` view transforms. |
|
|
188
|
+
| Flat UI / unlit brand color shifts under tone mapping | Use `View Transform: Standard` with `Look: None` only when exact flat sRGB hex preservation is required over photoreal lighting roll-off, and document the caveat. |
|
|
189
|
+
| Per-material texture looks too bright or normal map looks wrong | Out of scope for scene render config — hand off to `material-quality-checker` to validate per-material texture color spaces. |
|
|
190
|
+
|
|
191
|
+
## Best practices
|
|
192
|
+
- One config per render, not "default and hope".
|
|
193
|
+
- Verify with a known reference (color chart or brand color).
|
|
194
|
+
- Document choices in scene metadata.
|
|
195
|
+
- Avoid post-process color grading inside Blender for web — let the consumer do it.
|
|
196
|
+
|
|
197
|
+
## Good examples
|
|
198
|
+
- "Consumer pipeline: `web sRGB`. `Display Device`: sRGB. `View Transform`: Filmic. `Look`: None. `Sequencer`: sRGB. Per-output rule: apply display/view transform to web delivery output (file format pinned via `output-format-decision`). `Runtime status`: Not Run. `Artifact status`: Not Produced."
|
|
199
|
+
|
|
200
|
+
## Bad examples
|
|
201
|
+
- "Use Filmic." — no pipeline context.
|
|
202
|
+
|
|
203
|
+
## User-facing response template
|
|
204
|
+
|
|
205
|
+
```txt
|
|
206
|
+
Consumer pipeline: <web sRGB | film/VFX ACES linear | game engine | print | GLB-Three.js>
|
|
207
|
+
Output(s): <list>
|
|
208
|
+
|
|
209
|
+
Color management config:
|
|
210
|
+
Display Device: <…>
|
|
211
|
+
View Transform: <…>
|
|
212
|
+
Look: <…>
|
|
213
|
+
Sequencer: <…>
|
|
214
|
+
|
|
215
|
+
Per-output rules:
|
|
216
|
+
<output>: <per-output color transform rule>
|
|
217
|
+
|
|
218
|
+
Caveats: <list>
|
|
219
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
220
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
221
|
+
Evidence used: <links, paths, logs, or "none">
|
|
222
|
+
Limitations: <known gaps>
|
|
223
|
+
Next: <render-export-evidence | material-quality-checker | output-format-decision | cycles-vs-eevee-decision | glb-web-handoff>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
## Anti-patterns
|
|
227
|
+
- Saying "Just use Filmic" without identifying the consumer pipeline.
|
|
228
|
+
- Claiming `Produced` or `Verified` artifact/runtime status when only pinning a color config.
|
|
229
|
+
- Auditing per-material texture nodes here instead of handing off to `material-quality-checker`.
|
|
230
|
+
- Prescribing file containers/codecs here instead of handing off to `output-format-decision`.
|
|
231
|
+
- Doing post-render color grading inside the scene color-management decision step.
|
|
232
|
+
|
|
233
|
+
## Cross-skill handoff
|
|
234
|
+
<!-- blendops:generated:start handoffs -->
|
|
235
|
+
- [progression] Output format selection → `../output-format-decision/SKILL.md`
|
|
236
|
+
- [progression] Material texture color spaces → `../material-quality-checker/SKILL.md`
|
|
237
|
+
- [progression] Render engine choice → `../cycles-vs-eevee-decision/SKILL.md`
|
|
238
|
+
- [progression] GLB Three.js delivery → `../glb-web-handoff/SKILL.md`
|
|
239
|
+
- [progression] Render evidence verification → `../render-export-evidence/SKILL.md`
|
|
240
|
+
<!-- blendops:generated:end handoffs -->
|
|
241
|
+
|
|
242
|
+
## Non-goals
|
|
243
|
+
- Validate per-material texture color spaces (`material-quality-checker`).
|
|
244
|
+
- Choose output file formats or bit depths (`output-format-decision`).
|
|
245
|
+
- Choose the render engine (`cycles-vs-eevee-decision`).
|
|
246
|
+
- Perform post-render color grading (belongs to compositor / DCC).
|
|
247
|
+
- Calibrate a physical monitor (out of scope).
|
|
248
|
+
- Run Blender or execute renders.
|
|
249
|
+
|
|
250
|
+
## References
|
|
251
|
+
- `references/pipeline-mapping.md`
|
|
252
|
+
- `references/per-channel-rules.md`
|
|
253
|
+
- `references/look-comparison.md`
|
|
254
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "color-management-decision",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "render-and-output-decisions",
|
|
6
|
+
"role": "view-transform-and-colorspace-selector",
|
|
7
|
+
"purpose": "Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"what color space",
|
|
11
|
+
"Filmic vs Standard",
|
|
12
|
+
"ACEScg for our pipeline",
|
|
13
|
+
"colors look weird"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "Post-render color grading or soft-proofing (handled by compositor / DCC after render).",
|
|
18
|
+
"delegateTo": "output-format-decision",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to output-format-decision"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker).",
|
|
23
|
+
"delegateTo": "material-quality-checker",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to material-quality-checker"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "Selecting file formats or bit depths (output-format-decision).",
|
|
28
|
+
"delegateTo": "output-format-decision",
|
|
29
|
+
"reason": "Delegates out-of-scope requests to output-format-decision"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "Choosing the render engine (cycles-vs-eevee-decision).",
|
|
33
|
+
"delegateTo": "cycles-vs-eevee-decision",
|
|
34
|
+
"reason": "Delegates out-of-scope requests to cycles-vs-eevee-decision"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "Monitor hardware calibration (out of scope).",
|
|
38
|
+
"delegateTo": "material-quality-checker",
|
|
39
|
+
"reason": "Delegates out-of-scope requests to material-quality-checker"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "Raw modeling without lookdev (color management does not affect geometry accuracy).",
|
|
43
|
+
"delegateTo": "cycles-vs-eevee-decision",
|
|
44
|
+
"reason": "Delegates out-of-scope requests to cycles-vs-eevee-decision"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "target_delivery_pipeline",
|
|
51
|
+
"type": "string",
|
|
52
|
+
"description": "Target display or compositing pipeline (web sRGB, product brand match, ACEScg VFX, HDR)"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "blender_version_posture",
|
|
56
|
+
"type": "string",
|
|
57
|
+
"description": "Target Blender version family (3.6 LTS Filmic, 4.0+ AgX, 5.1+ AgX/ACES)"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "brand_hex_swatch_constraints",
|
|
63
|
+
"type": "array",
|
|
64
|
+
"description": "Optional strict brand hex colors requiring Standard vs tone-mapped tradeoffs"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"pinned_view_transform_and_look",
|
|
71
|
+
"display_and_working_colorspace_spec",
|
|
72
|
+
"cross_engine_and_web_color_caveats"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "output-format-decision",
|
|
83
|
+
"type": "progression",
|
|
84
|
+
"label": "Output format selection",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "decision.formatLocked",
|
|
89
|
+
"operator": "equals",
|
|
90
|
+
"value": false
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"target": "material-quality-checker",
|
|
97
|
+
"type": "progression",
|
|
98
|
+
"label": "Material texture color spaces",
|
|
99
|
+
"when": {
|
|
100
|
+
"all": [
|
|
101
|
+
{
|
|
102
|
+
"field": "quality.domain",
|
|
103
|
+
"operator": "equals",
|
|
104
|
+
"value": "material"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"field": "quality.verdict",
|
|
108
|
+
"operator": "equals",
|
|
109
|
+
"value": "not_run"
|
|
110
|
+
}
|
|
111
|
+
]
|
|
112
|
+
}
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"target": "cycles-vs-eevee-decision",
|
|
116
|
+
"type": "progression",
|
|
117
|
+
"label": "Render engine choice",
|
|
118
|
+
"when": {
|
|
119
|
+
"all": [
|
|
120
|
+
{
|
|
121
|
+
"field": "decision.engineLocked",
|
|
122
|
+
"operator": "equals",
|
|
123
|
+
"value": false
|
|
124
|
+
}
|
|
125
|
+
]
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"target": "glb-web-handoff",
|
|
130
|
+
"type": "progression",
|
|
131
|
+
"label": "GLB Three.js delivery",
|
|
132
|
+
"when": {
|
|
133
|
+
"all": [
|
|
134
|
+
{
|
|
135
|
+
"field": "artifact.type",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": "glb"
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"field": "handoff.consumerStack",
|
|
141
|
+
"operator": "equals",
|
|
142
|
+
"value": "web_glb"
|
|
143
|
+
}
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"target": "render-export-evidence",
|
|
149
|
+
"type": "progression",
|
|
150
|
+
"label": "Render evidence verification",
|
|
151
|
+
"when": {
|
|
152
|
+
"all": [
|
|
153
|
+
{
|
|
154
|
+
"field": "stage.current",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": "post_execution_audit"
|
|
157
|
+
}
|
|
158
|
+
]
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
]
|
|
162
|
+
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Look comparison (Filmic vs Standard vs AgX)
|
|
2
|
+
|
|
3
|
+
## Standard
|
|
4
|
+
|
|
5
|
+
- No tone-mapping; clamps values > 1.0.
|
|
6
|
+
- Preserves accurate colors in low-DR scenes.
|
|
7
|
+
- Burns out highlights in high-DR scenes (HDR lighting blown out).
|
|
8
|
+
- Good for: brand color work, flat graphics, low-DR scenes.
|
|
9
|
+
|
|
10
|
+
## Filmic
|
|
11
|
+
|
|
12
|
+
- Tone-maps HDR to display-referred range.
|
|
13
|
+
- Preserves highlight detail (clouds, sun, lightbulbs).
|
|
14
|
+
- Slightly desaturates very bright colors (intentional, looks photographic).
|
|
15
|
+
- Good for: product hero, lit interiors, cinematic.
|
|
16
|
+
|
|
17
|
+
## AgX (Blender 4.0+)
|
|
18
|
+
|
|
19
|
+
- Newer alternative to Filmic.
|
|
20
|
+
- Cleaner highlight rolloff than Filmic.
|
|
21
|
+
- Less aggressive desaturation.
|
|
22
|
+
- Good for: VFX-quality work, modern lit scenes.
|
|
23
|
+
|
|
24
|
+
## Look modifiers
|
|
25
|
+
|
|
26
|
+
| Look | Effect |
|
|
27
|
+
|---|---|
|
|
28
|
+
| None | Pure View Transform output |
|
|
29
|
+
| Very Low Contrast | Lifts shadows |
|
|
30
|
+
| Low Contrast | Slightly lifted shadows |
|
|
31
|
+
| Medium Contrast | Default-ish |
|
|
32
|
+
| Medium High Contrast | Slightly punched contrast (good for product hero) |
|
|
33
|
+
| High Contrast | Strong contrast (cinematic) |
|
|
34
|
+
| Very High Contrast | Heavy contrast (rarely needed) |
|
|
35
|
+
|
|
36
|
+
## When to pick which
|
|
37
|
+
|
|
38
|
+
- Pure brand color (logo render): Standard, Look None.
|
|
39
|
+
- Product hero with HDR lighting: Filmic, Look Medium High Contrast.
|
|
40
|
+
- VFX EXR pipeline: AgX, Look None (downstream tools grade).
|
|
41
|
+
- Stylized / illustrative: Standard or Filmic, with art direction tests.
|
|
42
|
+
|
|
43
|
+
## Related skill
|
|
44
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Per-channel texture color space rules
|
|
2
|
+
|
|
3
|
+
## Color textures (sRGB)
|
|
4
|
+
|
|
5
|
+
- Albedo / Base Color
|
|
6
|
+
- Diffuse
|
|
7
|
+
- Emission color (depending on workflow)
|
|
8
|
+
|
|
9
|
+
These contain perceptual color data; load as sRGB so they are interpreted correctly.
|
|
10
|
+
|
|
11
|
+
## Data textures (Linear / Non-Color)
|
|
12
|
+
|
|
13
|
+
- Roughness
|
|
14
|
+
- Metallic
|
|
15
|
+
- Normal map
|
|
16
|
+
- Bump / Displacement
|
|
17
|
+
- Ambient Occlusion (often)
|
|
18
|
+
- Specular (workflow-dependent)
|
|
19
|
+
- Alpha / Mask
|
|
20
|
+
- Anisotropy
|
|
21
|
+
|
|
22
|
+
These contain numerical data, not color; load as Linear / Non-Color so the values are not gamma-warped.
|
|
23
|
+
|
|
24
|
+
## Mixed-channel packed textures
|
|
25
|
+
|
|
26
|
+
ORM packing (Occlusion / Roughness / Metallic in R/G/B):
|
|
27
|
+
- Load whole texture as Linear / Non-Color.
|
|
28
|
+
- Do not split channels and load each differently.
|
|
29
|
+
|
|
30
|
+
## Loading rules in Blender
|
|
31
|
+
|
|
32
|
+
- Image Texture node → "Color Space" dropdown → set per channel role.
|
|
33
|
+
- Default sRGB is correct for color textures.
|
|
34
|
+
- Data textures must be flipped to Non-Color manually.
|
|
35
|
+
|
|
36
|
+
## Common errors
|
|
37
|
+
|
|
38
|
+
- Roughness loaded as sRGB → render looks incorrectly rough.
|
|
39
|
+
- Albedo loaded as Non-Color → render looks washed out.
|
|
40
|
+
- Normal map loaded as sRGB → strange edge artifacts.
|
|
41
|
+
|
|
42
|
+
## Verifying
|
|
43
|
+
|
|
44
|
+
- Render a test sphere with a known color chart.
|
|
45
|
+
- Compare against reference.
|
|
46
|
+
- Adjust if mismatched.
|
|
47
|
+
|
|
48
|
+
## Related skill
|
|
49
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Pipeline → color management mapping
|
|
2
|
+
|
|
3
|
+
## Web (sRGB display)
|
|
4
|
+
|
|
5
|
+
- Display Device: sRGB
|
|
6
|
+
- View Transform: Filmic (default) or Standard (flat color brand work)
|
|
7
|
+
- Look: None or Medium High Contrast
|
|
8
|
+
- Output: PNG / JPG / WebP 8-bit sRGB
|
|
9
|
+
|
|
10
|
+
## Film / VFX (ACES or AgX pipeline)
|
|
11
|
+
|
|
12
|
+
- Display Device: sRGB (for preview)
|
|
13
|
+
- View Transform: AgX or Filmic
|
|
14
|
+
- Look: None
|
|
15
|
+
- Output: OpenEXR linear 16-bit half float
|
|
16
|
+
|
|
17
|
+
## Game engine (Unity / Unreal)
|
|
18
|
+
|
|
19
|
+
- Display Device: sRGB
|
|
20
|
+
- View Transform: Standard (linear render preserved)
|
|
21
|
+
- Look: None
|
|
22
|
+
- Output: per-texture (color sRGB, data Linear)
|
|
23
|
+
|
|
24
|
+
## Print
|
|
25
|
+
|
|
26
|
+
- Display Device: sRGB
|
|
27
|
+
- View Transform: Standard
|
|
28
|
+
- Look: None
|
|
29
|
+
- Output: TIFF 16-bit; soft-proof to CMYK in print prep tool
|
|
30
|
+
|
|
31
|
+
## GLB (Three.js / R3F web)
|
|
32
|
+
|
|
33
|
+
- Display Device: sRGB
|
|
34
|
+
- View Transform: Filmic
|
|
35
|
+
- Look: None
|
|
36
|
+
- Embedded textures in GLB: color = sRGB, data = Linear
|
|
37
|
+
- Three.js: `renderer.outputColorSpace = SRGBColorSpace`
|
|
38
|
+
|
|
39
|
+
## Why these choices
|
|
40
|
+
|
|
41
|
+
- **Filmic** compresses HDR to display-referred range; flatters lit scenes; web's default for product / portrait / cinematic.
|
|
42
|
+
- **AgX** is similar to Filmic with cleaner highlight rolloff; preferred for VFX.
|
|
43
|
+
- **Standard** is "no tone-mapping"; flat, accurate for graphic / brand color work; not for high-DR scenes.
|
|
44
|
+
- **ACEScg** is a working color space, not a view transform; used in VFX pipelines that ingest BlendOps output downstream.
|
|
45
|
+
|
|
46
|
+
## Related skill
|
|
47
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# EVAL — composition-quality-checker
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use composition-quality-checker on a 16:9 product hero card camera plan. Subject right-third, 60% width, soft horizon.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- per-check rows (rule of thirds, subject placement, headroom, lead room, negative space, hierarchy, lens / FOV)
|
|
8
|
+
- aspect ratio + framing intent stated
|
|
9
|
+
- top-line status from rows
|
|
10
|
+
- worst-offender highlight
|
|
11
|
+
- evidence label honest
|
|
12
|
+
|
|
13
|
+
## Pass / Warn / Fail criteria
|
|
14
|
+
- Pass: full check rows + intent match + top-line correct
|
|
15
|
+
- Warn: rows present but ambiguity in headroom / negative space / hierarchy
|
|
16
|
+
- Fail: subject dead corner without justification, missing aspect ratio, fabricated values
|
|
17
|
+
|
|
18
|
+
## Common failure modes
|
|
19
|
+
- broad summary without per-check rows
|
|
20
|
+
- skipping aspect ratio
|
|
21
|
+
- mixing lighting / material checks
|
|
22
|
+
- claiming Verified without preview
|
|
23
|
+
|
|
24
|
+
## Evidence expectations
|
|
25
|
+
- per-check verdicts cited from rules
|
|
26
|
+
- aspect ratio stated
|
|
27
|
+
- intent match assessment
|
|
28
|
+
|
|
29
|
+
## Sample passing response outline
|
|
30
|
+
- Header: aspect + intent
|
|
31
|
+
- 7 check rows
|
|
32
|
+
- Top-line: Pass
|
|
33
|
+
- Next: handoff named
|
|
34
|
+
|
|
35
|
+
## Sample failing response outline
|
|
36
|
+
- "Composition looks great"
|
|
37
|
+
- No per-check data
|
|
38
|
+
- Verified without preview
|