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,190 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "runtime-readiness",
4
+ "version": "1.0.0",
5
+ "category": "runtime-and-execution",
6
+ "role": "runtime-connection-and-version-preflight",
7
+ "purpose": "Evaluate whether official runtime appears ready using evidence-bound checks and explicit readiness states.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "check runtime readiness",
11
+ "is runtime available",
12
+ "can we run this now",
13
+ "run the readiness matrix for our chosen Blender path"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "as proof that Blender ran or that runtime execution succeeded",
18
+ "delegateTo": "runtime-path-picker",
19
+ "reason": "Delegates out-of-scope requests to runtime-path-picker"
20
+ },
21
+ {
22
+ "condition": "as a substitute for runtime truth states (Not Run | Attempted | Produced | Verified | Failed) or artifact status (default Not Produced)",
23
+ "delegateTo": "path-one-host-outline",
24
+ "reason": "default Not Produced"
25
+ },
26
+ {
27
+ "condition": "to choose a runtime path",
28
+ "delegateTo": "path-one-host-outline",
29
+ "reason": "use path-one-host-outline"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "selected_runtime_path",
36
+ "type": "string",
37
+ "description": "Target runtime path to verify (Path 1 Official Blender Lab MCP 5.1+, Path 2 mcp-for-blender 3.0+, or CLI appendix)"
38
+ },
39
+ {
40
+ "name": "observed_environment_signals",
41
+ "type": "object",
42
+ "description": "Observed Blender version, enabled add-on state, MCP host configuration, and tool surface signals"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "port_or_session_diagnostics",
48
+ "type": "object",
49
+ "description": "Optional port 9876 listener status or active Blender session count"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "runtime_readiness_matrix",
56
+ "readiness_verdict_and_missing_prerequisites",
57
+ "preserved_not_run_truth_state_block"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "runtime-path-picker",
68
+ "type": "upstream_reference",
69
+ "label": "If runtime path is not yet chosen",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "runtime.path",
74
+ "operator": "equals",
75
+ "value": "unselected"
76
+ }
77
+ ]
78
+ }
79
+ },
80
+ {
81
+ "target": "path-one-host-outline",
82
+ "type": "upstream_reference",
83
+ "label": "If Path 1 host (a) or (b) outline is needed",
84
+ "when": {
85
+ "all": [
86
+ {
87
+ "field": "runtime.path",
88
+ "operator": "equals",
89
+ "value": "path_1"
90
+ },
91
+ {
92
+ "field": "stage.current",
93
+ "operator": "equals",
94
+ "value": "runtime_setup"
95
+ }
96
+ ]
97
+ }
98
+ },
99
+ {
100
+ "target": "runtime-setup",
101
+ "type": "fallback",
102
+ "label": "If prerequisites/boundaries are missing (Blocked / Unknown)",
103
+ "when": {
104
+ "all": [
105
+ {
106
+ "field": "runtime.path",
107
+ "operator": "not_equals",
108
+ "value": "unselected"
109
+ },
110
+ {
111
+ "field": "stage.current",
112
+ "operator": "equals",
113
+ "value": "runtime_setup"
114
+ }
115
+ ]
116
+ }
117
+ },
118
+ {
119
+ "target": "bridge-conflicts",
120
+ "type": "fallback",
121
+ "label": "If bridge contention is detected",
122
+ "when": {
123
+ "all": [
124
+ {
125
+ "field": "runtime.conflictDetected",
126
+ "operator": "equals",
127
+ "value": true
128
+ }
129
+ ]
130
+ }
131
+ },
132
+ {
133
+ "target": "cli-appendix-job-outline",
134
+ "type": "upstream_reference",
135
+ "label": "If CLI appendix job structure is needed",
136
+ "when": {
137
+ "all": [
138
+ {
139
+ "field": "runtime.path",
140
+ "operator": "equals",
141
+ "value": "cli_appendix"
142
+ },
143
+ {
144
+ "field": "request.topic",
145
+ "operator": "equals",
146
+ "value": "cli_batch"
147
+ }
148
+ ]
149
+ }
150
+ },
151
+ {
152
+ "target": "product-hero-scene-planner",
153
+ "type": "alternative",
154
+ "label": "If Ready / Partially Ready and moving to scene planning (product-hero-scene-planner)",
155
+ "when": {
156
+ "all": [
157
+ {
158
+ "field": "brief.locked",
159
+ "operator": "equals",
160
+ "value": true
161
+ },
162
+ {
163
+ "field": "recipe.domain",
164
+ "operator": "equals",
165
+ "value": "product_hero"
166
+ }
167
+ ]
168
+ }
169
+ },
170
+ {
171
+ "target": "workflow-stage-router",
172
+ "type": "conditional",
173
+ "label": "If Ready / Partially Ready and moving to scene planning (workflow-stage-router)",
174
+ "when": {
175
+ "all": [
176
+ {
177
+ "field": "preflight.passed",
178
+ "operator": "equals",
179
+ "value": true
180
+ },
181
+ {
182
+ "field": "inventory.exists",
183
+ "operator": "equals",
184
+ "value": true
185
+ }
186
+ ]
187
+ }
188
+ }
189
+ ]
190
+ }
@@ -0,0 +1,28 @@
1
+ # Blocker Report Template — Runtime Readiness
2
+
3
+ ## Purpose
4
+ Standardize evidence-bound blocker reporting whenever readiness checks fail (`Not Ready`) or lack observable proof (`Unknown`). Do **not** use the generic label `Blocked` as a truth state in runtime reports; distinguish **failed readiness checks** from **missing evidence** cleanly.
5
+
6
+ ## When to use
7
+ Whenever `runtime-readiness` discovers missing Blender version confirmation, unenabled Lab MCP add-on, dual-bridge conflict, or unreachable MCP endpoint.
8
+
9
+ ## Required Template
10
+ - **Check area**: (e.g., `blender_version`, `blender_addon_enabled`, `single_bridge_check`, `mcp_handshake`)
11
+ - **Truth state**: `Not Run` | `Attempted` | `Failed` (paired with Readiness verdict: `Not Ready` or `Unknown`)
12
+ - **Observed signal / evidence**: Exact verbatim message, port state, or note *"No probe run yet"*
13
+ - **User-facing impact (plain language)**: What cannot run safely until fixed
14
+ - **Exact next action**: Single concrete step (and target skill if routing needed, e.g., `bridge-conflicts` or `runtime-path-picker`)
15
+ - **Source confidence label**: `verified-read` | `linked-only` | `unknown`
16
+
17
+ ## Good example
18
+ - **Check area**: `blender_version` (Path 1 requirement)
19
+ - **Truth state**: `Failed` (Readiness: `Not Ready` for Path 1)
20
+ - **Observed signal**: `blender --version` returned `Blender 4.2.3 LTS`; Path 1 Lab MCP add-on declares `blender_version_min = 5.1.0`.
21
+ - **Impact**: Official Path 1 add-on cannot load on Blender 4.2.3.
22
+ - **Next action**: Route to `runtime-path-picker` to either upgrade Blender to 5.1+ OR switch to Path 2 (`mcp-for-blender` for 3.0+) or CLI appendix.
23
+
24
+ ## Bad example
25
+ "Blocked — Blender didn't connect, please fix your setup and retry."
26
+
27
+ ## Related skill
28
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,23 @@
1
+ # Evidence Examples
2
+
3
+ ## Purpose
4
+ Show concrete examples of acceptable versus unacceptable runtime evidence when `runtime-readiness` evaluates whether Blender and a chosen bridge (`Path 1`, `Path 2`, or `CLI fallback`) are genuinely ready.
5
+
6
+ ## When to use
7
+ - Whenever auditing a readiness claim before transitioning from `Not Run` to `Attempted` or `Verified`.
8
+
9
+ ## Acceptable vs. Unacceptable Evidence
10
+
11
+ | Check Target | Unacceptable Claim (Reject -> Keep `Not Run`) | Acceptable Observed Evidence (Verify) |
12
+ |---|---|---|
13
+ | **Blender Executable Version** | `"User probably has Blender installed in Program Files."` | `"Command \`blender --version\` returned: Blender 5.2.3 (build date 2026-09-10). Meets Path 1 5.1+ floor."` |
14
+ | **Path 1 Lab MCP Add-on** | `"Anthropic Connector is enabled in Claude Desktop so Blender works."` | `"Blender Preferences -> Add-ons confirms Blender Lab MCP add-on enabled, listening on local transport; host (a)/(b) paired."` |
15
+ | **Path 2 Community Bridge** | `"mcp-for-blender installed somewhere."` | `"ahujasid/mcp-for-blender add-on active inside Blender 4.2.1 on port 9876; Path 1 Lab add-on verified disabled."` |
16
+ | **MCP Client Config / Doctor** | `"Cursor should see the MCP server."` | `"Executed \`blendops runtime doctor --json\`: config path exists, 0 bridge conflicts, read-only \`get_scene_info\` returned object count 3."` |
17
+ | **Fallback Handling** | `"Failed to connect, trying anyway."` | `"Connection refused on port 9876 -> recorded \`Runtime status: Failed\`, halted scene mutation, routed to \`runtime-attempt-report\`."` |
18
+
19
+ ## Verification Rule
20
+ - Only cite versions, file paths, and command outputs **directly observed in this session**. Unobserved steps remain `Not Run` (`Artifact status: Not Produced`).
21
+
22
+ ## Related skill
23
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,46 @@
1
+ # Readiness Matrix
2
+
3
+ ## Purpose
4
+ Map observable environment signals to deterministic pre-attempt readiness verdicts (`Ready`, `Partially Ready`, `Blocked`, `Unknown`) before launching any Blender MCP or CLI execution.
5
+
6
+ ## When to use
7
+ - Inside every `runtime-readiness` preflight report before scene mutation, render, or GLB export.
8
+ - Before escalating from planning-only mode (`Runtime status: Not Run`) to an official Path 1, community Path 2, or CLI appendix attempt.
9
+
10
+ ## Pre-attempt readiness matrix
11
+
12
+ | Check dimension | Observable signal | Pass | Warn / Unknown | Fail (Blocks Execution) |
13
+ |---|---|---|---|---|
14
+ | **Blender binary & floor** | `blender --version` | Matches path floor (`5.1+` required for Path 1 Lab MCP; `3.0+` for Path 2; `4.2+` recommended for CLI) | Version unrecorded (`Unknown`) or only verified verbally | Missing binary, or below `5.1.0` when targeting Path 1 (`blender_version_min = "5.1.0"`) |
15
+ | **Add-on / bridge posture** | Active Blender add-on + single listener check | Exactly **one** add-on enabled matching chosen path (Lab MCP add-on for Path 1; `addon.py` for Path 2; none needed for CLI) | Add-on state not directly inspected (`Unknown`) | Path 1 + Path 2 both active on `localhost:9876`, or Connector enabled without Lab add-on inside Blender |
16
+ | **MCP host / CLI entrypoint** | Host client config + read-only handshake | Target host configured for chosen path (`Connector` or `mcpServers` for Path 1; `uvx mcp-for-blender` for Path 2) | Config present but read-only smoke test not yet run | Host targets conflicting bridge, unconfigured server, or unsupported direct official MCP claim |
17
+ | **Output & sandbox hygiene** | Target output directory & credential check | Writable non-sensitive output path verified; no secrets/tokens in `.blend` or prompts | Output path implied but write permissions unchecked | Target path missing/read-only, unsafe global write requested, or unredacted credentials detected |
18
+ | **Trusted read-only smoke** | Non-mutating summary query (`get_blendfile_summary_*` / `get_scene_info`) | Clean JSON response without running `execute_blender_code` | Prior smoke test exists from same host/version | Smoke test timed out, refused connection, or invoked mutating code |
19
+
20
+ ## Verdict mapping rules (downgrade-only)
21
+
22
+ | Verdict | Criteria | Permitted next action |
23
+ |---|---|---|
24
+ | **Ready** | All 5 rows `Pass` for the chosen path and single-bridge constraint verified | Proceed to scoped read-only or user-confirmed execution; record outputs via `runtime-attempt-report` |
25
+ | **Partially Ready** | Zero `Fail` rows, but 1+ `Warn / Unknown` rows remain (e.g., pending read-only smoke test) | Run read-only smoke test first; do **not** run mutating Python, render, or GLB export yet |
26
+ | **Blocked** | Any row is `Fail` (below Blender 5.1+ on Path 1, dual-bridge conflict on `localhost:9876`, missing binary) | Halt execution immediately; route to `bridge-conflicts`, `runtime-setup`, or remain planning-only (`Runtime status: Not Run`) |
27
+ | **Unknown** | Operator provided zero environment signals or conflicting claims without inspection | Collect versions and host configuration (`runtime-attempt-report` Section B) before retrying |
28
+
29
+ ## Good example
30
+ ```txt
31
+ Path posture: Path 1 — Official Blender Lab MCP, Host (a) Anthropic Connector in Claude Desktop
32
+ Checks: Blender 5.1.0 (Pass), Lab add-on active alone on 9876 (Pass), Connector active (Pass), output path writable (Pass), read-only smoke (Not yet run -> Warn).
33
+ Verdict: Partially Ready. Next step: run one read-only `get_blendfile_summary_path_info` call before any mutation.
34
+ Runtime status: Not Run | Artifact status: Not Produced
35
+ ```
36
+
37
+ ## Bad example
38
+ ```txt
39
+ Verdict: Ready — User enabled Anthropic Blender Connector on Blender 4.2 with mcp-for-blender also active.
40
+ ```
41
+ Why bad: Path 1 requires Blender 5.1+ (`blender_version_min = "5.1.0"`), Connector is never standalone, and running both bridges on `localhost:9876` violates the single-bridge constraint (`Blocked`, route to `bridge-conflicts`).
42
+
43
+ ## Related skill
44
+ - [../SKILL.md](../SKILL.md)
45
+ - [../../bridge-conflicts/SKILL.md](../../bridge-conflicts/SKILL.md)
46
+ - [../../runtime-attempt-report/SKILL.md](../../runtime-attempt-report/SKILL.md)
@@ -0,0 +1,33 @@
1
+ # EVAL — runtime-setup
2
+
3
+ ## Text-only eval prompt
4
+ Use runtime-setup to determine official runtime options and confidence labels for this workspace. Do not run Blender.
5
+
6
+ ## Expected behavior
7
+ - outputs official runtime hierarchy
8
+ - includes confidence labels
9
+ - avoids runtime success claims
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: official refs + confidence + safe boundary
13
+ - Warn: partial confidence labels, no overclaims
14
+ - Fail: non-official runtime path or runtime claim without evidence
15
+
16
+ ## Common failure modes
17
+ - guessing setup commands
18
+ - mixing install and runtime execution claims
19
+
20
+ ## Evidence expectations
21
+ - reference links listed
22
+ - confidence labels present
23
+ - explicit Not Run runtime state when applicable
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,209 @@
1
+ ---
2
+ name: runtime-setup
3
+ description: Establish Blender runtime prerequisites before execution claims across Path 1 Lab MCP (5.1+), Path 2 mcp-for-blender (3.0+), and single-bridge rules.
4
+ ---
5
+
6
+ # runtime-setup
7
+
8
+ ## Purpose
9
+ Establish runtime setup prerequisites, per-path minimum versions, source-confidence labels, truth-state defaults, and single-bridge boundaries before any Blender execution claim.
10
+
11
+ ## Quick start
12
+ - confirm this skill fits your goal
13
+ - provide required inputs first
14
+ - keep runtime claims evidence-bound
15
+ - follow suggested next-skill handoff
16
+
17
+ ## When to use
18
+ - beginning of a Blender-related task before any runtime path is executed
19
+ - user asks what prerequisites, version floors, or setup boundaries apply
20
+ - framing official vs third-party vs CLI appendix constraints before handoff
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - to install or configure a runtime automatically → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
25
+ - to claim runtime execution has already succeeded → use `../path-one-host-outline/SKILL.md` (Delegates out-of-scope requests to path-one-host-outline)
26
+ - to choose a runtime path → use `../runtime-readiness/SKILL.md` (runtime-readiness)
27
+ <!-- blendops:generated:end exclusions -->
28
+
29
+ ## Trigger phrases
30
+ <!-- blendops:generated:start triggers -->
31
+ - "set up Blender runtime prerequisites"
32
+ - "what are the Blender runtime setup boundaries"
33
+ - "prepare Official Blender Lab MCP setup prerequisites"
34
+ - "runtime prerequisites and version minimums"
35
+ <!-- blendops:generated:end triggers -->
36
+
37
+ ## Prerequisites / readiness
38
+ - ability to read/write project-local docs
39
+ - access to official runtime reference links
40
+ - no requirement to run Blender in this skill
41
+
42
+ ## Input schema
43
+
44
+ ### Required inputs
45
+ - user’s target tool/harness context
46
+ - user goal (planning-only vs runtime-eval intent)
47
+
48
+ ### Optional inputs
49
+ - OS/platform details
50
+ - known local config paths
51
+ - team policy on project-local vs global changes
52
+
53
+ ### Assumptions to confirm
54
+ - project-local attachment is default
55
+ - runtime setup is external to BlendOps
56
+ - runtime evidence may be unavailable in current environment
57
+
58
+ ## Output schema
59
+
60
+ ### Primary output
61
+ - per-path prerequisites, binding version minimums, and runtime boundary rules
62
+ - single-bridge constraint and truth-state baseline (Runtime: `Not Run`, Artifacts: `Not Produced`)
63
+
64
+ ### Secondary output
65
+ - known vs unverified local setup signals
66
+ - source-confidence map and handoff recommendation
67
+
68
+ ### Evidence / caveat output
69
+ - `verified-read` / `linked-only` / `mixed` confidence labels
70
+ - explicit unknowns, blockers, and Path 2 / CLI appendix caveats
71
+
72
+ ## Required laws
73
+ - ../../laws/official-runtime-only.md
74
+ - ../../laws/no-arbitrary-python-interface.md
75
+ - ../../laws/evidence-before-done.md
76
+ - ../../laws/non-blender-user-language.md
77
+
78
+ ## Official runtime boundary
79
+ - This skill does not install or configure Blender runtime.
80
+ - This skill does not run Blender or emit Python.
81
+ - This skill does not provide custom CLI/MCP/addon runtime.
82
+ - This skill frames **two MCP execution paths plus a CLI fallback appendix** (see `../../docs/runtime-stack-strategy.md`):
83
+ - **Path 1 — Official Blender Lab MCP** (in Blender 5.1+, add-on manifest literal `blender_version_min = "5.1.0"`, hosted from either (a) Anthropic Connector in Claude Desktop OR (b) any manually configured MCP client). The Anthropic Connector is **not** standalone — Anthropic's tutorial step 2 installs the Lab add-on inside Blender; although the tutorial prerequisite says "Blender 4.2 or later", the binding floor is **Blender 5.1+**. Sources: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude (host a), https://www.blender.org/lab/mcp-server/ (Blender side, both hosts).
84
+ - **Path 2 — Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`)** (third-party, minimum **Blender 3.0+**, exposes nine tools including `get_scene_info` and `execute_blender_code`). Use **only with caveats** and **never as release evidence**. Source: https://github.com/ahujasid/mcp-for-blender
85
+ - **CLI fallback (appendix only)** — direct `blender --background --python`, **never a peer path without an eval record**. Documented flags: `--background`, `--python`, `-E/--engine` (run `blender -E help` for exact engine tokens; Eevee token is `BLENDER_EEVEE` on 4.0–4.1 and 5.x, `BLENDER_EEVEE_NEXT` on 4.2–4.x). Source: https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
86
+
87
+ ## Operating procedure
88
+ 1. Confirm user objective and whether runtime execution is requested or planning-only.
89
+ 2. Confirm install scope boundary (project-local default; global changes require explicit user approval).
90
+ 3. Record stated client context (e.g., Claude Desktop via `Settings → Developer → Edit Config` for manual MCP JSON, Cursor via `.cursor/mcp.json`, Codex via `AGENTS.md` + MCP config, or another MCP client using its own config — never invent config paths).
91
+ 4. State the per-path prerequisites, minimums, and boundaries without pre-empting `runtime-path-picker`:
92
+ - **Path 1 (Official Blender Lab MCP, host a or b):** Requires **Blender 5.1+** (`blender_version_min = "5.1.0"`). Host (a) Anthropic Connector in Claude Desktop is not standalone and still requires the Lab add-on inside Blender 5.1+.
93
+ - **Path 2 (Community `mcp-for-blender`):** Requires **Blender 3.0+**. Third-party only; allowed **only with caveats** and **never counts as release evidence**.
94
+ - **CLI fallback (`blender --background --python`):** **Appendix only**, never a peer path without an eval record.
95
+ 5. Apply source-confidence labels (`verified-read` / `linked-only` / `mixed`) to each reference.
96
+ 6. Record known and unverified local setup signals without claiming readiness or execution.
97
+ 7. Enforce the single-bridge rule: only one MCP bridge/host may target a given Blender instance at a time (hand off conflicts to `bridge-conflicts`).
98
+ 8. Set baseline truth states: Runtime status = `Not Run` (valid states: `Not Run | Attempted | Produced | Verified | Failed`) and Artifacts = `Not Produced` (downgrade-only, never upgrade).
99
+ 9. Hand off to the appropriate next skill (`runtime-path-picker`, `path-one-host-outline`, `cli-appendix-job-outline`, or `runtime-readiness`).
100
+
101
+ ## Decision tree
102
+ - If user only needs planning now → stay in text-only planning mode; keep Runtime `Not Run` and Artifacts `Not Produced`.
103
+ - If user needs to choose which execution path fits their environment → state prerequisites/minimums, then hand off to `runtime-path-picker`.
104
+ - If user needs Path 1 host (a) vs host (b) setup structure (Claude Desktop Connector + Lab add-on in Blender 5.1+ vs manual MCP config such as Claude Desktop `Settings → Developer → Edit Config`, Cursor `.cursor/mcp.json`, or Codex `AGENTS.md` + MCP config) → hand off to `path-one-host-outline`.
105
+ - If user is below Blender 5.1 (on Blender 3.0–5.0) and asks about MCP → note Path 1 is blocked by the `5.1.0` manifest floor and Path 2 (`mcp-for-blender`) is third-party with caveats and never release evidence (`../../docs/unofficial-runtime-bridges.md`).
106
+ - If user asks about headless batch flags (`--background`, `--python`, `-E/--engine`) → note CLI fallback is appendix-only (never a peer path without an eval record) and hand off to `cli-appendix-job-outline`.
107
+ - If two bridges or hosts are configured against the same Blender instance → warn on the single-bridge rule and hand off to `bridge-conflicts`.
108
+ - If prerequisites are understood and user wants to verify readiness → hand off to `runtime-readiness`.
109
+
110
+ ## Playbooks
111
+ - Playbook A: text-only planning path
112
+ - Playbook B: runtime-ready path with evidence gating
113
+ - Playbook C: blocked runtime path with caveat-first reporting
114
+
115
+ ## Mode handling
116
+
117
+ ### Text-only mode
118
+ - produce setup prerequisites and boundary guidance only
119
+ - no runtime execution claims
120
+ - Runtime status is `Not Run`; artifact status defaults to `Not Produced` (downgrade-only, never upgrade)
121
+
122
+ ### Runtime-ready mode
123
+ - entered only after `runtime-readiness` completes its readiness matrix
124
+ - setup guide still keeps Runtime at `Not Run` and Artifacts at `Not Produced` until execution evidence exists (downgrade-only, never upgrade)
125
+
126
+ ### Blocked runtime mode
127
+ - explicit blockers and unmet version/prerequisite floors listed
128
+ - Runtime stays `Not Run` and Artifacts stay `Not Produced`
129
+ - provide upstream reference links and next setup handoff
130
+
131
+ ## Validation checklist
132
+ - [ ] Path 1 (5.1+ binding floor, Connector not standalone), Path 2 (3.0+, third-party caveats, never release evidence), and CLI appendix (never a peer path without eval record) boundaries present
133
+ - [ ] confidence labels (`verified-read` / `linked-only` / `mixed`) present
134
+ - [ ] project-local default stated and global changes require explicit user approval
135
+ - [ ] single-bridge rule stated
136
+ - [ ] truth states explicit: Runtime `Not Run`, Artifacts `Not Produced` (downgrade-only, never upgrade)
137
+ - [ ] no invented client config paths or Blender UI menu paths
138
+ - [ ] no role blur with `runtime-path-picker`, `path-one-host-outline`, or `runtime-readiness`
139
+ - [ ] plain-language user summary present with no Python or custom runtime ownership phrasing
140
+
141
+ ## Pass / Warn / Fail rubric
142
+
143
+ | Category | Pass | Warn | Fail |
144
+ |---|---|---|---|
145
+ | Runtime path & appendix refs | Path 1 official + Path 2 caveated + CLI appendix refs accurately framed | 1-2 refs present with explicit caveat | Path 2 without caveats, CLI fallback as peer path, or Connector described as standalone |
146
+ | Source confidence | All refs labeled (`verified-read` / `linked-only` / `mixed`) | Partial labeling | No labeling |
147
+ | Runtime & truth-state boundary | Runtime `Not Run`, Artifacts `Not Produced`, downgrade-only, no role blur | Mild ambiguity corrected | Runtime/artifacts upgraded without evidence or role blurred into execution/install |
148
+ | Install scope safety | Project-local default + explicit global approval guard | Scope partially documented | Global mutation implied by default |
149
+
150
+ ## Failure handling
151
+ - Missing source access: mark linked-only and avoid procedural specifics.
152
+ - Unknown paths/config: mark unknown/blocked and request verifiable context.
153
+ - Conflicting user constraints: ask one clarification before proceeding.
154
+
155
+ ## Troubleshooting
156
+ - If official page inaccessible: keep URL + linked-only confidence.
157
+ - If harness path uncertain: use neutral project-local AGENTS.md attachment note.
158
+ - If user asks destructive global changes: require explicit confirmation first.
159
+
160
+ ## Best practices
161
+ - keep setup guidance reversible
162
+ - separate readiness from execution success
163
+ - include concise before/after change summaries
164
+
165
+ ## Good examples
166
+ “Prerequisites framed for Official Blender Lab MCP (Path 1): requires Blender 5.1+ (`blender_version_min = "5.1.0"`) and the Lab add-on inside Blender even when using the Claude Desktop Connector. Source confidence: mixed. Runtime status: Not Run. Artifacts: Not Produced. Next: run `runtime-path-picker` or `runtime-readiness`.”
167
+
168
+ ## Bad examples
169
+ “Setup complete and runtime works now.” (no checks/evidence)
170
+
171
+ ## User-facing response template
172
+ - Applicable runtime prerequisites and version minimums
173
+ - Boundary rules (single-bridge constraint, Path 2 third-party caveats, CLI appendix restriction)
174
+ - What is verified now vs unverified (`verified-read` / `linked-only` / `mixed`)
175
+ - Truth states (Runtime: `Not Run`, Artifacts: `Not Produced`)
176
+ - Next skill handoff
177
+
178
+ ## Anti-patterns
179
+ - skipping required laws or runtime boundary statements
180
+ - describing the Anthropic Connector as standalone without the Blender 5.1+ Lab MCP add-on
181
+ - claiming runtime/artifact success without evidence or upgrading truth states
182
+ - using Path 2 without caveats (or as release evidence) or treating CLI fallback as a peer path
183
+ - inventing client config paths or Blender menu/UI paths
184
+ - blurring roles with `runtime-path-picker`, `path-one-host-outline`, or `runtime-readiness`
185
+ - producing jargon-heavy final output or Python code
186
+
187
+ ## Cross-skill handoff
188
+ <!-- blendops:generated:start handoffs -->
189
+ - [upstream_reference] Path selection → `../runtime-path-picker/SKILL.md`
190
+ - [progression] Path 1 host (a)/(b) details → `../path-one-host-outline/SKILL.md`
191
+ - [progression] CLI appendix job structure → `../cli-appendix-job-outline/SKILL.md`
192
+ - [fallback] Bridge conflict resolution → `../bridge-conflicts/SKILL.md`
193
+ - [progression] Readiness matrix check → `../runtime-readiness/SKILL.md`
194
+ - [alternative] Scene planning after readiness → `../product-hero-scene-planner/SKILL.md`
195
+ <!-- blendops:generated:end handoffs -->
196
+
197
+ ## Non-goals
198
+ - runtime installer creation
199
+ - runtime execution automation
200
+ - custom runtime ownership
201
+
202
+ ## References
203
+ - 2-path + CLI appendix runtime model: ../../docs/runtime-stack-strategy.md
204
+ - Per-path setup details: ../../docs/external-runtime-setup.md
205
+ - Path 2 caveats: ../../docs/unofficial-runtime-bridges.md
206
+ - Path 1 host (a) source — Anthropic Connector: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
207
+ - Path 1 Blender-side source — Lab MCP (required for both hosts): https://www.blender.org/lab/mcp-server/
208
+ - Path 2 source: https://github.com/ahujasid/mcp-for-blender
209
+ - CLI fallback source (documented upstream as a first-class Blender CLI; no in-repo evidence file yet): https://docs.blender.org/manual/en/latest/advanced/command_line/index.html