blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -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 +73 -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/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,247 @@
1
+ ---
2
+ name: lighting-quality-checker
3
+ description: Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
4
+ ---
5
+
6
+ # lighting-quality-checker
7
+
8
+ ## Purpose
9
+ Run a focused pass/warn/fail check on the scene's lighting setup per light — covering intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance, and mood match — without expanding into material, composition, or lookdev planning concerns.
10
+
11
+ ## Quick start
12
+ - enumerate every explicit light and HDRI in the scene plan or measured scene
13
+ - check intensity ranges per light
14
+ - check shadow softness consistency
15
+ - check color temperature consistency
16
+ - check HDRI presence + balance with explicit lights
17
+ - check mood match against the brief
18
+ - emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
19
+
20
+ ## When to use
21
+ - before render
22
+ - after a lighting change request
23
+ - as a sub-check during full quality review
24
+ - when the rendered preview looks "off" but the issue is unclear
25
+
26
+ ## When not to use
27
+ <!-- blendops:generated:start exclusions -->
28
+ - upstream lookdev and lighting planning → use `../lighting-material-plan/SKILL.md` (use lighting-material-plan)
29
+ - material validation → use `../material-quality-checker/SKILL.md` (use material-quality-checker)
30
+ - composition / camera validation → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
31
+ - broad pass/warn/fail scene readiness → use `../scene-readiness/SKILL.md` (use scene-readiness)
32
+ - classifying render or export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
33
+ - to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → use `../scene-readiness/SKILL.md` (this skill validates and gives remediation hints only; it never edits)
34
+ <!-- blendops:generated:end exclusions -->
35
+
36
+ ## Trigger phrases
37
+ <!-- blendops:generated:start triggers -->
38
+ - "is the lighting okay"
39
+ - "check shadow softness"
40
+ - "lighting feels off"
41
+ - "is the HDRI balanced"
42
+ <!-- blendops:generated:end triggers -->
43
+
44
+ ## Prerequisites / readiness
45
+ - light list known (from `lighting-material-plan` scene plan or measured scene snapshot)
46
+ - consumer target known (render or export target)
47
+ - mood / look brief known (from `intent-to-3d-brief-writer`)
48
+
49
+ ## Input schema
50
+
51
+ ### Required inputs
52
+
53
+ | Input | Why it is required |
54
+ |---|---|
55
+ | Light list (type, position, strength, color, soft size) | Scope of the check |
56
+ | Mood / look brief | Determines whether the lighting matches intent |
57
+ | Consumer target | Cycles vs Eevee vs glTF affects allowed light types |
58
+
59
+ ### Optional inputs
60
+
61
+ | Input | Use |
62
+ |---|---|
63
+ | HDRI file path or name | Identifies environment lighting |
64
+ | Reference image | Allows intensity / mood cross-check |
65
+
66
+ ### Assumptions to confirm
67
+ - Intensity units (Watts / Lumens / Sun strength) are consistent across the scene.
68
+ - Color temperature is in Kelvin where applicable; mixed Kelvin and RGB color modes need explicit annotation.
69
+ - HDRI is real-world calibrated (typical 0.5–2.0 strength), not arbitrarily boosted.
70
+
71
+ ## Output schema
72
+
73
+ ### Primary output
74
+ A per-light verdict table: name, type, intensity, color, shadow softness, verdict (`Pass / Warn / Fail`), and remediation hints (hints only, never direct edits or execution).
75
+
76
+ ### Secondary output
77
+ - top-line status (`Pass / Warn / Fail`) computed from per-light rows
78
+ - mood / look match: `Yes / No / Unknown`
79
+ - worst-offender highlighting
80
+
81
+ ### Evidence / caveat output
82
+ Validation verdicts (`Pass / Warn / Fail`) are separate from runtime and artifact truth states. Truth states are downgrade-only (never upgrade), and `Artifact status` defaults to `Not Produced` unless concrete output evidence exists (classified via `render-export-evidence`).
83
+
84
+ ```txt
85
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
86
+ Artifact status: Not Produced | Produced | Verified | Failed
87
+ Evidence used: <links, paths, logs, or "none">
88
+ Limitations: <known gaps>
89
+ ```
90
+
91
+ ## Required laws
92
+ - `../../laws/evidence-before-done.md`
93
+ - `../../laws/non-blender-user-language.md`
94
+ - `../../laws/no-arbitrary-python-interface.md`
95
+ - `../../laws/official-runtime-only.md`
96
+
97
+ ## Official runtime boundary
98
+
99
+ This skill validates plans or measured scene snapshots only. It never modifies lights, runs Blender, or renders. Use measured scene description (plan output, runtime tool snapshot) — never invent values.
100
+
101
+ For runtime path attribution, see `../../docs/runtime-stack-strategy.md`.
102
+
103
+ ## Operating procedure
104
+ 1. Read the light list from the `lighting-material-plan` plan or measured scene snapshot.
105
+ 2. For each light, evaluate intensity range (see `references/intensity-ranges.md`).
106
+ 3. Evaluate shadow softness consistency (see `references/shadow-softness-rules.md`).
107
+ 4. Evaluate color temperature consistency.
108
+ 5. Evaluate HDRI strength + explicit-light balance (see `references/hdri-balance-rules.md`).
109
+ 6. Cross-check overall setup with the mood brief from `intent-to-3d-brief-writer`.
110
+ 7. Assign per-light verdict (`Pass / Warn / Fail`) and provide brief remediation hints only (never edit lights).
111
+ 8. Compute top-line status, highlight worst offenders, and record downgrade-only truth states (`Artifact status: Not Produced` by default unless concrete output evidence exists).
112
+ 9. Hand off to `scene-readiness` (broad review), `lighting-material-plan` (re-plan), `material-quality-checker` (materials), `composition-quality-checker` (framing), or `render-export-evidence` (artifact evidence classification).
113
+
114
+ ## Decision tree
115
+
116
+ ```txt
117
+ Scene has only HDRI, no explicit light when brief requires strong key separation?
118
+ → Warn (HDRI/explicit-light balance flag; verify intent)
119
+ HDRI strength overpowers explicit lights?
120
+ → Warn (balance issue); add remediation hint to rebalance HDRI vs key light
121
+ Multiple explicit lights stacked above target intensity range?
122
+ → Warn or Fail depending on severity; add remediation hint to reduce intensities
123
+ Shadows hard when mood brief specifies soft lighting (or vice versa)?
124
+ → Fail (shadow softness + mood mismatch)
125
+ Inconsistent or unannotated color temperatures across lights?
126
+ → Warn (color temperature consistency flag)
127
+ ```
128
+
129
+ ## Playbooks
130
+
131
+ ### Playbook A: Product hero with HDRI + 3-point lighting
132
+ HDRI ~0.7–1.2; key area light ~50–500W; fill ~10–20% of key; rim for separation. Verdicts per light + balance check.
133
+
134
+ ### Playbook B: Cinematic moody scene
135
+ Single key + practical lights; HDRI ~0.2 (mostly ambient fill); shadows hard or soft per brief; verify mood match.
136
+
137
+ ### Playbook C: Outdoor sunlight
138
+ Sun strength ~1–5; HDRI environment map for ambient; verify shadow direction matches sun direction; verify color temperature (~5500–6500K daylight).
139
+
140
+ ## Mode handling
141
+
142
+ ### Text-only mode
143
+ Verdicts (`Pass / Warn / Fail`) are based on the plan or spec only. Set `Runtime status: Not Run` and `Artifact status: Not Produced`.
144
+
145
+ ### Runtime-ready mode
146
+ Verdicts are based on a measured scene snapshot; cite the inspection source used. Truth states are downgrade-only — never upgrade `Runtime status` or `Artifact status` inside this skill, and leave `Artifact status: Not Produced` unless concrete output evidence already exists and is classified via `render-export-evidence`.
147
+
148
+ ### Blocked runtime mode
149
+ Skip rows that depend on missing live measurement, mark limitations explicitly, and downgrade truth states (`Not Run` / `Not Produced` / `Failed` as applicable).
150
+
151
+ ## Validation checklist
152
+ - [ ] Every light listed
153
+ - [ ] Intensity column filled
154
+ - [ ] Color column filled (Kelvin or RGB)
155
+ - [ ] Shadow softness column filled
156
+ - [ ] HDRI presence noted (or "none")
157
+ - [ ] Per-light verdict assigned
158
+ - [ ] Mood match assessed
159
+ - [ ] Top-line status derived from rows
160
+ - [ ] Honest evidence label
161
+
162
+ ## Pass / Warn / Fail rubric
163
+
164
+ | Verdict | Criteria |
165
+ |---|---|
166
+ | Pass | All lights pass intensity / shadow / color sanity; HDRI balanced; mood match Yes. |
167
+ | Warn | Plausibility flags (HDRI alone, mixed color modes, intensity at edges of range) but no hard violations. |
168
+ | Fail | Mood mismatch (e.g. soft brief but hard shadows); unsupported light type for chosen export; intensity clearly off (factor of 10+); shadow direction inconsistent. |
169
+
170
+ ## Failure handling
171
+ - Missing light data → Fail with note.
172
+ - Mood unclear → mark Mood match Unknown; do not Pass.
173
+ - User pushes for "Pass" without checks → restate requirement.
174
+
175
+ ## Troubleshooting
176
+
177
+ | Problem | Remediation hint (lighting only) |
178
+ |---|---|
179
+ | Scene lighting too dark | Hint to recheck explicit light intensity ranges and HDRI balance in `lighting-material-plan` (route color/exposure questions to `color-management-decision`). |
180
+ | Scene lighting too bright | Hint to lower competing explicit light intensities or HDRI strength (route render clamping questions to `cycles-vs-eevee-decision`). |
181
+ | Shadows missing or harsh | Hint to check per-light shadow softness settings and key-to-fill intensity ratio. |
182
+ | Unintended color cast | Hint to check HDRI tint and color temperature consistency across key, fill, and rim lights. |
183
+ | Framing or surface response feels wrong | Out of scope — route framing/camera issues to `composition-quality-checker` and shader issues to `material-quality-checker`. |
184
+
185
+ ## Best practices
186
+ - Pair every Fail with the rule that triggered it.
187
+ - Cross-check intensity sums against the scene's overall exposure target.
188
+ - Always evaluate HDRI + explicit lights as a system, not separately.
189
+ - Keep this skill narrow — do not creep into material or composition.
190
+
191
+ ## Good examples
192
+ - "HDRI: studio.exr @ 1.0 (Pass); Key area light 250W, 5500K, 0.6m soft (Pass); Fill area 50W, 5500K, 0.8m soft (Pass); Rim area 80W, 5000K, 0.4m soft (Pass). Mood match: Yes (soft hero). Top-line: Pass. Runtime status: Not Run | Artifact status: Not Produced."
193
+
194
+ ## Bad examples
195
+ - "Lighting looks fine." — missing per-light rows, mood match, and top-line status.
196
+ - Upgrading `Artifact status` to `Verified` or `Produced` inside a lighting check without concrete output evidence classified by `render-export-evidence`.
197
+ - Editing light power or running Blender scripts instead of giving remediation hints.
198
+
199
+ ## User-facing response template
200
+
201
+ ```txt
202
+ Consumer target: <target>
203
+ Mood / look: <one-line summary>
204
+
205
+ | Light | Type | Intensity | Color | Shadow softness | Verdict | Remediation hint |
206
+ |---|---|---|---|---|---|---|
207
+ | <name> | <type / HDRI> | <value> | <color temp / value> | <softness> | <Pass / Warn / Fail> | <hint only, no edits> |
208
+
209
+ HDRI balance: <name + strength + balance note, or "none">
210
+ Mood match: Yes / No / Unknown
211
+ Top-line: <Pass / Warn / Fail>
212
+ Worst offenders: <list or "none">
213
+
214
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
215
+ Artifact status: Not Produced | Produced | Verified | Failed
216
+ Evidence used: <links, paths, logs, or "none">
217
+ Limitations: <known gaps>
218
+ Next: scene-readiness | lighting-material-plan | material-quality-checker | composition-quality-checker | render-export-evidence
219
+ ```
220
+
221
+ ## Anti-patterns
222
+ - Editing lights or generating full lighting recipes inside this skill (use `lighting-material-plan`).
223
+ - Inventing light intensity, color, or softness values.
224
+ - Upgrading Runtime or Artifact truth states (truth states are downgrade-only; artifacts stay `Not Produced` unless concrete evidence exists).
225
+ - Mixing material checks (`material-quality-checker`), camera/framing checks (`composition-quality-checker`), or artifact evidence classification (`render-export-evidence`) into lighting validation.
226
+
227
+ ## Cross-skill handoff
228
+ <!-- blendops:generated:start handoffs -->
229
+ - [progression] Broad readiness review → `../scene-readiness/SKILL.md`
230
+ - [upstream_reference] Material validation → `../material-quality-checker/SKILL.md`
231
+ - [progression] Composition validation → `../composition-quality-checker/SKILL.md`
232
+ - [retry] Lighting re-plan → `../lighting-material-plan/SKILL.md`
233
+ - [progression] Render evidence → `../render-export-evidence/SKILL.md`
234
+ <!-- blendops:generated:end handoffs -->
235
+
236
+ ## Non-goals
237
+ - Edit lights.
238
+ - Generate light setup recipes.
239
+ - Replace `scene-readiness`.
240
+ - Run Blender.
241
+
242
+ ## References
243
+ - `references/intensity-ranges.md`
244
+ - `references/shadow-softness-rules.md`
245
+ - `references/hdri-balance-rules.md`
246
+ - `../../laws/evidence-before-done.md`
247
+ - `../../docs/skill-system.md`
@@ -0,0 +1,187 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "lighting-quality-checker",
4
+ "version": "1.0.0",
5
+ "category": "quality-validators",
6
+ "role": "exposure-ratio-and-shadow-validator",
7
+ "purpose": "Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "is the lighting okay",
11
+ "check shadow softness",
12
+ "lighting feels off",
13
+ "is the HDRI balanced"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "upstream lookdev and lighting planning",
18
+ "delegateTo": "lighting-material-plan",
19
+ "reason": "use lighting-material-plan"
20
+ },
21
+ {
22
+ "condition": "material validation",
23
+ "delegateTo": "material-quality-checker",
24
+ "reason": "use material-quality-checker"
25
+ },
26
+ {
27
+ "condition": "composition / camera validation",
28
+ "delegateTo": "composition-quality-checker",
29
+ "reason": "use composition-quality-checker"
30
+ },
31
+ {
32
+ "condition": "broad pass/warn/fail scene readiness",
33
+ "delegateTo": "scene-readiness",
34
+ "reason": "use scene-readiness"
35
+ },
36
+ {
37
+ "condition": "classifying render or export artifact evidence",
38
+ "delegateTo": "render-export-evidence",
39
+ "reason": "use render-export-evidence"
40
+ },
41
+ {
42
+ "condition": "to fix or edit lights (this skill validates and gives remediation hints only; it never edits)",
43
+ "delegateTo": "scene-readiness",
44
+ "reason": "this skill validates and gives remediation hints only; it never edits"
45
+ }
46
+ ],
47
+ "inputs": {
48
+ "required": [
49
+ {
50
+ "name": "lighting_rig_specification",
51
+ "type": "object",
52
+ "description": "Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan"
53
+ },
54
+ {
55
+ "name": "color_management_pins",
56
+ "type": "object",
57
+ "description": "Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "render_or_preview_exposure_notes",
63
+ "type": "string",
64
+ "description": "Optional highlight clipping or shadow crush observations from preview output"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "lighting_quality_verdict_table",
71
+ "key_fill_rim_and_clipping_audit",
72
+ "lighting_remediation_instructions"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "scene-readiness",
83
+ "type": "progression",
84
+ "label": "Broad readiness review",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "quality.domain",
89
+ "operator": "equals",
90
+ "value": "holistic"
91
+ },
92
+ {
93
+ "field": "stage.current",
94
+ "operator": "equals",
95
+ "value": "quality_validation"
96
+ }
97
+ ]
98
+ }
99
+ },
100
+ {
101
+ "target": "material-quality-checker",
102
+ "type": "upstream_reference",
103
+ "label": "Material validation",
104
+ "when": {
105
+ "all": [
106
+ {
107
+ "field": "quality.domain",
108
+ "operator": "equals",
109
+ "value": "material"
110
+ },
111
+ {
112
+ "field": "quality.verdict",
113
+ "operator": "equals",
114
+ "value": "not_run"
115
+ }
116
+ ]
117
+ }
118
+ },
119
+ {
120
+ "target": "composition-quality-checker",
121
+ "type": "progression",
122
+ "label": "Composition validation",
123
+ "when": {
124
+ "all": [
125
+ {
126
+ "field": "quality.domain",
127
+ "operator": "equals",
128
+ "value": "composition"
129
+ },
130
+ {
131
+ "field": "quality.verdict",
132
+ "operator": "equals",
133
+ "value": "not_run"
134
+ }
135
+ ]
136
+ }
137
+ },
138
+ {
139
+ "target": "lighting-material-plan",
140
+ "type": "retry",
141
+ "label": "Lighting re-plan",
142
+ "when": {
143
+ "all": [
144
+ {
145
+ "field": "quality.domain",
146
+ "operator": "equals",
147
+ "value": "lighting"
148
+ },
149
+ {
150
+ "field": "quality.verdict",
151
+ "operator": "equals",
152
+ "value": "Fail"
153
+ }
154
+ ]
155
+ },
156
+ "retryPolicy": {
157
+ "maxAttempts": 2,
158
+ "exitCondition": {
159
+ "all": [
160
+ {
161
+ "field": "quality.verdict",
162
+ "operator": "in",
163
+ "value": [
164
+ "Pass",
165
+ "Warn"
166
+ ]
167
+ }
168
+ ]
169
+ }
170
+ }
171
+ },
172
+ {
173
+ "target": "render-export-evidence",
174
+ "type": "progression",
175
+ "label": "Render evidence",
176
+ "when": {
177
+ "all": [
178
+ {
179
+ "field": "stage.current",
180
+ "operator": "equals",
181
+ "value": "post_execution_audit"
182
+ }
183
+ ]
184
+ }
185
+ }
186
+ ]
187
+ }
@@ -0,0 +1,48 @@
1
+ # HDRI + explicit-light balance rules
2
+
3
+ HDRIs and explicit lights are not interchangeable. Use them as a system.
4
+
5
+ ## HDRI alone
6
+
7
+ | Use case | Verdict |
8
+ |---|---|
9
+ | Outdoor scene with sky HDRI | Pass |
10
+ | Quick lookdev / preview | Pass (rough check only) |
11
+ | Final product hero | Warn (HDRI alone often lacks key-light snap) |
12
+ | Cinematic narrative shot | Fail (no shaping) |
13
+
14
+ ## HDRI + 3-point key/fill/rim
15
+
16
+ This is the **default for product hero**. HDRI provides ambient + ground reflection; explicit lights shape the subject.
17
+
18
+ Recommended balance:
19
+ - HDRI strength: 0.5–1.2 (subordinate)
20
+ - Key area light: ~50–500W (dominant on subject)
21
+ - Fill: 10–20% of key strength
22
+ - Rim: enough for separation against background (often 50–100% of key)
23
+
24
+ ## Explicit lights only (no HDRI)
25
+
26
+ | Use case | Verdict |
27
+ |---|---|
28
+ | Studio product on solid color seamless | Pass (controlled) |
29
+ | Outdoor scene without sky | Fail (missing ambient) |
30
+ | Cinematic dark mood | Pass (HDRI optional) |
31
+
32
+ ## Fail rules
33
+
34
+ - HDRI strength > 2.0 with explicit lights at studio levels → likely overpowering. Verify intent or Fail.
35
+ - HDRI tint conflicts with key Kelvin (e.g., warm HDRI + cool 7000K key) → Fail unless intentional split lighting.
36
+ - HDRI on but environment-only checkbox off → confusing setup; Warn.
37
+
38
+ ## Common patterns
39
+
40
+ | Pattern | HDRI strength | Key W | Fill ratio | Rim |
41
+ |---|---|---|---|---|
42
+ | Soft hero | 1.0 | 250 | 0.15 | 100W rim |
43
+ | Hard dramatic | 0.3 | 500 | 0.05 | 100W rim |
44
+ | Outdoor daylight | 1.5 | 0 (sun separate) | — | — |
45
+ | Moody / noir | 0.2 | 400 | 0.0 | 50W rim only |
46
+
47
+ ## Related skill
48
+ `../SKILL.md`
@@ -0,0 +1,73 @@
1
+ # Light intensity ranges (sanity reference)
2
+
3
+ These are typical Cycles/Eevee values for common scenarios. Use as plausibility ranges, not hard requirements.
4
+
5
+ ## Sun light (directional)
6
+
7
+ | Scenario | Strength |
8
+ |---|---|
9
+ | Outdoor daylight (overcast) | 1–2 |
10
+ | Outdoor daylight (clear sun) | 2–5 |
11
+ | Sunset / sunrise warm | 1–3 |
12
+ | Moonlight | 0.05–0.3 |
13
+
14
+ ## Area light (W in Cycles, watts-equivalent)
15
+
16
+ | Scenario | Wattage |
17
+ |---|---|
18
+ | Practical (small bulb) | 5–25 W |
19
+ | Tabletop product key | 50–250 W |
20
+ | Studio key (medium soft) | 250–1000 W |
21
+ | Hero product key (large soft) | 500–2000 W |
22
+ | Architectural overhead bank | 1000–5000 W |
23
+
24
+ ## Point light
25
+
26
+ | Scenario | Wattage |
27
+ |---|---|
28
+ | Practical (lamp bulb) | 5–60 W |
29
+ | Visible point glow | up to 200 W |
30
+
31
+ ## Spot light
32
+
33
+ | Scenario | Wattage |
34
+ |---|---|
35
+ | Theater rim spot | 100–500 W |
36
+ | Architectural accent | 50–300 W |
37
+
38
+ ## HDRI environment
39
+
40
+ | Scenario | Strength |
41
+ |---|---|
42
+ | Studio (soft fill) | 0.5–1.2 |
43
+ | Outdoor sun | 0.7–1.5 |
44
+ | Subtle ambient (mood scene) | 0.2–0.5 |
45
+ | Overpowering (likely error) | > 2.0 |
46
+
47
+ ## View transform & color temperature pairing
48
+
49
+ Always judge lighting intensity under the intended target `view_transform`:
50
+
51
+ | View Transform | Best used for | Web / engine parity |
52
+ |---|---|---|
53
+ | **AgX** (Blender 4.0+ default) | Hero renders, high-contrast highlights, realistic rolloff | Pair with `ACESFilmic` / `AgX` tone mapping if targeting realistic web |
54
+ | **Khronos PBR Neutral** | E-commerce products, exact brand color & albedo parity | Direct 1:1 parity with Three.js `THREE.NeutralToneMapping` |
55
+ | **Standard** | 2D UI panels, flat graphic signage, pixel-exact color | No filmic highlight compression |
56
+
57
+ ### Practical Kelvin pairings (contrast without mud)
58
+
59
+ | Contrast pair | Warm key / practical | Cool fill / rim |
60
+ |---|---|---|
61
+ | Studio product | `5200–5600 K` neutral key | `6500–7500 K` subtle cool rim |
62
+ | Moody / cozy interior | `2700–3200 K` practical lamp | `7500–10000 K` sky / window fill |
63
+ | Sci-fi / cyberpunk accent | Accent saturated rim (`cyan / magenta`) | Low-strength neutral fill (`20–35%` key) |
64
+
65
+ ## Verdict guidance
66
+
67
+ - Outside the range → Warn
68
+ - 10× outside the range → Fail
69
+ - Range overlaps with a different scenario → check brief
70
+ - Judging PBR brand colors under extreme Filmic look instead of `Khronos PBR Neutral` or `AgX` → Warn
71
+
72
+ ## Related skill
73
+ `../SKILL.md`
@@ -0,0 +1,38 @@
1
+ # Shadow softness rules
2
+
3
+ Shadow softness is a **system property**: it depends on light size, distance, and the shadowed surface — not just one parameter.
4
+
5
+ ## Light size (area / disc) drives softness
6
+
7
+ - Small light (≤ 0.1m) at 2m distance → hard shadow.
8
+ - Medium light (0.5m) at 2m → softer.
9
+ - Large light (1.5m) at 2m → very soft.
10
+ - HDRI environment → very soft (entire dome contributes).
11
+
12
+ ## Distance affects perceived softness
13
+
14
+ A small light far away looks like a point (hard shadow). A large light close looks soft.
15
+
16
+ ## Mood matching
17
+
18
+ | Mood | Expected shadow style |
19
+ |---|---|
20
+ | Hard / dramatic | Single sharp light, small light size, no fill |
21
+ | Soft hero / studio | Large soft key + soft fill |
22
+ | Cinematic noir | Hard key + minimal fill |
23
+ | Outdoor daylight (clear) | Hard sun shadow + soft fill from sky HDRI |
24
+ | Outdoor daylight (overcast) | Very soft shadows, sky HDRI dominant |
25
+
26
+ ## Fail rules
27
+
28
+ - Brief says "soft hero" but key light size ≤ 0.1m → Fail.
29
+ - Brief says "hard dramatic" but key light size ≥ 1m → Fail.
30
+ - Multiple key-strength lights with conflicting shadow directions → Fail (creates double shadows that read as error).
31
+
32
+ ## Warn rules
33
+
34
+ - Light size exactly at the boundary of soft/hard categories → Warn.
35
+ - Shadow softness depends on contact-shadow vs ray-trace shadow distinction; flag when this is unclear.
36
+
37
+ ## Related skill
38
+ `../SKILL.md`
@@ -0,0 +1,40 @@
1
+ # EVAL — material-quality-checker
2
+
3
+ ## Text-only eval prompt
4
+ Use material-quality-checker on a glTF-mobile scene plan with 5 PBR materials and a 4 MP total texture budget.
5
+
6
+ ## Expected behavior
7
+ - per-material rows (5) with name, type, albedo, normal, roughness/metallic, texture count + resolution, consumer compatibility, verdict, notes
8
+ - top-line status derived from rows
9
+ - worst-offender highlight
10
+ - consumer target stated explicitly
11
+ - evidence label honest (Not Run for text-only)
12
+ - handoff named
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: every row filled with explicit values; top-line correct; no fabricated row
16
+ - Warn: rows mostly filled but one column missing or one verdict ambiguous
17
+ - Fail: marks "Pass" without rule citations, fabricates values, performs material edits, or skips consumer-stack check
18
+
19
+ ## Common failure modes
20
+ - broad summary without per-material rows
21
+ - claiming Verified without measurement
22
+ - mixing lighting / composition checks
23
+ - skipping consumer compatibility column
24
+
25
+ ## Evidence expectations
26
+ - per-row PBR sanity verdicts cited from rules
27
+ - texture budget compared to pinned cap
28
+ - consumer target named
29
+
30
+ ## Sample passing response outline
31
+ - Consumer target + texture budget cap header
32
+ - 5 material rows
33
+ - Top-line: derived from rows
34
+ - Worst offenders: 1-2 named
35
+ - Next: scene-readiness / render-export-evidence
36
+
37
+ ## Sample failing response outline
38
+ - "Materials look good"
39
+ - No per-row analysis
40
+ - Verified label without measurement