blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,194 @@
1
+ ---
2
+ name: plain-language-response
3
+ description: Translate technical Blender status, GLB handoffs, and quality caveats into jargon-free stakeholder updates for non-Blender users.
4
+ ---
5
+
6
+ # plain-language-response
7
+
8
+ ## Purpose
9
+ Produce stakeholder-friendly outputs that preserve truthfulness, evidence boundaries, and clear next actions.
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
+ - in the final response phase to convert technical findings into plain-language user-facing wording
19
+ - after `render-export-evidence` classifies artifact evidence, validators (such as `scene-readiness`, `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`) supply pass/warn/fail outcomes, `glb-web-handoff` supplies the handoff summary, and `pre-handoff-verification` gates the handoff
20
+ - when translating technical blockers, caveats, and verified/unverified status splits for non-Blender users
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - to hide blockers, drop caveats for readability, or overclaim runtime or artifact success → use `../render-export-evidence/SKILL.md` (Delegates out-of-scope requests to render-export-evidence)
25
+ - to upgrade Runtime or Artifact truth states → use `../scene-readiness/SKILL.md` (Delegates out-of-scope requests to scene-readiness)
26
+ - to classify raw artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
27
+ - to generate technical pass/warn/fail checks → use `../scene-readiness/SKILL.md` (use scene-readiness or domain quality checkers)
28
+ - to assemble technical GLB/web compatibility summaries → use `../glb-web-handoff/SKILL.md` (use glb-web-handoff)
29
+ - to gate handoff readiness → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
30
+ <!-- blendops:generated:end exclusions -->
31
+
32
+ ## Trigger phrases
33
+ <!-- blendops:generated:start triggers -->
34
+ - "write final user summary"
35
+ - "explain this for non-Blender user"
36
+ - "make this stakeholder-friendly"
37
+ <!-- blendops:generated:end triggers -->
38
+
39
+ ## Prerequisites / readiness
40
+ - classified Runtime and per-artifact evidence states from `render-export-evidence`
41
+ - pass/warn/fail findings from upstream validators (e.g. `scene-readiness`)
42
+ - handoff summary and caveats from `glb-web-handoff` (when applicable) and gate status from `pre-handoff-verification`
43
+ - complete list of active blockers and caveats
44
+
45
+ ## Input schema
46
+
47
+ ### Required inputs
48
+ - Runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact truth states (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) from `render-export-evidence`
49
+ - pass/warn/fail outcomes from upstream validators and gate status from `pre-handoff-verification`
50
+ - technical handoff summary (from `glb-web-handoff` when applicable), blockers, and caveats
51
+
52
+ ### Optional inputs
53
+ - audience context (client, product owner, internal team)
54
+ - preferred response brevity
55
+
56
+ ### Assumptions to confirm
57
+ - the reader is a non-Blender user who needs jargon-free language
58
+ - blockers and caveats must remain visible with clear user impact (never dropped for readability)
59
+ - truth states are strictly downgrade-only (never upgrade); contradictory status language must downgrade to safer wording
60
+
61
+ ## Output schema
62
+
63
+ ### Primary output
64
+ - concise, jargon-free plain-language summary of what was requested and current status
65
+
66
+ ### Secondary output
67
+ - caveats translated into plain-language user impact
68
+ - prioritized next actions
69
+
70
+ ### Evidence / caveat output
71
+ - explicit verified vs unverified split
72
+ - explicit Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`), strictly downgrade-only
73
+
74
+ ## Required laws
75
+ - ../../laws/non-blender-user-language.md
76
+ - ../../laws/evidence-before-done.md
77
+ - ../../laws/official-runtime-only.md
78
+ - ../../laws/no-arbitrary-python-interface.md
79
+
80
+ ## Official runtime boundary
81
+ Never imply runtime success or artifact existence without concrete evidence, never hide blockers, and never drop caveats for readability. Keep Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states strictly downgrade-only — if upstream status language is contradictory, downgrade to safer wording. Keep runtime vocabulary strictly within the 2-path + CLI appendix model. This skill writes final wording only and never executes Python or Blender or replaces upstream evidence, validator, handoff, or gate skills.
82
+
83
+ ## Operating procedure
84
+ 1. Identify the audience and restate the request in plain, jargon-free language.
85
+ 2. Check upstream inputs (`render-export-evidence`, validators, `glb-web-handoff`, `pre-handoff-verification`); if status language is contradictory, downgrade to safer wording and never upgrade any truth state.
86
+ 3. State current Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) in plain language.
87
+ 4. Explicitly separate what is verified from what remains unverified.
88
+ 5. Translate every technical blocker and caveat into concrete user impact without hiding blockers or dropping caveats for readability.
89
+ 6. Preserve upstream pass/warn/fail meaning accurately.
90
+ 7. List clear, prioritized next actions.
91
+ 8. Audit final wording to remove dense Blender jargon and any unsupported certainty phrases.
92
+
93
+ ## Decision tree
94
+ - If `pre-handoff-verification` passes, evidence is classified by `render-export-evidence`, and validator status is positive -> write plain-language readiness summary + explicit verified/unverified split + caveats with user impact + prioritized next actions.
95
+ - If evidence is partial, unverified, or contradictory -> downgrade contradictory status language to safer wording, highlight the unverified split and user impact, and list prioritized verification steps.
96
+ - If runtime is blocked or major validator/export failures exist -> state the `Failed`, `Not Run`, or `Not Produced` state plainly without hiding blockers, explain the user impact, and list prioritized remediation steps.
97
+ - If upstream evidence classification, handoff summary, or gate verification is missing -> route to `render-export-evidence`, `glb-web-handoff`, or `pre-handoff-verification` before claiming completion.
98
+
99
+ ## Playbooks
100
+ - Playbook A: text-only planning path
101
+ - Playbook B: runtime-ready path with evidence gating
102
+ - Playbook C: blocked runtime path with caveat-first reporting
103
+
104
+ ## Mode handling
105
+
106
+ ### Text-only mode
107
+ - emphasize that work is currently in planning-only state
108
+ - state Runtime status as `Not Run` and artifact statuses as `Not Run` or default `Not Produced` (downgrade-only)
109
+
110
+ ### Runtime-ready mode
111
+ - report evidence-linked Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) alongside the verified/unverified split and caveats
112
+
113
+ ### Blocked runtime mode
114
+ - state blockers, user impact, and setup next steps plainly without blame language
115
+ - keep Runtime and artifact statuses at `Not Run`, `Not Produced`, or `Failed` (never upgrade)
116
+
117
+ ## Validation checklist
118
+ - [ ] plain-language summary present and jargon-free
119
+ - [ ] explicit verified vs unverified split included
120
+ - [ ] Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states preserved (downgrade-only)
121
+ - [ ] contradictory status language downgraded to safer wording
122
+ - [ ] upstream pass/warn/fail meaning preserved without role blur
123
+ - [ ] all blockers visible and caveats translated into user impact (none dropped for readability)
124
+ - [ ] next actions clearly prioritized
125
+ - [ ] no unsupported certainty language or dense jargon blocks
126
+ - [ ] runtime vocabulary stays within the 2-path + CLI appendix model
127
+
128
+ ## Pass / Warn / Fail rubric
129
+
130
+ | Category | Pass | Warn | Fail |
131
+ |---|---|---|---|
132
+ | Clarity | Non-technical reader understands outcome | Minor jargon remains | Jargon-heavy/confusing |
133
+ | Truthfulness | Claims align with evidence | Partial ambiguity | Overclaiming present |
134
+ | Actionability | Next steps clear and prioritized | Generic next steps | No clear next steps |
135
+ | Caveat quality | Caveats preserved with impact | Caveats vague | Caveats missing |
136
+
137
+ ## Failure handling
138
+ - Missing evidence classification: keep artifact status at default `Not Produced` (or `Not Run`) and route to `render-export-evidence`.
139
+ - Contradictory upstream status language: downgrade immediately to the safer truth state and note the uncertainty in the unverified section.
140
+ - Missing technical handoff summary or gate check: route to `glb-web-handoff` or `pre-handoff-verification` rather than inventing technical guarantees.
141
+ - Excessive jargon in draft: rewrite technical terms into plain-language user impact while keeping every caveat intact.
142
+
143
+ ## Troubleshooting
144
+ - If draft wording sounds certain when evidence is partial, rewrite with conditional phrasing and verify that truth states were not upgraded.
145
+ - If audience mismatch occurs, replace 3D terminology with plain everyday descriptions of visual or delivery impact.
146
+ - If the draft is too long, tighten phrasing in the summary while keeping the full verified/unverified split, all blockers, and all caveats with user impact intact — never drop caveats for readability.
147
+
148
+ ## Best practices
149
+ - Lead with a plain-language summary of what the user asked for and the honest current truth state.
150
+ - Always pair technical caveats with their practical impact on the user's goal, never dropping caveats for readability.
151
+ - End with prioritized, actionable next steps grounded in the 2-path + CLI appendix runtime workflow.
152
+
153
+ ## Good examples
154
+ "Summary: Your product scene plan is ready, but no 3D files or preview images have been generated yet. Verified vs Unverified: Scene layout and lighting steps are planned (`Pass` on planning checks), while Runtime status is `Not Run` and the GLB file and preview render are `Not Produced` (unverified in Blender). Caveats & User Impact: Web material appearance and file size cannot be confirmed until an export runs, meaning the model cannot be embedded on your website yet. Prioritized Next Actions: 1. Run `runtime-readiness` on your chosen runtime path. 2. Execute the scene build and classify outputs with `render-export-evidence`. 3. Complete `glb-web-handoff` and `pre-handoff-verification` before web delivery."
155
+
156
+ ## Bad examples
157
+ “Everything is done and production-ready.” (without evidence)
158
+
159
+ ## User-facing response template
160
+ 1. Plain-language summary (what you asked for and current Runtime / Artifact truth state)
161
+ 2. Verified vs unverified split (what is confirmed now vs what is still `Not Run`, `Not Produced`, or unverified)
162
+ 3. Caveats and blockers with user impact (why each limitation matters to your delivery)
163
+ 4. Prioritized next actions (ordered steps to verify or resolve)
164
+
165
+ ## Anti-patterns
166
+ - skipping required laws or runtime boundary statements
167
+ - claiming runtime/artifact success without evidence
168
+ - using non-official runtime setup paths
169
+ - producing jargon-heavy final output without explanation
170
+
171
+ ## Cross-skill handoff
172
+ <!-- blendops:generated:start handoffs -->
173
+ - [upstream_reference] Upstream artifact evidence classification → `../render-export-evidence/SKILL.md`
174
+ - [fallback] Upstream quality pass/warn/fail validation (scene-readiness) → `../scene-readiness/SKILL.md`
175
+ - [fallback] Upstream quality pass/warn/fail validation (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
176
+ - [fallback] Upstream quality pass/warn/fail validation (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
177
+ - [fallback] Upstream quality pass/warn/fail validation (material-quality-checker) → `../material-quality-checker/SKILL.md`
178
+ - [fallback] Upstream quality pass/warn/fail validation (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
179
+ - [upstream_reference] Upstream GLB/web handoff summary → `../glb-web-handoff/SKILL.md`
180
+ - [upstream_reference] Upstream handoff gate check → `../pre-handoff-verification/SKILL.md`
181
+ - [upstream_reference] Runtime readiness check when runtime is unverified → `../runtime-readiness/SKILL.md`
182
+ <!-- blendops:generated:end handoffs -->
183
+
184
+ ## Non-goals
185
+ - Dumping raw logs or unexplained 3D jargon as final output
186
+ - Hiding blockers or dropping caveats for readability
187
+ - Upgrading Runtime or Artifact truth states or overclaiming completion
188
+ - Executing Python or Blender
189
+ - Replacing `render-export-evidence` (evidence classification), validators (`scene-readiness`, etc.), `glb-web-handoff` (handoff summary), or `pre-handoff-verification` (handoff gating)
190
+
191
+ ## References
192
+ - https://www.blender.org/lab/mcp-server/
193
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
194
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
@@ -0,0 +1,242 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "plain-language-response",
4
+ "version": "1.0.0",
5
+ "category": "evidence-and-handoff",
6
+ "role": "plain-language-final-response-translator",
7
+ "purpose": "Convert technical Blender workflow findings into plain-language user-facing responses with honest caveats.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "write final user summary",
11
+ "explain this for non-Blender user",
12
+ "make this stakeholder-friendly"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "to hide blockers, drop caveats for readability, or overclaim runtime or artifact success",
17
+ "delegateTo": "render-export-evidence",
18
+ "reason": "Delegates out-of-scope requests to render-export-evidence"
19
+ },
20
+ {
21
+ "condition": "to upgrade Runtime or Artifact truth states",
22
+ "delegateTo": "scene-readiness",
23
+ "reason": "Delegates out-of-scope requests to scene-readiness"
24
+ },
25
+ {
26
+ "condition": "to classify raw artifact evidence",
27
+ "delegateTo": "render-export-evidence",
28
+ "reason": "use render-export-evidence"
29
+ },
30
+ {
31
+ "condition": "to generate technical pass/warn/fail checks",
32
+ "delegateTo": "scene-readiness",
33
+ "reason": "use scene-readiness or domain quality checkers"
34
+ },
35
+ {
36
+ "condition": "to assemble technical GLB/web compatibility summaries",
37
+ "delegateTo": "glb-web-handoff",
38
+ "reason": "use glb-web-handoff"
39
+ },
40
+ {
41
+ "condition": "to gate handoff readiness",
42
+ "delegateTo": "pre-handoff-verification",
43
+ "reason": "use pre-handoff-verification"
44
+ }
45
+ ],
46
+ "inputs": {
47
+ "required": [
48
+ {
49
+ "name": "verified_workflow_and_evidence_state",
50
+ "type": "object",
51
+ "description": "Final pre-handoff verification gate status, runtime truth state, and artifact truth state"
52
+ },
53
+ {
54
+ "name": "deliverable_summary_inputs",
55
+ "type": "object",
56
+ "description": "Technical outputs from scene planners, quality checkers, or handoff packagers to translate"
57
+ }
58
+ ],
59
+ "optional": [
60
+ {
61
+ "name": "stakeholder_audience_profile",
62
+ "type": "string",
63
+ "description": "Target reader role (product manager, web developer, creative director, end user)"
64
+ }
65
+ ]
66
+ },
67
+ "outputs": {
68
+ "primary": [
69
+ "plain_language_stakeholder_response",
70
+ "explicit_runtime_and_artifact_status_block",
71
+ "jargon_free_next_steps"
72
+ ],
73
+ "truthStatePolicy": {
74
+ "runtimeDefault": "Not Run",
75
+ "artifactDefault": "Not Produced",
76
+ "mutationRule": "downgrade_only"
77
+ }
78
+ },
79
+ "handoffs": [
80
+ {
81
+ "target": "render-export-evidence",
82
+ "type": "upstream_reference",
83
+ "label": "Upstream artifact evidence classification",
84
+ "when": {
85
+ "all": [
86
+ {
87
+ "field": "stage.current",
88
+ "operator": "equals",
89
+ "value": "post_execution_audit"
90
+ }
91
+ ]
92
+ }
93
+ },
94
+ {
95
+ "target": "scene-readiness",
96
+ "type": "fallback",
97
+ "label": "Upstream quality pass/warn/fail validation (scene-readiness)",
98
+ "when": {
99
+ "all": [
100
+ {
101
+ "field": "quality.domain",
102
+ "operator": "equals",
103
+ "value": "holistic"
104
+ },
105
+ {
106
+ "field": "stage.current",
107
+ "operator": "equals",
108
+ "value": "quality_validation"
109
+ }
110
+ ]
111
+ }
112
+ },
113
+ {
114
+ "target": "composition-quality-checker",
115
+ "type": "fallback",
116
+ "label": "Upstream quality pass/warn/fail validation (composition-quality-checker)",
117
+ "when": {
118
+ "all": [
119
+ {
120
+ "field": "quality.domain",
121
+ "operator": "equals",
122
+ "value": "composition"
123
+ },
124
+ {
125
+ "field": "quality.verdict",
126
+ "operator": "equals",
127
+ "value": "not_run"
128
+ }
129
+ ]
130
+ }
131
+ },
132
+ {
133
+ "target": "lighting-quality-checker",
134
+ "type": "fallback",
135
+ "label": "Upstream quality pass/warn/fail validation (lighting-quality-checker)",
136
+ "when": {
137
+ "all": [
138
+ {
139
+ "field": "quality.domain",
140
+ "operator": "equals",
141
+ "value": "lighting"
142
+ },
143
+ {
144
+ "field": "quality.verdict",
145
+ "operator": "equals",
146
+ "value": "not_run"
147
+ }
148
+ ]
149
+ }
150
+ },
151
+ {
152
+ "target": "material-quality-checker",
153
+ "type": "fallback",
154
+ "label": "Upstream quality pass/warn/fail validation (material-quality-checker)",
155
+ "when": {
156
+ "all": [
157
+ {
158
+ "field": "quality.domain",
159
+ "operator": "equals",
160
+ "value": "material"
161
+ },
162
+ {
163
+ "field": "quality.verdict",
164
+ "operator": "equals",
165
+ "value": "not_run"
166
+ }
167
+ ]
168
+ }
169
+ },
170
+ {
171
+ "target": "polycount-budget-checker",
172
+ "type": "fallback",
173
+ "label": "Upstream quality pass/warn/fail validation (polycount-budget-checker)",
174
+ "when": {
175
+ "all": [
176
+ {
177
+ "field": "quality.domain",
178
+ "operator": "equals",
179
+ "value": "polycount"
180
+ },
181
+ {
182
+ "field": "budget.verdict",
183
+ "operator": "equals",
184
+ "value": "Not Run"
185
+ }
186
+ ]
187
+ }
188
+ },
189
+ {
190
+ "target": "glb-web-handoff",
191
+ "type": "upstream_reference",
192
+ "label": "Upstream GLB/web handoff summary",
193
+ "when": {
194
+ "all": [
195
+ {
196
+ "field": "artifact.type",
197
+ "operator": "equals",
198
+ "value": "glb"
199
+ },
200
+ {
201
+ "field": "handoff.consumerStack",
202
+ "operator": "equals",
203
+ "value": "web_glb"
204
+ }
205
+ ]
206
+ }
207
+ },
208
+ {
209
+ "target": "pre-handoff-verification",
210
+ "type": "upstream_reference",
211
+ "label": "Upstream handoff gate check",
212
+ "when": {
213
+ "all": [
214
+ {
215
+ "field": "stage.current",
216
+ "operator": "equals",
217
+ "value": "final_verification"
218
+ }
219
+ ]
220
+ }
221
+ },
222
+ {
223
+ "target": "runtime-readiness",
224
+ "type": "upstream_reference",
225
+ "label": "Runtime readiness check when runtime is unverified",
226
+ "when": {
227
+ "all": [
228
+ {
229
+ "field": "runtime.path",
230
+ "operator": "not_equals",
231
+ "value": "unselected"
232
+ },
233
+ {
234
+ "field": "runtime.verifiedReady",
235
+ "operator": "equals",
236
+ "value": false
237
+ }
238
+ ]
239
+ }
240
+ }
241
+ ]
242
+ }
@@ -0,0 +1,25 @@
1
+ # Caveat Language
2
+
3
+ ## Purpose
4
+ Preserve strict factual honesty about unverified runtime steps or partial outputs without confusing non-Blender users with jargon or vague hedging.
5
+
6
+ ## When to use
7
+ - Whenever runtime was `Not Run`, an export has not been validated yet, or a workaround/simplification was chosen for web performance.
8
+
9
+ ## Four-Part Caveat Formula
10
+ Every caveat should explicitly state:
11
+ 1. **What is unverified or skipped**: e.g., `"Blender did not run in this step."`
12
+ 2. **Concrete impact on the user**: e.g., `"So there is no rendered image or 3D web file (.glb) on disk yet."`
13
+ 3. **Why it is safe or blocked**: e.g., `"This pass was planning-only"` or `"Blender 5.1+ is missing the Lab MCP add-on."`
14
+ 4. **Single clearest next step**: e.g., `"Open docs/install/cursor.md to enable Path 1, or run a read-only check first."`
15
+
16
+ ## Good vs. Bad Caveat Examples
17
+
18
+ | Situation | Bad Caveat (Avoid) | Good Plain-Language Caveat |
19
+ |---|---|---|
20
+ | **Planning-only session** | `"Everything looks good, model ready soon!"` | `"This is a complete scene blueprint only. Blender has not run yet (Runtime status: Not Run), so no 3D file or image exists on disk yet (Artifact status: Not Produced). Next: connect Path 1 or CLI to build the scene."` |
21
+ | **File exported, validator not run** | `"GLB exported, should work fine in Three.js."` | `"The 3D web file was saved to exports/shoe.glb (3.1 MB), so the file exists (Artifact status: Produced), but it has not passed validator or browser viewer checks yet. Next: run blendops glb-inspect exports/shoe.glb."` |
22
+ | **Web material downgrade** | `"Removed transmission BSDF lobes."` | `"To keep mobile load fast (< 5 MB), glass transparency was switched to a glossy clearcoat finish instead of heavy refraction. You get smooth 60 fps scrolling with a slightly simpler glass look."` |
23
+
24
+ ## Related skill
25
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,30 @@
1
+ # Plain-Language Patterns
2
+
3
+ ## Purpose
4
+ Standardize clear, jargon-free user communication so anyone who has never opened Blender understands exactly what happened, what files exist, and what single action comes next.
5
+
6
+ ## When to use
7
+ - At the final synthesis step of any workflow (`plain-language-response`) before presenting results to stakeholders or end users.
8
+
9
+ ## Core Communication Structure (4-Block Pattern)
10
+ 1. **What you asked for (1 sentence)**: Mirror the user's goal in everyday terms (`"a clean 3D sneaker render and web file for your landing page"`).
11
+ 2. **What is ready right now**: Plain bullet list of completed plans, decisions, or verified files (`"Camera plan, 3-point neon lighting setup, and web budget checklist are ready"`).
12
+ 3. **What is NOT done yet (Truth boundary)**: Explicitly separate plans from actual 3D files (`Runtime status` + `Artifact status`), translating any unavoidable Blender term in brackets (`"cycles raytracing (photo-realistic lighting engine)"`).
13
+ 4. **Your one next step**: A single concrete action — never dump five competing technical options on a beginner.
14
+
15
+ ## Jargon Translation Quick Table
16
+
17
+ | Blender / 3D Term (Never leave unexplained) | Plain-Language Translation |
18
+ |---|---|
19
+ | `Principled BSDF / PBR` | Standard realistic surface shader (controls shine, roughness, and metal look) |
20
+ | `GLB / glTF 2.0` | Standard lightweight 3D file format that runs directly inside web browsers |
21
+ | `Triangle budget / Polycount` | How detailed the 3D shape is (fewer triangles = faster page loads on phones) |
22
+ | `View Transform (AgX / PBR Neutral)` | Color lens setting that keeps bright lights natural and brand colors true |
23
+ | `UV unwrap / Texel density` | How cleanly 2D textures wrap onto the 3D shape without blurry or stretched patches |
24
+ | `Bake textures` | Turning complex Blender effects into regular image maps so websites can load them |
25
+
26
+ ## Bad Pattern to Avoid
27
+ - Pasting raw `bpy.ops` Python snippets, node-graph dumps, or ambiguous `"Done!"` claims when no render or `.glb` file was actually written.
28
+
29
+ ## Related skill
30
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,30 @@
1
+ # Stakeholder-Friendly Examples
2
+
3
+ ## Purpose
4
+ Provide concrete before-and-after response examples for non-technical product managers, founders, and designers receiving BlendOps updates.
5
+
6
+ ## When to use
7
+ - When formatting final milestone summaries, blocked-runtime updates, or web-handoff reports.
8
+
9
+ ## Three Canonical Examples
10
+
11
+ ### 1. Concise Executive Summary (Planning Pass Complete)
12
+ > **Goal**: Futuristic sneaker hero visual + lightweight web 3D file for your product page.
13
+ > **What is ready**: Scene layout blueprint, three-quarter camera angle leaving the left side clear for your headline, neon rim lighting plan, and a 5 MB mobile web budget target.
14
+ > **Important note**: Blender has **not** run yet (`Runtime status: Not Run`), so **no image or `.glb` 3D file has been created yet** (`Artifact status: Not Produced`).
15
+ > **Next step**: Enable Blender Path 1 following `docs/install/cursor.md` and run a read-only check so we can generate your first preview render.
16
+
17
+ ### 2. Implementation-Ready Web Handoff Summary (Verified Build)
18
+ > **Goal**: E-commerce 3D sneaker viewer ready for React/Next.js.
19
+ > **Verified output**: `exports/hero-shoe.glb` (**2.84 MB**, **31,420 triangles** — well under the 50k mobile limit; `gltf-validator`: **0 errors**). Color balance verified with `Khronos PBR Neutral` so brand reds stay accurate.
20
+ > **Truth status**: `Runtime status: Verified`, `Artifact status: Verified`.
21
+ > **Next step**: Drop `exports/hero-shoe.glb` into the `<Canvas>` starter component in `docs/examples/glb-web-handoff/README.md`.
22
+
23
+ ### 3. Blocked-Runtime Summary (Missing Prerequisite)
24
+ > **Goal**: Render final PNG + turntable video.
25
+ > **What stopped us**: Blender 5.1+ is installed, but the **Lab MCP add-on** inside Blender Preferences is not switched on yet, so our agent cannot safely touch your scene.
26
+ > **Truth status**: `Runtime status: Failed` (connection refused), `Artifact status: Not Produced`.
27
+ > **Next step**: Open Blender -> *Edit -> Preferences -> Add-ons*, enable **Blender Lab MCP**, click **Start Server**, and re-run the check.
28
+
29
+ ## Related skill
30
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,50 @@
1
+ # Status Summary Templates
2
+
3
+ ## Purpose
4
+ Ensure every final user update uses the exact status template matched to the actual execution mode (`Planning-only`, `Runtime Blocked`, `Runtime Produced-Unverified`, or `Verified`).
5
+
6
+ ## When to use
7
+ - During the closing status block of `plain-language-response` or `blendops-help`.
8
+
9
+ ## Templates by Mode
10
+
11
+ ### 1. Planning-Only Mode (`Not Run` / `Not Produced`)
12
+ ```txt
13
+ Summary: Blueprint ready; Blender has not run yet.
14
+ What is ready: <list of approved plans / checklists / budgets>
15
+ What is missing: Actual Blender build, render image, or .glb file on disk.
16
+ Runtime status: Not Run (planning-only pass)
17
+ Artifact status: Not Produced
18
+ Next single step: <choose runtime path via runtime-path-picker or run read-only setup check>
19
+ ```
20
+
21
+ ### 2. Runtime Blocked / Failed Mode (`Failed` / `Not Produced`)
22
+ ```txt
23
+ Summary: Stopped cleanly before changing your scene because <plain reason>.
24
+ Blocker: <exact missing add-on / Blender version / port conflict / missing brief slot>
25
+ Runtime status: Failed (<short error reason>)
26
+ Artifact status: Not Produced
27
+ Next single step: <exact 1-action fix + re-check command>
28
+ ```
29
+
30
+ ### 3. File Written, Not Yet Validated (`Produced` — Intermediate)
31
+ ```txt
32
+ Summary: Output file saved to <path> (<size>), awaiting quality & validator checks.
33
+ Created file: <path> (<size>)
34
+ Unverified: <gltf-validator / visual render inspection / mobile frame-rate check>
35
+ Runtime status: Produced
36
+ Artifact status: Produced (validation pending)
37
+ Next single step: Run `blendops glb-inspect <path>` or visual review via `pre-handoff-verification`.
38
+ ```
39
+
40
+ ### 4. Verified Delivery (`Verified` / `Verified`)
41
+ ```txt
42
+ Summary: Ready for handoff — verified on disk with zero critical errors.
43
+ Verified file(s): <path> (<size>, <polycount>, <validator result>)
44
+ Runtime status: Verified (<Blender version + path used>)
45
+ Artifact status: Verified
46
+ Next single step: <plug into viewer / publish asset>
47
+ ```
48
+
49
+ ## Related skill
50
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,40 @@
1
+ # EVAL — polycount-budget-checker
2
+
3
+ ## Text-only eval prompt
4
+ Use polycount-budget-checker on a mid-mobile product hero scene (total cap 50K) with 4 meshes: shoe-upper 18K, sole 8K, laces 5K, ground-shadow 1K.
5
+
6
+ ## Expected behavior
7
+ - pinned budget header (50K total + per-mesh cap)
8
+ - per-mesh rows with triangle count + % of total + verdict + hint
9
+ - worst-offender highlight (shoe-upper at 18K = 36% of total)
10
+ - total: 32K of 50K (64%)
11
+ - top-line: Pass (within budget, no single dominator)
12
+ - evidence label honest
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: full per-mesh data + correct totals + top-line consistent
16
+ - Warn: rows present but missing per-mesh cap comparison or hint advisory missing
17
+ - Fail: invents counts, claims compliance without numbers, decimates inside the skill
18
+
19
+ ## Common failure modes
20
+ - broad summary without per-mesh rows
21
+ - skipping per-mesh cap comparison
22
+ - mixing other quality checks
23
+ - claiming Verified without measurement
24
+
25
+ ## Evidence expectations
26
+ - triangle counts cited
27
+ - per-mesh + total cap headers
28
+ - hints labeled advisory
29
+
30
+ ## Sample passing response outline
31
+ - Header: pinned budget
32
+ - 4 mesh rows
33
+ - Total + worst offender
34
+ - Top-line: Pass
35
+ - Next: handoff named
36
+
37
+ ## Sample failing response outline
38
+ - "Polycount fine"
39
+ - No row data
40
+ - Verified without measurement