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,191 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "runtime-path-picker",
4
+ "version": "1.0.0",
5
+ "category": "runtime-and-execution",
6
+ "role": "execution-path-selector",
7
+ "purpose": "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.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "which MCP should I use",
11
+ "Lab MCP or mcp-for-blender",
12
+ "Path 1 or Path 2",
13
+ "CLI vs MCP"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "prerequisite framing or install steps",
18
+ "delegateTo": "runtime-setup",
19
+ "reason": "Delegates out-of-scope requests to runtime-setup"
20
+ },
21
+ {
22
+ "condition": "running the readiness matrix",
23
+ "delegateTo": "runtime-readiness",
24
+ "reason": "Delegates out-of-scope requests to runtime-readiness"
25
+ },
26
+ {
27
+ "condition": "detailing Path 1 host (a) Connector vs (b) manual MCP client",
28
+ "delegateTo": "path-one-host-outline",
29
+ "reason": "Delegates out-of-scope requests to path-one-host-outline"
30
+ },
31
+ {
32
+ "condition": "outlining headless CLI jobs",
33
+ "delegateTo": "cli-appendix-job-outline",
34
+ "reason": "Delegates out-of-scope requests to cli-appendix-job-outline"
35
+ },
36
+ {
37
+ "condition": "resolving active bridge or port collisions",
38
+ "delegateTo": "bridge-conflicts",
39
+ "reason": "Delegates out-of-scope requests to bridge-conflicts"
40
+ },
41
+ {
42
+ "condition": "halting on contradictory constraints before handoff",
43
+ "delegateTo": "pre-handoff-verification",
44
+ "reason": "Delegates out-of-scope requests to pre-handoff-verification"
45
+ }
46
+ ],
47
+ "inputs": {
48
+ "required": [
49
+ {
50
+ "name": "blender_version_posture",
51
+ "type": "string",
52
+ "description": "Installed or available Blender version (e.g., 5.1+, 4.2 LTS, 3.6 LTS, or unknown)"
53
+ },
54
+ {
55
+ "name": "host_environment_category",
56
+ "type": "string",
57
+ "description": "Available MCP client host (Claude Desktop Connector, manual MCP IDE client, or headless CI)"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "organizational_policy_constraints",
63
+ "type": "string",
64
+ "description": "Optional security or IT constraints restricting third-party add-ons or interactive GUI sessions"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "single_recommended_runtime_path",
71
+ "rejected_paths_comparison_table",
72
+ "path_specific_caveat_and_next_skill"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "runtime-setup",
83
+ "type": "progression",
84
+ "label": "Prerequisite framing",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "runtime.path",
89
+ "operator": "not_equals",
90
+ "value": "unselected"
91
+ },
92
+ {
93
+ "field": "stage.current",
94
+ "operator": "equals",
95
+ "value": "runtime_setup"
96
+ }
97
+ ]
98
+ }
99
+ },
100
+ {
101
+ "target": "runtime-readiness",
102
+ "type": "progression",
103
+ "label": "Readiness matrix check",
104
+ "when": {
105
+ "all": [
106
+ {
107
+ "field": "runtime.path",
108
+ "operator": "not_equals",
109
+ "value": "unselected"
110
+ },
111
+ {
112
+ "field": "runtime.verifiedReady",
113
+ "operator": "equals",
114
+ "value": false
115
+ }
116
+ ]
117
+ }
118
+ },
119
+ {
120
+ "target": "path-one-host-outline",
121
+ "type": "progression",
122
+ "label": "Host (a)/(b) specifics for Path 1",
123
+ "when": {
124
+ "all": [
125
+ {
126
+ "field": "runtime.path",
127
+ "operator": "equals",
128
+ "value": "path_1"
129
+ },
130
+ {
131
+ "field": "stage.current",
132
+ "operator": "equals",
133
+ "value": "runtime_setup"
134
+ }
135
+ ]
136
+ }
137
+ },
138
+ {
139
+ "target": "cli-appendix-job-outline",
140
+ "type": "progression",
141
+ "label": "Headless CLI appendix job outline",
142
+ "when": {
143
+ "all": [
144
+ {
145
+ "field": "runtime.path",
146
+ "operator": "equals",
147
+ "value": "cli_appendix"
148
+ },
149
+ {
150
+ "field": "request.topic",
151
+ "operator": "equals",
152
+ "value": "cli_batch"
153
+ }
154
+ ]
155
+ }
156
+ },
157
+ {
158
+ "target": "bridge-conflicts",
159
+ "type": "fallback",
160
+ "label": "Bridge or port 9876 conflicts",
161
+ "when": {
162
+ "all": [
163
+ {
164
+ "field": "runtime.conflictDetected",
165
+ "operator": "equals",
166
+ "value": true
167
+ }
168
+ ]
169
+ }
170
+ },
171
+ {
172
+ "target": "pre-handoff-verification",
173
+ "type": "fallback",
174
+ "label": "Contradictory constraints failure exit",
175
+ "when": {
176
+ "any": [
177
+ {
178
+ "field": "gate.status",
179
+ "operator": "equals",
180
+ "value": "failed"
181
+ },
182
+ {
183
+ "field": "runtime.mode",
184
+ "operator": "equals",
185
+ "value": "blocked"
186
+ }
187
+ ]
188
+ }
189
+ }
190
+ ]
191
+ }
@@ -0,0 +1,14 @@
1
+ # Anti-Patterns — Runtime Path Selection
2
+
3
+ Stop immediately and correct course if any of these appear in a plan or reply:
4
+
5
+ | Anti-pattern | Why it breaks | Required correction |
6
+ |---|---|---|
7
+ | **Standalone Connector myth** | Anthropic's official setup explicitly requires installing the Blender Lab MCP add-on inside Blender before the Connector works. | Present Connector strictly as Path 1 host option `(a)` alongside the Lab add-on prerequisite. |
8
+ | **Path 1 version bleed (`5.1+` everywhere)** | The `5.1.0` floor comes from the Lab add-on manifest only. Claiming Path 2 or `blender --background` needs 5.1+ misleads Blender 3.x/4.x users. | Scope `Blender 5.1+` strictly to Path 1; keep Path 2 at `3.0+` and CLI version-matched. |
9
+ | **Dual active bridges on one Blender instance** | Binding Path 1 Lab MCP and Path 2 `mcp-for-blender` (port `9876`) in the same session causes port conflicts and state drift. | Stop and route to `bridge-conflicts` before attempting any tool call. |
10
+ | **Dismissing CLI appendix as unsupported** | Upstream Blender documents `--background --python` as a first-class CLI surface; BlendOps simply has `Not Run` in-repo eval evidence for it today. | Frame CLI accurately as upstream-documented with `Not Run` in-repo evidence. |
11
+ | **Assuming IT/sandbox permission** | Choosing Path 1 or Path 2 does not guarantee local firewall, socket, or extension permissions succeed. | Keep `Runtime status: Not Run` until live probes return observed tool output. |
12
+
13
+ ## Related skill
14
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,29 @@
1
+ # Decision Tree — Choosing a Blender Execution Path
2
+
3
+ ```txt
4
+ Need interactive, multi-step scene inspection or steering inside a live Blender session?
5
+ ├─ NO (headless batch renders, deterministic CI export, scripted hygiene passes)
6
+ │ └─ Use CLI appendix (`cli-appendix-job-outline`) — documented upstream as a
7
+ │ first-class Blender CLI surface (no in-repo eval evidence file yet).
8
+ └─ YES (interactive MCP host session)
9
+ ├─ Are TWO or more MCP bridges/add-ons enabled on port 9876 or the same instance?
10
+ │ └─ STOP immediately → route to `bridge-conflicts` (single-bridge law).
11
+ ├─ Is Blender 5.1+ installed AND user ready to install Official Blender Lab MCP add-on?
12
+ │ ├─ YES → Choose Path 1 (`path-one-host-outline`):
13
+ │ │ (a) Anthropic Connector host (Claude Desktop) OR
14
+ │ │ (b) Manual MCP client (Claude Code, Cursor, Codex, OpenCode, Zed, etc.)
15
+ │ └─ NO (Blender 3.0–5.0 or Lab MCP unavailable)
16
+ │ └─ Consider Path 2 (`mcp-for-blender`) ONLY IF user explicitly accepts
17
+ │ community maintenance/support boundaries (`docs/unofficial-runtime-bridges.md`).
18
+ └─ Blender version unknown?
19
+ └─ WARN branch: emit conditional Path 1 (5.1+) vs Path 2 (3.0+) table;
20
+ request verbatim `blender --version` output before proceeding.
21
+ ```
22
+
23
+ ## Non-Negotiable Rules
24
+ - Anthropic Connector is a **Path 1 host option**, never a standalone runtime — the Blender Lab MCP add-on must be installed and enabled inside Blender 5.1+ first.
25
+ - Never apply the Blender 5.1+ floor to Path 2 (`3.0+`) or the CLI appendix.
26
+ - Selecting a path does **not** verify readiness or approve writes; pair with `runtime-readiness` and `runtime-attempt-report`.
27
+
28
+ ## Related skill
29
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,18 @@
1
+ # Path Constraints Comparison Matrix
2
+
3
+ | Dimension | Path 1 — Official Blender Lab MCP | Path 2 — Community `mcp-for-blender` | CLI Fallback Appendix (`blender --background`) |
4
+ |---|---|---|---|
5
+ | **Minimum Blender version** | **5.1+** (bound to Lab add-on `blender_version_min`) | **3.0+** (community bridge floor) | Matches target `.blend` / file operators (upstream manual) |
6
+ | **Host options** | (a) Anthropic Connector OR (b) manual MCP client (`stdio`/HTTP) | Manual MCP client configuration (`uvx mcp-for-blender` / local server) | Terminal, CI runner, shell scripts |
7
+ | **Blender-side prerequisite** | Blender Lab MCP add-on installed & enabled inside Blender | Community `addon.py` installed & enabled inside Blender | None (no MCP server or add-on required) |
8
+ | **Interactive iteration** | High (live tool inspection & staged updates) | High (community tool schemas vary by version) | Low (stateless batch execution per invocation) |
9
+ | **Deterministic batch / CI** | Heavyweight (requires open GUI + add-on socket) | Heavyweight & community-coupled | Ideal (headless reproducible job outline) |
10
+ | **Release gate policy** | Preferred official path when Blender 5.1+ available | **Never** ship as primary release recommendation; explicit caveat required | First-class upstream CLI surface (no in-repo evidence file yet) |
11
+ | **Single-bridge invariant** | Strictly **1 active MCP bridge** per Blender instance | Strictly **1 active MCP bridge** per Blender instance (watch port `9876` collisions) | Not applicable |
12
+
13
+ ## Caveats & Links
14
+ - Review `../../../docs/runtime-stack-strategy.md` for full 2-path + CLI appendix boundaries.
15
+ - Review `../../../docs/unofficial-runtime-bridges.md` before accepting Path 2 caveats.
16
+
17
+ ## Related skill
18
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,33 @@
1
+ # EVAL — runtime-readiness
2
+
3
+ ## Text-only eval prompt
4
+ Use runtime-readiness to produce readiness matrix and final status (Ready/Partially Ready/Blocked/Unknown) without running Blender scene operations.
5
+
6
+ ## Expected behavior
7
+ - readiness checks with evidence
8
+ - confidence label per check
9
+ - conservative final status
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: matrix complete + evidence-aligned status
13
+ - Warn: partial evidence with explicit caveat
14
+ - Fail: readiness claim without evidence
15
+
16
+ ## Common failure modes
17
+ - confusing readiness with execution success
18
+ - missing blocker details
19
+
20
+ ## Evidence expectations
21
+ - check table with evidence lines
22
+ - final status rationale
23
+ - blocker list when not ready
24
+
25
+ ## Sample passing response outline
26
+ - Scope and mode stated clearly
27
+ - Evidence expectations listed
28
+ - Pass/warn/fail reasoning tied to checks
29
+
30
+ ## Sample failing response outline
31
+ - Overclaims runtime/artifact success
32
+ - Missing caveats or blocker details
33
+ - No clear next action
@@ -0,0 +1,218 @@
1
+ ---
2
+ name: runtime-readiness
3
+ description: Run evidence-bound Blender MCP readiness checks (version floor, add-on active, port collisions, handshake) -> Ready/Partially Ready/Not Ready/Unknown.
4
+ ---
5
+
6
+ # runtime-readiness
7
+
8
+ ## Purpose
9
+ Run the evidence-bound readiness matrix to evaluate check completeness (`Ready | Partially Ready | Blocked | Unknown`) before any runtime attempt.
10
+
11
+ Canonical role: `runtime-readiness` in the BlendOps skill system. Respect strict role boundaries:
12
+ - `runtime-setup` frames prerequisites and boundaries.
13
+ - `runtime-path-picker` chooses the runtime path.
14
+ - `path-one-host-outline` details Path 1 host (a) and host (b) setup.
15
+ - THIS skill (`runtime-readiness`) runs the readiness matrix only.
16
+
17
+ ## Quick start
18
+ - confirm this skill fits your goal
19
+ - provide required inputs first
20
+ - keep runtime claims evidence-bound
21
+ - follow suggested next-skill handoff
22
+
23
+ ## When to use
24
+ - to run the readiness matrix after prerequisites are framed (`runtime-setup`) and a target path is selected (`runtime-path-picker`)
25
+ - before any runtime manual evaluation or planning handoff
26
+
27
+ ## When not to use
28
+ <!-- blendops:generated:start exclusions -->
29
+ - as proof that Blender ran or that runtime execution succeeded → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
30
+ - as a substitute for runtime truth states (Not Run | Attempted | Produced | Verified | Failed) or artifact status (default Not Produced) → use `../path-one-host-outline/SKILL.md` (default Not Produced)
31
+ - to choose a runtime path → use `../path-one-host-outline/SKILL.md` (use path-one-host-outline)
32
+ <!-- blendops:generated:end exclusions -->
33
+
34
+ ## Trigger phrases
35
+ <!-- blendops:generated:start triggers -->
36
+ - "check runtime readiness"
37
+ - "is runtime available"
38
+ - "can we run this now"
39
+ - "run the readiness matrix for our chosen Blender path"
40
+ <!-- blendops:generated:end triggers -->
41
+
42
+ ## Prerequisites / readiness
43
+ - non-destructive local environment access
44
+ - ability to read config/path signals
45
+ - clear distinction between readiness and execution
46
+
47
+ ## Input schema
48
+
49
+ ### Required inputs
50
+ - expected runtime path(s)
51
+ - target harness context
52
+
53
+ ### Optional inputs
54
+ - known executable paths
55
+ - known config file locations
56
+ - prior blocker records
57
+
58
+ ### Assumptions to confirm
59
+ - no Blender run required for readiness-only pass
60
+ - Path 2 used only with third-party caveats; CLI appendix never a peer path
61
+
62
+ ## Output schema
63
+
64
+ ### Primary output
65
+ - readiness matrix + final readiness status (`Ready | Partially Ready | Blocked | Unknown`, describing check completeness only)
66
+ - explicit runtime truth state reminder (runtime remains `Not Run`; artifacts remain `Not Produced`)
67
+
68
+ ### Secondary output
69
+ - blocker list + next-skill handoff or retry steps
70
+
71
+ ### Evidence / caveat output
72
+ - per-check evidence lines
73
+ - confidence label per check: `verified-read | linked-only | unknown | blocked`
74
+
75
+ ## Required laws
76
+ - ../../laws/official-runtime-only.md
77
+ - ../../laws/evidence-before-done.md
78
+ - ../../laws/no-arbitrary-python-interface.md
79
+ - ../../laws/non-blender-user-language.md
80
+
81
+ ## Official runtime boundary
82
+ - Readiness ≠ execution: `Ready` means readiness checks passed, never that Blender executed or artifacts exist.
83
+ - 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`).
84
+ - This skill can check local readiness signals.
85
+ - This skill must not claim runtime artifact production.
86
+ - This skill must not claim execution success without execution evidence.
87
+ - Path 1 Anthropic Connector is never standalone: it always requires the Official Blender Lab MCP add-on installed inside Blender 5.1+.
88
+ - Path 2 (`mcp-for-blender`) is third-party only, carries mandatory caveats, and is never release evidence.
89
+ - CLI fallback (`blender --background --python`) is appendix-only and never a peer path without an evaluation record.
90
+
91
+ ## Operating procedure
92
+ 1. Confirm chosen runtime path (Path 1 or Path 2 from `../../docs/runtime-stack-strategy.md`); for Path 1 also confirm host option (a Anthropic Connector, b manual MCP). CLI fallback is appendix only — documented upstream as a first-class Blender CLI surface but no in-repo evidence file yet; flag this if user picks it.
93
+ 2. Check Blender executable availability (command/path evidence) AND record exact `blender --version` output for per-path minimum check:
94
+ - **Path 1 (either host)** → 5.1+ required (Lab install-link parameter + add-on manifest literal `blender_version_min=5.1.0`, re-verified 2026-10-13).
95
+ - Path 2 → 3.0+ required (per upstream).
96
+ - CLI fallback → 4.2+ recommended; documented upstream as a first-class Blender CLI surface; no in-repo evidence file yet.
97
+ 3. Per chosen path + host, check the path-specific configuration:
98
+ - **Path 1 Blender-side (always required)**: Lab MCP add-on installed in Blender + MCP server (`.mcpb` bundle or source) reachable.
99
+ - Path 1 host (a): Anthropic Connector enabled in Claude Desktop → Customize → Connectors.
100
+ - Path 1 host (b): Lab MCP server registered in MCP client config (`mcpServers` JSON or equivalent).
101
+ - Path 2: `mcp-for-blender` (formerly `blender-mcp`) server registered (`uvx mcp-for-blender` or equivalent) + upstream `addon.py` installed + enabled in Blender.
102
+ - CLI fallback: Blender executable resolvable from agent shell.
103
+ 4. Check single-bridge constraint: at most one MCP bridge session active per Blender instance on the default port (Path 1 + Path 2 must not both target the same Blender on `localhost:9876`; per-instance `--port 9877` is the supported multi-instance pattern; Path 1 host (a) + host (b) must not both target the same Blender).
104
+ 5. Check operator sandbox hygiene: trusted environment, no secrets in scenes/logs, disposable ports/paths.
105
+ 6. Check artifact/output location readiness for future run.
106
+ 7. Assign confidence label to each check (`verified-read` / `linked-only` / `unknown` / `blocked`).
107
+ 8. Populate readiness matrix table per path + host.
108
+ 9. Derive final status (Ready / Partially Ready / Blocked / Unknown) while keeping runtime truth at `Not Run` and artifacts at `Not Produced`.
109
+ 10. Produce blocker summary and next actions.
110
+ 11. Route to planner or setup skill based on status.
111
+
112
+ ## Decision tree
113
+ - Blender missing + no connector/MCP evidence → Blocked.
114
+ - Blender found but connector/MCP uncertain → Partially Ready or Unknown.
115
+ - Blender found + connector/MCP signals sufficient → Ready candidate (still no artifact claim).
116
+
117
+ ## Playbooks
118
+ - Playbook A: text-only planning path
119
+ - Playbook B: runtime-ready path with evidence gating
120
+ - Playbook C: blocked runtime path with caveat-first reporting
121
+
122
+ ## Mode handling
123
+
124
+ ### Text-only mode
125
+ - evaluate readiness matrix from provided evidence only
126
+ - runtime truth state stays `Not Run`; artifacts stay `Not Produced`
127
+
128
+ ### Runtime-ready mode
129
+ - status `Ready` or `Partially Ready` with explicit path caveats
130
+ - handoff to scene planning or host outline skills (never claim execution occurred)
131
+
132
+ ### Blocked runtime mode
133
+ - status `Blocked` or `Unknown`
134
+ - list explicit blockers and handoff to setup or conflict-resolution skills
135
+
136
+ ## Validation checklist
137
+ - [ ] Blender check recorded
138
+ - [ ] connector check recorded
139
+ - [ ] MCP check recorded
140
+ - [ ] artifact path readiness recorded
141
+ - [ ] confidence labels assigned
142
+ - [ ] final status assigned
143
+ - [ ] blocker list included
144
+ - [ ] no execution success claim
145
+ - [ ] runtime truth state kept at `Not Run`, artifacts at `Not Produced` (readiness is not execution)
146
+ - [ ] Path 2 references carry third-party caveats; CLI appendix never a peer path
147
+ - [ ] operator sandbox hygiene noted (trusted environment, no secrets in scenes/logs, disposable ports/paths)
148
+ - [ ] next actions clear
149
+
150
+ ## Pass / Warn / Fail rubric
151
+
152
+ | Category | Pass | Warn | Fail |
153
+ |---|---|---|---|
154
+ | Blender availability | Verified with local evidence | Partial path evidence | Missing/not found |
155
+ | Path & host signals | Both in-Blender Lab add-on + host (a/b) verified for Path 1 (or caveated Path 2/CLI) | Incomplete signal downgraded to `Unknown`/`Partially Ready` | Standalone-Connector assumed or claimed without evidence |
156
+ | Sandbox hygiene & confidence | Sandbox hygiene noted; every check labeled (`verified-read`/`linked-only`/`unknown`/`blocked`) | Partial labels or hygiene caveats | Missing labels or hygiene ignored |
157
+ | Status vs truth separation | Matrix status matches evidence; runtime kept at `Not Run` and artifacts `Not Produced` | Minor ambiguity with conservative downgrade | Readiness conflated with execution or truth upgraded |
158
+
159
+ ## Failure handling
160
+ - Unknown state: mark Unknown, not Ready.
161
+ - Missing config path: mark Blocked and provide exact next check.
162
+ - Conflicting signals: choose safer status with caveat.
163
+
164
+ ## Troubleshooting
165
+ - Blender not on PATH: check absolute path.
166
+ - Config file exists but missing runtime entries: mark unknown/blocked.
167
+ - Existing artifacts found: treat as pre-existing unless run-specific evidence ties them to current eval.
168
+
169
+ ## Best practices
170
+ - keep checks reproducible and non-destructive
171
+ - include exact evidence lines in report
172
+ - separate readiness from artifact claims
173
+
174
+ ## Good examples
175
+ “Status: Blocked. Blender binary exists, but official connector/MCP runtime path is not confirmed in this environment.”
176
+
177
+ ## Bad examples
178
+ “Looks good; runtime should work.” (no matrix, no evidence)
179
+
180
+ ## User-facing response template
181
+ - Current runtime status
182
+ - Evidence observed
183
+ - Missing readiness signals
184
+ - Next setup action
185
+
186
+ ## Anti-patterns
187
+ - skipping required laws or runtime boundary statements
188
+ - claiming runtime/artifact success without evidence
189
+ - conflating readiness status (`Ready`) with runtime truth states (`Produced | Verified`) or claiming artifacts exist
190
+ - treating the Path 1 Anthropic Connector as standalone without the Blender 5.1+ Lab MCP add-on
191
+ - using Path 2 (`mcp-for-blender`) without third-party caveats or as release evidence
192
+ - treating CLI fallback (`blender --background --python`) as a peer path without an eval record
193
+ - blurring roles with `runtime-setup`, `runtime-path-picker`, or `path-one-host-outline`
194
+ - producing jargon-heavy final output without explanation
195
+
196
+ ## Cross-skill handoff
197
+ <!-- blendops:generated:start handoffs -->
198
+ - [upstream_reference] If runtime path is not yet chosen → `../runtime-path-picker/SKILL.md`
199
+ - [upstream_reference] If Path 1 host (a) or (b) outline is needed → `../path-one-host-outline/SKILL.md`
200
+ - [fallback] If prerequisites/boundaries are missing (Blocked / Unknown) → `../runtime-setup/SKILL.md`
201
+ - [fallback] If bridge contention is detected → `../bridge-conflicts/SKILL.md`
202
+ - [upstream_reference] If CLI appendix job structure is needed → `../cli-appendix-job-outline/SKILL.md`
203
+ - [alternative] If Ready / Partially Ready and moving to scene planning (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
204
+ - [conditional] If Ready / Partially Ready and moving to scene planning (workflow-stage-router) → `../workflow-stage-router/SKILL.md`
205
+ <!-- blendops:generated:end handoffs -->
206
+
207
+ ## Non-goals
208
+ - runtime execution
209
+ - artifact generation claims
210
+ - uncaveated Path 2 / peer-path CLI fallback
211
+
212
+ ## References
213
+ - 2-path + CLI appendix runtime model: ../../docs/runtime-stack-strategy.md
214
+ - Per-path setup details: ../../docs/external-runtime-setup.md
215
+ - Path 1 host (a) source — Anthropic Connector: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
216
+ - Path 1 Blender-side source — Lab MCP (required for both hosts): https://www.blender.org/lab/mcp-server/
217
+ - Path 2 source: https://github.com/ahujasid/mcp-for-blender
218
+ - CLI fallback source (documented upstream as first-class Blender CLI; no in-repo evidence file yet): https://docs.blender.org/manual/en/latest/advanced/command_line/index.html