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.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. 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