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,32 @@
1
+ # EVAL — lighting-material-plan
2
+
3
+ ## Text-only eval prompt
4
+ Use lighting-material-plan to produce detailed lighting/material plan with web portability caveats.
5
+
6
+ ## Expected behavior
7
+ - key/fill/rim logic
8
+ - style-specific notes
9
+ - PBR/web portability caveats
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: complete lookdev plan + caveats
13
+ - Warn: plan usable but caveats shallow
14
+ - Fail: overclaim visual output or no portability logic
15
+
16
+ ## Common failure modes
17
+ - generic “make it cinematic” language only
18
+ - no web constraints
19
+
20
+ ## Evidence expectations
21
+ - structured lookdev plan
22
+ - explicit uncertainty markers
23
+
24
+ ## Sample passing response outline
25
+ - Scope and mode stated clearly
26
+ - Evidence expectations listed
27
+ - Pass/warn/fail reasoning tied to checks
28
+
29
+ ## Sample failing response outline
30
+ - Overclaims runtime/artifact success
31
+ - Missing caveats or blocker details
32
+ - No clear next action
@@ -0,0 +1,194 @@
1
+ ---
2
+ name: lighting-material-plan
3
+ description: Design studio lighting rigs (key/fill/rim ratios, Kelvin pairs) and Principled BSDF materials with AgX/PBR Neutral and glTF portability caveats.
4
+ ---
5
+
6
+ # lighting-material-plan
7
+
8
+ ## Purpose
9
+ Create a high-quality, practical lighting/material plan that balances visual intent and web portability constraints.
10
+
11
+ ## Quick start
12
+ - confirm this skill fits your goal
13
+ - provide required inputs first
14
+ - keep runtime claims evidence-bound
15
+ - follow suggested next-skill handoff
16
+
17
+ ## When to use
18
+ - look-development strategy is needed
19
+ - lighting/material choices drive scene mood
20
+ - web/GLB portability caveats must be explicit
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - to claim final rendered quality or executed results → use `../camera-composition/SKILL.md` (Delegates out-of-scope requests to camera-composition)
25
+ - to skip composition/camera context from camera-composition → use `../camera-composition/SKILL.md` (Delegates out-of-scope requests to camera-composition)
26
+ - to validate existing lighting or materials → use `../lighting-quality-checker/SKILL.md` (use lighting-quality-checker and material-quality-checker)
27
+ - to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision) → use `../color-management-decision/SKILL.md` (output-format-decision)
28
+ - to execute Blender or generate Python scripts → use `../color-management-decision/SKILL.md` (Delegates out-of-scope requests to color-management-decision)
29
+ <!-- blendops:generated:end exclusions -->
30
+
31
+ ## Trigger phrases
32
+ <!-- blendops:generated:start triggers -->
33
+ - "plan lighting and materials"
34
+ - "design cyberpunk lookdev"
35
+ - "define PBR and reflection strategy"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - framing and camera plan received from `camera-composition` when chaining upstream planners (or clear subject and destination context for standalone use)
40
+ - upstream constraints known from `cycles-vs-eevee-decision`, `color-management-decision`, and `output-format-decision` when applicable
41
+ - target delivery context known
42
+
43
+ ## Input schema
44
+
45
+ ### Required inputs
46
+ - style intent
47
+ - subject material constraints
48
+ - output destination
49
+
50
+ ### Optional inputs
51
+ - brand color/style constraints
52
+ - performance budget hints
53
+ - preferred mood references
54
+
55
+ ### Assumptions to confirm
56
+ - realism vs stylized priority
57
+ - reflection intensity tolerance
58
+ - portability strictness for web handoff
59
+
60
+ ## Output schema
61
+
62
+ ### Primary output
63
+ - lighting rig strategy (key/fill/rim, mood accents, reflection behavior) + material lookdev strategy (hierarchy, PBR targets, naming)
64
+
65
+ ### Secondary output
66
+ - portability simplification recommendations
67
+
68
+ ### Evidence / caveat output
69
+ - unverified visual assumptions
70
+ - explicit truth states: `Runtime: Not Run`, `Artifacts: Not Produced` (downgrade-only, never upgrade)
71
+
72
+ ## Required laws
73
+ - ../../laws/evidence-before-done.md
74
+ - ../../laws/non-blender-user-language.md
75
+ - ../../laws/official-runtime-only.md
76
+ - ../../laws/no-arbitrary-python-interface.md
77
+
78
+ ## Official runtime boundary
79
+ This is a planning-only skill: no Blender execution, no Python, and no artifact generation. Runtime status always remains `Not Run` and artifact status always remains `Not Produced` (truth states are downgrade-only, never upgrade). If referencing Eevee engine tokens from upstream `cycles-vs-eevee-decision`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` only for 4.2–4.x — never present Eevee Next as the current name.
80
+
81
+ ## Operating procedure
82
+ 1. Define lighting objective (readability vs drama balance).
83
+ 2. Choose key/fill/rim strategy.
84
+ 3. Add neon/cyberpunk accent pattern where requested.
85
+ 4. Define reflective floor behavior and caveats.
86
+ 5. Choose material classes and hierarchy.
87
+ 6. Define PBR portability assumptions.
88
+ 7. Identify web simplification opportunities.
89
+ 8. Define texture/material naming expectations.
90
+ 9. Add GLB/web handoff caveats.
91
+ 10. Provide user-facing summary with uncertainty markers.
92
+
93
+ ## Decision tree
94
+ - If style is cyberpunk + product clarity required → neon accents + controlled reflections.
95
+ - If web performance priority high → simplify material stack and reflection complexity.
96
+ - If portability uncertain → keep assumptions explicit and request runtime validation.
97
+
98
+ ## Playbooks
99
+ - Playbook A: text-only lookdev planning (`Runtime: Not Run`, `Artifacts: Not Produced`)
100
+ - Playbook B: runtime-ready lookdev planning with verification targets prepared for `lighting-quality-checker` and `material-quality-checker` (`Runtime: Not Run`, `Artifacts: Not Produced`)
101
+ - Playbook C: blocked-runtime conservative lookdev planning with strict portability caveats (`Runtime: Not Run`, `Artifacts: Not Produced`)
102
+
103
+ ## Mode handling
104
+
105
+ ### Text-only mode
106
+ - produce lighting rig and material lookdev plan only
107
+ - report `Runtime: Not Run` and `Artifacts: Not Produced`
108
+
109
+ ### Runtime-ready mode
110
+ - produce lookdev plan and define checklist targets for downstream `lighting-quality-checker` and `material-quality-checker`
111
+ - keep `Runtime: Not Run` and `Artifacts: Not Produced` within this skill
112
+
113
+ ### Blocked runtime mode
114
+ - provide conservative lookdev plan and explicit portability caveats
115
+ - keep `Runtime: Not Run` and `Artifacts: Not Produced` with no rendered output claims
116
+
117
+ ## Validation checklist
118
+ - [ ] key/fill/rim strategy documented
119
+ - [ ] style-specific lighting notes documented
120
+ - [ ] reflective floor caveats documented
121
+ - [ ] material hierarchy documented
122
+ - [ ] PBR portability assumptions documented
123
+ - [ ] web simplification recommendations provided
124
+ - [ ] naming expectations provided
125
+ - [ ] handoff caveats provided
126
+ - [ ] uncertainty markers explicit
127
+ - [ ] no evidence overclaims
128
+
129
+ ## Pass / Warn / Fail rubric
130
+
131
+ | Category | Pass | Warn | Fail |
132
+ |---|---|---|---|
133
+ | Lighting strategy | Clear and goal-aligned | Basic but usable | Missing/contradictory |
134
+ | Material strategy | Coherent and portable-aware | Partial portability | No portability consideration |
135
+ | Web caveats | Explicit and actionable | Present but vague | Missing caveats |
136
+ | Evidence boundary | No visual overclaims | Minor ambiguity | Claims rendered results without evidence |
137
+
138
+ ## Failure handling
139
+ - Missing style detail: request targeted clarification.
140
+ - Conflicting constraints: output option sets with trade-offs.
141
+ - Unknown runtime state: keep plan-only with explicit caveats.
142
+
143
+ ## Troubleshooting
144
+ - Overly harsh reflections: reduce floor reflectance assumptions.
145
+ - Muddy lighting plan: simplify key/fill ratio assumptions.
146
+ - Material complexity too high for web: propose simplification tiers.
147
+
148
+ ## Best practices
149
+ - prioritize readability before stylization extremes
150
+ - map each lookdev decision to user-facing outcome
151
+ - preserve portability caveats explicitly
152
+
153
+ ## Good examples
154
+ “Use key+soft fill for product readability, neon rim accents for mood, and limit reflective floor intensity to avoid detail washout in web contexts.”
155
+
156
+ ## Bad examples
157
+ “Make it look cool with neon materials.” (no constraints, no caveats)
158
+
159
+ ## User-facing response template
160
+ - Lighting plan summary
161
+ - Material plan summary
162
+ - Portability caveats
163
+ - Truth states: `Runtime: Not Run` | `Artifacts: Not Produced`
164
+ - Next handoff step (`lighting-quality-checker`, `material-quality-checker`, `scene-readiness`, `glb-web-handoff`)
165
+
166
+ ## Anti-patterns
167
+ - skipping required laws or runtime boundary statements
168
+ - claiming runtime/artifact success without evidence
169
+ - upgrading truth states above `Runtime: Not Run` or `Artifacts: Not Produced`
170
+ - blurring roles by validating lighting/materials instead of handing off to `lighting-quality-checker` and `material-quality-checker`
171
+ - making render engine, color config, or file format decisions owned by `cycles-vs-eevee-decision`, `color-management-decision`, or `output-format-decision`
172
+ - presenting `BLENDER_EEVEE_NEXT` / Eevee Next as the current Blender 5.x engine name
173
+ - including Python snippets, Blender execution commands, or unhedged jargon
174
+
175
+ ## Cross-skill handoff
176
+ <!-- blendops:generated:start handoffs -->
177
+ - [upstream_reference] Upstream input from (camera-composition) → `../camera-composition/SKILL.md`
178
+ - [progression] Upstream input from (color-management-decision) → `../color-management-decision/SKILL.md`
179
+ - [progression] Upstream input from (cycles-vs-eevee-decision) → `../cycles-vs-eevee-decision/SKILL.md`
180
+ - [progression] Upstream input from (output-format-decision) → `../output-format-decision/SKILL.md`
181
+ - [progression] Next validation (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
182
+ - [progression] Next validation (material-quality-checker) → `../material-quality-checker/SKILL.md`
183
+ - [progression] Then scene check → `../scene-readiness/SKILL.md`
184
+ - [progression] Then delivery → `../glb-web-handoff/SKILL.md`
185
+ <!-- blendops:generated:end handoffs -->
186
+
187
+ ## Non-goals
188
+ - shader/runtime implementation code
189
+ - rendered quality claims without evidence
190
+
191
+ ## References
192
+ - https://www.blender.org/lab/mcp-server/
193
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
194
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
@@ -0,0 +1,213 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "lighting-material-plan",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "lighting-rig-and-lookdev-deep-planner",
7
+ "purpose": "Build detailed lighting and material direction with portability and caveat handling for Blender/web-3D outputs.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "plan lighting and materials",
11
+ "design cyberpunk lookdev",
12
+ "define PBR and reflection strategy"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "to claim final rendered quality or executed results",
17
+ "delegateTo": "camera-composition",
18
+ "reason": "Delegates out-of-scope requests to camera-composition"
19
+ },
20
+ {
21
+ "condition": "to skip composition/camera context from camera-composition",
22
+ "delegateTo": "camera-composition",
23
+ "reason": "Delegates out-of-scope requests to camera-composition"
24
+ },
25
+ {
26
+ "condition": "to validate existing lighting or materials",
27
+ "delegateTo": "lighting-quality-checker",
28
+ "reason": "use lighting-quality-checker and material-quality-checker"
29
+ },
30
+ {
31
+ "condition": "to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision)",
32
+ "delegateTo": "color-management-decision",
33
+ "reason": "output-format-decision"
34
+ },
35
+ {
36
+ "condition": "to execute Blender or generate Python scripts",
37
+ "delegateTo": "color-management-decision",
38
+ "reason": "Delegates out-of-scope requests to color-management-decision"
39
+ }
40
+ ],
41
+ "inputs": {
42
+ "required": [
43
+ {
44
+ "name": "domain_scene_plan",
45
+ "type": "object",
46
+ "description": "Upstream scene layout and subject surface description"
47
+ },
48
+ {
49
+ "name": "camera_framing_plan",
50
+ "type": "object",
51
+ "description": "Locked camera angles and hero silhouette requirements from camera-composition"
52
+ }
53
+ ],
54
+ "optional": [
55
+ {
56
+ "name": "target_render_engine_hint",
57
+ "type": "string",
58
+ "description": "Preferred engine (Cycles, Eevee, or WebGL/GLB PBR export target)"
59
+ }
60
+ ]
61
+ },
62
+ "outputs": {
63
+ "primary": [
64
+ "key_fill_rim_lighting_plan",
65
+ "pbr_material_and_roughness_spec",
66
+ "hdri_and_reflection_strategy"
67
+ ],
68
+ "truthStatePolicy": {
69
+ "runtimeDefault": "Not Run",
70
+ "artifactDefault": "Not Produced",
71
+ "mutationRule": "downgrade_only"
72
+ }
73
+ },
74
+ "handoffs": [
75
+ {
76
+ "target": "camera-composition",
77
+ "type": "upstream_reference",
78
+ "label": "Upstream input from (camera-composition)",
79
+ "when": {
80
+ "all": [
81
+ {
82
+ "field": "brief.locked",
83
+ "operator": "equals",
84
+ "value": true
85
+ },
86
+ {
87
+ "field": "stage.current",
88
+ "operator": "equals",
89
+ "value": "camera_planning"
90
+ }
91
+ ]
92
+ }
93
+ },
94
+ {
95
+ "target": "color-management-decision",
96
+ "type": "progression",
97
+ "label": "Upstream input from (color-management-decision)",
98
+ "when": {
99
+ "all": [
100
+ {
101
+ "field": "decision.colorLocked",
102
+ "operator": "equals",
103
+ "value": false
104
+ }
105
+ ]
106
+ }
107
+ },
108
+ {
109
+ "target": "cycles-vs-eevee-decision",
110
+ "type": "progression",
111
+ "label": "Upstream input from (cycles-vs-eevee-decision)",
112
+ "when": {
113
+ "all": [
114
+ {
115
+ "field": "decision.engineLocked",
116
+ "operator": "equals",
117
+ "value": false
118
+ }
119
+ ]
120
+ }
121
+ },
122
+ {
123
+ "target": "output-format-decision",
124
+ "type": "progression",
125
+ "label": "Upstream input from (output-format-decision)",
126
+ "when": {
127
+ "all": [
128
+ {
129
+ "field": "decision.formatLocked",
130
+ "operator": "equals",
131
+ "value": false
132
+ }
133
+ ]
134
+ }
135
+ },
136
+ {
137
+ "target": "lighting-quality-checker",
138
+ "type": "progression",
139
+ "label": "Next validation (lighting-quality-checker)",
140
+ "when": {
141
+ "all": [
142
+ {
143
+ "field": "quality.domain",
144
+ "operator": "equals",
145
+ "value": "lighting"
146
+ },
147
+ {
148
+ "field": "quality.verdict",
149
+ "operator": "equals",
150
+ "value": "not_run"
151
+ }
152
+ ]
153
+ }
154
+ },
155
+ {
156
+ "target": "material-quality-checker",
157
+ "type": "progression",
158
+ "label": "Next validation (material-quality-checker)",
159
+ "when": {
160
+ "all": [
161
+ {
162
+ "field": "quality.domain",
163
+ "operator": "equals",
164
+ "value": "material"
165
+ },
166
+ {
167
+ "field": "quality.verdict",
168
+ "operator": "equals",
169
+ "value": "not_run"
170
+ }
171
+ ]
172
+ }
173
+ },
174
+ {
175
+ "target": "scene-readiness",
176
+ "type": "progression",
177
+ "label": "Then scene check",
178
+ "when": {
179
+ "all": [
180
+ {
181
+ "field": "quality.domain",
182
+ "operator": "equals",
183
+ "value": "holistic"
184
+ },
185
+ {
186
+ "field": "stage.current",
187
+ "operator": "equals",
188
+ "value": "quality_validation"
189
+ }
190
+ ]
191
+ }
192
+ },
193
+ {
194
+ "target": "glb-web-handoff",
195
+ "type": "progression",
196
+ "label": "Then delivery",
197
+ "when": {
198
+ "all": [
199
+ {
200
+ "field": "artifact.type",
201
+ "operator": "equals",
202
+ "value": "glb"
203
+ },
204
+ {
205
+ "field": "handoff.consumerStack",
206
+ "operator": "equals",
207
+ "value": "web_glb"
208
+ }
209
+ ]
210
+ }
211
+ }
212
+ ]
213
+ }
@@ -0,0 +1,22 @@
1
+ # Cyberpunk & Neon Lookdev Discipline
2
+
3
+ ## Purpose
4
+ Keep high-saturation neon/cyberpunk lighting legible and physically believable so product silhouettes and material breakup stay sharp instead of turning into mud or clipping to white/neon mush.
5
+
6
+ ## When to use
7
+ Whenever a user requests neon, sci-fi, dark studio, cyber-product, or glowing accent lookdev.
8
+
9
+ ## Core Calibration Guardrails
10
+ 1. **Reserve 70%+ neutral anchor**: Keep the base studio rig / ambient key neutral (`4800K–5800K` low-energy directional key) so surface albedo and fabric/metal distinctions remain readable; apply neon (`Cyan #00F0FF`, `Magenta #FF2975`, `Acid Lime`) strictly on rim lights and controlled emissive strips.
11
+ 2. **Emission strength discipline under `AgX`**: Under Blender `AgX` / Three.js `NeutralToneMapping`, high `Emission Strength` (`> 8–20`) naturally desaturates core pixels toward white. Keep crisp saturated accents in `2.0 – 5.5` range (and subtle halo bloom in post/compositor rather than blowing out raw RGB).
12
+ 3. **Never place neon bloom directly behind primary thin typography or edges**: Offset bright emissive geometry cards outside primary silhouette outline or soften into floor bounce.
13
+ 4. **Web GLB portability warning**: Cycles area-mesh bounce illumination and volumetric fog do **not** export inside `.glb`. Plan an explicit fallback for web delivery: crisp emissive texture channel (`emissiveMap`), baked subtle environment light, and optional Three.js `<Bloom luminanceThreshold={1.1} mipmapBlur />` note (`gltf-web-handoff`).
14
+
15
+ ## Good example
16
+ "Uses neutral soft top key (`5400K`, weight 4) to preserve sneaker mesh knit pattern, dual Cyan/Magenta strip rims (`intensity 3.5`) separating sole silhouette, and documented `.glb` emissive-texture + post-bloom fallback."
17
+
18
+ ## Bad example
19
+ "Put blinding purple + pink point lights at power 5000W inside volumetric fog and expect the GLB to look identical in Chrome."
20
+
21
+ ## Related skill
22
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,30 @@
1
+ # Lighting Patterns & Energy Calibration
2
+
3
+ ## Purpose
4
+ Provide reusable lighting rig patterns with explicit energy ratios, softness rules, and web-portability notes for product and prop lookdev planning.
5
+
6
+ ## When to use
7
+ During lighting and material planning before committing to render-engine settings or GLB environment baking.
8
+
9
+ ## Canonical Studio & Mood Patterns
10
+
11
+ | Pattern | Ratio (`Key : Fill : Rim`) | Light Geometry & Softness | Color Temp Pairing | Best Use Case |
12
+ |---|---|---|---|---|
13
+ | **Commercial Clean 3-Point** | `4 : 1 : 2` | Large overhead/45° softbox key (`size 1.5–3m`), gentle broad fill (`5500K`), sharp crisp edge rim | Key `5500K` (Neutral) / Fill `6000K` / Rim `5000K` | E-commerce products, footwear, electronics, white/neutral sweeps |
14
+ | **High-Contrast Editorial** | `8 : 1 : 3` | Narrow directional soft key (`size 0.6–1.0m`), negative fill black card on shadow side, strong graze rim | Key `4800K` warm / Rim `7200K` cool ice | Dramatic launch stills, luxury hardware, anodized metals |
15
+ | **Cool-Key / Warm-Rim Cyberpunk** | `3 : 0.8 : 2.5` | Dual colored rim strips (`Area` bars tight beam spread), soft neutral top fill for legibility | Rim A Cyan `#00E5FF` / Rim B Magenta `#FF2A85` / Subtle Neutral Fill `5200K` | Futuristic footwear, tech props, dark glossy plinths |
16
+ | **Portable IBL / glTF Safe Rig** | Environment HDRI (`strength 0.8–1.4`) + `1–2` simple directional/punctual accents | Minimal area lights translated cleanly into Three.js directional/spot + PMREM HDRI | Matched HDRI dominant temperature | Assets exporting to Web `.glb` where Blender area shapes don't transfer 1:1 |
17
+
18
+ ## Rules Against Flat or Blown-Out Rigs
19
+ - Avoid `1 : 1 : 1` flat equal energy across key/fill/rim — silhouettes lose depth immediately.
20
+ - Never crank a small area light past reasonable dynamic range without checking `False Color` exposure under `AgX` (`<= +2 stops` on hero highlights).
21
+ - Separate dark products from dark studio backgrounds using an explicit Grazing Rim (`backlight` `15°–30°` behind subject).
22
+
23
+ ## Good example
24
+ "Editorial hardware rig uses `6:1:2.5` ratio (`5600K` soft overhead key + dark bounce card + `7000K` crisp right rim) paired with low-intensity subtle neutral HDRI (`0.25`) so Three.js `<Environment>` preview maintains clear specular separation."
25
+
26
+ ## Bad example
27
+ "Add 3 lights around the product to make it bright."
28
+
29
+ ## Related skill
30
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,25 @@
1
+ # Material Portability
2
+
3
+ ## Purpose
4
+ Document shader and material assumptions early in `lighting-material-plan` so Blender Cycles/EEVEE lookdev translates predictably to real-time glTF 2.0 (`.glb`), Three.js, React Three Fiber, Unreal, or Unity without silent visual breakage.
5
+
6
+ ## When to use
7
+ - Whenever the deliverables include `.glb` / Web 3D / real-time engine handoff alongside or instead of offline Cycles stills.
8
+
9
+ ## Blender -> glTF 2.0 Portability Matrix
10
+
11
+ | Feature / Node Pattern | Cycles / EEVEE Offline | glTF 2.0 (`.glb`) / Three.js Behavior | Required Portability Action |
12
+ |---|---|---|---|
13
+ | **Principled BSDF core inputs** (`Base Color`, `Metallic`, `Roughness`, `Normal`, `Emission`) | Native | Supported directly via standard glTF PBR metallic-roughness | Drive directly via uniform values or baked image textures (`sRGB` color, `Non-Color` data) |
14
+ | **Procedural Noise / Voronoi / Musgrave / ColorRamp chains** | Native, infinite resolution | **Dropped silently** on glTF export (`Export failed` or blank default white/grey) | Bake procedural chains to `1024-2048 px` `Image Texture` maps before `.glb` export |
15
+ | **Coat / Transmission / Sheen / Anisotropy** | Native BSDF lobes | Requires `KHR_materials_clearcoat`, `KHR_materials_transmission`, `KHR_materials_sheen`, `KHR_materials_anisotropy` | Verify target viewer supports extension (Three.js `MeshPhysicalMaterial` yes; budget mobile viewers may ignore) |
16
+ | **Subsurface Scattering (SSS) / Custom Shader Math / Mix Shader stacks** | Native Cycles raytrace | Unsupported or approximated poorly in glTF PBR | Replace with baked translucent/tint textures + standard `Principled BSDF` for real-time builds |
17
+ | **Blender 4.x / 5.x `Specular IOR Level` & `Transmission Weight`** | Native | Exported via `KHR_materials_ior` / `KHR_materials_specular` | Keep `IOR = 1.5` default for plastics/organics unless intentionally overriding glass/water (`1.33-1.52`) |
18
+
19
+ ## Handoff Checklist
20
+ 1. Separate **offline-only lookdev layers** (deep SSS, volumetric mist, complex procedural shaders) from **baked real-time web materials**.
21
+ 2. Keep baked material count low (`<= 4-6` materials per hero asset) to stay under `mobile-glb-budget` draw-call limits.
22
+ 3. Explicitly note which KHR material extensions (`clearcoat`, `transmission`, `emissive_strength`) the web viewer must enable.
23
+
24
+ ## Related skill
25
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,22 @@
1
+ # Reflective Floor & Ground Plinth Pattern
2
+
3
+ ## Purpose
4
+ Achieve grounded dark-gloss reflections under hero products without creating noisy fireflies, mirror distraction, or broken contact shadows in web GLB consumers.
5
+
6
+ ## When to use
7
+ Dark studio plinths, glossy showroom floors, cyber-wet slabs, or acrylic pedestals.
8
+
9
+ ## Production Rules
10
+ 1. **Never use mirror-zero roughness (`0.00`)**: Pure mirror reflections duplicate the entire upside-down model and compete visually with the real silhouette. Target base `Roughness = 0.10 – 0.24` with subtle large-scale roughness noise (`±0.05` variation) so reflections smear cleanly toward the viewer.
11
+ 2. **Dark slate albedo bounds (`0.02 – 0.06` linear)**: Keep floor Albedo around `0.025 – 0.05` dark charcoal rather than pure `#000000` black so ambient grazing sheen & floor-to-horizon vignette gradients still read cleanly.
12
+ 3. **Strict `Z = 0` flush contact**: Every floor/plinth hero must touch `Z = 0.0` (or float only when intentional turntable/levitation brief says so, with explicit shadow catcher). Even a `3mm` unintended gap breaks visual weight.
13
+ 4. **Web / glTF Grounding Caveat**: Standard `.glb` meshes do **not** include Blender's procedural shader-node roughness variation unless baked to a roughness map, and real-time Three.js `MeshStandardMaterial` does not trace sharp planar mirror reflections automatically. Flag web handoff choice explicitly (`ContactShadows` + dark matte floor OR Three.js `MeshReflectorMaterial` note).
14
+
15
+ ## Good example
16
+ "Matte-gloss charcoal plinth (`Base Color 0.035`, `Roughness 0.16 ± 0.04` baked noise map), shoe outsole anchored at `Z = 0.000`, with explicit R3F `<ContactShadows>` handoff fallback."
17
+
18
+ ## Bad example
19
+ "`Roughness = 0.0` pitch-black floor mirroring 100% sharp reflection while Cycles renders fireflies."
20
+
21
+ ## Related skill
22
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,23 @@
1
+ # Web Material Simplification
2
+
3
+ ## Purpose
4
+ Define clear material simplification tiers so Blender scenes meet interactive Web 3D (Three.js / React Three Fiber / mobile) size and frame-rate budgets without losing hero visual identity.
5
+
6
+ ## When to use
7
+ - When targeting interactive Web 3D, mobile AR/QuickLook, or multi-product web configurators where `<= 2-10 MB` GLB and `60 fps` frame times matter.
8
+
9
+ ## Three Simplification Tiers
10
+
11
+ | Tier | Target Consumer | Texture & Material Budget | Simplification Rules |
12
+ |---|---|---|---|
13
+ | **Tier 1: High-Fidelity Desktop Showcase** | Desktop WebGL hero landing, studio showcase (`<= 10 MB` GLB) | `<= 6` materials, `2048 px` max textures, KTX2/WebP, Clearcoat & Emissive Strength allowed | Bake complex procedural Blender nodes to ORM (`AO + Roughness + Metallic` packed into R/G/B) + BaseColor + Normal |
14
+ | **Tier 2: Balanced E-Commerce / Responsive Web** | Desktop + mid-range mobile (`<= 5 MB` GLB, `< 1.5s` load) | `<= 4` materials, `1024 px` textures (one `2048 px` allowed for hero logo/sole), Meshopt + WebP/KTX2 | Collapse minor micro-detail bump into single normal map; replace multi-layer transparency with alpha-cutout or simple opacity `Blend` |
15
+ | **Tier 3: Conservative Mobile / AR / Configurator** | Low-end mobile, multi-object catalog grid (`<= 2 MB` GLB, `< 15` draw calls) | `<= 2-3` materials, `512-1024 px` packed atlases, standard glTF metallic-roughness only (no heavy transmission) | Drop `Transmission`/glass refraction (use glossy tinted specular instead); merge static meshes by material; share textures across variants |
16
+
17
+ ## Decision Rule
18
+ 1. Choose **Tier 2** as the default whenever user asks for "web-ready GLB" without specifying desktop-only.
19
+ 2. Drop to **Tier 3** immediately if the product loads in a mobile feed, AR preview, or multi-SKU grid (`product-grid-scene-planner`).
20
+ 3. Always record the chosen Tier and any visual trade-off (e.g., "dropped refractive glass transmission in favor of tinted clearcoat for `60 fps` mobile parity") in the `glb-web-handoff` caveats block.
21
+
22
+ ## Related skill
23
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,41 @@
1
+ # EVAL — lighting-quality-checker
2
+
3
+ ## Text-only eval prompt
4
+ Use lighting-quality-checker on a product-hero scene plan with HDRI + 3-point lighting (key / fill / rim). Mood: soft hero.
5
+
6
+ ## Expected behavior
7
+ - per-light rows (4: HDRI + key + fill + rim) with intensity, color, soft size, verdict
8
+ - mood match assessment
9
+ - top-line status from rows
10
+ - worst-offender highlight
11
+ - consumer target stated
12
+ - evidence label honest
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: full rows + mood match + top-line consistent + no fabricated values
16
+ - Warn: rows present but intensity / mood / HDRI balance ambiguous
17
+ - Fail: mood mismatch undetected, fabricated values, edits attempted
18
+
19
+ ## Common failure modes
20
+ - broad summary without per-light rows
21
+ - ignoring HDRI + explicit-light balance
22
+ - skipping mood match
23
+ - claiming Verified without reference image
24
+
25
+ ## Evidence expectations
26
+ - per-light verdicts with rule citations
27
+ - HDRI strength noted
28
+ - Kelvin or RGB color mode consistent or annotated
29
+
30
+ ## Sample passing response outline
31
+ - Header: consumer + mood
32
+ - 4 light rows
33
+ - HDRI line
34
+ - Mood match
35
+ - Top-line
36
+ - Next handoff
37
+
38
+ ## Sample failing response outline
39
+ - "Lighting looks great"
40
+ - No per-light data
41
+ - Verified without measurement