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,63 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/output-format-decision/SKILL.md and skills/output-format-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # output-format-decision (reference summary)
3
+
4
+ ## Purpose
5
+ Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.
6
+
7
+ Avoid mismatched output formats (e.g., JPEG for VFX, EXR for web, TIFF for social). Match format to consumer pipeline.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/output-format-decision/SKILL.md`
11
+ - **Contract:** `skills/output-format-decision/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `render-and-output-decisions` / `still-animation-and-3d-format-selector`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - when consumer requires specific format
19
+ - when transparency / HDR / loss tolerance matters
20
+
21
+ ## Trigger cues
22
+ - "PNG or JPEG"
23
+ - "do we need EXR"
24
+ - "what format for the web"
25
+
26
+ ## When not to use
27
+ - raw modeling without rendering → delegate to `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
28
+ - 3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff) → delegate to `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`; out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)
29
+ - verifying saved files on disk after rendering → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
30
+
31
+ ## Inputs & output/evidence contract
32
+ ### Required inputs
33
+ - `deliverable_channel_and_use` (`string`): Downstream consumer surface (web hero image, compositing EXR pipeline, turntable video, interactive WebGL)
34
+ - `alpha_and_bit_depth_needs` (`object`): Transparency (straight vs premultiplied alpha) and dynamic range (8-bit, 16-bit, 32-bit float) requirements
35
+
36
+ ### Optional inputs
37
+ - `file_size_ceiling` (`string`): Optional delivery file size cap from mobile-glb-budget or web spec
38
+
39
+ ### Primary outputs
40
+ - `pinned_container_and_codec_spec`
41
+ - `bit_depth_and_alpha_mode_record`
42
+ - `color_space_and_export_verification_hooks`
43
+
44
+ ## Quick-start procedure
45
+ 1. name the consumer
46
+ 2. pick one format per output stream
47
+ 3. pin bit depth + compression + alpha rules
48
+ 4. emit a 4-line config
49
+
50
+ ## Handoff notes
51
+ - **[upstream_reference]** Color management → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
52
+ - **[upstream_reference]** Resolution & aspect ratio → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
53
+ - **[upstream_reference]** Engine choice → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
54
+ - **[progression]** Render file verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
55
+ - **[progression]** 3D / GLB exports (out of scope here) (glb-animation-handoff) → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
56
+ - **[boundary_delegation]** 3D / GLB exports (out of scope here) (mobile-glb-budget) → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
57
+ - **[progression]** 3D / GLB exports (out of scope here) (glb-web-handoff) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** Decision skill — does not run Blender. Pins format; operator applies to scene render output.
61
+ - Convert formats post-render.
62
+ - Run Blender.
63
+ - Compress / re-encode files.
@@ -0,0 +1,74 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/pack-prerequisite-checker/SKILL.md and skills/pack-prerequisite-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # pack-prerequisite-checker (reference summary)
3
+
4
+ ## Purpose
5
+ Verify brief, runtime posture, skill coverage, and evidence habits before starting a BlendOps workflow pack, then emit a Go/No-Go decision and single next skill.
6
+
7
+ Block "half-ready" pack execution: confirm the user's brief, chosen pack/recipe, runtime understanding, and evidence workflow are sufficient to start planners and validators without rework loops.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/pack-prerequisite-checker/SKILL.md`
11
+ - **Contract:** `skills/pack-prerequisite-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `routing-and-governance` / `pack-preflight-readiness-gate`
13
+ - **Capability tier:** `L0`
14
+ - **Routing precedence:** group `entry-and-stage-routing`, rank `3` | activationGate: `goalClarity="clear"`, `recipeSelected=true`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
15
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
16
+
17
+ ## When to use
18
+ - immediately after `recipe-fit-assessor` + `intent-to-3d-brief-writer`
19
+ - before first scene planner for a pack workflow
20
+ - when user jumps mid-pack without status context
21
+
22
+ ## Trigger cues
23
+ - "are we ready to start"
24
+ - "pre-flight for the pack"
25
+ - "what's missing before we build"
26
+ - "check prerequisites"
27
+
28
+ ## When not to use
29
+ - Goal or entry point is ambiguous and no pack is chosen yet → delegate to `blendops-help` (`references/skills/blendops-help.md`; Triages ambiguous entry requests at precedence Rank 1)
30
+ - Evaluating which recipe or pack fits the user's goal → delegate to `recipe-fit-assessor` (`references/skills/recipe-fit-assessor.md`; Scores candidate recipes/packs at precedence Rank 2 before preflight)
31
+ - Workflow is already past preflight with existing stage or artifact inventory → delegate to `workflow-stage-router` (`references/skills/workflow-stage-router.md`; Routes in-flight workflows at precedence Rank 4)
32
+ - Detailed Blender MCP runtime connection preflight → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Inspects Path 1 or Path 2 runtime readiness in detail)
33
+ - Active MCP bridge port or add-on session conflicts → delegate to `bridge-conflicts` (`references/skills/bridge-conflicts.md`; Resolves port 9876 and dual-bridge conflicts)
34
+ - Debugging Blender scene or runtime execution errors → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; Diagnoses runtime or scene failures)
35
+ - Auditing external 3D asset license compliance → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; Performs dedicated asset license and provenance verification)
36
+
37
+ ## Inputs & output/evidence contract
38
+ ### Required inputs
39
+ - `target_pack_id` (`string`): Selected BlendOps pack or recipe identifier (e.g., product-hero-v0)
40
+ - `current_brief_status` (`object`): Current 3D brief completeness across subject, destination, and constraints
41
+
42
+ ### Optional inputs
43
+ - `declared_runtime_posture` (`string`): Whether the session is text-only planning or targets Path 1 / Path 2 / CLI
44
+
45
+ ### Primary outputs
46
+ - `prerequisite_matrix_rows`
47
+ - `go_no_go_verdict`
48
+ - `single_next_skill`
49
+
50
+ ## Quick-start procedure
51
+ 1. identify target pack/recipe
52
+ 2. run checklist rows from `skills/pack-prerequisite-checker/references/prerequisite-matrix.md`
53
+ 3. mark each row Ready / Needs input / Blocked
54
+ 4. only then authorize entry into execution-heavy skills
55
+
56
+ ## Handoff notes
57
+ - **[upstream_reference]** Recipe selection → `recipe-fit-assessor` (`references/skills/recipe-fit-assessor.md`) — `when.all: [recipe.selected equals false]`
58
+ - **[fallback]** Brief completeness → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [brief.complete equals false]`
59
+ - **[conditional]** Runtime detail → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.mode equals "runtime_requested"; runtime.verifiedReady equals false]`
60
+ - **[fallback]** Bridge conflicts → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
61
+ - **[fallback]** Runtime debugging → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
62
+ - **[conditional]** License checks → `asset-license-checker` (`references/skills/asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
63
+ - **[alternative]** Domain planner (product hero when Go) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "product_hero"]`
64
+ - **[alternative]** Domain planner (product grid when Go) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "product_grid"]`
65
+ - **[alternative]** Domain planner (character portrait when Go) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "character_portrait"]`
66
+ - **[alternative]** Domain planner (environment establishing shot when Go) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "environment_shot"]`
67
+ - **[alternative]** Domain planner (interior architectural when Go) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "interior_archviz"]`
68
+
69
+ ## Safety boundaries & non-goals
70
+ - **Runtime boundary:** Preflight gate only — never executes packs, domain planners, or Blender runtime. Uses the 2-path + CLI appendix model per `docs/runtime-stack-strategy.md`:
71
+ - Scoring which recipe or pack fits the user's initial idea (use `recipe-fit-assessor`).
72
+ - Routing active mid-flight workflows that already passed preflight (use `workflow-stage-router`).
73
+ - Writing the 8-slot 3D brief, planning scene geometry/lighting, or auditing asset licenses directly.
74
+ - Running Blender, configuring MCP hosts, or verifying rendered/exported files.
@@ -0,0 +1,66 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/path-one-host-outline/SKILL.md and skills/path-one-host-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # path-one-host-outline (reference summary)
3
+
4
+ ## Purpose
5
+ Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.
6
+
7
+ Outline **Path 1 host surfaces** — **(a)** Anthropic Connector in Claude Desktop vs **(b)** any manually configured MCP client — while making clear that both require the Lab MCP add-on inside **Blender 5.1+** and that the Connector is **never standalone**. This skill provides an outline only; it never configures hosts and never runs Blender.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/path-one-host-outline/SKILL.md`
11
+ - **Contract:** `skills/path-one-host-outline/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `lab-mcp-host-configuration-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - user on Claude Desktop asking what the Anthropic Connector does vs the Blender-side add-on
18
+ - user or agent comparing Path 1 host surfaces: **(a)** Anthropic Connector in Claude Desktop vs **(b)** a manually configured MCP client
19
+ - outlining which components live on the host side vs inside Blender 5.1+ before setup begins
20
+
21
+ ## Trigger cues
22
+ - "Connector vs Cursor MCP"
23
+ - "how do I host Lab MCP"
24
+ - "Claude Desktop Connector vs manual MCP client"
25
+ - "what hosts work with Path 1"
26
+
27
+ ## When not to use
28
+ - choosing between Path 1, Path 2, or CLI → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
29
+ - step-by-step host or add-on installation and configuration → delegate to `runtime-setup` (`references/skills/runtime-setup.md`; Delegates out-of-scope requests to runtime-setup)
30
+ - probing live runtime readiness → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
31
+ - resolving conflicts between official and unofficial bridges → delegate to `bridge-conflicts` (`references/skills/bridge-conflicts.md`; Delegates out-of-scope requests to bridge-conflicts)
32
+ - Path 2 community bridge specifics → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
33
+ - CLI appendix job outlining → delegate to `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`; Delegates out-of-scope requests to cli-appendix-job-outline)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `path_one_host_option` (`string`): Selected Path 1 host mode: option (a) Anthropic Connector in Claude Desktop or option (b) manual MCP client
38
+ - `blender_5_1_addon_posture` (`object`): Confirmation that Official Blender Lab MCP add-on in Blender 5.1+ is required by both host options
39
+
40
+ ### Optional inputs
41
+ - `mcp_client_name` (`string`): Specific MCP client for host option (b) such as Cursor, Claude Code, or Zed
42
+
43
+ ### Primary outputs
44
+ - `path_one_host_architecture_outline`
45
+ - `connector_not_standalone_boundary_check`
46
+ - `host_to_readiness_handoff`
47
+
48
+ ## Quick-start procedure
49
+ 1. confirm Blender 5.1+ target
50
+ 2. choose host category using `skills/path-one-host-outline/references/connector-vs-manual-matrix.md`
51
+ 3. apply reminders from `skills/path-one-host-outline/references/lab-addon-reminders.md`
52
+ 4. emit checklist `skills/path-one-host-outline/references/host-checklist-template.md`
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Path selection → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
56
+ - **[upstream_reference]** Detailed setup and configuration → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
57
+ - **[progression]** Readiness probing → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
58
+ - **[fallback]** Bridge conflicts → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
59
+ - **[progression]** CLI appendix workflows → `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
60
+
61
+ ## Safety boundaries & non-goals
62
+ - **Runtime boundary:** Outline only; never configures hosts and never runs Blender. Path 1 requires the Lab MCP add-on inside **Blender 5.1+** plus a host surface: **(a)** Anthropic Connector in Claude Desktop or **(b)** any manually configured MCP client. The Connector is **never standalone**. Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`; see `docs/unofficial-runtime-bridges.md`) and CLI workflows (`cli-appendix-job-outline`) are out of scope here.
63
+ - Choosing between Path 1, Path 2, and the CLI appendix (owned by `runtime-path-picker`).
64
+ - Performing step-by-step installation or editing host MCP configuration files (owned by `runtime-setup`).
65
+ - Probing whether a live Blender MCP session is currently connected (owned by `runtime-readiness`).
66
+ - Documenting Path 2 community bridge internals or headless CLI batch scripts.
@@ -0,0 +1,70 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/plain-language-response/SKILL.md and skills/plain-language-response/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # plain-language-response (reference summary)
3
+
4
+ ## Purpose
5
+ Convert technical Blender workflow findings into plain-language user-facing responses with honest caveats.
6
+
7
+ Produce stakeholder-friendly outputs that preserve truthfulness, evidence boundaries, and clear next actions.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/plain-language-response/SKILL.md`
11
+ - **Contract:** `skills/plain-language-response/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `plain-language-final-response-translator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - in the final response phase to convert technical findings into plain-language user-facing wording
18
+ - after `render-export-evidence` classifies artifact evidence, validators (such as `scene-readiness`, `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`) supply pass/warn/fail outcomes, `glb-web-handoff` supplies the handoff summary, and `pre-handoff-verification` gates the handoff
19
+ - when translating technical blockers, caveats, and verified/unverified status splits for non-Blender users
20
+
21
+ ## Trigger cues
22
+ - "write final user summary"
23
+ - "explain this for non-Blender user"
24
+ - "make this stakeholder-friendly"
25
+
26
+ ## When not to use
27
+ - to hide blockers, drop caveats for readability, or overclaim runtime or artifact success → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
28
+ - to upgrade Runtime or Artifact truth states → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
29
+ - to classify raw artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
30
+ - to generate technical pass/warn/fail checks → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness or domain quality checkers)
31
+ - to assemble technical GLB/web compatibility summaries → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; use glb-web-handoff)
32
+ - to gate handoff readiness → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; use pre-handoff-verification)
33
+
34
+ ## Inputs & output/evidence contract
35
+ ### Required inputs
36
+ - `verified_workflow_and_evidence_state` (`object`): Final pre-handoff verification gate status, runtime truth state, and artifact truth state
37
+ - `deliverable_summary_inputs` (`object`): Technical outputs from scene planners, quality checkers, or handoff packagers to translate
38
+
39
+ ### Optional inputs
40
+ - `stakeholder_audience_profile` (`string`): Target reader role (product manager, web developer, creative director, end user)
41
+
42
+ ### Primary outputs
43
+ - `plain_language_stakeholder_response`
44
+ - `explicit_runtime_and_artifact_status_block`
45
+ - `jargon_free_next_steps`
46
+
47
+ ## Quick-start procedure
48
+ 1. confirm this skill fits your goal
49
+ 2. provide required inputs first
50
+ 3. keep runtime claims evidence-bound
51
+ 4. follow suggested next-skill handoff
52
+
53
+ ## Handoff notes
54
+ - **[upstream_reference]** Upstream artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
55
+ - **[fallback]** Upstream quality pass/warn/fail validation (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
56
+ - **[fallback]** Upstream quality pass/warn/fail validation (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
57
+ - **[fallback]** Upstream quality pass/warn/fail validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
58
+ - **[fallback]** Upstream quality pass/warn/fail validation (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
59
+ - **[fallback]** Upstream quality pass/warn/fail validation (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
60
+ - **[upstream_reference]** Upstream GLB/web handoff summary → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
61
+ - **[upstream_reference]** Upstream handoff gate check → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
62
+ - **[upstream_reference]** Runtime readiness check when runtime is unverified → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** Never imply runtime success or artifact existence without concrete evidence, never hide blockers, and never drop caveats for readability. Keep Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states strictly downgrade-only — if upstream status language is contradictory, downgrade to safer wording. Keep runtime vocabulary strictly within the 2-path + CLI appendix model. This skill writes final wording only and never executes Python or Blender or replaces upstream evidence, validator, handoff, or gate skills.
66
+ - Dumping raw logs or unexplained 3D jargon as final output
67
+ - Hiding blockers or dropping caveats for readability
68
+ - Upgrading Runtime or Artifact truth states or overclaiming completion
69
+ - Executing Python or Blender
70
+ - Replacing `render-export-evidence` (evidence classification), validators (`scene-readiness`, etc.), `glb-web-handoff` (handoff summary), or `pre-handoff-verification` (handoff gating)
@@ -0,0 +1,71 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/polycount-budget-checker/SKILL.md and skills/polycount-budget-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # polycount-budget-checker (reference summary)
3
+
4
+ ## Purpose
5
+ Validate per-mesh and total-scene triangle counts against the pinned budget; flag worst offenders and topology hints without modeling.
6
+
7
+ Run a focused pass/warn/fail check on per-mesh and total-scene triangle counts vs the pinned budget from `mobile-glb-budget` (or any other pinned budget). Surface worst offenders and basic topology hints without performing modeling.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/polycount-budget-checker/SKILL.md`
11
+ - **Contract:** `skills/polycount-budget-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `quality-validators` / `geometry-and-topology-budget-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - before GLB export
19
+ - after a mesh change request
20
+ - as a sub-check during full quality review
21
+ - when `mobile-glb-budget` is pinned
22
+
23
+ ## Trigger cues
24
+ - "is the polycount okay"
25
+ - "check triangle budget"
26
+ - "what's blowing the budget"
27
+ - "topology issue?"
28
+
29
+ ## When not to use
30
+ - pinning or negotiating the performance budget itself → delegate to `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`; use mobile-glb-budget)
31
+ - material validation → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; use material-quality-checker)
32
+ - lighting validation → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker)
33
+ - composition validation → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
34
+ - broad scene readiness review → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
35
+ - classifying render or export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
36
+ - fixing topology, decimating, or retopologizing (this skill validates; it never edits or models) → delegate to `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`; this skill validates; it never edits or models)
37
+
38
+ ## Inputs & output/evidence contract
39
+ ### Required inputs
40
+ - `scene_geometry_inventory` (`array`): Per-object triangle, vertex, modifier stack, and subdivision level counts
41
+ - `pinned_geometry_budget` (`object`): Target triangle and draw-call ceilings from mobile-glb-budget or brief
42
+
43
+ ### Optional inputs
44
+ - `deformation_or_rig_requirements` (`object`): Optional skeletal deformation or silhouette curvature constraints
45
+
46
+ ### Primary outputs
47
+ - `polycount_and_topology_verdict_table`
48
+ - `top_budget_offenders_ranking`
49
+ - `decimation_or_retopology_remediation_plan`
50
+
51
+ ## Quick-start procedure
52
+ 1. read the pinned budget (per-mesh + total-scene)
53
+ 2. enumerate every mesh in the scene plan or measured scene
54
+ 3. compute per-mesh triangle counts vs per-mesh cap
55
+ 4. compute total-scene triangle count vs total cap
56
+ 5. flag worst offenders + give topology hints (no modeling)
57
+
58
+ ## Handoff notes
59
+ - **[upstream_reference]** Pinned budget source → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
60
+ - **[progression]** Broad readiness review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
61
+ - **[progression]** Artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
62
+ - **[upstream_reference]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
63
+ - **[upstream_reference]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
64
+ - **[upstream_reference]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
65
+
66
+ ## Safety boundaries & non-goals
67
+ - **Runtime boundary:** This skill validates plans or measured scene snapshots. It never decimates, retopologizes, or runs Blender. Hints are advisory.
68
+ - Decimate or retopologize.
69
+ - Generate topology recipes.
70
+ - Replace `scene-readiness`.
71
+ - Run Blender.
@@ -0,0 +1,76 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/pre-handoff-verification/SKILL.md and skills/pre-handoff-verification/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # pre-handoff-verification (reference summary)
3
+
4
+ ## Purpose
5
+ Verification gate before claiming any deliverable is ready. Forces evidence checks (path, file existence, validation notes) per evidence-before-done law. Use before any 'Verified' claim.
6
+
7
+ Run a structured verification pass before any BlendOps output is handed to the user as "ready" or "Verified". Forces explicit evidence checks per the `evidence-before-done` law and downgrades any unsupported claim to a lower truth label.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/pre-handoff-verification/SKILL.md`
11
+ - **Contract:** `skills/pre-handoff-verification/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `final-7-point-release-gate`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - `workflow-stage-router` routes here as the final gate before handoff, or exits here on any failed upstream gate to lock in an honest downgraded truth label
18
+ - `blendops-help` routes a user directly to verify an existing deliverable or evidence claim
19
+ - a planner / executor / response writer says "the output is ready"
20
+ - before saving an evidence file under `docs/evals/path-X-...md` via `runtime-attempt-report` or `render-export-evidence`
21
+ - before answering a user with `Verified` or `Produced` status
22
+ - before tagging a release or confirming whether a claim holds or must be downgraded
23
+ - when the operator is tempted to claim "done" but evidence is fuzzy
24
+
25
+ ## Trigger cues
26
+ - "looks ready, can we ship?"
27
+ - "I think the render is good — verify before sending"
28
+ - "before saving the evidence file..."
29
+ - "is this Verified or do we downgrade?"
30
+ - "confirm whether this claim holds or must be downgraded"
31
+
32
+ ## When not to use
33
+ - the workflow is still in planning / brainstorming / brief stage (no claim to verify yet) → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; no claim to verify yet)
34
+ - the user explicitly asked for a draft, not a verified deliverable → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; Delegates out-of-scope requests to blender-troubleshooting)
35
+ - runtime status is Not Run and the user knows it (no verification needed when Not Run is the explicit state) → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; no verification needed when Not Run is the explicit state)
36
+
37
+ ## Inputs & output/evidence contract
38
+ ### Required inputs
39
+ - `candidate_delivery_package` (`object`): Complete set of planning, quality validation, runtime attempt, and artifact evidence records
40
+ - `proposed_truth_state_claims` (`object`): Proposed Runtime status and Artifact status labels to audit against the 7-point release gate
41
+
42
+ ### Optional inputs
43
+ - `active_blocker_or_failed_gate_notes` (`array`): Any upstream Warn/Fail quality verdicts or unresolved runtime blockers
44
+
45
+ ### Primary outputs
46
+ - `seven_point_release_gate_table`
47
+ - `enforced_downgrade_only_truth_states`
48
+ - `release_clearance_or_remediation_route`
49
+
50
+ ## Quick-start procedure
51
+ 1. read the proposed handoff (response text, artifact list, evidence fields)
52
+ 2. run the 7-point verification checklist
53
+ 3. downgrade any unsupported claim explicitly
54
+ 4. gate handoff on all 7 checks passing or explicit caveats
55
+
56
+ ## Handoff notes
57
+ - **[boundary_delegation]** Entry wiring (blendops-help) → `blendops-help` (`references/skills/blendops-help.md`) — `when.all: [request.scope equals "general_help"]`
58
+ - **[upstream_reference]** Entry wiring (workflow-stage-router) → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
59
+ - **[conditional]** If verdict is Pass (plain-language-response) → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
60
+ - **[upstream_reference]** If verdict is Pass (render-export-evidence) → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
61
+ - **[upstream_reference]** If verdict is Pass (runtime-attempt-report) → `runtime-attempt-report` (`references/skills/runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
62
+ - **[upstream_reference]** scene/asset quality gap (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
63
+ - **[upstream_reference]** scene/asset quality gap (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
64
+ - **[upstream_reference]** scene/asset quality gap (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
65
+ - **[upstream_reference]** scene/asset quality gap (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
66
+ - **[upstream_reference]** scene/asset quality gap (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
67
+ - **[fallback]** runtime/bridge failure (blender-troubleshooting) → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
68
+ - **[fallback]** runtime/bridge failure (runtime-readiness) → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
69
+ - **[fallback]** runtime/bridge failure (bridge-conflicts) → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
70
+
71
+ ## Safety boundaries & non-goals
72
+ - **Runtime boundary:** This skill does not run Blender, mutate scenes, or generate artifacts. It reads the proposed handoff and existing evidence, and either confirms or downgrades the truth label.
73
+ - running Blender
74
+ - generating evidence
75
+ - upgrading claims
76
+ - replacing `render-export-evidence` (that classifies; this gates handoff)
@@ -0,0 +1,62 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/preview-report/SKILL.md and skills/preview-report/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # preview-report (reference summary)
3
+
4
+ ## Purpose
5
+ Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.
6
+
7
+ Standardize how a preview / render / export run's evidence is summarized so that downstream skills (handoff, final response writer) consume a known schema instead of re-parsing free-form text.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/preview-report/SKILL.md`
11
+ - **Contract:** `skills/preview-report/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `stakeholder-preview-packet-formatter`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - after `render-export-evidence` produces measurements
18
+ - before `glb-web-handoff` is composed
19
+ - before `plain-language-response` writes the final summary
20
+
21
+ ## Trigger cues
22
+ - "summarize the render"
23
+ - "write up the export evidence"
24
+ - "what's the preview status"
25
+
26
+ ## When not to use
27
+ - measuring artifacts directly → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence instead)
28
+ - raw debug logs or crash triage → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; use blender-troubleshooting instead)
29
+ - gating handoff readiness → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; use pre-handoff-verification instead)
30
+
31
+ ## Inputs & output/evidence contract
32
+ ### Required inputs
33
+ - `classified_artifact_evidence` (`object`): Verified or Produced artifact evidence record from render-export-evidence
34
+ - `quality_checker_summary` (`object`): Pass/Warn/Fail summary from scene-readiness and specialist validators
35
+
36
+ ### Optional inputs
37
+ - `known_visual_caveats` (`array`): Optional non-blocking visual warnings or pending stakeholder review questions
38
+
39
+ ### Primary outputs
40
+ - `stakeholder_preview_evidence_packet`
41
+ - `truth_state_and_provenance_summary`
42
+ - `pre_handoff_gate_submission`
43
+
44
+ ## Quick-start procedure
45
+ 1. pick the report kind (`preview` / `render` / `export` / `full`)
46
+ 2. copy measured values and truth labels from `render-export-evidence` (downgrade-only, never upgrade)
47
+ 3. attach artifact paths and runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) per row verbatim
48
+ 4. mark unmeasured or unproduced fields as `Not Run` / `Not Produced` (no-run reports are full `Not Run` / `Not Produced` placeholders)
49
+
50
+ ## Handoff notes
51
+ - **[upstream_reference]** Measured evidence input (supplies measurements + truth states) → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
52
+ - **[progression]** Handoff gate (gates handoffs before downstream delivery) → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
53
+ - **[progression]** Web handoff consumer → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
54
+ - **[progression]** Final non-Blender user response consumer → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
55
+ - **[fallback]** Raw debug log triage (out of scope here) → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
56
+
57
+ ## Safety boundaries & non-goals
58
+ - **Runtime boundary:** This skill is documentation only. It never runs Blender, renders, exports, or parses logs (`render-export-evidence` supplies measurements; `blender-troubleshooting` owns raw debug logs). It only formats existing evidence into the canonical schema. If the run did not happen, the report is a full placeholder with every artifact at `Not Run` / `Not Produced`.
59
+ - Run Blender.
60
+ - Render or export.
61
+ - Parse log files (out of scope; consume measurement output of `render-export-evidence`).
62
+ - Promote a label without evidence.
@@ -0,0 +1,72 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/product-grid-scene-planner/SKILL.md and skills/product-grid-scene-planner/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # product-grid-scene-planner (reference summary)
3
+
4
+ ## Purpose
5
+ Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.
6
+
7
+ Translate a multi-product grid intent (e-commerce / catalog / comparison) into a structured scene plan. Distinct from `product-hero-scene-planner` (single product, hero) and `interior-scene` (room scene).
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/product-grid-scene-planner/SKILL.md`
11
+ - **Contract:** `skills/product-grid-scene-planner/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `multi-product-catalog-grid-architect`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - intent is multi-product display (4+ products in same scene)
18
+ - e-commerce catalog grid
19
+ - product comparison view
20
+ - showroom-style grid
21
+
22
+ ## Trigger cues
23
+ - "grid of products"
24
+ - "lineup of"
25
+ - "catalog showing N items"
26
+ - "comparison render"
27
+
28
+ ## When not to use
29
+ - single product hero → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
30
+ - character portrait → delegate to `character-portrait` (`references/skills/character-portrait.md`; use character-portrait)
31
+ - outdoor environment scene → delegate to `environment-shot` (`references/skills/environment-shot.md`; use environment-shot)
32
+ - interior room scene → delegate to `interior-scene` (`references/skills/interior-scene.md`; use interior-scene)
33
+
34
+ ## Inputs & output/evidence contract
35
+ ### Required inputs
36
+ - `locked_3d_brief` (`object`): Locked 3D brief specifying product lineup count, grid rows/columns, and comparison goal
37
+ - `product_variant_inventory` (`array`): List of product SKUs or variants with real-world dimensions for relative scale normalization
38
+
39
+ ### Optional inputs
40
+ - `catalog_aspect_and_margin_rules` (`object`): Optional e-commerce card aspect ratio and uniform padding requirements
41
+
42
+ ### Primary outputs
43
+ - `multi_product_grid_layout_matrix`
44
+ - `scale_normalization_and_spacing_spec`
45
+ - `uniform_catalog_camera_and_lighting_hooks`
46
+
47
+ ## Quick-start procedure
48
+ 1. pin product list (count + per-product type and relative real-world size)
49
+ 2. normalize product scale across cells (or split incompatible scales into separate grids)
50
+ 3. pin grid layout (rows × cols + spacing)
51
+ 4. pin per-cell consistency level (strict / loose for camera angle, lighting, background)
52
+ 5. pin shared material / lighting / background palette
53
+ 6. record assumptions register and hand off to asset discovery, format decision, and quality checkers
54
+
55
+ ## Handoff notes
56
+ - **[upstream_reference]** Upstream brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
57
+ - **[upstream_reference]** Single hero product alternative → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
58
+ - **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
59
+ - **[progression]** Variant / SKU file output format → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
60
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
61
+ - **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
62
+ - **[progression]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
63
+ - **[progression]** Overall scene quality validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
64
+ - **[upstream_reference]** Catalog sign-off & stop conditions (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
65
+ - **[upstream_reference]** Catalog sign-off & stop conditions (done-criteria) → `done-criteria` (`references/skills/done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
66
+
67
+ ## Safety boundaries & non-goals
68
+ - **Runtime boundary:** Planning-only skill — does not run Blender, model, source assets, or render. Runtime status must remain `Not Run` and Artifact status must remain `Not Produced` (truth states are downgrade-only, never upgrade). Hand off asset needs to `asset-discovery`, file output rules to `output-format-decision`, and validation to quality checkers.
69
+ - Model the products.
70
+ - Source the products.
71
+ - Render.
72
+ - Run Blender.