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,251 @@
1
+ ---
2
+ name: path-one-host-outline
3
+ description: Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.
4
+ ---
5
+
6
+ # path-one-host-outline
7
+
8
+ ## Purpose
9
+
10
+ Outline **Path 1 host surfaces** — **(a)** Anthropic Connector in Claude Desktop vs **(b)** any manually configured MCP client — while making clear that both require the Lab MCP add-on inside **Blender 5.1+** and that the Connector is **never standalone**. This skill provides an outline only; it never configures hosts and never runs Blender.
11
+
12
+ ## Quick start
13
+
14
+ - confirm Blender 5.1+ target
15
+ - choose host category using `references/connector-vs-manual-matrix.md`
16
+ - apply reminders from `references/lab-addon-reminders.md`
17
+ - emit checklist `references/host-checklist-template.md`
18
+
19
+ ## When to use
20
+
21
+ - user on Claude Desktop asking what the Anthropic Connector does vs the Blender-side add-on
22
+ - user or agent comparing Path 1 host surfaces: **(a)** Anthropic Connector in Claude Desktop vs **(b)** a manually configured MCP client
23
+ - outlining which components live on the host side vs inside Blender 5.1+ before setup begins
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - choosing between Path 1, Path 2, or CLI → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
28
+ - step-by-step host or add-on installation and configuration → use `../runtime-setup/SKILL.md` (Delegates out-of-scope requests to runtime-setup)
29
+ - probing live runtime readiness → use `../runtime-readiness/SKILL.md` (Delegates out-of-scope requests to runtime-readiness)
30
+ - resolving conflicts between official and unofficial bridges → use `../bridge-conflicts/SKILL.md` (Delegates out-of-scope requests to bridge-conflicts)
31
+ - Path 2 community bridge specifics → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
32
+ - CLI appendix job outlining → use `../cli-appendix-job-outline/SKILL.md` (Delegates out-of-scope requests to cli-appendix-job-outline)
33
+ <!-- blendops:generated:end exclusions -->
34
+
35
+ ## Trigger phrases
36
+ <!-- blendops:generated:start triggers -->
37
+ - "Connector vs Cursor MCP"
38
+ - "how do I host Lab MCP"
39
+ - "Claude Desktop Connector vs manual MCP client"
40
+ - "what hosts work with Path 1"
41
+ <!-- blendops:generated:end triggers -->
42
+
43
+ ## Prerequisites / readiness
44
+
45
+ - target environment plans for **Blender 5.1+** with the Blender-side Lab MCP add-on required for both Host **(a)** and Host **(b)** (the Anthropic Connector is never standalone)
46
+
47
+ ## Input schema
48
+
49
+ ### Required inputs
50
+
51
+ | Input | Why it is required |
52
+ |---|---|
53
+ | Host product name | Select matrix row |
54
+ | Blender version plan | Confirms Path 1 viability |
55
+
56
+ ### Optional inputs
57
+
58
+ | Input | Use |
59
+ |---|---|
60
+ | OS | Install nuance pointers |
61
+
62
+ ## Output schema
63
+
64
+ ### Primary output
65
+
66
+ - host-specific outline using **(a)** Anthropic Connector in Claude Desktop vs **(b)** manually configured MCP client framing (outline only — never configure hosts or dump executable setup scripts; hand off setup details to `runtime-setup`)
67
+ - explicit prerequisite line stating that both Host **(a)** and Host **(b)** require the Lab MCP add-on inside **Blender 5.1+**
68
+ - explicit statement that the Anthropic Connector is **never standalone** whenever Connector is discussed
69
+
70
+ ### Evidence / caveat output
71
+
72
+ ```txt
73
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
74
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
75
+ Rule: Downgrade-only, never upgrade. Outlining hosts never configures hosts or runs Blender.
76
+ Blockers: <separate line>
77
+ Evidence used: <doc references>
78
+ Limitations: <unknown host version>
79
+ ```
80
+
81
+ ## Required laws
82
+
83
+ - `../../laws/evidence-before-done.md`
84
+ - `../../laws/non-blender-user-language.md`
85
+ - `../../laws/no-arbitrary-python-interface.md`
86
+ - `../../laws/official-runtime-only.md`
87
+
88
+ ## Official runtime boundary
89
+
90
+ Outline only; never configures hosts and never runs Blender. Path 1 requires the Lab MCP add-on inside **Blender 5.1+** plus a host surface: **(a)** Anthropic Connector in Claude Desktop or **(b)** any manually configured MCP client. The Connector is **never standalone**. Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`; see `docs/unofficial-runtime-bridges.md`) and CLI workflows (`cli-appendix-job-outline`) are out of scope here.
91
+
92
+ ## Operating procedure
93
+
94
+ 1. Verify the **Blender 5.1+** version floor for Path 1 (route path selection questions to `runtime-path-picker`).
95
+ 2. Identify the target host surface as **(a)** Anthropic Connector in Claude Desktop or **(b)** a manually configured MCP client using `references/connector-vs-manual-matrix.md`.
96
+ 3. State explicitly that the Lab MCP add-on inside Blender 5.1+ is required for both **(a)** and **(b)**, and reiterate that the Connector is **never standalone** (`references/lab-addon-reminders.md`).
97
+ 4. Emit the conceptual checklist (`references/host-checklist-template.md`) with pointers to `docs/install/claude-desktop.md` or `runtime-setup` without performing host configuration.
98
+
99
+ ## Decision tree
100
+
101
+ ```txt
102
+ Is the user still deciding between Path 1 (Lab MCP), Path 2 (`mcp-for-blender`), or the CLI appendix?
103
+ Yes → stop and route to runtime-path-picker
104
+ No (Path 1 selected) → continue
105
+ Can the target environment run Blender 5.1+ (`blender_version_min = "5.1.0"`) with the Lab MCP add-on installed inside Blender?
106
+ No → Path 1 is not viable; route back to runtime-path-picker for Path 2 (`Blender 3.0+`) or CLI appendix evaluation
107
+ Yes → continue
108
+ Which Path 1 host surface is the user targeting (`references/connector-vs-manual-matrix.md`)?
109
+ Host (a) Claude Desktop with Anthropic Blender Connector →
110
+ 1. Require Blender 5.1+ and Lab MCP add-on inside Blender first
111
+ 2. State explicitly that the Anthropic Connector is NEVER standalone
112
+ 3. Point to `docs/install/claude-desktop.md` and `runtime-setup`
113
+ Host (b) Manually configured MCP client (Cursor, Claude Code, Codex, OpenCode, Zed, Windsurf, etc.) →
114
+ 1. Require Blender 5.1+ and Lab MCP add-on inside Blender first
115
+ 2. Outline host MCP server entry pointing at the Blender Lab MCP server
116
+ 3. Point to `docs/external-runtime-setup.md`, `docs/install/<target>.md`, and `runtime-setup`
117
+ Host unknown / comparing both →
118
+ Emit side-by-side Host (a) vs Host (b) outline sharing the mandatory Blender 5.1+ Lab add-on invariant
119
+ ```
120
+
121
+ ## Playbooks
122
+
123
+ ### Playbook A: Claude Desktop user asking how the Anthropic Connector works (`Host (a)`)
124
+
125
+ - Lead with the shared Path 1 invariant from `references/lab-addon-reminders.md`: **Blender 5.1+** (`blender_version_min = "5.1.0"`) and the **Official Blender Lab MCP add-on** inside Blender must be installed and enabled first.
126
+ - Explain that **Host (a)** (Anthropic Connector in Claude Desktop) is a host-side convenience layer that attaches to the Lab MCP add-on after Blender-side setup — the Connector is **never standalone**.
127
+ - Emit the 5-step outline from `references/host-checklist-template.md` and route step-by-step installation to `../runtime-setup/SKILL.md`.
128
+
129
+ ### Playbook B: Coding agent user (Cursor, Claude Code, Codex, OpenCode) on Path 1 (`Host (b)`)
130
+
131
+ - Confirm the **Blender 5.1+** and Blender-side **Lab MCP add-on** prerequisite (`references/connector-vs-manual-matrix.md`).
132
+ - Outline **Host (b)**: the coding agent acts as a manually configured MCP client connecting to the Lab MCP server surface exposed by Blender 5.1+, with no Anthropic Connector involved.
133
+ - Remind the user of the single-bridge rule (do not attach Path 2 `mcp-for-blender` to the same Blender instance on port `9876`) and point to `../../docs/install/claude-desktop.md` or the target agent's install doc.
134
+
135
+ ### Playbook C: Side-by-side comparison of Host (a) vs Host (b)
136
+
137
+ - Present the comparison table from `references/connector-vs-manual-matrix.md` showing what stays identical inside Blender 5.1+ (the Lab MCP add-on and single-bridge rule) vs what changes on the host (Connector UI linkage in Claude Desktop vs MCP client config in other agents).
138
+ - Keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
139
+
140
+ ## Mode handling
141
+
142
+ ### Text-only mode
143
+
144
+ References only; no credential paths.
145
+
146
+ ### Runtime-ready mode
147
+
148
+ Suggest pairing with `runtime-readiness`.
149
+
150
+ ### Blocked runtime mode
151
+
152
+ Still explain host conceptual split.
153
+
154
+ ## Validation checklist
155
+
156
+ * [ ] Host **(a)** (Anthropic Connector in Claude Desktop) vs Host **(b)** (manually configured MCP client) framing is used
157
+ * [ ] Lab MCP add-on inside **Blender 5.1+** is stated as a prerequisite on the outline
158
+ * [ ] "Connector is never standalone" phrasing is present whenever the Connector is discussed
159
+ * [ ] No host configuration, Python, or Blender execution is performed
160
+ * [ ] Former Path 2 repo is cited as `ahujasid/blender-mcp` (never bare `blender-mcp`)
161
+ * [ ] Truth states use the full allowed enums with default `Not Produced` for artifacts and downgrade-only enforcement
162
+
163
+ ## Pass / Warn / Fail rubric
164
+
165
+ | Verdict | Criteria |
166
+ |---|---|
167
+ | Pass | Uses Host (a)/(b) framing, requires Lab MCP add-on in Blender 5.1+, states Connector is never standalone, keeps strictly to outlining, and uses exact truth-state enums. |
168
+ | Warn | Host product or version is ambiguous, requiring a general (a) vs (b) comparison with documented limitations. |
169
+ | Fail | Implies Connector is standalone or installs Blender internals automatically, omits Blender 5.1+ Lab add-on prerequisite, uses bare `blender-mcp`, configures hosts/runs Blender, or upgrades truth states. |
170
+
171
+ ## Failure handling
172
+
173
+ - If the user's environment is pinned below **Blender 5.1** (for example, Blender 4.2 LTS or 3.6 LTS), state clearly that Path 1 (both Host (a) and Host (b)) is unavailable because the Lab MCP add-on requires `blender_version_min = "5.1.0"`, and route to `../runtime-path-picker/SKILL.md`.
174
+ - If the user asks this skill to write live MCP client JSON configs, edit system credential files, or execute Blender, decline and route setup execution to `../runtime-setup/SKILL.md`.
175
+ - If both Path 1 Lab MCP and Path 2 `mcp-for-blender` (formerly `ahujasid/blender-mcp`) are active on the same Blender instance, route immediately to `../bridge-conflicts/SKILL.md`.
176
+ - Preserve downgrade-only truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
177
+
178
+ ## Troubleshooting
179
+
180
+ | Symptom | Cause | Safe resolution |
181
+ |---|---|---|
182
+ | User enabled Anthropic Connector in Claude Desktop but nothing connects | Lab MCP add-on was never installed/enabled inside Blender 5.1+ (Anthropic tutorial step 2 skipped) | Reiterate that the Anthropic Connector is **never standalone**; require installing and enabling the Lab MCP add-on inside Blender 5.1+ first, then route to `../runtime-setup/SKILL.md`. |
183
+ | User cites Anthropic tutorial prerequisite "Blender 4.2 or later" for Path 1 | Upstream tutorial text lags the Lab add-on manifest floor | Explain that the binding floor in the Lab MCP add-on manifest is `blender_version_min = "5.1.0"` (**Blender 5.1+**), which governs both Host (a) and Host (b). |
184
+ | User confuses Path 1 Host (b) with Path 2 `mcp-for-blender` | Both use manual MCP client configuration in coding agents | Clarify that Path 1 Host (b) connects to the official Blender Lab MCP add-on in Blender 5.1+, whereas Path 2 connects to the third-party `mcp-for-blender` (`ahujasid/blender-mcp`) add-on (`../../docs/unofficial-runtime-bridges.md`). |
185
+
186
+ ## Best practices
187
+
188
+ - Always state the Blender-side prerequisite (**Blender 5.1+** + **Lab MCP add-on** inside Blender) **before** describing either Host (a) or Host (b).
189
+ - Include the explicit reminder that **the Anthropic Connector is never standalone** whenever Host (a) or Claude Desktop is mentioned.
190
+ - Cite the community Path 2 bridge as `mcp-for-blender` (formerly `ahujasid/blender-mcp`), never bare `blender-mcp`.
191
+ - Keep this skill strictly at the architectural outline level and hand off step-by-step installation to `../runtime-setup/SKILL.md` and live checks to `../runtime-readiness/SKILL.md`.
192
+
193
+ ## Good examples
194
+
195
+ - "For Path 1 on Claude Desktop (**Host (a)**): 1) Install **Blender 5.1+** (`blender_version_min = \"5.1.0\"`). 2) Install and enable the **Official Blender Lab MCP add-on** inside Blender. 3) Connect the Anthropic Blender Connector in Claude Desktop — the Connector is **never standalone** and depends on the Lab add-on running inside Blender 5.1+. `Runtime status: Not Run`. `Artifact status: Not Produced`."
196
+ - "For Path 1 in Cursor or Claude Code (**Host (b)**): Both Host (a) and Host (b) require the **Lab MCP add-on inside Blender 5.1+**. On the host side, configure your agent's manual MCP client to point at the Lab MCP server and ensure no Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`) bridge is attached to the same Blender instance. Hand off to `../runtime-setup/SKILL.md`."
197
+
198
+ ## Bad examples
199
+
200
+ - "In Claude Desktop, just toggle on the Anthropic Blender Connector — no Blender add-on installation is needed." — false standalone Connector claim.
201
+ - "Use Host (b) manual MCP client to run Path 1 on Blender 4.2 LTS." — violates the binding Blender 5.1+ floor (`blender_version_min = "5.1.0"`) for Path 1.
202
+ - "Path 1 Host (b) uses `blender-mcp`." — confuses Path 1 with Path 2 and uses the ambiguous bare name `blender-mcp`.
203
+
204
+ ## User-facing response template
205
+
206
+ ```txt
207
+ Path 1 host outline: <Host (a) Anthropic Connector in Claude Desktop | Host (b) Manual MCP client | (a) vs (b) comparison>
208
+ Mandatory Path 1 prerequisite: Both Host (a) and Host (b) require Blender 5.1+ (`blender_version_min = "5.1.0"`) with the Official Blender Lab MCP add-on installed and enabled inside Blender. The Anthropic Connector is never standalone.
209
+
210
+ Component split:
211
+ 1. Blender-side (shared by (a) and (b)): <Blender 5.1+ + Lab MCP add-on enabled + single-bridge check on port 9876>
212
+ 2. Host-side wiring: <Host (a) Anthropic Connector linkage after step 1 | Host (b) manual MCP client server entry>
213
+
214
+ Blockers: <none or version/host constraints>
215
+ Runtime status: Not Run
216
+ Artifact status: Not Produced
217
+ Evidence used: <docs/runtime-stack-strategy.md, docs/install/claude-desktop.md, skill references>
218
+ Limitations: <outline only — does not configure hosts or run Blender>
219
+ Next skill: <runtime-setup | runtime-readiness | runtime-path-picker>
220
+ ```
221
+
222
+ ## Anti-patterns
223
+
224
+ - Describing the Anthropic Blender Connector as standalone or implying it works without installing the Lab MCP add-on inside Blender 5.1+.
225
+ - Claiming Path 1 Host (b) bypasses the **Blender 5.1+** floor (`blender_version_min = "5.1.0"`).
226
+ - Referring to the former Path 2 repository as bare `blender-mcp` instead of `mcp-for-blender` (`ahujasid/blender-mcp`).
227
+ - Writing `Artifact status: Not Run` or upgrading `Runtime status` / `Artifact status` from a host outline.
228
+ - Turning a conceptual host outline into live configuration execution or Python scripts.
229
+
230
+ ## Cross-skill handoff
231
+ <!-- blendops:generated:start handoffs -->
232
+ - [upstream_reference] Path selection → `../runtime-path-picker/SKILL.md`
233
+ - [upstream_reference] Detailed setup and configuration → `../runtime-setup/SKILL.md`
234
+ - [progression] Readiness probing → `../runtime-readiness/SKILL.md`
235
+ - [fallback] Bridge conflicts → `../bridge-conflicts/SKILL.md`
236
+ - [progression] CLI appendix workflows → `../cli-appendix-job-outline/SKILL.md`
237
+ <!-- blendops:generated:end handoffs -->
238
+
239
+ ## Non-goals
240
+
241
+ - Choosing between Path 1, Path 2, and the CLI appendix (owned by `../runtime-path-picker/SKILL.md`).
242
+ - Performing step-by-step installation or editing host MCP configuration files (owned by `../runtime-setup/SKILL.md`).
243
+ - Probing whether a live Blender MCP session is currently connected (owned by `../runtime-readiness/SKILL.md`).
244
+ - Documenting Path 2 community bridge internals or headless CLI batch scripts.
245
+
246
+ ## References
247
+
248
+ - `references/connector-vs-manual-matrix.md`
249
+ - `references/lab-addon-reminders.md`
250
+ - `references/host-checklist-template.md`
251
+ - `../../docs/install/claude-desktop.md`
@@ -0,0 +1,167 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "path-one-host-outline",
4
+ "version": "1.0.0",
5
+ "category": "runtime-and-execution",
6
+ "role": "lab-mcp-host-configuration-planner",
7
+ "purpose": "Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "Connector vs Cursor MCP",
11
+ "how do I host Lab MCP",
12
+ "Claude Desktop Connector vs manual MCP client",
13
+ "what hosts work with Path 1"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "choosing between Path 1, Path 2, or CLI",
18
+ "delegateTo": "runtime-path-picker",
19
+ "reason": "Delegates out-of-scope requests to runtime-path-picker"
20
+ },
21
+ {
22
+ "condition": "step-by-step host or add-on installation and configuration",
23
+ "delegateTo": "runtime-setup",
24
+ "reason": "Delegates out-of-scope requests to runtime-setup"
25
+ },
26
+ {
27
+ "condition": "probing live runtime readiness",
28
+ "delegateTo": "runtime-readiness",
29
+ "reason": "Delegates out-of-scope requests to runtime-readiness"
30
+ },
31
+ {
32
+ "condition": "resolving conflicts between official and unofficial bridges",
33
+ "delegateTo": "bridge-conflicts",
34
+ "reason": "Delegates out-of-scope requests to bridge-conflicts"
35
+ },
36
+ {
37
+ "condition": "Path 2 community bridge specifics",
38
+ "delegateTo": "runtime-path-picker",
39
+ "reason": "Delegates out-of-scope requests to runtime-path-picker"
40
+ },
41
+ {
42
+ "condition": "CLI appendix job outlining",
43
+ "delegateTo": "cli-appendix-job-outline",
44
+ "reason": "Delegates out-of-scope requests to cli-appendix-job-outline"
45
+ }
46
+ ],
47
+ "inputs": {
48
+ "required": [
49
+ {
50
+ "name": "path_one_host_option",
51
+ "type": "string",
52
+ "description": "Selected Path 1 host mode: option (a) Anthropic Connector in Claude Desktop or option (b) manual MCP client"
53
+ },
54
+ {
55
+ "name": "blender_5_1_addon_posture",
56
+ "type": "object",
57
+ "description": "Confirmation that Official Blender Lab MCP add-on in Blender 5.1+ is required by both host options"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "mcp_client_name",
63
+ "type": "string",
64
+ "description": "Specific MCP client for host option (b) such as Cursor, Claude Code, or Zed"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "path_one_host_architecture_outline",
71
+ "connector_not_standalone_boundary_check",
72
+ "host_to_readiness_handoff"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "runtime-path-picker",
83
+ "type": "upstream_reference",
84
+ "label": "Path selection",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "runtime.path",
89
+ "operator": "equals",
90
+ "value": "unselected"
91
+ }
92
+ ]
93
+ }
94
+ },
95
+ {
96
+ "target": "runtime-setup",
97
+ "type": "upstream_reference",
98
+ "label": "Detailed setup and configuration",
99
+ "when": {
100
+ "all": [
101
+ {
102
+ "field": "runtime.path",
103
+ "operator": "not_equals",
104
+ "value": "unselected"
105
+ },
106
+ {
107
+ "field": "stage.current",
108
+ "operator": "equals",
109
+ "value": "runtime_setup"
110
+ }
111
+ ]
112
+ }
113
+ },
114
+ {
115
+ "target": "runtime-readiness",
116
+ "type": "progression",
117
+ "label": "Readiness probing",
118
+ "when": {
119
+ "all": [
120
+ {
121
+ "field": "runtime.path",
122
+ "operator": "not_equals",
123
+ "value": "unselected"
124
+ },
125
+ {
126
+ "field": "runtime.verifiedReady",
127
+ "operator": "equals",
128
+ "value": false
129
+ }
130
+ ]
131
+ }
132
+ },
133
+ {
134
+ "target": "bridge-conflicts",
135
+ "type": "fallback",
136
+ "label": "Bridge conflicts",
137
+ "when": {
138
+ "all": [
139
+ {
140
+ "field": "runtime.conflictDetected",
141
+ "operator": "equals",
142
+ "value": true
143
+ }
144
+ ]
145
+ }
146
+ },
147
+ {
148
+ "target": "cli-appendix-job-outline",
149
+ "type": "progression",
150
+ "label": "CLI appendix workflows",
151
+ "when": {
152
+ "all": [
153
+ {
154
+ "field": "runtime.path",
155
+ "operator": "equals",
156
+ "value": "cli_appendix"
157
+ },
158
+ {
159
+ "field": "request.topic",
160
+ "operator": "equals",
161
+ "value": "cli_batch"
162
+ }
163
+ ]
164
+ }
165
+ }
166
+ ]
167
+ }
@@ -0,0 +1,21 @@
1
+ # Path 1 Host Outline — Connector `(a)` vs Manual MCP `(b)`
2
+
3
+ Both Path 1 host options share the **exact same Blender-side engine**: Official Blender Lab MCP add-on running inside **Blender 5.1+**. Only the client-side wiring differs.
4
+
5
+ | Aspect | Host `(a)` — Anthropic Connector | Host `(b)` — Manual MCP Client |
6
+ |---|---|---|
7
+ | **Typical clients** | Claude Desktop / Anthropic UI Connector flow | Claude Code, Cursor, Codex, OpenCode, Windsurf, Cline, Zed, Continue |
8
+ | **Blender version floor** | Blender **5.1+** | Blender **5.1+** |
9
+ | **Blender-side add-on** | Install & enable Blender Lab MCP add-on inside Blender preferences | Install & enable Blender Lab MCP add-on inside Blender preferences |
10
+ | **Client transport wiring** | Linked via Connector extension UI per Anthropic tutorial | Configured in client MCP JSON/TOML/YAML (`mcpServers` pointing at Lab server) |
11
+ | **Trust boundary** | Standalone Connector **cannot** operate without Lab add-on enabled | Client executes only upstream Lab tool schemas; no BlendOps-owned bridge |
12
+ | **Safe initial check** | Read-only scene introspection (`tier0_read_only`) | Read-only scene introspection (`tier0_read_only`) before any write |
13
+
14
+ ## Ordering Rule
15
+ 1. Confirm Blender version is `5.1+`.
16
+ 2. Confirm no competing Path 2 bridge add-on is enabled inside Blender (`bridge-conflicts`).
17
+ 3. Enable Blender Lab MCP add-on inside Blender first.
18
+ 4. Attach Host `(a)` OR Host `(b)` — never claim readiness before observed tool handshake.
19
+
20
+ ## Related skill
21
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,35 @@
1
+ # Path 1 Host Checklist Template
2
+
3
+ Use this step-by-step verification template when outlining **Path 1 (Official Blender Lab MCP)** for either host option **(a) Anthropic Blender Connector** or **(b) Manual MCP client** (Claude Code, Cursor, Codex, OpenCode, Cline, Continue, Zed, Windsurf, etc.). Remember the Blender **5.1+** floor applies specifically to the Lab add-on manifest.
4
+
5
+ ```txt
6
+ Path 1 Host Outline — Official Blender Lab MCP
7
+ =============================================
8
+ 1) Blender Executable Floor:
9
+ - Required for Path 1: Blender 5.1+ (Lab add-on manifest requirement)
10
+ - Detected / planned version: <e.g. Blender 5.2.3 LTS | Not checked yet>
11
+
12
+ 2) Blender-Side Lab MCP Add-on (MANDATORY before host setup):
13
+ - Installed Blender Lab MCP add-on inside Blender Preferences? [Yes | Pending user step]
14
+ - Add-on enabled and local server started inside Blender session? [Yes | Pending user step]
15
+ - Note: Anthropic Blender Connector is NOT standalone — step 2 is required even for Host (a).
16
+
17
+ 3) Host Wiring (choose exactly one active host):
18
+ - Host (a) Anthropic Blender Connector -> Follow Anthropic's official connector setup AFTER step 2
19
+ - Host (b) Manual MCP Client -> Follow `docs/install/<target>.md` and point client config to Lab MCP server
20
+
21
+ 4) Single-Bridge Sanity Check:
22
+ - Confirm community `mcp-for-blender` (Path 2) is disabled/unloaded and port 9876 has no conflicting bridge.
23
+ - If dual-bridge suspected -> stop and invoke `bridge-conflicts`.
24
+
25
+ 5) Initial Read-Only Verification:
26
+ - Run one non-mutating inspection check (`get_scene_info` / `blendops runtime doctor`) before creating or editing meshes.
27
+
28
+ Truth Status:
29
+ Runtime status: Not Run (until live tool output captured)
30
+ Artifact status: Not Produced
31
+ Source docs: docs/runtime-stack-strategy.md, docs/external-runtime-setup.md
32
+ ```
33
+
34
+ ## Related skill
35
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,12 @@
1
+ # Lab Add-on Reminders — Path 1 Prerequisites
2
+
3
+ Keep these hard boundaries visible whenever guiding a non-Blender user through Path 1 setup:
4
+
5
+ 1. **Blender 5.1+ applies to Path 1 ONLY**: The Lab MCP add-on manifest sets `blender_version_min = 5.1.0`. Translate in plain user language: *"This official connection needs Blender 5.1 or newer."* If the user cannot upgrade from 3.x/4.x, stop and route back to `runtime-path-picker` (Path 2 or CLI appendix).
6
+ 2. **Blender-side add-on precedes client setup**: Never advise enabling Anthropic Connector or editing Cursor/Claude Code MCP config alone and expecting Blender control to work. The Lab MCP add-on inside Blender opens the endpoint.
7
+ 3. **One bridge per instance**: Never leave a community `mcp-for-blender` add-on active alongside Lab MCP inside the same Blender preferences profile.
8
+ 4. **Verify add-on checkbox & restart if stalled**: Users frequently install the `.zip` without ticking the add-on enable checkbox or saving preferences before restarting Blender.
9
+ 5. **Conservative truth status**: Document setup steps cleanly, then require `runtime-readiness` checks (`Runtime status: Not Run` until handshake is observed).
10
+
11
+ ## Related skill
12
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,33 @@
1
+ # EVAL — plain-language-response
2
+
3
+ ## Text-only eval prompt
4
+ Use plain-language-response to transform technical findings into plain-language user output.
5
+
6
+ ## Expected behavior
7
+ - clear summary
8
+ - verified/unverified split
9
+ - prioritized next action
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: plain language + truthful caveats
13
+ - Warn: minor jargon remains but understandable
14
+ - Fail: overclaiming or jargon-heavy output
15
+
16
+ ## Common failure modes
17
+ - hiding blockers
18
+ - unsupported certainty language
19
+
20
+ ## Evidence expectations
21
+ - status aligned with evidence
22
+ - caveats included
23
+ - next action included
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