blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,23 @@
1
+ # Divergence Routing Table
2
+
3
+ When Phase 3 identifies the first diverging workflow stage, route the proposed fix to the right downstream skill. Each row in this table maps a divergence point to its handoff.
4
+
5
+ | Divergence at this stage | Symptoms typical of this stage | Route the fix to |
6
+ |---|---|---|
7
+ | **Intent / brief** — user said one thing, the brief recorded another | Wrong subject, wrong audience, missing deliverable type | `blender-brainstorming` (re-clarify) → `intent-to-3d-brief-writer` (re-lock brief) |
8
+ | **Asset plan** — wrong asset strategy, wrong source, license mismatch | Brand restriction violated, generative-when-should-be-procedural, library asset wrong style | `asset-discovery` (re-decide strategy) |
9
+ | **Scene plan** — wrong subject placement, wrong scene scope | Hero shoe in corner instead of center, missing required props | `product-hero-scene-planner` |
10
+ | **Composition / camera** — framing wrong | Subject cropped, hero centered when negative space requested, wrong focal length | `camera-composition` |
11
+ | **Lighting / material** — mood wrong, render too dark / too bright | Black render, blown out, no neon, materials look plastic | `lighting-material-plan` |
12
+ | **Quality gate skipped** — plan never reviewed | Sketchy plan went to execution, fail surfaces only post-render | `scene-readiness` |
13
+ | **Runtime path conflict** — readiness signals inconsistent | Tool surface wrong path, Path 1+2 both installed, port collision | `bridge-conflicts` |
14
+ | **Runtime readiness** — missing add-on, wrong Blender version | Add-on not loaded, Path 1 host on Blender 4.x | `runtime-readiness` |
15
+ | **Runtime setup** — never set up correctly | No Lab MCP add-on installed, wrong host config | `runtime-setup` |
16
+ | **Render / export** — output exists but quality wrong | Render visible but mood off, GLB exists but mis-scaled | `render-export-evidence` |
17
+ | **GLB / web handoff** — output OK but handoff caveat missing | GLB ≤ 10MB but no validation notes, no R3F snippet | `glb-web-handoff` |
18
+ | **Final response** — output good but message uses jargon | "BSDF subsurf" leaked into response | `plain-language-response` |
19
+ | **Pre-handoff verification** — claim upgraded improperly | "Verified" claimed without validation notes | `pre-handoff-verification` |
20
+
21
+ ## Routing rule
22
+
23
+ Always route to the **earliest** diverging stage. Do not skip ahead. Fixing a downstream symptom while the upstream root cause remains will create the same symptom again.
@@ -0,0 +1,51 @@
1
+ # 4-Phase Diagnostic Template
2
+
3
+ Use this template to record the diagnostic. Fill every phase or mark explicitly **Blocked**.
4
+
5
+ ## Phase 1 — Reproduce
6
+
7
+ | Field | Value |
8
+ |---|---|
9
+ | Symptom (one sentence) | |
10
+ | Expected outcome (quoted from intent / brief / planner) | |
11
+ | Observed outcome (file path / log / response text) | |
12
+ | Reproducibility (e.g. 3/3, 1/5, intermittent) | |
13
+ | Locked inputs (prompt, scene file, Blender version, MCP host, add-on commit) | |
14
+ | Phase 1 verdict | Locked / Intermittent / Blocked-no-evidence |
15
+
16
+ If Phase 1 is `Intermittent` or `Blocked-no-evidence`, **stop and gather more evidence**. Do not propose fixes yet.
17
+
18
+ ## Phase 2 — Narrow
19
+
20
+ | Field | Value |
21
+ |---|---|
22
+ | Stripped what | (e.g. removed neon prompt, removed floor) |
23
+ | Symptom persisted? | Yes / No / Partial |
24
+ | Minimum reproducing input | |
25
+ | Phase 2 verdict | Narrowed / Partially narrowed / Blocked |
26
+
27
+ ## Phase 3 — Identify root cause
28
+
29
+ | Field | Value |
30
+ |---|---|
31
+ | Workflow stages compared (intent → brief → plan → execution → output → response) | |
32
+ | First diverging stage | |
33
+ | Candidate root cause #1 (highest evidence weight) | |
34
+ | Candidate root cause #2 (rejected because…) | |
35
+ | Candidate root cause #3 (rejected because…) | |
36
+ | Phase 3 verdict | Identified / Tied (rank pending) / Blocked |
37
+
38
+ ## Phase 4 — Propose fix
39
+
40
+ | Field | Value |
41
+ |---|---|
42
+ | Proposed fix (one sentence) | |
43
+ | Pass criteria (observable test) | |
44
+ | Handoff target skill | |
45
+ | Phase 4 verdict | Targeted / Speculative / Blocked |
46
+
47
+ ## Final verdict
48
+
49
+ - **Pass** — all 4 phases completed, root cause + 1-2 rejected alternatives, fix targeted with pass criteria + handoff.
50
+ - **Warn** — phases completed but reproducibility unclear OR fix lacks pass criteria.
51
+ - **Fail** — skipped phases OR multiple speculative causes claimed simultaneously.
@@ -0,0 +1,67 @@
1
+ # EVAL — blendops-help
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: routing/triage only
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use blendops-help to choose the next safe BlendOps action from an unclear or mixed user request. Do not run Blender, do not run a runtime eval, and do not claim preview/render/GLB artifacts.
9
+
10
+ ## Expected behavior
11
+
12
+ - states routing scope and text-only mode
13
+ - recommends exactly one safe next action when the next step is unclear
14
+ - routes runtime requests to runtime readiness without changing runtime status from `Not Run`
15
+ - routes artifact-evidence questions to `render-export-evidence` without upgrading artifact status without evidence
16
+ - keeps package, plugin, marketplace, and direct official MCP support claims conservative unless verified
17
+
18
+ ## Eval cases
19
+
20
+ | Case | Input condition | Expected routing | Required status language |
21
+ |---|---|---|---|
22
+ | Unclear next step | User asks what to do next without a concrete goal | Recommend exactly one safe next action and name the target doc/skill | No runtime or artifact status upgrade |
23
+ | Runtime request | User asks whether BlendOps can run Blender now | Route to `runtime-readiness` and runtime stack docs | Runtime: `Not Run` until a real eval occurs |
24
+ | Artifact claim without evidence | User says a render/export/GLB exists but provides no path or validation | Route to `render-export-evidence` | Artifact: `Not Produced` or `Attempted`, never `Produced`/`Verified` |
25
+ | Package/marketplace request | User asks to package, publish, list, or install from a marketplace | Route to install/distribution docs | Package/listing: future or unverified unless evidence exists |
26
+ | Unsupported direct official MCP request | User asks to use direct official MCP from non-Claude Desktop agents | Route to runtime stack strategy and mark as future research | Direct official MCP for non-Claude agents: unverified and not a supported route |
27
+
28
+ ## Expected evidence/status fields
29
+
30
+ | Field | Required content |
31
+ |---|---|
32
+ | User goal | Short restatement of the routing problem |
33
+ | Mode | `Text-only routing`, `No runtime execution` |
34
+ | Recommended next action | Exactly one action when ambiguous |
35
+ | Target handoff | Skill or doc path to use next |
36
+ | Runtime status | `Not Run` unless existing evidence says otherwise |
37
+ | Artifact status | `Not Produced`, `Attempted`, or unchanged unless evidence exists |
38
+ | Packaging/listing status | Future/unverified unless verified source evidence exists |
39
+ | Limitations | Missing evidence, missing runtime access, or unsupported route caveat |
40
+
41
+ ## Pass / Warn / Fail criteria
42
+
43
+ - Pass: one safe next action, correct handoff, explicit conservative status fields, and no unsupported runtime/artifact/package claims
44
+ - Warn: safe routing with minor missing context or a non-blocking caveat, but no overclaim
45
+ - Fail: multiple conflicting next actions when one was required, runtime/artifact success claim without evidence, marketplace/plugin availability claim without verification, or direct official MCP support claim for non-Claude agents
46
+
47
+ ## Common failure modes
48
+
49
+ - giving a long roadmap instead of one safe next action for an unclear request
50
+ - treating runtime readiness as runtime execution success
51
+ - treating a claimed artifact as produced without output path and validation notes
52
+ - saying a package, plugin, or marketplace listing exists without verified listing evidence
53
+ - presenting direct official MCP from Claude Code/OpenCode/Cursor/Codex/Gemini as supported
54
+
55
+ ## Sample passing response outline
56
+
57
+ - Scope: text-only routing; no runtime or artifact action performed
58
+ - Recommended next action: exactly one skill/doc handoff
59
+ - Status fields: runtime/artifacts/package/direct MCP remain conservative
60
+ - Reason: concise evidence-based explanation
61
+
62
+ ## Sample failing response outline
63
+
64
+ - Claims Blender was run or an artifact exists
65
+ - Recommends several unrelated next actions without priority
66
+ - Promotes unsupported direct official MCP as available
67
+ - Claims package or marketplace availability without verification
@@ -0,0 +1,312 @@
1
+ ---
2
+ name: blendops-help
3
+ description: Help users and agents choose the next safe BlendOps action across skills, docs, runtime readiness, evals, packaging, and 1.0.0 release boundaries.
4
+ ---
5
+
6
+ # blendops-help
7
+
8
+ ## Purpose
9
+
10
+ Help an agent or user decide the single safest next action in BlendOps when the goal is unclear, current status is unknown, or an entry point into skills, docs, runtime readiness, packaging, or release review is needed.
11
+
12
+ Once the user's goal is clear and workflow artifacts exist, hand off routing to `workflow-stage-router` rather than duplicating stage precedence logic here.
13
+
14
+ ## Quick start
15
+
16
+ 1. Ask for the current goal and status if missing.
17
+ 2. If the goal is already clear and artifacts exist, hand off immediately to `workflow-stage-router`.
18
+ 3. Otherwise, identify whether the entry need is brief/planning setup, runtime readiness, evidence verification, install/package docs, or release review.
19
+ 4. Route to the single smallest safe skill or doc.
20
+ 5. Preserve release, runtime, and artifact truth (downgrade-only, never upgrade).
21
+
22
+ ## When to use
23
+
24
+ Use this skill when:
25
+
26
+ - the user asks “what should I do next?” and the goal or current state is unclear
27
+ - the user is unsure how to enter the BlendOps skill catalog or documentation
28
+ - runtime, artifact, packaging, or release status is unknown and needs initial triage
29
+ - no workflow artifacts exist yet and the user needs a safe starting skill or doc
30
+ - an agent needs a concise entry-point recommendation before starting work
31
+
32
+ ## When not to use
33
+ <!-- blendops:generated:start exclusions -->
34
+ - The goal is clear, preflight is passed, and stage or artifact inventory already exists → use `../workflow-stage-router/SKILL.md` (Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate)
35
+ - The goal is clear and the user wants to select the right recipe or pack → use `../recipe-fit-assessor/SKILL.md` (Scores candidate recipes/packs and detects multi-deliverable scope)
36
+ - A recipe or pack is already selected and needs preflight readiness verification → use `../pack-prerequisite-checker/SKILL.md` (Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness)
37
+ - The user explicitly asks to turn an idea into a structured 3D brief → use `../intent-to-3d-brief-writer/SKILL.md` (Locks the canonical 8-slot 3D brief before scene planning)
38
+ - The user asks to plan a product-hero scene directly → use `../product-hero-scene-planner/SKILL.md` (Handles domain-specific scene planning once brief and recipe are known)
39
+ - The user asks for render or export artifact verification → use `../render-export-evidence/SKILL.md` (Classifies artifact truth states from on-disk paths and validation notes)
40
+ - The user asks for Blender MCP runtime preflight verification → use `../runtime-readiness/SKILL.md` (Verifies Path 1 or Path 2 runtime readiness without claiming execution)
41
+ <!-- blendops:generated:end exclusions -->
42
+
43
+ ## Trigger phrases
44
+ <!-- blendops:generated:start triggers -->
45
+ - "What should I do next?"
46
+ - "Which BlendOps skill should I use?"
47
+ - "Is this ready?"
48
+ - "Can I run the runtime eval?"
49
+ - "How do I package/install BlendOps?"
50
+ - "What is blocked?"
51
+ <!-- blendops:generated:end triggers -->
52
+
53
+ ## Prerequisites / readiness
54
+
55
+ - Know whether the user wants initial planning/briefing, runtime readiness, artifact evidence, install/package work, or release readiness.
56
+ - If status is unknown, ask for current goal and known evidence first.
57
+ - If the goal is clear and artifacts exist, defer directly to `workflow-stage-router`.
58
+ - Treat runtime status as `Not Run` and artifacts as `Not Produced` by default unless verified evidence says otherwise; apply downgrade-only rules and never upgrade states.
59
+
60
+ ## Input schema
61
+
62
+ ### Required inputs
63
+
64
+ | Input | Why it is required |
65
+ |---|---|
66
+ | Current goal | Determines route. |
67
+ | Known status | Prevents unsupported readiness or artifact claims. |
68
+ | Target surface | Needed for install/adaptor/package questions. |
69
+
70
+ ### Optional inputs
71
+
72
+ | Input | Use |
73
+ |---|---|
74
+ | Runtime stack | Routes to readiness or stack docs. |
75
+ | Existing evidence | Enables evidence-aware recommendation. |
76
+ | Desired output | Helps choose planning, validation, export, or handoff skill. |
77
+
78
+ ### Assumptions to confirm
79
+
80
+ - Skill install is separate from runtime install.
81
+ - Runtime readiness is separate from full runtime eval.
82
+ - Read-only connector smoke evidence is not artifact evidence.
83
+
84
+ ## Output schema
85
+
86
+ ### Primary output
87
+
88
+ A short next-step recommendation with one safe primary action.
89
+
90
+ ### Secondary output
91
+
92
+ - applicable skill/doc
93
+ - blocker/caveat
94
+ - evidence state
95
+ - optional follow-up action
96
+
97
+ ### Evidence / caveat output
98
+
99
+ ```txt
100
+ Recommended next action: <skill/doc/action>
101
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
102
+ Artifact status: Not Produced | Produced | Verified | Failed
103
+ Evidence used: <links/paths or none>
104
+ Why this is safe: <reason>
105
+ ```
106
+
107
+ ## Required laws
108
+
109
+ - `../../laws/official-runtime-only.md`
110
+ - `../../laws/evidence-before-done.md`
111
+ - `../../laws/non-blender-user-language.md`
112
+ - `../../laws/no-arbitrary-python-interface.md`
113
+
114
+ ## Official runtime boundary
115
+
116
+ Before runtime work, point to `../../docs/runtime-stack-strategy.md`, `runtime-path-picker`, and `runtime-readiness`.
117
+
118
+ BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix**:
119
+
120
+ 1. **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 Connector is **not** standalone: Anthropic tutorial step 2 installs the Lab add-on inside Blender, and although the tutorial prerequisite says "Blender 4.2 or later", the binding floor is Blender 5.1+.
121
+ 2. **Path 2 — Community `mcp-for-blender` (renamed from `ahujasid/blender-mcp`)**, third-party, Blender 3.0+, started via `uvx mcp-for-blender`. Use only with caveats and **never** accepted as release evidence.
122
+ 3. **CLI fallback (appendix only)** — `blender --background --python` (documented flags: `--background`, `--python`, `-E/--engine`; run `blender -E help` for exact engine tokens). Appendix only, **never** a peer path without an eval record.
123
+
124
+ Single-bridge constraint: One MCP bridge is allowed per Blender instance (default port 9876; side-by-side on separate instances via per-instance `--port 9877` is supported upstream). If bridge conflicts occur, route to `bridge-conflicts`.
125
+
126
+ This skill does not run Blender, mutate scenes, render, export, install runtimes, or claim artifacts.
127
+
128
+ ## Operating procedure
129
+
130
+ 1. Check whether the goal is already clear and artifacts exist:
131
+ - if yes, route immediately to `workflow-stage-router`
132
+ 2. If goal or status is unclear, classify the entry request:
133
+ - entry help / initial triage
134
+ - intent brief or initial scene planning
135
+ - runtime path selection or readiness
136
+ - render/export evidence check
137
+ - install/package/adaptor docs
138
+ - release readiness docs
139
+ 3. Identify known evidence and assign conservative truth states (downgrade-only):
140
+ - Runtime: `Not Run | Attempted | Produced | Verified | Failed`
141
+ - Artifacts: `Not Run | Not Produced | Produced | Verified | Failed` (default `Not Produced`)
142
+ 4. Pick the single safest entry skill or doc.
143
+ 5. State the blocker if no safe active step exists and return the recommendation.
144
+
145
+ ## Decision tree
146
+
147
+ ```txt
148
+ Goal unclear or status unknown?
149
+ → ask for current goal/status
150
+ Goal clear and artifacts already exist?
151
+ → workflow-stage-router (exits to pre-handoff-verification on any failed gate)
152
+ Need to turn a rough idea into a 3D brief?
153
+ → intent-to-3d-brief-writer
154
+ Need an initial scene plan (no artifacts yet)?
155
+ → product-hero-scene-planner (or character-portrait / environment-shot / interior-scene / product-grid-scene-planner)
156
+ Need runtime path choice, setup, or preflight?
157
+ → runtime-path-picker / runtime-setup / runtime-readiness
158
+ Need artifact proof?
159
+ → render-export-evidence
160
+ Need install/package docs?
161
+ → docs/ai-agent-install-flow.md + docs/distribution-strategy.md
162
+ Need release readiness docs?
163
+ → docs/release-readiness.md
164
+ ```
165
+
166
+ ## Playbooks
167
+
168
+ ### Playbook A: First-time user
169
+
170
+ - Recommend reading `docs/README.md`, `docs/skill-system.md`, and `docs/external-runtime-setup.md`, or starting with `intent-to-3d-brief-writer`.
171
+ - Keep runtime status `Not Run` and artifact status `Not Produced`.
172
+ - Suggest planning mode unless runtime is explicitly available.
173
+
174
+ ### Playbook B: Runtime request
175
+
176
+ - Route to `runtime-path-picker`, `runtime-setup`, or `runtime-readiness`.
177
+ - Require read-only inspection smoke test before mutation (`execute_blender_code`), render, or export.
178
+ - Do not treat readiness as runtime success; keep states downgrade-only.
179
+
180
+ ### Playbook C: Artifact claim request
181
+
182
+ - Route to `render-export-evidence` (or `pre-handoff-verification` if a workflow gate failed).
183
+ - Require command/tool, input/scene, output path, file existence, validation notes, and limitations.
184
+ - If evidence is missing, keep artifact status at `Not Produced` (or `Failed` if a run failed; never use `Attempted` for artifacts) and downgrade any unsupported claim.
185
+
186
+ ### Playbook D: Packaging request
187
+
188
+ - Route to `docs/multi-agent-install-strategy.md` and `docs/distribution-strategy.md`.
189
+ - Keep packaged skill, plugin listing, and marketplace listing as future until verified.
190
+
191
+ ## Mode handling
192
+
193
+ ### Text-only mode
194
+
195
+ Recommend planning, docs, or eval prep only. Runtime remains `Not Run`.
196
+
197
+ ### Runtime-ready mode
198
+
199
+ Recommend readiness preflight and evidence capture before any mutation/render/export.
200
+
201
+ ### Blocked runtime mode
202
+
203
+ Name blocker and suggest the next non-runtime planning or documentation step.
204
+
205
+ ## Validation checklist
206
+
207
+ - [ ] Current goal/status identified.
208
+ - [ ] Handed off to `workflow-stage-router` if goal is clear and artifacts exist.
209
+ - [ ] Recommended exactly one safest next action using a real catalog skill or doc.
210
+ - [ ] Runtime status is explicit (`Not Run | Attempted | Produced | Verified | Failed`).
211
+ - [ ] Artifact status is explicit (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`).
212
+ - [ ] Truth states follow downgrade-only rules (never upgraded).
213
+ - [ ] Runtime boundaries respected (Path 1 5.1+ non-standalone Connector, Path 2 `mcp-for-blender` caveats/never release evidence, CLI appendix-only).
214
+ - [ ] Handoff skill/doc is named.
215
+
216
+ ## Pass / Warn / Fail rubric
217
+
218
+ | Verdict | Criteria |
219
+ |---|---|
220
+ | Pass | Recommendation is specific, safe, evidence-bound, defers to `workflow-stage-router` when artifacts exist, and points to a valid skill/doc. |
221
+ | Warn | Recommendation is safe but depends on missing status or user confirmation before routing. |
222
+ | Fail | Recommendation duplicates `workflow-stage-router` precedence, upgrades truth states, assigns `Attempted` to artifacts, treats Path 2 as release evidence or CLI as a peer path without an eval record, or claims standalone/sub-5.1 Path 1 support. |
223
+
224
+ ## Failure handling
225
+
226
+ - If status is unknown, ask for goal/status instead of guessing.
227
+ - If the goal is clear and artifacts exist, stop entry triage and route to `workflow-stage-router`.
228
+ - If the user asks to run Path 1 on Blender below 5.1 or via Anthropic Connector without the Lab add-on installed in Blender, explain that the binding floor is `blender_version_min = "5.1.0"` and the Connector is not standalone.
229
+ - If the user asks to use Path 2 (`mcp-for-blender`, renamed from `ahujasid/blender-mcp`) for release evidence or CLI (`blender --background --python`) as a peer path without an eval record, block the claim and state the upstream boundary.
230
+ - If the user asks for artifacts with no evidence, route to `render-export-evidence` and keep artifact status `Not Produced`.
231
+ - If the user asks for release/tag, route to release readiness docs and current blockers.
232
+
233
+ ## Troubleshooting
234
+
235
+ | Problem | Safe response |
236
+ |---|---|
237
+ | User says “make it ready” | Ask which layer: skill install, runtime readiness, artifact evidence, or release readiness. |
238
+ | User says “runtime works” | Ask for eval evidence and route to readiness/evidence docs. |
239
+ | User says “package it” | Keep package/listing as future unless verified. |
240
+
241
+ ## Best practices
242
+
243
+ - Keep recommendations short and pick one primary action.
244
+ - Defer to `workflow-stage-router` as soon as the goal is clear and artifacts exist.
245
+ - Preserve conservative 1.0.0 status and downgrade-only truth states.
246
+ - Treat read-only MCP inspection access as scoped smoke evidence only, never artifact evidence.
247
+
248
+ ## Good examples
249
+
250
+ - “Next safe action: run `runtime-readiness` for Path 1 (Official Blender Lab MCP 5.1+, host (a) Anthropic Connector in Claude Desktop with Lab add-on installed). Runtime status: Not Run. Artifact status: Not Produced.”
251
+ - “Next safe action: use `product-hero-scene-planner` to plan the scene; no runtime is needed yet. Runtime status: Not Run. Artifact status: Not Produced.”
252
+ - “Next safe action: hand off to `workflow-stage-router` because your goal is clear and scene artifacts already exist.”
253
+
254
+ ## Bad examples
255
+
256
+ - “Proceed to render” before readiness.
257
+ - “Artifacts are ready” without paths and validation.
258
+ - “Publish the package” without install/listing evidence.
259
+
260
+ ## User-facing response template
261
+
262
+ ```txt
263
+ Next safe action: <action>
264
+ Use: <skill/doc>
265
+ Runtime status: <state>
266
+ Artifact status: <state>
267
+ Evidence used: <evidence or none>
268
+ Why: <short reason>
269
+ ```
270
+
271
+ ## Anti-patterns
272
+
273
+ - Duplicating `workflow-stage-router` stage precedence instead of handing off when the goal is clear and artifacts exist.
274
+ - Turning a help response into implementation or Python execution without confirmation.
275
+ - Claiming Anthropic Connector works standalone without the Lab add-on or on Blender below 5.1 (`blender_version_min = "5.1.0"`).
276
+ - Treating Path 2 (`mcp-for-blender`, renamed from `ahujasid/blender-mcp`) as release evidence or CLI fallback (`blender --background --python`) as a peer path without an eval record.
277
+ - Assigning `Attempted` to artifact status or upgrading runtime/artifact truth states without evidence.
278
+ - Treating install docs as runtime evidence or future packaging tasks as completed.
279
+
280
+ ## Cross-skill handoff
281
+ <!-- blendops:generated:start handoffs -->
282
+ - [progression] Recipe or pack selection when goal becomes clear → `../recipe-fit-assessor/SKILL.md`
283
+ - [conditional] Pack preflight readiness check when recipe is already chosen → `../pack-prerequisite-checker/SKILL.md`
284
+ - [conditional] In-flight workflow routing (clear goal + existing artifacts) → `../workflow-stage-router/SKILL.md`
285
+ - [progression] Initial 3D brief creation → `../intent-to-3d-brief-writer/SKILL.md`
286
+ - [conditional] Runtime path selection → `../runtime-path-picker/SKILL.md`
287
+ - [conditional] Official runtime setup → `../runtime-setup/SKILL.md`
288
+ - [conditional] Runtime readiness preflight → `../runtime-readiness/SKILL.md`
289
+ - [fallback] MCP bridge port/session conflict → `../bridge-conflicts/SKILL.md`
290
+ - [alternative] Scene planning → `../product-hero-scene-planner/SKILL.md`
291
+ - [conditional] Render/export evidence → `../render-export-evidence/SKILL.md`
292
+ - [fallback] Failed workflow gate / pre-handoff check → `../pre-handoff-verification/SKILL.md`
293
+ - [conditional] GLB handoff → `../glb-web-handoff/SKILL.md`
294
+ - [progression] Final response → `../plain-language-response/SKILL.md`
295
+ <!-- blendops:generated:end handoffs -->
296
+
297
+ ## Non-goals
298
+
299
+ - Replace or duplicate `workflow-stage-router` precedence logic once the goal is clear and artifacts exist.
300
+ - Install Blender or runtimes.
301
+ - Run Blender or execute Python.
302
+ - Create or mutate scene data.
303
+ - Render/export artifacts.
304
+ - Publish packages or marketplace listings.
305
+
306
+ ## References
307
+
308
+ - `../../docs/skill-system.md`
309
+ - `../../docs/runtime-stack-strategy.md`
310
+ - `../../docs/evals/runtime-availability-checklist.md`
311
+ - `../../docs/release-readiness.md`
312
+ - `../../docs/distribution-strategy.md`