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,171 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "runtime-setup",
4
+ "version": "1.0.0",
5
+ "category": "runtime-and-execution",
6
+ "role": "path-1-and-2-setup-instructor",
7
+ "purpose": "Establish official runtime prerequisites and setup boundaries before any Blender execution claim.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "set up Blender runtime prerequisites",
11
+ "what are the Blender runtime setup boundaries",
12
+ "prepare Official Blender Lab MCP setup prerequisites",
13
+ "runtime prerequisites and version minimums"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "to install or configure a runtime automatically",
18
+ "delegateTo": "runtime-path-picker",
19
+ "reason": "Delegates out-of-scope requests to runtime-path-picker"
20
+ },
21
+ {
22
+ "condition": "to claim runtime execution has already succeeded",
23
+ "delegateTo": "path-one-host-outline",
24
+ "reason": "Delegates out-of-scope requests to path-one-host-outline"
25
+ },
26
+ {
27
+ "condition": "to choose a runtime path",
28
+ "delegateTo": "runtime-readiness",
29
+ "reason": "runtime-readiness"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "selected_runtime_path",
36
+ "type": "string",
37
+ "description": "Chosen execution path from runtime-path-picker (Path 1 Lab MCP, Path 2 mcp-for-blender, or CLI appendix)"
38
+ },
39
+ {
40
+ "name": "host_client_environment",
41
+ "type": "string",
42
+ "description": "User MCP host application (Claude Desktop Connector, Claude Code, Cursor, Windsurf, or manual client)"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "installed_blender_version",
48
+ "type": "string",
49
+ "description": "Installed Blender version used to check the Blender 5.1+ floor for Path 1 vs 3.0+ for Path 2"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "step_by_step_setup_prerequisites",
56
+ "path_version_and_host_boundary_notes",
57
+ "readiness_verification_handoff"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "runtime-path-picker",
68
+ "type": "upstream_reference",
69
+ "label": "Path selection",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "runtime.path",
74
+ "operator": "equals",
75
+ "value": "unselected"
76
+ }
77
+ ]
78
+ }
79
+ },
80
+ {
81
+ "target": "path-one-host-outline",
82
+ "type": "progression",
83
+ "label": "Path 1 host (a)/(b) details",
84
+ "when": {
85
+ "all": [
86
+ {
87
+ "field": "runtime.path",
88
+ "operator": "equals",
89
+ "value": "path_1"
90
+ },
91
+ {
92
+ "field": "stage.current",
93
+ "operator": "equals",
94
+ "value": "runtime_setup"
95
+ }
96
+ ]
97
+ }
98
+ },
99
+ {
100
+ "target": "cli-appendix-job-outline",
101
+ "type": "progression",
102
+ "label": "CLI appendix job structure",
103
+ "when": {
104
+ "all": [
105
+ {
106
+ "field": "runtime.path",
107
+ "operator": "equals",
108
+ "value": "cli_appendix"
109
+ },
110
+ {
111
+ "field": "request.topic",
112
+ "operator": "equals",
113
+ "value": "cli_batch"
114
+ }
115
+ ]
116
+ }
117
+ },
118
+ {
119
+ "target": "bridge-conflicts",
120
+ "type": "fallback",
121
+ "label": "Bridge conflict resolution",
122
+ "when": {
123
+ "all": [
124
+ {
125
+ "field": "runtime.conflictDetected",
126
+ "operator": "equals",
127
+ "value": true
128
+ }
129
+ ]
130
+ }
131
+ },
132
+ {
133
+ "target": "runtime-readiness",
134
+ "type": "progression",
135
+ "label": "Readiness matrix check",
136
+ "when": {
137
+ "all": [
138
+ {
139
+ "field": "runtime.path",
140
+ "operator": "not_equals",
141
+ "value": "unselected"
142
+ },
143
+ {
144
+ "field": "runtime.verifiedReady",
145
+ "operator": "equals",
146
+ "value": false
147
+ }
148
+ ]
149
+ }
150
+ },
151
+ {
152
+ "target": "product-hero-scene-planner",
153
+ "type": "alternative",
154
+ "label": "Scene planning after readiness",
155
+ "when": {
156
+ "all": [
157
+ {
158
+ "field": "brief.locked",
159
+ "operator": "equals",
160
+ "value": true
161
+ },
162
+ {
163
+ "field": "recipe.domain",
164
+ "operator": "equals",
165
+ "value": "product_hero"
166
+ }
167
+ ]
168
+ }
169
+ }
170
+ ]
171
+ }
@@ -0,0 +1,28 @@
1
+ # Runtime Option Decision Tree
2
+
3
+ ## Purpose
4
+ Establish prerequisite boundaries and select the lowest-risk runtime posture before any execution claim.
5
+
6
+ ## When to use
7
+ At the start of any task that may touch Blender — before claiming readiness, recommending a bridge, or scheduling writes.
8
+
9
+ ## Decision tree
10
+ 1. **Pure planning / brief / web-code handoff only?**
11
+ - Stay planning-only (`Runtime status: Not Run`, `Artifact status: Not Produced`). Do not invent runtime setup work the user did not ask for.
12
+ 2. **Claude Desktop / Claude.ai UI with Path 1 Connector?**
13
+ - State Path 1 prerequisites explicitly: **Blender 5.1+ + Blender Lab MCP add-on inside Blender** PLUS Connector linkage (never describe Connector as standalone).
14
+ 3. **IDE / CLI coding agent (Claude Code, Cursor, Codex, OpenCode, Windsurf, Cline, Zed, etc.)?**
15
+ - Recommend project-local BlendOps install + Path 1 host `(b)` manual MCP client (Blender 5.1+ Lab MCP) OR Path 2 `mcp-for-blender` (`3.0+`, community caveats) — never enable both simultaneously.
16
+ 4. **Uncertain host support or unverified native config path?**
17
+ - Fall back cleanly to `generic-root` adapter guidance with honest `linked-only` confidence label (`docs/adapter-registry.md`).
18
+ 5. **Runtime execution requested before probes ran?**
19
+ - Hand off to `runtime-path-picker` → `runtime-readiness` first; never assume readiness from installed config files alone.
20
+
21
+ ## Good example
22
+ "Target client Cursor uses project-local install; Path 1 host `(b)` selected conditional on Blender 5.1+ + Lab MCP add-on enabled. Runtime readiness not verified yet (`Runtime status: Not Run`)."
23
+
24
+ ## Bad example
25
+ "Installed Connector config, so Blender 5.1 runtime is ready to render." (Unverified premise + false readiness claim.)
26
+
27
+ ## Related skill
28
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,33 @@
1
+ # Setup Summary Template
2
+
3
+ ## Purpose
4
+ Standardize the final summary emitted by `runtime-setup` so non-Blender users see which path was chosen, what is verified on disk vs. linked-only, and one exact next step — without mixing up canonical truth states.
5
+
6
+ ## When to use
7
+ - At the conclusion of `runtime-setup` or whenever updating setup posture after checking a user's MCP host config.
8
+
9
+ ## Canonical Output Template
10
+ ```txt
11
+ Selected runtime path: <Path 1 (Lab MCP: Host a Connector / Host b Manual) | Path 2 (Community mcp-for-blender) | CLI Fallback (blender --background --python)>
12
+ Blender version floor: <5.1+ for Path 1 | 3.0+ for Path 2 | Upstream CLI surface>
13
+ Source confidence: <verified-read | linked-only | mixed>
14
+
15
+ What is verified locally (observed in this pass):
16
+ - <e.g. docs/install/cursor.md read; no conflicting Path 2 bridge found in workspace config>
17
+
18
+ What remains unverified / linked-only:
19
+ - <e.g. Blender executable version not yet checked on host; Lab MCP add-on toggle inside Blender UI pending user click>
20
+
21
+ Required single next step:
22
+ - <e.g. Install + enable Blender Lab MCP add-on inside Blender Preferences, then run a read-only connection check>
23
+
24
+ Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
25
+ Artifact status: <Not Produced | Produced | Verified | Failed>
26
+ ```
27
+
28
+ ## Good vs. Bad Rules
29
+ - **Good**: Uses only the 5 canonical runtime truth states (`Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`) and marks `Artifact status: Not Produced` during setup.
30
+ - **Bad**: Claims `"Setup complete, Blender ready to render!"` when no Blender process or MCP handshake was actually observed.
31
+
32
+ ## Related skill
33
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,23 @@
1
+ # Source Confidence Labels
2
+
3
+ ## Purpose
4
+ Standardize provenance confidence labels whenever `runtime-setup` or install skills cite upstream Blender, Anthropic Connector, `mcp-for-blender`, or IDE skill-path documentation.
5
+
6
+ ## When to use
7
+ - Whenever citing external setup guides, MCP client configuration schemas, or target native skill paths (`docs/install/*.md`, `docs/adapter-registry.md`).
8
+
9
+ ## Canonical Confidence Tiers
10
+
11
+ | Label | Exact Meaning | Allowed Action in BlendOps | Required Reason Format |
12
+ |---|---|---|---|
13
+ | `verified-read` | Source documentation or target config behavior was **directly inspected and verified** in this repository (`claude-code`, `generic-project`, Path 1 Lab MCP docs) | Safe to describe behavior directly; native fallback or verified target path allowed | Cite exact verified doc/path read (`verified-read: inspected docs/install/claude-code.md and verified CLAUDE.md + BLENDOPS.md behavior`) |
14
+ | `linked-only` | Official URL or community doc link is cataloged and reachable-by-reference, **but live target skill autoloader or client build was not empirically tested in this run** (`cursor`, `windsurf`, `zed`, etc.) | Default to safe project-local `BLENDOPS.md` unless user explicitly passes `--confirm-target-path` or `--with-skills-dir` | State URL + explicit unverified native caveat (`linked-only: official Cursor MCP docs cited; native .cursor/rules/ loader not empirically executed here`) |
15
+ | `mixed` | Base repo docs are `verified-read`, while a specific client plugin flag or OS binary version remains `linked-only` | Clearly split verified core steps from unverified host-specific steps | Bullet verified part separately from unverified host part |
16
+ | `unknown` | No authoritative doc, URL, or observed local command exists for the requested client or runtime bridge | **Fail closed** — stop setup instructions and ask user or point to `generic-project` fallback | State missing evidence explicitly (`unknown: no verified MCP config spec found for target X`) |
17
+
18
+ ## Good vs. Bad Usage
19
+ - **Good**: `"linked-only: official Zed MCP context_servers URL cited in docs/install/zed.md; Zed native skill loader unverified, so BLENDOPS.md fallback is active."`
20
+ - **Bad**: `"Probably supported in all IDEs"` (omits confidence tier and blurs verified facts with assumptions).
21
+
22
+ ## Related skill
23
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,33 @@
1
+ # EVAL — scene-readiness
2
+
3
+ ## Text-only eval prompt
4
+ Use scene-readiness to score a planned hero scene with pass/warn/fail and final verdict.
5
+
6
+ ## Expected behavior
7
+ - category rubric
8
+ - blockers/caveats
9
+ - verdict: Ready/Conditionally Ready/Not Ready/Not Run
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: full rubric + evidence-aligned verdict
13
+ - Warn: partial rubric with explicit caveat
14
+ - Fail: verdict without rubric/evidence
15
+
16
+ ## Common failure modes
17
+ - claiming Ready without artifacts
18
+ - missing blocker explanation
19
+
20
+ ## Evidence expectations
21
+ - mode label
22
+ - artifact status language
23
+ - rationale for verdict
24
+
25
+ ## Sample passing response outline
26
+ - Scope and mode stated clearly
27
+ - Evidence expectations listed
28
+ - Pass/warn/fail reasoning tied to checks
29
+
30
+ ## Sample failing response outline
31
+ - Overclaims runtime/artifact success
32
+ - Missing caveats or blocker details
33
+ - No clear next action
@@ -0,0 +1,195 @@
1
+ ---
2
+ name: scene-readiness
3
+ description: Run multi-category scene readiness gates (mesh, UVs, PBR, bake caches, camera, silhouette match) with PASS/WARN/FAIL verdicts before export.
4
+ ---
5
+
6
+ # scene-readiness
7
+
8
+ ## Purpose
9
+ Evaluate scene/workflow readiness honestly and consistently before any success claim.
10
+
11
+ ## Quick start
12
+ - confirm this skill fits your goal
13
+ - provide required inputs first
14
+ - keep runtime claims evidence-bound
15
+ - follow suggested next-skill handoff
16
+
17
+ ## When to use
18
+ - before readiness, export, or handoff claims to get a broad multi-category review
19
+ - after planning passes or after focused domain checkers have run
20
+ - during text-only or runtime evaluation reporting
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - as a replacement for evidence collection → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
25
+ - to fabricate confidence in missing artifacts → use `../lighting-material-plan/SKILL.md` (Delegates out-of-scope requests to lighting-material-plan)
26
+ <!-- blendops:generated:end exclusions -->
27
+
28
+ ## Trigger phrases
29
+ <!-- blendops:generated:start triggers -->
30
+ - "quality-check this scene"
31
+ - "is this ready"
32
+ - "evaluate pass warn fail"
33
+ <!-- blendops:generated:end triggers -->
34
+
35
+ ## Prerequisites / readiness
36
+ - plan output and acceptance criteria set available (e.g., from `acceptance-criteria-builder`)
37
+ - runtime truth state known (`Not Run | Attempted | Produced | Verified | Failed`; stays `Not Run` unless a real attempt was recorded)
38
+ - artifact truth state known (`Not Run | Not Produced | Produced | Verified | Failed`; defaults to `Not Produced` unless concrete output evidence exists)
39
+ - optional outputs from focused checkers (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`) and `render-export-evidence`
40
+
41
+ ## Input schema
42
+
43
+ ### Required inputs
44
+ - scene plan summary
45
+ - intended output criteria
46
+ - current runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`)
47
+ - current artifact truth state ledger (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`)
48
+
49
+ ### Optional inputs
50
+ - focused domain reports from `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `polycount-budget-checker`
51
+ - artifact evidence classification from `render-export-evidence`
52
+ - target quality threshold and destination-specific constraints
53
+
54
+ ### Assumptions to confirm
55
+ - whether a real runtime attempt was recorded (otherwise runtime stays `Not Run`)
56
+ - whether artifacts have verified provenance to the current run vs. being pre-existing files
57
+
58
+ ## Output schema
59
+
60
+ ### Primary output
61
+ - category-level pass/warn/fail matrix
62
+
63
+ ### Secondary output
64
+ - overall readiness verdict (`Ready | Conditionally Ready | Not Ready`, or `Not Run` when no runtime attempt happened) kept strictly separate from runtime/artifact truth states
65
+ - consolidated blockers and remediation steps traced from category scores
66
+
67
+ ### Evidence / caveat output
68
+ - downgrade-only runtime and artifact truth-state ledger (with provenance noted for any pre-existing files)
69
+ - explicit caveats, unknowns, and plain-language user impact
70
+
71
+ ## Required laws
72
+ - ../../laws/evidence-before-done.md
73
+ - ../../laws/non-blender-user-language.md
74
+ - ../../laws/official-runtime-only.md
75
+ - ../../laws/no-arbitrary-python-interface.md
76
+
77
+ ## Official runtime boundary
78
+ Review-only skill: never executes Blender, never runs or emits Python, and never produces artifacts. Runtime truth state stays `Not Run` unless a real attempt was recorded; artifact truth state defaults to `Not Produced` unless concrete output evidence from the current run exists. Truth states are downgrade-only (never upgrade). Text-only and blocked modes must remain explicit.
79
+
80
+ ## Operating procedure
81
+ 1. Confirm run mode, runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`), and artifact truth state (`Not Run | Not Produced | Produced | Verified | Failed`), verifying provenance to the current run for any existing files.
82
+ 2. Score **Subject clarity** against brief/plan intent.
83
+ 3. Score **Composition/camera** readiness (consume `composition-quality-checker` output if available; do not redo deep domain validation).
84
+ 4. Score **Lighting/material** readiness (consume `lighting-quality-checker` and `material-quality-checker` outputs if available; do not redo deep domain validation).
85
+ 5. Score **Scale, transforms, and geometry budget** readiness (consume `polycount-budget-checker` output if available).
86
+ 6. Score **Evidence and export readiness** (consume `render-export-evidence` classification if available; verify readiness for `pre-handoff-verification` and `glb-web-handoff` without taking over their roles).
87
+ 7. Assign independent Pass / Warn / Fail scores per category and trace how each contributes to the final outcome.
88
+ 8. Apply downgrade-only rules to truth states if gaps or missing provenance are found.
89
+ 9. Produce the final readiness verdict (`Ready | Conditionally Ready | Not Ready`, or `Not Run` when no runtime attempt happened), keeping the verdict scale separate from runtime and artifact truth states.
90
+
91
+ ## Decision tree
92
+ - If no runtime attempt happened → Runtime truth state stays `Not Run`, artifacts stay `Not Produced`, and readiness verdict is `Not Run` or `Conditionally Ready` (never `Ready`).
93
+ - If any critical category scores Fail or claims contradict evidence → Readiness verdict is `Not Ready`.
94
+ - If all critical categories Pass, runtime/artifact evidence is `Verified` for the current run, and no blockers remain → Readiness verdict is `Ready`.
95
+ - If critical categories Pass with minor warnings, or planning is complete while runtime/artifacts are unverified → Readiness verdict is `Conditionally Ready`.
96
+
97
+ ## Playbooks
98
+ - Playbook A: text-only planning path
99
+ - Playbook B: runtime-ready path with evidence gating
100
+ - Playbook C: blocked runtime path with caveat-first reporting
101
+
102
+ ## Mode handling
103
+
104
+ ### Text-only mode
105
+ - evaluate planning quality across categories only
106
+ - keep runtime truth state at `Not Run` and artifact truth states at `Not Produced`
107
+ - cap readiness verdict at `Conditionally Ready` or `Not Run` (never `Ready`)
108
+
109
+ ### Runtime-ready mode
110
+ - consume artifact classifications from `render-export-evidence` and domain checks from focused quality checkers
111
+ - require current-run provenance before accepting `Produced` or `Verified` artifact states
112
+
113
+ ### Blocked runtime mode
114
+ - keep readiness verdict conservative (`Not Ready`, `Conditionally Ready`, or `Not Run`)
115
+ - preserve exact runtime/artifact truth states (downgrade-only) and list blockers and next actions
116
+
117
+ ## Validation checklist
118
+ - [ ] run mode explicitly labeled
119
+ - [ ] runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`) and artifact truth state (`Not Run | Not Produced | Produced | Verified | Failed`) recorded separately from the readiness verdict
120
+ - [ ] truth states are downgrade-only (never upgraded) and pre-existing files require current-run provenance
121
+ - [ ] category rubric scored independently with clear traceability to the final verdict
122
+ - [ ] focused checker outputs consumed without redoing their domain work
123
+ - [ ] blocker list complete and caveats include plain-language user impact
124
+ - [ ] final readiness verdict (`Ready | Conditionally Ready | Not Ready | Not Run`) justified without unsupported success claims
125
+ - [ ] no uncaveated Path 2 guidance; CLI appendix never treated as a peer path
126
+ - [ ] plain-language summary and next-skill handoffs provided
127
+
128
+ ## Pass / Warn / Fail rubric
129
+
130
+ | Category | Pass | Warn | Fail |
131
+ |---|---|---|---|
132
+ | Subject clarity | Clear focal hierarchy aligned with brief | Minor ambiguity in secondary elements | Unclear focal subject or intent mismatch |
133
+ | Composition/camera | Coherent framing; passes `composition-quality-checker` if run | Minor framing gaps; needs review | Framing fails user goal or missing camera plan |
134
+ | Lighting/material | Supports intent; passes `lighting-quality-checker` / `material-quality-checker` if run | Minor tuning needed or focused checks pending | Major lookdev mismatch or broken shading/lighting plan |
135
+ | Scale/geometry budget | Real-world scale, clean transforms, passes `polycount-budget-checker` if run | Unconfirmed transforms or near budget limit | Wrong scale, unapplied transforms, or over budget |
136
+ | Evidence & handoff readiness | Claims match `render-export-evidence` with current-run provenance | Partial evidence or pre-handoff checks pending | Claims contradict evidence, or pre-existing files claimed as new |
137
+
138
+ ## Failure handling
139
+ - Missing runtime attempt or evidence: keep runtime truth state `Not Run`, keep artifact truth state `Not Produced` (downgrade-only, never upgrade), and cap readiness verdict at `Conditionally Ready` or `Not Run`.
140
+ - Critical category Fail: set readiness verdict to `Not Ready` with traced remediation steps.
141
+ - Unverified or pre-existing files without current-run provenance: refuse `Produced`/`Verified` attribution for this run and log a Warn/Fail caveat.
142
+ - Unknowns in domain specifics: log Warn with explicit caveat and recommend the appropriate focused checker (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, or `polycount-budget-checker`).
143
+
144
+ ## Troubleshooting
145
+ - If all categories pass but no artifacts exist: ensure verdict is not Ready.
146
+ - If pre-existing files found: do not attribute to current run without linkage.
147
+ - If plan quality high but runtime blocked: use Conditionally Ready or Not Run.
148
+
149
+ ## Best practices
150
+ - score categories independently before final verdict
151
+ - keep caveats visible in final summary
152
+ - preserve traceability from category score to verdict
153
+
154
+ ## Good examples
155
+ "Readiness Verdict: Conditionally Ready. All planning categories pass, but Runtime Truth State is `Not Run` and Artifact Truth State is `Not Produced` for this pass."
156
+
157
+ ## Bad examples
158
+ “Looks good overall, ship it.” (no rubric, no evidence mapping)
159
+
160
+ ## User-facing response template
161
+ - Current status
162
+ - What passed
163
+ - What needs follow-up
164
+ - Next best action
165
+
166
+ ## Anti-patterns
167
+ - conflating the readiness verdict scale (`Ready | Conditionally Ready | Not Ready | Not Run`) with runtime or artifact truth states
168
+ - upgrading runtime or artifact truth states, or attributing pre-existing files to the current run without provenance
169
+ - redoing deep per-domain validation instead of consuming `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, or `polycount-budget-checker`
170
+ - usurping artifact classification from `render-export-evidence`, gate ownership from `pre-handoff-verification`, or web packaging from `glb-web-handoff`
171
+ - skipping required laws, using Path 2 without caveats, treating CLI fallback as a peer path, or emitting jargon/Python
172
+
173
+ ## Cross-skill handoff
174
+ <!-- blendops:generated:start handoffs -->
175
+ - [upstream_reference] Focused domain validation (if gaps found) (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
176
+ - [upstream_reference] Focused domain validation (if gaps found) (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
177
+ - [upstream_reference] Focused domain validation (if gaps found) (material-quality-checker) → `../material-quality-checker/SKILL.md`
178
+ - [upstream_reference] Focused domain validation (if gaps found) (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
179
+ - [progression] Evidence classification → `../render-export-evidence/SKILL.md`
180
+ - [progression] Handoff gate → `../pre-handoff-verification/SKILL.md`
181
+ - [conditional] Web delivery (when applicable) → `../glb-web-handoff/SKILL.md`
182
+ - [progression] Final communication → `../plain-language-response/SKILL.md`
183
+ <!-- blendops:generated:end handoffs -->
184
+
185
+ ## Non-goals
186
+ - executing Blender or running/generating Python code
187
+ - producing or classifying raw render/export artifacts (owned by `render-export-evidence`)
188
+ - replacing focused domain validators (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`)
189
+ - owning final handoff gating (`pre-handoff-verification`) or web handoff packaging (`glb-web-handoff`)
190
+ - making evidence-free readiness claims
191
+
192
+ ## References
193
+ - https://www.blender.org/lab/mcp-server/
194
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
195
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html