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,39 @@
1
+ # EVAL — preview-report
2
+
3
+ ## Text-only eval prompt
4
+ Use preview-report to summarize a Path 1 (host a Anthropic Connector) full recipe run that produced a render PNG and a GLB.
5
+
6
+ ## Expected behavior
7
+ - report kind = full (preview + render + export)
8
+ - artifact rows for render PNG and GLB with path + metric + truth label + validation notes
9
+ - runtime path: Path 1 host a Anthropic Connector
10
+ - tool versions recorded or marked unknown
11
+ - top-line status matches rows
12
+ - handoff to glb-web-handoff named
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: full schema filled, truth labels honest, runtime path recorded, handoff named
16
+ - Warn: schema filled but tool versions missing, or validation notes thin
17
+ - Fail: `Verified` label without validation, or fabricated path, or runtime path missing
18
+
19
+ ## Common failure modes
20
+ - writing prose summary instead of canonical schema
21
+ - upgrading `Produced` → `Verified` without validation evidence
22
+ - mixing Path 1 + Path 2 in one report (forbidden by single-bridge constraint)
23
+
24
+ ## Evidence expectations
25
+ - canonical schema layout (per references/report-schema.md)
26
+ - per-row truth labels matching laws/evidence-before-done.md
27
+ - explicit runtime path
28
+
29
+ ## Sample passing response outline
30
+ - Header (date, operator, runtime path, tool versions)
31
+ - Artifacts table with PNG and GLB rows + truth labels
32
+ - Validation checks
33
+ - Top-line: Pass
34
+ - Next: glb-web-handoff
35
+
36
+ ## Sample failing response outline
37
+ - Free-form text "Render and GLB done"
38
+ - No path, no truth label
39
+ - Verified claim without validation evidence
@@ -0,0 +1,254 @@
1
+ ---
2
+ name: preview-report
3
+ description: Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.
4
+ ---
5
+
6
+ # preview-report
7
+
8
+ ## Purpose
9
+ Standardize how a preview / render / export run's evidence is summarized so that downstream skills (handoff, final response writer) consume a known schema instead of re-parsing free-form text.
10
+
11
+ ## Quick start
12
+ - pick the report kind (`preview` / `render` / `export` / `full`)
13
+ - copy measured values and truth labels from `render-export-evidence` (downgrade-only, never upgrade)
14
+ - attach artifact paths and runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) per row verbatim
15
+ - mark unmeasured or unproduced fields as `Not Run` / `Not Produced` (no-run reports are full `Not Run` / `Not Produced` placeholders)
16
+
17
+ ## When to use
18
+ - after `render-export-evidence` produces measurements
19
+ - before `glb-web-handoff` is composed
20
+ - before `plain-language-response` writes the final summary
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - measuring artifacts directly → use `../render-export-evidence/SKILL.md` (use render-export-evidence instead)
25
+ - raw debug logs or crash triage → use `../blender-troubleshooting/SKILL.md` (use blender-troubleshooting instead)
26
+ - gating handoff readiness → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification instead)
27
+ <!-- blendops:generated:end exclusions -->
28
+
29
+ ## Trigger phrases
30
+ <!-- blendops:generated:start triggers -->
31
+ - "summarize the render"
32
+ - "write up the export evidence"
33
+ - "what's the preview status"
34
+ <!-- blendops:generated:end triggers -->
35
+
36
+ ## Prerequisites / readiness
37
+ - runtime evidence (or explicit absence) is known
38
+ - output paths are known
39
+ - validation notes are written or marked missing
40
+
41
+ ## Input schema
42
+
43
+ ### Required inputs
44
+
45
+ | Input | Why it is required |
46
+ |---|---|
47
+ | Report kind (`preview` / `render` / `export` / `full`) | Determines which sections appear |
48
+ | Output paths (or explicit `Not Produced`) | Anchors all artifact rows |
49
+ | Measurements + source truth labels from `render-export-evidence` | Supplies measured metrics and baseline truth state (downgrade-only, never upgraded; `Not Run` / `Not Produced` if no run) |
50
+ | Runtime path per row (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`) | Records per-row execution provenance |
51
+ | Validation notes per artifact | Supports keeping or downgrading the truth label |
52
+
53
+ ### Optional inputs
54
+
55
+ | Input | Use |
56
+ |---|---|
57
+ | Tool versions | Helps reproduce (`unknown` if unavailable) |
58
+ | Operator name | Useful for multi-operator repos |
59
+
60
+ ### Assumptions to confirm
61
+ - Output paths are real on the machine the report was generated; consumers should not assume they exist on other machines without copying artifacts.
62
+ - Truth labels (`Not Run`, `Not Produced`, `Attempted`, `Produced`, `Verified`, `Failed`) match `laws/evidence-before-done.md` and `render-export-evidence` output; this skill may only downgrade labels, never upgrade them.
63
+
64
+ ## Output schema
65
+
66
+ ### Primary output
67
+ A Markdown file (or block) following the canonical preview-report schema (see `references/report-schema.md`).
68
+
69
+ ### Secondary output
70
+ - a top-line truth status (`Pass / Warn / Fail`)
71
+ - pointers to next skills (`pre-handoff-verification` to gate handoffs, then `glb-web-handoff` and `plain-language-response`)
72
+
73
+ ### Evidence / caveat output
74
+
75
+ ```txt
76
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
77
+ Artifact status: Not Produced | Produced | Verified | Failed
78
+ Evidence used: <links, paths, logs, or "none">
79
+ Limitations: <known gaps>
80
+ ```
81
+
82
+ ## Required laws
83
+ - `../../laws/evidence-before-done.md`
84
+ - `../../laws/non-blender-user-language.md`
85
+ - `../../laws/no-arbitrary-python-interface.md`
86
+ - `../../laws/official-runtime-only.md`
87
+
88
+ ## Official runtime boundary
89
+
90
+ This skill is documentation only. It never runs Blender, renders, exports, or parses logs (`render-export-evidence` supplies measurements; `blender-troubleshooting` owns raw debug logs). It only formats existing evidence into the canonical schema. If the run did not happen, the report is a full placeholder with every artifact at `Not Run` / `Not Produced`.
91
+
92
+ For runtime path attribution, follow `../../docs/runtime-stack-strategy.md` (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) — record the runtime path explicitly per artifact row.
93
+
94
+ ## Operating procedure
95
+
96
+ 1. Determine report kind (`preview` / `render` / `export` / `full`) based on what was attempted or requested.
97
+ 2. Read the canonical schema (see `references/report-schema.md`).
98
+ 3. Fill artifact rows using measurements and truth labels copied from `render-export-evidence` (or `Not Run` / `Not Produced` for unmeasured/no-run items); never fabricate rows and never upgrade a truth label (downgrade-only).
99
+ 4. Record the runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`) explicitly on every artifact row.
100
+ 5. Fill validation rows with the checks performed; downgrade the row truth label if validation is missing or thin.
101
+ 6. Note tool versions if available (or mark `unknown`).
102
+ 7. Compute top-line `Pass / Warn / Fail` status from the rows.
103
+ 8. Name the handoff to `pre-handoff-verification` (handoff gate), `glb-web-handoff` (web), or `plain-language-response` (final response).
104
+
105
+ ## Decision tree
106
+
107
+ ```txt
108
+ No run occurred or field not measured?
109
+ → Runtime: Not Run | Artifact: Not Produced (full placeholder; never fabricate)
110
+ Render/export attempted in render-export-evidence but file missing?
111
+ → Artifact: Failed (or Not Produced if never written)
112
+ render-export-evidence reports Produced or Verified, but validation is missing/thin?
113
+ → Downgrade/keep Artifact at Produced (never upgrade to Verified)
114
+ render-export-evidence reports Verified with validation evidence attached?
115
+ → Copy Verified as-is (never upgrade a lower label to Verified here)
116
+ Path 1 + Path 2 mixed in one run?
117
+ → Forbidden by single-bridge constraint; mark Failed and explain
118
+ ```
119
+
120
+ ## Playbooks
121
+
122
+ ### Playbook A: Preview report (`kind: preview`)
123
+
124
+ * Preview screenshot path (or `Not Produced`) + dimensions + runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) + truth label copied from `render-export-evidence` + validation notes.
125
+ * Used for early scene review before render.
126
+
127
+ ### Playbook B: Render report (`kind: render`)
128
+
129
+ * Render output paths (or `Not Produced`) + resolution + frame range + render time + sample count + engine + runtime path per row + truth label copied from `render-export-evidence` + validation notes.
130
+ * Used after `render-export-evidence` capture.
131
+
132
+ ### Playbook C: Export report (`kind: export`)
133
+
134
+ * GLB output path (or `Not Produced`) + size + Draco status + animation channel count + texture count + runtime path per row + truth label copied from `render-export-evidence` + validation notes.
135
+ * Used after a GLB export step without a fresh render.
136
+
137
+ ### Playbook D: Full report (`kind: full`)
138
+
139
+ * Preview + render + export artifact rows, each with path, metrics, per-row runtime path, truth label from `render-export-evidence` (downgrade-only), and validation notes.
140
+ * Used at the end of a complete recipe run.
141
+
142
+ ## Mode handling
143
+
144
+ ### Text-only mode
145
+
146
+ No-run report: all runtime states are `Not Run` and all artifact rows are `Not Run` / `Not Produced`. Report serves as a full placeholder without fabricated values.
147
+
148
+ ### Runtime-ready mode
149
+
150
+ Populated from `render-export-evidence` measurements. Truth labels copied honestly per `evidence-before-done` (downgrade-only, never upgraded).
151
+
152
+ ### Blocked runtime mode
153
+
154
+ Report explicitly notes the blocker; unmeasured and unproduced rows stay `Not Run` / `Not Produced`.
155
+
156
+ ## Validation checklist
157
+
158
+ * [ ] Report kind chosen (`preview` / `render` / `export` / `full`)
159
+ * [ ] Every artifact row has a real path or `Not Produced` (no fabricated rows)
160
+ * [ ] Every artifact row has a truth label copied from `render-export-evidence` (or `Not Run` / `Not Produced`)
161
+ * [ ] No truth label is upgraded beyond `render-export-evidence` (downgrade-only)
162
+ * [ ] Runtime path recorded per artifact row (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`)
163
+ * [ ] Tool versions recorded or marked `unknown`
164
+ * [ ] Validation notes included per artifact
165
+ * [ ] Top-line status (`Pass / Warn / Fail`) matches the rows
166
+ * [ ] Handoff to next skill named (`pre-handoff-verification`, `glb-web-handoff`, or `plain-language-response`)
167
+
168
+ ## Pass / Warn / Fail rubric
169
+
170
+ | Verdict | Criteria |
171
+ |---|---|
172
+ | Pass | All applicable rows filled with consistent truth labels; runtime path recorded; handoff named. |
173
+ | Warn | Rows filled but tool versions missing, or validation notes thin. |
174
+ | Fail | Truth label upgraded beyond evidence (`Verified` without validation), or path not recorded, or rows fabricated. |
175
+
176
+ ## Failure handling
177
+
178
+ * If artifact path is unknown or unmeasured → mark row `Not Produced` (or `Not Run`) with a note; never fabricate.
179
+ * If validation note is missing or thin → downgrade/keep label at `Produced`, never `Verified`.
180
+ * If raw debug logs fail or need parsing → route to `blender-troubleshooting` (do not parse logs in this skill).
181
+ * If runtime path is unclear or bridges conflict → mark `unknown` and let `bridge-conflicts` triage.
182
+
183
+ ## Troubleshooting
184
+
185
+ | Problem | Response |
186
+ | --- | --- |
187
+ | Asked to write a "summary" without measurements | Output a full placeholder report with all `Not Run` / `Not Produced` rows; do not fabricate. |
188
+ | Operator pushes for a `Verified` label without validation or above `render-export-evidence` | Refuse upgrade (downgrade-only rule); explain which validation or measurement step is missing. |
189
+ | Handed raw Blender debug logs instead of `render-export-evidence` output | Do not parse logs; route raw logs to `blender-troubleshooting` and request measured inputs from `render-export-evidence`. |
190
+ | Multi-path attempt | Record each artifact row with its own runtime path (`Path 1 host a`, `Path 1 host b`, `Path 2`, `CLI`) separately; do not merge into one ambiguous total. |
191
+
192
+ ## Best practices
193
+
194
+ * Match the canonical schema verbatim; downstream consumers (`glb-web-handoff`, `plain-language-response`) rely on it.
195
+ * Copy truth labels from `render-export-evidence` and enforce downgrade-only (never upgrade).
196
+ * Always anchor every artifact row with both an output path (or `Not Produced`) and a runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI` / `Not Run`).
197
+ * Use ISO date in the report filename (`preview-report-YYYY-MM-DD.md`).
198
+
199
+ ## Good examples
200
+ - "Render: `out/render-2026-05-09.png`, 1920×1080, Cycles 128 samples, 23s, Path 1 host a, Verified by reference image diff < 2%."
201
+
202
+ ## Bad examples
203
+ - "Render done." — no path, no label.
204
+ - "Verified GLB." — no validation evidence.
205
+
206
+ ## User-facing response template
207
+
208
+ ```txt
209
+ # Preview report (kind: <preview / render / export / full>)
210
+ Date: <YYYY-MM-DD>
211
+ Operator: <name or unknown>
212
+ Runtime path: <Path 1 host a / Path 1 host b / Path 2 / CLI / Not Run>
213
+ Tool versions: <blender X / addon Y / mcp host Z / unknown>
214
+
215
+ ## Artifacts
216
+ - <kind>: <path or Not Produced> | <metric: e.g. resolution / size or Not Run> | runtime_path: <Path 1 host a / Path 1 host b / Path 2 / CLI / Not Run> | truth: <Not Run / Not Produced / Attempted / Produced / Verified / Failed> | validation: <notes>
217
+ - ...
218
+
219
+ ## Validation
220
+ - <check>: <pass/fail/skip> | <evidence>
221
+
222
+ ## Top-line
223
+ Status: Pass / Warn / Fail
224
+ Next: pre-handoff-verification / glb-web-handoff / plain-language-response
225
+ Limitations: <gaps>
226
+ ```
227
+
228
+ ## Anti-patterns
229
+ - Free-form prose summary that downstream skills cannot parse.
230
+ - Upgrading truth labels.
231
+ - Mixing artifact paths into a single comma-separated cell.
232
+ - Omitting the runtime path.
233
+
234
+ ## Cross-skill handoff
235
+ <!-- blendops:generated:start handoffs -->
236
+ - [upstream_reference] Measured evidence input (supplies measurements + truth states) → `../render-export-evidence/SKILL.md`
237
+ - [progression] Handoff gate (gates handoffs before downstream delivery) → `../pre-handoff-verification/SKILL.md`
238
+ - [progression] Web handoff consumer → `../glb-web-handoff/SKILL.md`
239
+ - [progression] Final non-Blender user response consumer → `../plain-language-response/SKILL.md`
240
+ - [fallback] Raw debug log triage (out of scope here) → `../blender-troubleshooting/SKILL.md`
241
+ <!-- blendops:generated:end handoffs -->
242
+
243
+ ## Non-goals
244
+ - Run Blender.
245
+ - Render or export.
246
+ - Parse log files (out of scope; consume measurement output of `render-export-evidence`).
247
+ - Promote a label without evidence.
248
+
249
+ ## References
250
+ - `references/report-schema.md`
251
+ - `references/truth-label-rules.md`
252
+ - `references/handoff-recipients.md`
253
+ - `../../laws/evidence-before-done.md`
254
+ - `../../docs/skill-system.md`
@@ -0,0 +1,141 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "preview-report",
4
+ "version": "1.0.0",
5
+ "category": "evidence-and-handoff",
6
+ "role": "stakeholder-preview-packet-formatter",
7
+ "purpose": "Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "summarize the render",
11
+ "write up the export evidence",
12
+ "what's the preview status"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "measuring artifacts directly",
17
+ "delegateTo": "render-export-evidence",
18
+ "reason": "use render-export-evidence instead"
19
+ },
20
+ {
21
+ "condition": "raw debug logs or crash triage",
22
+ "delegateTo": "blender-troubleshooting",
23
+ "reason": "use blender-troubleshooting instead"
24
+ },
25
+ {
26
+ "condition": "gating handoff readiness",
27
+ "delegateTo": "pre-handoff-verification",
28
+ "reason": "use pre-handoff-verification instead"
29
+ }
30
+ ],
31
+ "inputs": {
32
+ "required": [
33
+ {
34
+ "name": "classified_artifact_evidence",
35
+ "type": "object",
36
+ "description": "Verified or Produced artifact evidence record from render-export-evidence"
37
+ },
38
+ {
39
+ "name": "quality_checker_summary",
40
+ "type": "object",
41
+ "description": "Pass/Warn/Fail summary from scene-readiness and specialist validators"
42
+ }
43
+ ],
44
+ "optional": [
45
+ {
46
+ "name": "known_visual_caveats",
47
+ "type": "array",
48
+ "description": "Optional non-blocking visual warnings or pending stakeholder review questions"
49
+ }
50
+ ]
51
+ },
52
+ "outputs": {
53
+ "primary": [
54
+ "stakeholder_preview_evidence_packet",
55
+ "truth_state_and_provenance_summary",
56
+ "pre_handoff_gate_submission"
57
+ ],
58
+ "truthStatePolicy": {
59
+ "runtimeDefault": "Not Run",
60
+ "artifactDefault": "Not Produced",
61
+ "mutationRule": "downgrade_only"
62
+ }
63
+ },
64
+ "handoffs": [
65
+ {
66
+ "target": "render-export-evidence",
67
+ "type": "upstream_reference",
68
+ "label": "Measured evidence input (supplies measurements + truth states)",
69
+ "when": {
70
+ "all": [
71
+ {
72
+ "field": "stage.current",
73
+ "operator": "equals",
74
+ "value": "post_execution_audit"
75
+ }
76
+ ]
77
+ }
78
+ },
79
+ {
80
+ "target": "pre-handoff-verification",
81
+ "type": "progression",
82
+ "label": "Handoff gate (gates handoffs before downstream delivery)",
83
+ "when": {
84
+ "all": [
85
+ {
86
+ "field": "stage.current",
87
+ "operator": "equals",
88
+ "value": "final_verification"
89
+ }
90
+ ]
91
+ }
92
+ },
93
+ {
94
+ "target": "glb-web-handoff",
95
+ "type": "progression",
96
+ "label": "Web handoff consumer",
97
+ "when": {
98
+ "all": [
99
+ {
100
+ "field": "artifact.type",
101
+ "operator": "equals",
102
+ "value": "glb"
103
+ },
104
+ {
105
+ "field": "handoff.consumerStack",
106
+ "operator": "equals",
107
+ "value": "web_glb"
108
+ }
109
+ ]
110
+ }
111
+ },
112
+ {
113
+ "target": "plain-language-response",
114
+ "type": "progression",
115
+ "label": "Final non-Blender user response consumer",
116
+ "when": {
117
+ "all": [
118
+ {
119
+ "field": "stage.current",
120
+ "operator": "equals",
121
+ "value": "final_communication"
122
+ }
123
+ ]
124
+ }
125
+ },
126
+ {
127
+ "target": "blender-troubleshooting",
128
+ "type": "fallback",
129
+ "label": "Raw debug log triage (out of scope here)",
130
+ "when": {
131
+ "all": [
132
+ {
133
+ "field": "runtime.errorDetected",
134
+ "operator": "equals",
135
+ "value": true
136
+ }
137
+ ]
138
+ }
139
+ }
140
+ ]
141
+ }
@@ -0,0 +1,41 @@
1
+ # Handoff recipients
2
+
3
+ The preview report is consumed by exactly these downstream skills. Hand off to one of them based on the next step.
4
+
5
+ ## glb-web-handoff (web target)
6
+
7
+ Use when the next consumer is a web app (Three.js / R3F / Babylon / model-viewer).
8
+
9
+ The web handoff skill will read:
10
+ - `Artifacts` section to know what was produced
11
+ - `Validation` section to know what was checked
12
+ - `Top-line.Status` to know whether to allow handoff
13
+
14
+ ## plain-language-response (final user reply)
15
+
16
+ Use when the next step is the final reply to a non-Blender user.
17
+
18
+ The response writer skill will read:
19
+ - `Top-line.Status` for the headline
20
+ - `Artifacts` rows for the "what was made" list
21
+ - `Limitations` line for the honest caveats
22
+
23
+ ## pre-handoff-verification (gate before handoff)
24
+
25
+ Use **before** glb-web-handoff or plain-language-response if any of:
26
+ - artifact rows have `Produced` but not `Verified`
27
+ - validation rows have skips
28
+ - top-line status is `Warn`
29
+
30
+ The pre-handoff verification skill applies the 7-point evidence gate.
31
+
32
+ ## render-export-evidence (re-run if needed)
33
+
34
+ Use if the report shows `Failed` rows that need a new run, or if no rows have evidence.
35
+
36
+ ## Two recipient rule
37
+
38
+ A single preview report can hand off to at most two recipients (e.g., web + final response). More than two means the report is being asked to do too much; split into separate reports.
39
+
40
+ ## Related skill
41
+ `../SKILL.md`
@@ -0,0 +1,60 @@
1
+ # Canonical preview-report schema
2
+
3
+ Downstream skills parse this layout. Do not deviate.
4
+
5
+ ## File header (required)
6
+
7
+ ```md
8
+ # Preview report (kind: <preview | render | export | full>)
9
+ Date: <YYYY-MM-DD>
10
+ Operator: <name or unknown>
11
+ Runtime path: <Path 1 host a Anthropic Connector | Path 1 host b manual MCP | Path 2 mcp-for-blender | CLI fallback>
12
+ Tool versions: <blender X.Y | lab-mcp-addon vN | mcp-host product+build | uvx mcp-for-blender vN | unknown>
13
+ ```
14
+
15
+ ## Artifacts section (required)
16
+
17
+ One row per artifact. Keep the column order verbatim.
18
+
19
+ ```md
20
+ ## Artifacts
21
+ - preview: <path> | <resolution> | truth: Not Run | Produced | Verified | Failed | validation: <notes or "none">
22
+ - render: <path> | <resolution> + <samples + engine> + <render time> | truth: <label> | validation: <notes>
23
+ - export: <path> | <size MB> + <Draco yes/no> + <animation channels> + <texture count> | truth: <label> | validation: <notes>
24
+ ```
25
+
26
+ If an artifact is `Not Run`, the row still appears with `Not Produced` path placeholder and explicit truth label.
27
+
28
+ ## Validation section (required)
29
+
30
+ ```md
31
+ ## Validation
32
+ - <check name>: pass | fail | skip | <evidence>
33
+ - ...
34
+ ```
35
+
36
+ Validation checks must be explicit (e.g., "render PNG dimensions match scene render output settings", "GLB validates with `gltf-validator`", "GLB triangle count ≤ budget").
37
+
38
+ ## Top-line section (required)
39
+
40
+ ```md
41
+ ## Top-line
42
+ Status: Pass | Warn | Fail
43
+ Next: <handoff skill>
44
+ Limitations: <gaps or "none">
45
+ ```
46
+
47
+ Status must be derived from the rows; a `Failed` artifact forces top-line `Fail`.
48
+
49
+ ## Optional appendix
50
+
51
+ - Logs path
52
+ - Reference image path (for diff-based verification)
53
+ - Operator notes
54
+
55
+ ## Why this schema
56
+
57
+ `glb-web-handoff` and `plain-language-response` both consume this exact layout. Free-form prose breaks them.
58
+
59
+ ## Related skill
60
+ `../SKILL.md`
@@ -0,0 +1,36 @@
1
+ # Truth label rules (per laws/evidence-before-done.md)
2
+
3
+ ## The five labels
4
+
5
+ | Label | When to use |
6
+ |---|---|
7
+ | `Not Run` | The action was not attempted. |
8
+ | `Attempted` | The action was attempted but did not produce a verifiable artifact. |
9
+ | `Produced` | An artifact exists at a known path; not yet validated against the planned spec. |
10
+ | `Verified` | An artifact exists AND a validation check passes (e.g. dimensions, file integrity, visual diff, gltf-validator). |
11
+ | `Failed` | The action was attempted and produced an error or unusable artifact. |
12
+
13
+ ## Upgrade rules
14
+
15
+ - `Not Run → Attempted`: only when an attempt happened.
16
+ - `Attempted → Produced`: only when a file exists at a known path.
17
+ - `Produced → Verified`: only when a validation check name + result is recorded.
18
+ - Never upgrade past `Verified` (no "double verified" or "stable" in this dimension).
19
+ - Never downgrade silently; downgrades require a recorded reason.
20
+
21
+ ## Common mistakes
22
+
23
+ - Calling a render `Verified` because it "looks fine". Verification needs an explicit check.
24
+ - Calling a GLB `Produced` without a path on disk.
25
+ - Calling a step `Failed` without recording the error.
26
+
27
+ ## When validation is partial
28
+
29
+ Stay at `Produced`; add a note like "validation: dimensions match; gltf-validator skipped".
30
+
31
+ ## When the artifact came from a different path
32
+
33
+ If the report records a Path 1 host b run but the artifact came from a Path 2 run, the row is `Failed` with a note about the path mismatch (single-bridge constraint forbids merging).
34
+
35
+ ## Related skill
36
+ `../SKILL.md`
@@ -0,0 +1,42 @@
1
+ # EVAL — product-grid-scene-planner
2
+
3
+ ## Text-only eval prompt
4
+ Use product-grid-scene-planner on a brief: "4 sneaker variants in 2×2 grid, e-commerce hero, neutral background, 16:9".
5
+
6
+ ## Expected behavior
7
+ - Product list (4) + grid layout (2×2 + spacing)
8
+ - Consistency level (strict)
9
+ - Shared lighting plan + shared background
10
+ - Per-cell camera consistent
11
+ - Caption space pinned
12
+ - Asset list flagged
13
+ - Handoff named
14
+
15
+ ## Pass / Warn / Fail criteria
16
+ - Pass: full sections + scale normalized + consistent lighting + assets flagged
17
+ - Warn: per-cell variance unspecified
18
+ - Fail: mixed scale, no shared lighting, missing aspect
19
+
20
+ ## Common failure modes
21
+ - per-cell separate lighting (breaks uniformity)
22
+ - mixed scale products
23
+ - no caption / label space
24
+ - background clashing
25
+
26
+ ## Evidence expectations
27
+ - explicit grid layout
28
+ - shared lighting + background
29
+ - camera consistency stated
30
+
31
+ ## Sample passing response outline
32
+ - Product list header
33
+ - Grid layout row
34
+ - Lighting + background rows
35
+ - Camera row
36
+ - Caption space row
37
+ - Asset list
38
+ - Next: handoff
39
+
40
+ ## Sample failing response outline
41
+ - "4 products in grid"
42
+ - No layout / lighting / scale