blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/product-hero-scene-planner/SKILL.md and skills/product-hero-scene-planner/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # product-hero-scene-planner (reference summary)
3
+
4
+ ## Purpose
5
+ Generate a complete product-hero scene plan from non-Blender-user intent with explicit assumptions and gates.
6
+
7
+ Turn user intent or an upstream brief into a complete, plain-language product-hero scene plan (subject, composition, camera, lighting, material, environment, plus render, export, and web-handoff intent) before any runtime phase.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/product-hero-scene-planner/SKILL.md`
11
+ - **Contract:** `skills/product-hero-scene-planner/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `single-product-hero-scene-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
+ - single product-hero scene planning from user intent or an `intent-to-3d-brief-writer` brief
18
+ - pre-runtime structural planning across subject, camera, composition, lighting, material, environment, and delivery intent
19
+ - translating non-Blender product presentation goals into an assumption-tracked scene plan
20
+
21
+ ## Trigger cues
22
+ - "plan a product hero scene"
23
+ - "turn this into a Blender plan"
24
+ - "prepare cyberpunk shoe scene plan"
25
+
26
+ ## When not to use
27
+ - to execute Blender commands, write Python, or claim generated artifacts → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
28
+ - to skip unresolved critical ambiguity or hide missing inputs → delegate to `camera-composition` (`references/skills/camera-composition.md`; Delegates out-of-scope requests to camera-composition)
29
+ - when raw user intent still needs initial brief normalization → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; use intent-to-3d-brief-writer first)
30
+ - when planning a multi-item catalog or grid layout → delegate to `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`; use product-grid-scene-planner)
31
+ - when deep-diving camera/framing mechanics → delegate to `camera-composition` (`references/skills/camera-composition.md`; use lighting-material-plan)
32
+ - when writing measurable pass/fail acceptance tables → delegate to `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`; use scene-readiness)
33
+
34
+ ## Inputs & output/evidence contract
35
+ ### Required inputs
36
+ - `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining the hero product, hero feature callout, mood, and output channel
37
+ - `sourced_product_asset_status` (`object`): Hero product model posture and material readiness from asset-discovery
38
+
39
+ ### Optional inputs
40
+ - `pack_context` (`string`): Optional pack reference such as packs/product-hero-v0/PACK.md
41
+
42
+ ### Primary outputs
43
+ - `hero_product_staging_and_pedestal_plan`
44
+ - `camera_and_lookdev_handoff_inputs`
45
+ - `scene_quality_validation_hooks`
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 input (if raw prompt needs structuring) → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
55
+ - **[progression]** Next (deep-dive framing & camera) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
56
+ - **[progression]** Next (deep-dive lookdev & lighting) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
57
+ - **[fallback]** Then (measurable pass/fail rows) → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
58
+ - **[upstream_reference]** Then (pin done condition) → `done-criteria` (`references/skills/done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
59
+ - **[progression]** Later (post-build readiness review) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
60
+ - **[conditional]** Delivery handoff (when web/render output is targeted) (glb-web-handoff) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
61
+ - **[conditional]** Delivery handoff (when web/render output is targeted) (render-export-evidence) → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
62
+
63
+ ## Safety boundaries & non-goals
64
+ - **Runtime boundary:** Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. - Runtime truth state must remain `Not Run` (from canonical states `Not Run | Attempted | Produced | Verified | Failed`). - Artifact truth state must remain `Not Produced` (downgrade-only, never upgrade). - When a live scene exists, consume read-only inspection results (`get_objects_summary`) rather than assuming object dimensions, without executing scene mutations.
65
+ - executing Blender commands, MCP mutations, or CLI jobs
66
+ - writing Python scripts
67
+ - claiming `Attempted`, `Produced`, or `Verified` runtime/artifact states
68
+ - replacing `intent-to-3d-brief-writer` (upstream brief), `camera-composition` (deep framing), `lighting-material-plan` (deep lookdev), `acceptance-criteria-builder` (measurable acceptance rows), `done-criteria` (done conditions), or `scene-readiness` (readiness review)
@@ -0,0 +1,66 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/r3f-component-plan/SKILL.md and skills/r3f-component-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # r3f-component-plan (reference summary)
3
+
4
+ ## Purpose
5
+ Plan the React Three Fiber component shape (props, refs, Suspense, useGLTF cache, animation hooks) before delivering a GLB to a web team.
6
+
7
+ Translate a planned GLB delivery into the exact public surface a React Three Fiber component should expose, so the web engineer's contract is locked before code is written.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/r3f-component-plan/SKILL.md`
11
+ - **Contract:** `skills/r3f-component-plan/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `r3f-component-contract-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
+ - the GLB will ship to a web app using React Three Fiber
18
+ - before the web team writes the component
19
+ - when "I'll just import the GLB" needs more rigor (multiple clips, prop overrides, lazy loading)
20
+
21
+ ## Trigger cues
22
+ - "how should the React component look"
23
+ - "what props should I expose"
24
+ - "ref shape for the model"
25
+ - "we use react-three-fiber"
26
+
27
+ ## When not to use
28
+ - consumers using vanilla Three.js (different API) → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; different API)
29
+ - consumers using Babylon / model-viewer (different stack) → delegate to `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`; different stack)
30
+ - the GLB is rendered server-side (e.g. AR pre-render); no React component needed → delegate to `plain-language-response` (`references/skills/plain-language-response.md`; Delegates out-of-scope requests to plain-language-response)
31
+
32
+ ## Inputs & output/evidence contract
33
+ ### Required inputs
34
+ - `glb_delivery_contract` (`object`): Locked GLB node hierarchy, material slots, and compression spec from glb-web-handoff
35
+ - `r3f_version_and_use_case` (`object`): Target @react-three/fiber major version (8 vs 9) and interactive component use case
36
+
37
+ ### Optional inputs
38
+ - `animation_clip_contract` (`object`): Optional clip names, triggers, and crossfade rules from glb-animation-handoff
39
+
40
+ ### Primary outputs
41
+ - `r3f_component_props_and_ref_spec`
42
+ - `suspense_caching_and_dispose_contract`
43
+ - `consumer_call_site_usage_outline`
44
+
45
+ ## Quick-start procedure
46
+ 1. enumerate the props the consumer needs (color, animation name, scale, onLoaded)
47
+ 2. decide ref shape (forwardRef, imperative methods)
48
+ 3. decide Suspense boundary location
49
+ 4. decide useGLTF caching + cleanup strategy
50
+ 5. decide animation hook contract (auto-play, manual control)
51
+
52
+ ## Handoff notes
53
+ - **[upstream_reference]** Animation contract → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
54
+ - **[upstream_reference]** Performance budget ceilings → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
55
+ - **[upstream_reference]** Color and material checks (color-management-decision) → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
56
+ - **[upstream_reference]** Color and material checks (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
57
+ - **[upstream_reference]** Web delivery packaging → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
58
+ - **[progression]** Final user-facing response → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
59
+
60
+ ## Safety boundaries & non-goals
61
+ - **Runtime boundary:** This skill produces **planning specs only**. It does not generate component code, run a web app, or claim that the resulting component will perform correctly without measured load tests. Web-side implementation is owned by the consumer team.
62
+ - Generate React or Three.js component implementation code.
63
+ - Run web apps or execute React Three Fiber at runtime.
64
+ - Claim or verify web runtime performance.
65
+ - Upgrade truth states (web runtime belongs to the consumer team, not BlendOps).
66
+ - Own animation contracts, performance budgets, color/material validation, or web delivery packaging.
@@ -0,0 +1,75 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/recipe-fit-assessor/SKILL.md and skills/recipe-fit-assessor/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # recipe-fit-assessor (reference summary)
3
+
4
+ ## Purpose
5
+ Score whether a user's 3D goal fits an existing BlendOps recipe or pack, or needs custom decomposition, and name the exact next skill.
6
+
7
+ Map a user's stated goal to the closest documented BlendOps recipe or pack before expensive planning or runtime work, returning a fit verdict (`Strong` / `Partial` / `Poor`), rationale, explicit gap list, and **one** recommended next skill. This skill is planning-only and never runs Blender, packs, or runtime.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/recipe-fit-assessor/SKILL.md`
11
+ - **Contract:** `skills/recipe-fit-assessor/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `routing-and-governance` / `recipe-and-pack-selector`
13
+ - **Capability tier:** `L0`
14
+ - **Routing precedence:** group `entry-and-stage-routing`, rank `2` | activationGate: `goalClarity="clear"`, `recipeSelected=false`, `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
+ - user asks "which recipe / pack fits my idea"
19
+ - scope drifts between product hero, portrait, interior, web GLB, batch renders
20
+ - before locking `intent-to-3d-brief-writer` output to a pack
21
+
22
+ ## Trigger cues
23
+ - "what recipe should I use"
24
+ - "does product hero fit"
25
+ - "closest workflow for X"
26
+ - "which pack"
27
+
28
+ ## When not to use
29
+ - Diverging raw creative ideas before a delivery shape exists → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; Explores creative directions and clarifies vague ideas before recipe selection)
30
+ - General entry routing across BlendOps when the goal itself is unclear → delegate to `blendops-help` (`references/skills/blendops-help.md`; Handles ambiguous entry triage at precedence Rank 1)
31
+ - Checking whether a selected pack's preflight prerequisites are met → delegate to `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`; Evaluates preflight readiness once the recipe/pack is already selected)
32
+ - Picking the next workflow stage after preflight passed and artifacts already exist → delegate to `workflow-stage-router` (`references/skills/workflow-stage-router.md`; Routes active in-flight workflows at precedence Rank 4)
33
+ - Writing the structured 8-slot 3D brief after recipe fit is settled → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Authors the formal brief after recipe fit is determined)
34
+ - Detailed scene planning once a domain and brief are locked → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Builds the domain-specific scene plan after preflight passes)
35
+ - Runtime setup, path selection, or bridge conflict troubleshooting → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Handles MCP runtime selection and setup outside recipe scoring)
36
+ - Legal or asset license verification → delegate to `asset-license-checker` (`references/skills/asset-license-checker.md`; Audits asset provenance and license compatibility)
37
+
38
+ ## Inputs & output/evidence contract
39
+ ### Required inputs
40
+ - `user_goal_summary` (`string`): Plain-language 3D goal and intended deliverable subject
41
+ - `target_output_destination` (`string`): Target format or channel (e.g., hero still, catalog grid, turntable, web GLB)
42
+
43
+ ### Optional inputs
44
+ - `candidate_pack_hint` (`string`): Optional pack or recipe the user is considering
45
+
46
+ ### Primary outputs
47
+ - `recipe_fit_verdict`
48
+ - `candidate_comparison_table`
49
+ - `recommended_next_skill`
50
+
51
+ ## Quick-start procedure
52
+ 1. capture goal + constraints + deliverables
53
+ 2. compare against catalog rows in `skills/recipe-fit-assessor/references/recipe-catalog.md`
54
+ 3. assign fit verdict (Strong / Partial / Poor)
55
+ 4. list gap fixes or recommend a different workflow entrypoint
56
+
57
+ ## Handoff notes
58
+ - **[upstream_reference]** Upstream creative divergence → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
59
+ - **[boundary_delegation]** General entry routing → `blendops-help` (`references/skills/blendops-help.md`) — `when.all: [request.scope equals "general_help"]`
60
+ - **[conditional]** Multi-deliverable scope split when prompt spans multiple incompatible recipes → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
61
+ - **[progression]** Downstream structured brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [fit.verdict in ["strong_fit","partial_fit"]; brief.locked equals false]`
62
+ - **[progression]** Pack prerequisite verification → `pack-prerequisite-checker` (`references/skills/pack-prerequisite-checker.md`) — `when.all: [fit.verdict equals "strong_fit"; brief.locked equals true]`
63
+ - **[conditional]** Post-artifact stage routing → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
64
+ - **[alternative]** Domain scene planner (product hero) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
65
+ - **[alternative]** Domain scene planner (product grid) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
66
+ - **[alternative]** Domain scene planner (character portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
67
+ - **[alternative]** Domain scene planner (environment establishing shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
68
+ - **[alternative]** Domain scene planner (interior architectural) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
69
+
70
+ ## Safety boundaries & non-goals
71
+ - **Runtime boundary:** Planning-only skill. Does not configure MCP, Blender, or hosts. When mentioning runtime, use the 2-path + CLI appendix model from `docs/runtime-stack-strategy.md` only as context for whether a workflow expects interactive MCP vs batch CLI — never claim runtime success.
72
+ - Brainstorming open-ended creative concepts before a goal exists (use `blender-brainstorming`).
73
+ - Authoring the locked 8-slot 3D brief (use `intent-to-3d-brief-writer`).
74
+ - Running the 7-row pack preflight gate (use `pack-prerequisite-checker`).
75
+ - Selecting MCP runtime paths, configuring Blender, or verifying rendered/exported artifacts.
@@ -0,0 +1,70 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/render-export-evidence/SKILL.md and skills/render-export-evidence/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # render-export-evidence (reference summary)
3
+
4
+ ## Purpose
5
+ Verify preview/render/GLB artifact truth by recording commands, inputs, output paths, file existence, validation notes, limitations, and conservative status labels.
6
+
7
+ Classify preview, render, `.blend`, and GLB/export evidence into a conservative, one-row-per-artifact-type evidence ledger.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/render-export-evidence/SKILL.md`
11
+ - **Contract:** `skills/render-export-evidence/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `artifact-truth-and-provenance-auditor`
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
+ - a user asks whether a preview, render, `.blend`, or GLB/export was actually produced or verified
18
+ - an agent needs to classify raw runtime outputs into a structured, one-row-per-artifact-type evidence ledger
19
+ - a runtime attempt (`runtime-attempt-report`) recorded commands, tools, or output files that need artifact status labels
20
+ - `pre-handoff-verification` or `preview-report` requires classified artifact truth labels as input
21
+
22
+ ## Trigger cues
23
+ - "Did the render produce?"
24
+ - "Can I claim the GLB exists?"
25
+ - "Verify export evidence."
26
+ - "What artifact status should this have?"
27
+ - "Summarize preview/render/GLB evidence."
28
+
29
+ ## When not to use
30
+ - the user only needs a scene plan with no runtime or artifact evidence → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
31
+ - runtime readiness or path selection has not been completed and the user wants setup or routing; use runtime-readiness or runtime-path-picker → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
32
+ - the task is gating a handoff via confirm-or-downgrade rules; use pre-handoff-verification → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; Delegates out-of-scope requests to pre-handoff-verification)
33
+ - the task is rendering the formatted preview/eval report Markdown; use preview-report → delegate to `preview-report` (`references/skills/preview-report.md`; Delegates out-of-scope requests to preview-report)
34
+ - the task is GLB web integration after evidence is already classified and gated; use glb-web-handoff → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `candidate_artifact_records` (`array`): Reported file paths, byte sizes, SHA-256 digests, and inspection outputs for renders or GLBs
39
+ - `runtime_execution_trace` (`object`): Factual runtime attempt record indicating whether Blender actually ran
40
+
41
+ ### Optional inputs
42
+ - `glb_inspector_or_validator_report` (`object`): Optional output from scripts/inspect-glb.mjs or Khronos gltf-validator
43
+
44
+ ### Primary outputs
45
+ - `artifact_truth_state_ledger`
46
+ - `downgrade_only_evidence_classification`
47
+ - `missing_evidence_remediation_checklist`
48
+
49
+ ## Quick-start procedure
50
+ 1. Identify the runtime state (`Not Run | Attempted | Produced | Verified | Failed`) and list one ledger row per claimed artifact type.
51
+ 2. Collect command/tool (plus exact command and exit code for CLI), input/script/scene, output path, current-run provenance, file existence, validation notes, and limitations.
52
+ 3. Assign the most conservative valid artifact status (`Not Run | Not Produced | Produced | Verified | Failed`, defaulting to `Not Produced`, downgrade-only) and label any Path 2 evidence as `non-release`.
53
+ 4. Pass the classified ledger to `pre-handoff-verification` to gate handoffs, `preview-report` to render report Markdown, `glb-web-handoff` for web integration, or `plain-language-response` for plain-language user responses.
54
+
55
+ ## Handoff notes
56
+ - **[upstream_reference]** Runtime readiness → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
57
+ - **[upstream_reference]** Runtime attempt recording → `runtime-attempt-report` (`references/skills/runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
58
+ - **[upstream_reference]** Scene validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
59
+ - **[progression]** Handoff gating (confirm-or-downgrade) → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
60
+ - **[progression]** Report Markdown rendering → `preview-report` (`references/skills/preview-report.md`) — `when.all: [stage.current equals "report_formatting"; handoff.consumerStack equals "stakeholder_report"]`
61
+ - **[progression]** GLB/web handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
62
+ - **[progression]** User-facing explanation → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** This skill classifies evidence from the 2-path + CLI appendix runtime model (see `docs/runtime-stack-strategy.md`):
66
+ - Run Blender, render images, export GLB, or modify scene data.
67
+ - Install or configure runtime bridges.
68
+ - Gate handoffs or perform confirm-or-downgrade release decisions (`pre-handoff-verification`).
69
+ - Render the formatted preview or evaluation report Markdown (`preview-report`).
70
+ - Own GLB web integration handoffs (`glb-web-handoff`).
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/resolution-aspect-decision/SKILL.md and skills/resolution-aspect-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # resolution-aspect-decision (reference summary)
3
+
4
+ ## Purpose
5
+ Pick the right render resolution + aspect ratio for the consumer use case before render; avoid render-then-crop and aspect mismatch.
6
+
7
+ Avoid the most common render planning mistake: rendering at one aspect / resolution and cropping or upscaling to fit. Pick the consumer's required output upfront.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/resolution-aspect-decision/SKILL.md`
11
+ - **Contract:** `skills/resolution-aspect-decision/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `render-and-output-decisions` / `resolution-and-aspect-ratio-pinner`
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 aspect / resolution
19
+ - before composition planning (aspect drives composition rules)
20
+
21
+ ## Trigger cues
22
+ - "what resolution"
23
+ - "how big should the render be"
24
+ - "16:9 or square"
25
+
26
+ ## When not to use
27
+ - after render is complete (no benefit) → delegate to `camera-composition` (`references/skills/camera-composition.md`; no benefit)
28
+ - pure modeling → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
29
+ - internal preview-only renders (any reasonable size works) → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; any reasonable size works)
30
+
31
+ ## Inputs & output/evidence contract
32
+ ### Required inputs
33
+ - `target_delivery_surfaces` (`array`): Target display placements (desktop hero banner, mobile portrait feed, 1:1 e-commerce card, 4K print)
34
+ - `framing_and_crop_strategy` (`string`): Whether deliverables use a single master aspect ratio with safe-zone crops or separate camera setups
35
+
36
+ ### Optional inputs
37
+ - `render_time_constraints` (`string`): Optional render time ceiling influencing pixel dimensions and percentage scale
38
+
39
+ ### Primary outputs
40
+ - `pinned_pixel_dimensions_and_aspect_ratio`
41
+ - `safe_frame_and_overscan_margins`
42
+ - `camera_sensor_fit_alignment_notes`
43
+
44
+ ## Quick-start procedure
45
+ 1. Identify the consumer use case and target placement (web hero, social feed, print, app asset).
46
+ 2. Pick the delivery aspect ratio (`W:H`) upfront so camera framing matches target placement.
47
+ 3. Pick exact render resolution (`W × H` in pixels) and `DPI / PPI` for print deliverables.
48
+ 4. Define per-stream resolution records if multiple delivery targets exist.
49
+ 5. Pin the record for the operator to enter in Blender scene render properties (no rendering, no post-render resizing).
50
+
51
+ ## Handoff notes
52
+ - **[upstream_reference]** Camera & composition planning (upstream framing setup) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
53
+ - **[progression]** Composition framing validation against pinned aspect → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
54
+ - **[upstream_reference]** Color configuration decision → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
55
+ - **[progression]** Container / codec decision → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
56
+ - **[progression]** Render engine decision → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
57
+ - **[progression]** Post-render saved file verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** Decision skill — does not render. Pins resolution + aspect; operator applies in scene render properties.
61
+ - Never execute Blender or trigger renders.
62
+ - Never resize, crop, upscale, or convert images post-render (belongs outside this skill).
63
+ - Never choose file containers, codecs, or bit depths (`output-format-decision`).
64
+ - Never configure color spaces or HDR view transforms (`color-management-decision`).
65
+ - Never validate camera composition (`composition-quality-checker`) or verify rendered output files (`render-export-evidence`).
@@ -0,0 +1,67 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-attempt-report/SKILL.md and skills/runtime-attempt-report/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # runtime-attempt-report (reference summary)
3
+
4
+ ## Purpose
5
+ Produce an evidence-bound runtime attempt report with truth labels and next steps; does not certify upstream stack success.
6
+
7
+ Record a chronological, secret-free runtime attempt log—including version stamps, downgrade-only truth labels, and routed next steps—for Path 1, Path 2, or CLI appendix runs. A report produced by this skill can serve as an in-repo provenance record under `docs/evals/`, without certifying artifact quality or diagnosing runtime defects.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/runtime-attempt-report/SKILL.md`
11
+ - **Contract:** `skills/runtime-attempt-report/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `execution-attempt-provenance-logger`
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 any Blender connect attempt (success or failure)
18
+ - preparing notes for `docs/evals/` style provenance
19
+ - teaching non-technical stakeholders what actually occurred
20
+
21
+ ## Trigger cues
22
+ - "write up what we tried"
23
+ - "runtime attempt log"
24
+ - "postmortem blender connect"
25
+ - "evidence report template"
26
+
27
+ ## When not to use
28
+ - Classifying rendered or exported visual artifacts (render-export-evidence) → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; render-export-evidence)
29
+ - Diagnosing systematic runtime or scene defects (blender-troubleshooting) → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; blender-troubleshooting)
30
+ - Running pre-attempt environment checks (runtime-readiness) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; runtime-readiness)
31
+ - Selecting which runtime path to use before an attempt (runtime-path-picker) → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; runtime-path-picker)
32
+ - Performing final release or delivery gating (pre-handoff-verification) → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; pre-handoff-verification)
33
+
34
+ ## Inputs & output/evidence contract
35
+ ### Required inputs
36
+ - `attempted_runtime_path_and_host` (`object`): Path 1, Path 2, or CLI appendix route and MCP host configuration used during the attempt
37
+ - `chronological_execution_log` (`array`): Timestamped sequence of read-only or mutation tool calls, responses, and observed outcomes
38
+ - `version_stamps` (`object`): Exact Blender version, add-on version, and MCP client version strings
39
+
40
+ ### Optional inputs
41
+ - `pre_mutation_backup_record` (`object`): Optional .blend checkpoint backup metadata if an L1+ mutation was attempted
42
+
43
+ ### Primary outputs
44
+ - `structured_runtime_attempt_report_md`
45
+ - `locked_runtime_and_artifact_truth_labels`
46
+ - `eval_evidence_archival_path`
47
+
48
+ ## Quick-start procedure
49
+ 1. gather timestamps, commands/config surfaces touched (no secrets)
50
+ 2. choose blocks from `skills/runtime-attempt-report/references/truth-label-blocks.md`
51
+ 3. fill `skills/runtime-attempt-report/references/attempt-record-template.md`
52
+ 4. route improvements via `skills/runtime-attempt-report/references/triage-next-steps.md`
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Pre-attempt readiness check → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
56
+ - **[upstream_reference]** Runtime path selection context → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
57
+ - **[fallback]** Bridge / port / host conflicts → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
58
+ - **[fallback]** Runtime or scene defect diagnosis → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
59
+ - **[progression]** Artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
60
+ - **[fallback]** Final handoff gate & failure exit → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** Documentation skill only—never executes Blender or generates Python. Reports must strictly preserve upstream runtime distinctions: - **Path 1**: Official Blender Lab MCP in Blender 5.1+, hosted from (a) Anthropic Connector or (b) manual MCP client. The Connector is NOT standalone. - **Path 2**: Community `mcp-for-blender` (third-party, Blender 3.0+); document only with explicit caveats and never treat as release evidence. - **CLI fallback**: Appendix only (`blender --background --python`); remains upstream-documented with no in-repo evidence file unless a report written by this skill becomes one under `docs/evals/`.
64
+ - Executing Blender, running MCP commands, or writing Python scripts.
65
+ - Certifying visual artifact quality or export integrity (owned by `render-export-evidence`).
66
+ - Diagnosing runtime crashes, bridge conflicts, or scene errors (owned by `blender-troubleshooting` and `bridge-conflicts`).
67
+ - Approving final delivery packages without passing through `pre-handoff-verification`.
@@ -0,0 +1,67 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-path-picker/SKILL.md and skills/runtime-path-picker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # runtime-path-picker (reference summary)
3
+
4
+ ## Purpose
5
+ Choose Path 1 Lab MCP, Path 2 mcp-for-blender bridge, or CLI appendix from constraints; Connector hosts Path 1 only with Lab add-on inside Blender.
6
+
7
+ Produce a **single primary** runtime execution choice among Path 1 (Blender Lab MCP), Path 2 (community `mcp-for-blender` (formerly `ahujasid/blender-mcp`)), or the CLI fallback appendix — with explicit tradeoffs and no false "standalone Connector" claims.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/runtime-path-picker/SKILL.md`
11
+ - **Contract:** `skills/runtime-path-picker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `execution-path-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
+ - user unsure Lab vs community vs CLI
18
+ - environment pinned to Blender below 5.1 (Path 1 unavailable)
19
+ - automation / batch render discussion
20
+
21
+ ## Trigger cues
22
+ - "which MCP should I use"
23
+ - "Lab MCP or mcp-for-blender"
24
+ - "Path 1 or Path 2"
25
+ - "CLI vs MCP"
26
+
27
+ ## When not to use
28
+ - prerequisite framing or install steps → delegate to `runtime-setup` (`references/skills/runtime-setup.md`; Delegates out-of-scope requests to runtime-setup)
29
+ - running the readiness matrix → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
30
+ - detailing Path 1 host (a) Connector vs (b) manual MCP client → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
31
+ - outlining headless CLI jobs → delegate to `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`; Delegates out-of-scope requests to cli-appendix-job-outline)
32
+ - resolving active bridge or port collisions → delegate to `bridge-conflicts` (`references/skills/bridge-conflicts.md`; Delegates out-of-scope requests to bridge-conflicts)
33
+ - halting on contradictory constraints before handoff → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; Delegates out-of-scope requests to pre-handoff-verification)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `blender_version_posture` (`string`): Installed or available Blender version (e.g., 5.1+, 4.2 LTS, 3.6 LTS, or unknown)
38
+ - `host_environment_category` (`string`): Available MCP client host (Claude Desktop Connector, manual MCP IDE client, or headless CI)
39
+
40
+ ### Optional inputs
41
+ - `organizational_policy_constraints` (`string`): Optional security or IT constraints restricting third-party add-ons or interactive GUI sessions
42
+
43
+ ### Primary outputs
44
+ - `single_recommended_runtime_path`
45
+ - `rejected_paths_comparison_table`
46
+ - `path_specific_caveat_and_next_skill`
47
+
48
+ ## Quick-start procedure
49
+ 1. collect Blender version band, host app (Claude Desktop vs coding agent vs CI), interactivity needs
50
+ 2. score against `skills/runtime-path-picker/references/path-constraints-table.md`
51
+ 3. walk `skills/runtime-path-picker/references/decision-tree.md`
52
+ 4. document choice using `skills/runtime-path-picker/references/anti-patterns.md` guardrails
53
+
54
+ ## Handoff notes
55
+ - **[progression]** Prerequisite framing → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
56
+ - **[progression]** Readiness matrix check → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
57
+ - **[progression]** Host (a)/(b) specifics for Path 1 → `path-one-host-outline` (`references/skills/path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
58
+ - **[progression]** Headless CLI appendix job outline → `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
59
+ - **[fallback]** Bridge or port 9876 conflicts → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
60
+ - **[fallback]** Contradictory constraints failure exit → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** Decision skill only — chooses a single primary path from constraints and configures nothing (see `docs/runtime-stack-strategy.md` for the canonical model). - **Path 1**: Official Blender Lab MCP in Blender 5.1+ (add-on manifest literal `blender_version_min = "5.1.0"`), hosted from (a) Anthropic Connector in Claude Desktop or (b) any manually configured MCP client. Connector is NOT standalone. - **Path 2**: Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`), third-party, Blender 3.0+, recommended only with explicit caveats and **never as release evidence**. Manual configuration responsibility; see `docs/unofficial-runtime-bridges.md`. - **CLI fallback**: Appendix only (`blender --background --python`), never a peer path without an eval record. Documented upstream as a first-class Blender CLI surface (render/Cycles/format/Python sections read in the current Blender 5.2 LTS Manual); **no in-repo evidence file yet** for BlendOps-run CLI examples. - **Bridge limit**: One MCP bridge per Blender instance (default port 9876). - **Role boundary**: Prerequisite framing belongs to `runtime-setup`; readiness matrix checks belong to `runtime-readiness`; Path 1 host a/b details belong to `path-one-host-outline`; headless job outlines belong to `cli-appendix-job-outline`; bridge conflicts belong to `bridge-conflicts`.
64
+ - Walking through step-by-step add-on installation or host config file edits (owned by `runtime-setup`).
65
+ - Probing live runtime connectivity (owned by `runtime-readiness`).
66
+ - Detailing Path 1 Host (a) vs Host (b) architecture (owned by `path-one-host-outline`) or CLI batch job phases (owned by `cli-appendix-job-outline`).
67
+ - Executing Blender, generating Python code, or verifying artifacts.
@@ -0,0 +1,63 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/runtime-readiness/SKILL.md and skills/runtime-readiness/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # runtime-readiness (reference summary)
3
+
4
+ ## Purpose
5
+ Evaluate whether official runtime appears ready using evidence-bound checks and explicit readiness states.
6
+
7
+ Run the evidence-bound readiness matrix to evaluate check completeness (`Ready | Partially Ready | Blocked | Unknown`) before any runtime attempt.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/runtime-readiness/SKILL.md`
11
+ - **Contract:** `skills/runtime-readiness/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `runtime-connection-and-version-preflight`
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
+ - to run the readiness matrix after prerequisites are framed (`runtime-setup`) and a target path is selected (`runtime-path-picker`)
18
+ - before any runtime manual evaluation or planning handoff
19
+
20
+ ## Trigger cues
21
+ - "check runtime readiness"
22
+ - "is runtime available"
23
+ - "can we run this now"
24
+ - "run the readiness matrix for our chosen Blender path"
25
+
26
+ ## When not to use
27
+ - as proof that Blender ran or that runtime execution succeeded → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
28
+ - as a substitute for runtime truth states (Not Run | Attempted | Produced | Verified | Failed) or artifact status (default Not Produced) → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; default Not Produced)
29
+ - to choose a runtime path → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; use path-one-host-outline)
30
+
31
+ ## Inputs & output/evidence contract
32
+ ### Required inputs
33
+ - `selected_runtime_path` (`string`): Target runtime path to verify (Path 1 Official Blender Lab MCP 5.1+, Path 2 mcp-for-blender 3.0+, or CLI appendix)
34
+ - `observed_environment_signals` (`object`): Observed Blender version, enabled add-on state, MCP host configuration, and tool surface signals
35
+
36
+ ### Optional inputs
37
+ - `port_or_session_diagnostics` (`object`): Optional port 9876 listener status or active Blender session count
38
+
39
+ ### Primary outputs
40
+ - `runtime_readiness_matrix`
41
+ - `readiness_verdict_and_missing_prerequisites`
42
+ - `preserved_not_run_truth_state_block`
43
+
44
+ ## Quick-start procedure
45
+ 1. confirm this skill fits your goal
46
+ 2. provide required inputs first
47
+ 3. keep runtime claims evidence-bound
48
+ 4. follow suggested next-skill handoff
49
+
50
+ ## Handoff notes
51
+ - **[upstream_reference]** If runtime path is not yet chosen → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
52
+ - **[upstream_reference]** If Path 1 host (a) or (b) outline is needed → `path-one-host-outline` (`references/skills/path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
53
+ - **[fallback]** If prerequisites/boundaries are missing (Blocked / Unknown) → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
54
+ - **[fallback]** If bridge contention is detected → `bridge-conflicts` (`references/skills/bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
55
+ - **[upstream_reference]** If CLI appendix job structure is needed → `cli-appendix-job-outline` (`references/skills/cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
56
+ - **[alternative]** If Ready / Partially Ready and moving to scene planning (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
57
+ - **[conditional]** If Ready / Partially Ready and moving to scene planning (workflow-stage-router) → `workflow-stage-router` (`references/skills/workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
58
+
59
+ ## Safety boundaries & non-goals
60
+ - **Runtime boundary:** - Readiness ≠ execution: `Ready` means readiness checks passed, never that Blender executed or artifacts exist. - Readiness statuses (`Ready | Partially Ready | Blocked | Unknown`) describe check completeness only; never conflate them with runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`, downgrade-only) or artifact state (default `Not Produced`). - This skill can check local readiness signals. - This skill must not claim runtime artifact production. - This skill must not claim execution success without execution evidence. - Path 1 Anthropic Connector is never standalone: it always requires the Official Blender Lab MCP add-on installed inside Blender 5.1+. - Path 2 (`mcp-for-blender`) is third-party only, carries mandatory caveats, and is never release evidence. - CLI fallback (`blender --background --python`) is appendix-only and never a peer path without an evaluation record.
61
+ - runtime execution
62
+ - artifact generation claims
63
+ - uncaveated Path 2 / peer-path CLI fallback