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,53 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/material-quality-checker/SKILL.md and skills/material-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # material-quality-checker
3
+
4
+ Purpose: Validate PBR material sanity, texture budgets, and web/runtime compatibility per material before render or export.
5
+
6
+ Run a focused pass/warn/fail check on each material in the scene against PBR sanity, texture budgets, and consumer-stack compatibility — without expanding into lighting or composition concerns.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `pbr-and-shader-portability-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - before GLB export
13
+ - after a material change request
14
+ - as a sub-check during full quality review
15
+ - Trigger phrases: "are the materials okay", "check PBR sanity", "texture budget for materials", "will the materials work in Three.js"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - upstream lookdev and material planning → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; use lighting-material-plan)
19
+ - lighting validation → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker)
20
+ - composition / camera validation → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
21
+ - broad pass/warn/fail scene readiness → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
22
+ - web integration and viewer handoff → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; use glb-web-handoff)
23
+ - to fix or edit materials (this skill validates and emits remediation hints only; it never edits) → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; this skill validates and emits remediation hints only; it never edits)
24
+
25
+ ## Input & output contract
26
+ - Required input `material_and_shader_inventory` (`array`): Principled BSDF parameter ranges, texture maps, UV channels, and normal map conventions
27
+ - Required input `target_consumption_surface` (`string`): Whether materials target offline Cycles/Eevee rendering or glTF 2.0 PBR web export
28
+ - Optional input `texture_memory_budget` (`object`): Maximum texture resolution and VRAM budget from mobile-glb-budget
29
+ - Output contract: `pbr_material_verdict_table`, `gltf_shader_portability_risks`, `material_remediation_steps` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. enumerate every material referenced in the scene plan or measured scene
33
+ 2. check PBR sanity (albedo range, normal map sign, roughness/metallic plausibility)
34
+ 3. check texture budget (resolution, count, format)
35
+ 4. check consumer-stack compatibility (KHR extensions, unsupported features for chosen target)
36
+ 5. emit per-material verdicts + a top-line status
37
+
38
+ ## Cross-skill handoffs
39
+ - [retry] Upstream lookdev & material planning → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
40
+ - [upstream_reference] Mobile/web texture budget definition → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
41
+ - [progression] Broad readiness review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
42
+ - [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
43
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
44
+ - [progression] Polycount budget → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
45
+ - [progression] Render / GLB export evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
46
+ - [progression] Web handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
47
+
48
+ ## Safety boundaries & non-goals
49
+ - Runtime boundary: This skill validates plans or measured scene snapshots. It never modifies materials, runs Blender, or exports a GLB. If actual material values are needed, rely on a measured scene description (plan output, runtime tool snapshot) — never invent values.
50
+ - Edit materials.
51
+ - Generate shader code.
52
+ - Replace `scene-readiness` (this skill is one of its inputs).
53
+ - Run Blender.
@@ -0,0 +1,55 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/mobile-glb-budget/SKILL.md and skills/mobile-glb-budget/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # mobile-glb-budget
3
+
4
+ Purpose: Set explicit triangle / texture / draw-call / file-size / animation budgets for GLB targeted at mobile-web before any export decision.
5
+
6
+ Translate "make it work on mobile" intent into a concrete numeric planning ceiling table (triangles, vertices, GLB file size, texture pixels, materials, draw calls, animation channels, bones, morph targets) per device tier, scene scope, and target context. Pin this budget before scene mutation so downstream scene planners consume it, `polycount-budget-checker` and `material-quality-checker` validate counts and textures against it, `render-export-evidence` measures compliance, `glb-web-handoff` consumes it for web delivery, and `glb-animation-handoff` owns animation contracts.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `mobile-webgl-budget-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before scene plan is locked
12
+ - before any GLB export attempt
13
+ - when user says "for mobile" / "for the web" / "phone" / "low-end devices"
14
+ - when designing a scene that must run alongside other web content
15
+ - Trigger phrases: "what's a good polycount for mobile", "how big can the GLB be", "will this load on iPhone", "what should I aim for on a phone"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - desktop-only renders without web handoff → use `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`; Delegates out-of-scope requests to polycount-budget-checker)
19
+ - offline pre-rendered video (no real-time budget needed) → use `material-quality-checker` (`references/skill-material-quality-checker.md`; no real-time budget needed)
20
+ - replacing engineering load testing (this skill sets a planning budget, not a real-world benchmark) → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; this skill sets a planning budget, not a real-world benchmark)
21
+
22
+ ## Input & output contract
23
+ - Required input `target_device_tier_and_network` (`string`): Target mobile/web hardware tier (iOS Safari, mid-range Android, desktop WebGL) and load budget
24
+ - Required input `scene_deliverable_type` (`string`): Whether the GLB is a single hero product, multi-item configurator, or animated character
25
+ - Optional input `compression_pipeline_support` (`object`): Whether the host app supports Draco, Meshopt, or KTX2 BasisU transcoding
26
+ - Output contract: `pinned_glb_performance_budget_table`, `triangle_drawcall_and_texture_ceilings`, `compression_and_lod_requirements` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
27
+
28
+ ## Quick-start steps
29
+ 1. pick the device tier (low-end Android, mid-mobile, high-mobile, desktop-fallback)
30
+ 2. read the budget row for that tier
31
+ 3. pin the budget into the scene plan before mutation
32
+ 4. treat any later violation as a blocker, not a warning
33
+
34
+ ## Cross-skill handoffs
35
+ - [progression] Scene planning (consumes pinned budget) (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
36
+ - [progression] Scene planning (consumes pinned budget) (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
37
+ - [alternative] Scene planning (consumes pinned budget) (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
38
+ - [alternative] Scene planning (consumes pinned budget) (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
39
+ - [alternative] Scene planning (consumes pinned budget) (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
40
+ - [alternative] Scene planning (consumes pinned budget) (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
41
+ - [alternative] Scene planning (consumes pinned budget) (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
42
+ - [progression] Count and texture budget validation (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
43
+ - [progression] Count and texture budget validation (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
44
+ - [progression] Count and texture budget validation (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
45
+ - [progression] Measured export compliance → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
46
+ - [progression] Web delivery handoff (consumes pinned budget) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
47
+ - [progression] Animation contracts (owns animation contract details within pinned channel/bone/morph ceilings) → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
48
+
49
+ ## Safety boundaries & non-goals
50
+ - Runtime boundary: BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix** (see `docs/runtime-stack-strategy.md`):
51
+ - Run a real-world benchmark.
52
+ - Install Blender.
53
+ - Run Blender.
54
+ - Choose a render engine.
55
+ - Write web-side optimization code.
@@ -0,0 +1,46 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/output-format-decision/SKILL.md and skills/output-format-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # output-format-decision
3
+
4
+ Purpose: Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.
5
+
6
+ Avoid mismatched output formats (e.g., JPEG for VFX, EXR for web, TIFF for social). Match format to consumer pipeline.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `still-animation-and-3d-format-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - when consumer requires specific format
13
+ - when transparency / HDR / loss tolerance matters
14
+ - Trigger phrases: "PNG or JPEG", "do we need EXR", "what format for the web"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - raw modeling without rendering → use `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
18
+ - 3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff) → use `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`; out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)
19
+ - verifying saved files on disk after rendering → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
20
+
21
+ ## Input & output contract
22
+ - Required input `deliverable_channel_and_use` (`string`): Downstream consumer surface (web hero image, compositing EXR pipeline, turntable video, interactive WebGL)
23
+ - Required input `alpha_and_bit_depth_needs` (`object`): Transparency (straight vs premultiplied alpha) and dynamic range (8-bit, 16-bit, 32-bit float) requirements
24
+ - Optional input `file_size_ceiling` (`string`): Optional delivery file size cap from mobile-glb-budget or web spec
25
+ - Output contract: `pinned_container_and_codec_spec`, `bit_depth_and_alpha_mode_record`, `color_space_and_export_verification_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
26
+
27
+ ## Quick-start steps
28
+ 1. name the consumer
29
+ 2. pick one format per output stream
30
+ 3. pin bit depth + compression + alpha rules
31
+ 4. emit a 4-line config
32
+
33
+ ## Cross-skill handoffs
34
+ - [upstream_reference] Color management → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
35
+ - [upstream_reference] Resolution & aspect ratio → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
36
+ - [upstream_reference] Engine choice → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
37
+ - [progression] Render file verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
38
+ - [progression] 3D / GLB exports (out of scope here) (glb-animation-handoff) → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
39
+ - [boundary_delegation] 3D / GLB exports (out of scope here) (mobile-glb-budget) → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
40
+ - [progression] 3D / GLB exports (out of scope here) (glb-web-handoff) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
41
+
42
+ ## Safety boundaries & non-goals
43
+ - Runtime boundary: Decision skill — does not run Blender. Pins format; operator applies to scene render output.
44
+ - Convert formats post-render.
45
+ - Run Blender.
46
+ - Compress / re-encode files.
@@ -0,0 +1,56 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/pack-prerequisite-checker/SKILL.md and skills/pack-prerequisite-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # pack-prerequisite-checker
3
+
4
+ Purpose: Verify brief, runtime posture, skill coverage, and evidence habits before starting a BlendOps workflow pack, then emit a Go/No-Go decision and single next skill.
5
+
6
+ Block "half-ready" pack execution: confirm the user's brief, chosen pack/recipe, runtime understanding, and evidence workflow are sufficient to start planners and validators without rework loops.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `pack-preflight-readiness-gate` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+ Routing precedence: group `entry-and-stage-routing`, rank `3` | activationGate: `goalClarity="clear"`, `recipeSelected=true`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
10
+
11
+ ## When to use & trigger cues
12
+ - immediately after `recipe-fit-assessor` + `intent-to-3d-brief-writer`
13
+ - before first scene planner for a pack workflow
14
+ - when user jumps mid-pack without status context
15
+ - Trigger phrases: "are we ready to start", "pre-flight for the pack", "what's missing before we build", "check prerequisites"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - Goal or entry point is ambiguous and no pack is chosen yet → use `blendops-help` (`references/skill-blendops-help.md`; Triages ambiguous entry requests at precedence Rank 1)
19
+ - Evaluating which recipe or pack fits the user's goal → use `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`; Scores candidate recipes/packs at precedence Rank 2 before preflight)
20
+ - Workflow is already past preflight with existing stage or artifact inventory → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; Routes in-flight workflows at precedence Rank 4)
21
+ - Detailed Blender MCP runtime connection preflight → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Inspects Path 1 or Path 2 runtime readiness in detail)
22
+ - Active MCP bridge port or add-on session conflicts → use `bridge-conflicts` (`references/skill-bridge-conflicts.md`; Resolves port 9876 and dual-bridge conflicts)
23
+ - Debugging Blender scene or runtime execution errors → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; Diagnoses runtime or scene failures)
24
+ - Auditing external 3D asset license compliance → use `asset-license-checker` (`references/skill-asset-license-checker.md`; Performs dedicated asset license and provenance verification)
25
+
26
+ ## Input & output contract
27
+ - Required input `target_pack_id` (`string`): Selected BlendOps pack or recipe identifier (e.g., product-hero-v0)
28
+ - Required input `current_brief_status` (`object`): Current 3D brief completeness across subject, destination, and constraints
29
+ - Optional input `declared_runtime_posture` (`string`): Whether the session is text-only planning or targets Path 1 / Path 2 / CLI
30
+ - Output contract: `prerequisite_matrix_rows`, `go_no_go_verdict`, `single_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
31
+
32
+ ## Quick-start steps
33
+ 1. identify target pack/recipe
34
+ 2. run checklist rows from `skills/pack-prerequisite-checker/references/prerequisite-matrix.md`
35
+ 3. mark each row Ready / Needs input / Blocked
36
+ 4. only then authorize entry into execution-heavy skills
37
+
38
+ ## Cross-skill handoffs
39
+ - [upstream_reference] Recipe selection → `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`) — `when.all: [recipe.selected equals false]`
40
+ - [fallback] Brief completeness → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [brief.complete equals false]`
41
+ - [conditional] Runtime detail → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.mode equals "runtime_requested"; runtime.verifiedReady equals false]`
42
+ - [fallback] Bridge conflicts → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
43
+ - [fallback] Runtime debugging → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
44
+ - [conditional] License checks → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
45
+ - [alternative] Domain planner (product hero when Go) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "product_hero"]`
46
+ - [alternative] Domain planner (product grid when Go) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "product_grid"]`
47
+ - [alternative] Domain planner (character portrait when Go) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "character_portrait"]`
48
+ - [alternative] Domain planner (environment establishing shot when Go) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "environment_shot"]`
49
+ - [alternative] Domain planner (interior architectural when Go) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [preflight.verdict equals "go"; recipe.domain equals "interior_archviz"]`
50
+
51
+ ## Safety boundaries & non-goals
52
+ - Runtime boundary: Preflight gate only — never executes packs, domain planners, or Blender runtime. Uses the 2-path + CLI appendix model per `docs/runtime-stack-strategy.md`:
53
+ - Scoring which recipe or pack fits the user's initial idea (use `recipe-fit-assessor`).
54
+ - Routing active mid-flight workflows that already passed preflight (use `workflow-stage-router`).
55
+ - Writing the 8-slot 3D brief, planning scene geometry/lighting, or auditing asset licenses directly.
56
+ - Running Blender, configuring MCP hosts, or verifying rendered/exported files.
@@ -0,0 +1,48 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/path-one-host-outline/SKILL.md and skills/path-one-host-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # path-one-host-outline
3
+
4
+ Purpose: Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.
5
+
6
+ Outline **Path 1 host surfaces** — **(a)** Anthropic Connector in Claude Desktop vs **(b)** any manually configured MCP client — while making clear that both require the Lab MCP add-on inside **Blender 5.1+** and that the Connector is **never standalone**. This skill provides an outline only; it never configures hosts and never runs Blender.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `lab-mcp-host-configuration-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - user on Claude Desktop asking what the Anthropic Connector does vs the Blender-side add-on
12
+ - user or agent comparing Path 1 host surfaces: **(a)** Anthropic Connector in Claude Desktop vs **(b)** a manually configured MCP client
13
+ - outlining which components live on the host side vs inside Blender 5.1+ before setup begins
14
+ - Trigger phrases: "Connector vs Cursor MCP", "how do I host Lab MCP", "Claude Desktop Connector vs manual MCP client", "what hosts work with Path 1"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - choosing between Path 1, Path 2, or CLI → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
18
+ - step-by-step host or add-on installation and configuration → use `runtime-setup` (`references/skill-runtime-setup.md`; Delegates out-of-scope requests to runtime-setup)
19
+ - probing live runtime readiness → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Delegates out-of-scope requests to runtime-readiness)
20
+ - resolving conflicts between official and unofficial bridges → use `bridge-conflicts` (`references/skill-bridge-conflicts.md`; Delegates out-of-scope requests to bridge-conflicts)
21
+ - Path 2 community bridge specifics → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
22
+ - CLI appendix job outlining → use `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`; Delegates out-of-scope requests to cli-appendix-job-outline)
23
+
24
+ ## Input & output contract
25
+ - Required input `path_one_host_option` (`string`): Selected Path 1 host mode: option (a) Anthropic Connector in Claude Desktop or option (b) manual MCP client
26
+ - Required input `blender_5_1_addon_posture` (`object`): Confirmation that Official Blender Lab MCP add-on in Blender 5.1+ is required by both host options
27
+ - Optional input `mcp_client_name` (`string`): Specific MCP client for host option (b) such as Cursor, Claude Code, or Zed
28
+ - Output contract: `path_one_host_architecture_outline`, `connector_not_standalone_boundary_check`, `host_to_readiness_handoff` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
29
+
30
+ ## Quick-start steps
31
+ 1. confirm Blender 5.1+ target
32
+ 2. choose host category using `skills/path-one-host-outline/references/connector-vs-manual-matrix.md`
33
+ 3. apply reminders from `skills/path-one-host-outline/references/lab-addon-reminders.md`
34
+ 4. emit checklist `skills/path-one-host-outline/references/host-checklist-template.md`
35
+
36
+ ## Cross-skill handoffs
37
+ - [upstream_reference] Path selection → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
38
+ - [upstream_reference] Detailed setup and configuration → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
39
+ - [progression] Readiness probing → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
40
+ - [fallback] Bridge conflicts → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
41
+ - [progression] CLI appendix workflows → `cli-appendix-job-outline` (`references/skill-cli-appendix-job-outline.md`) — `when.all: [runtime.path equals "cli_appendix"; request.topic equals "cli_batch"]`
42
+
43
+ ## Safety boundaries & non-goals
44
+ - Runtime boundary: Outline only; never configures hosts and never runs Blender. Path 1 requires the Lab MCP add-on inside **Blender 5.1+** plus a host surface: **(a)** Anthropic Connector in Claude Desktop or **(b)** any manually configured MCP client. The Connector is **never standalone**. Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`; see `docs/unofficial-runtime-bridges.md`) and CLI workflows (`cli-appendix-job-outline`) are out of scope here.
45
+ - Choosing between Path 1, Path 2, and the CLI appendix (owned by `runtime-path-picker`).
46
+ - Performing step-by-step installation or editing host MCP configuration files (owned by `runtime-setup`).
47
+ - Probing whether a live Blender MCP session is currently connected (owned by `runtime-readiness`).
48
+ - Documenting Path 2 community bridge internals or headless CLI batch scripts.
@@ -0,0 +1,53 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/plain-language-response/SKILL.md and skills/plain-language-response/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # plain-language-response
3
+
4
+ Purpose: Convert technical Blender workflow findings into plain-language user-facing responses with honest caveats.
5
+
6
+ Produce stakeholder-friendly outputs that preserve truthfulness, evidence boundaries, and clear next actions.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `plain-language-final-response-translator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - in the final response phase to convert technical findings into plain-language user-facing wording
12
+ - 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
13
+ - when translating technical blockers, caveats, and verified/unverified status splits for non-Blender users
14
+ - Trigger phrases: "write final user summary", "explain this for non-Blender user", "make this stakeholder-friendly"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - to hide blockers, drop caveats for readability, or overclaim runtime or artifact success → use `render-export-evidence` (`references/skill-render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
18
+ - to upgrade Runtime or Artifact truth states → use `scene-readiness` (`references/skill-scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
19
+ - to classify raw artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
20
+ - to generate technical pass/warn/fail checks → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness or domain quality checkers)
21
+ - to assemble technical GLB/web compatibility summaries → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; use glb-web-handoff)
22
+ - to gate handoff readiness → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
23
+
24
+ ## Input & output contract
25
+ - Required input `verified_workflow_and_evidence_state` (`object`): Final pre-handoff verification gate status, runtime truth state, and artifact truth state
26
+ - Required input `deliverable_summary_inputs` (`object`): Technical outputs from scene planners, quality checkers, or handoff packagers to translate
27
+ - Optional input `stakeholder_audience_profile` (`string`): Target reader role (product manager, web developer, creative director, end user)
28
+ - Output contract: `plain_language_stakeholder_response`, `explicit_runtime_and_artifact_status_block`, `jargon_free_next_steps` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
29
+
30
+ ## Quick-start steps
31
+ 1. confirm this skill fits your goal
32
+ 2. provide required inputs first
33
+ 3. keep runtime claims evidence-bound
34
+ 4. follow suggested next-skill handoff
35
+
36
+ ## Cross-skill handoffs
37
+ - [upstream_reference] Upstream artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
38
+ - [fallback] Upstream quality pass/warn/fail validation (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
39
+ - [fallback] Upstream quality pass/warn/fail validation (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
40
+ - [fallback] Upstream quality pass/warn/fail validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
41
+ - [fallback] Upstream quality pass/warn/fail validation (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
42
+ - [fallback] Upstream quality pass/warn/fail validation (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
43
+ - [upstream_reference] Upstream GLB/web handoff summary → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
44
+ - [upstream_reference] Upstream handoff gate check → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
45
+ - [upstream_reference] Runtime readiness check when runtime is unverified → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
46
+
47
+ ## Safety boundaries & non-goals
48
+ - Runtime boundary: 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.
49
+ - Dumping raw logs or unexplained 3D jargon as final output
50
+ - Hiding blockers or dropping caveats for readability
51
+ - Upgrading Runtime or Artifact truth states or overclaiming completion
52
+ - Executing Python or Blender
53
+ - Replacing `render-export-evidence` (evidence classification), validators (`scene-readiness`, etc.), `glb-web-handoff` (handoff summary), or `pre-handoff-verification` (handoff gating)
@@ -0,0 +1,53 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/polycount-budget-checker/SKILL.md and skills/polycount-budget-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # polycount-budget-checker
3
+
4
+ Purpose: Validate per-mesh and total-scene triangle counts against the pinned budget; flag worst offenders and topology hints without modeling.
5
+
6
+ Run a focused pass/warn/fail check on per-mesh and total-scene triangle counts vs the pinned budget from `mobile-glb-budget` (or any other pinned budget). Surface worst offenders and basic topology hints without performing modeling.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `geometry-and-topology-budget-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - before GLB export
13
+ - after a mesh change request
14
+ - as a sub-check during full quality review
15
+ - when `mobile-glb-budget` is pinned
16
+ - Trigger phrases: "is the polycount okay", "check triangle budget", "what's blowing the budget", "topology issue?"
17
+
18
+ ## When not to use (delegation boundaries)
19
+ - pinning or negotiating the performance budget itself → use `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`; use mobile-glb-budget)
20
+ - material validation → use `material-quality-checker` (`references/skill-material-quality-checker.md`; use material-quality-checker)
21
+ - lighting validation → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker)
22
+ - composition validation → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
23
+ - broad scene readiness review → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
24
+ - classifying render or export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
25
+ - fixing topology, decimating, or retopologizing (this skill validates; it never edits or models) → use `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`; this skill validates; it never edits or models)
26
+
27
+ ## Input & output contract
28
+ - Required input `scene_geometry_inventory` (`array`): Per-object triangle, vertex, modifier stack, and subdivision level counts
29
+ - Required input `pinned_geometry_budget` (`object`): Target triangle and draw-call ceilings from mobile-glb-budget or brief
30
+ - Optional input `deformation_or_rig_requirements` (`object`): Optional skeletal deformation or silhouette curvature constraints
31
+ - Output contract: `polycount_and_topology_verdict_table`, `top_budget_offenders_ranking`, `decimation_or_retopology_remediation_plan` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
32
+
33
+ ## Quick-start steps
34
+ 1. read the pinned budget (per-mesh + total-scene)
35
+ 2. enumerate every mesh in the scene plan or measured scene
36
+ 3. compute per-mesh triangle counts vs per-mesh cap
37
+ 4. compute total-scene triangle count vs total cap
38
+ 5. flag worst offenders + give topology hints (no modeling)
39
+
40
+ ## Cross-skill handoffs
41
+ - [upstream_reference] Pinned budget source → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
42
+ - [progression] Broad readiness review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
43
+ - [progression] Artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
44
+ - [upstream_reference] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
45
+ - [upstream_reference] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
46
+ - [upstream_reference] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
47
+
48
+ ## Safety boundaries & non-goals
49
+ - Runtime boundary: This skill validates plans or measured scene snapshots. It never decimates, retopologizes, or runs Blender. Hints are advisory.
50
+ - Decimate or retopologize.
51
+ - Generate topology recipes.
52
+ - Replace `scene-readiness`.
53
+ - Run Blender.
@@ -0,0 +1,57 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/pre-handoff-verification/SKILL.md and skills/pre-handoff-verification/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # pre-handoff-verification
3
+
4
+ Purpose: Verification gate before claiming any deliverable is ready. Forces evidence checks (path, file existence, validation notes) per evidence-before-done law. Use before any 'Verified' claim.
5
+
6
+ Run a structured verification pass before any BlendOps output is handed to the user as "ready" or "Verified". Forces explicit evidence checks per the `evidence-before-done` law and downgrades any unsupported claim to a lower truth label.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `final-7-point-release-gate` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - `workflow-stage-router` routes here as the final gate before handoff, or exits here on any failed upstream gate to lock in an honest downgraded truth label
12
+ - `blendops-help` routes a user directly to verify an existing deliverable or evidence claim
13
+ - a planner / executor / response writer says "the output is ready"
14
+ - before saving an evidence file under `docs/evals/path-X-...md` via `runtime-attempt-report` or `render-export-evidence`
15
+ - before answering a user with `Verified` or `Produced` status
16
+ - before tagging a release or confirming whether a claim holds or must be downgraded
17
+ - when the operator is tempted to claim "done" but evidence is fuzzy
18
+ - Trigger phrases: "looks ready, can we ship?", "I think the render is good — verify before sending", "before saving the evidence file...", "is this Verified or do we downgrade?", "confirm whether this claim holds or must be downgraded"
19
+
20
+ ## When not to use (delegation boundaries)
21
+ - the workflow is still in planning / brainstorming / brief stage (no claim to verify yet) → use `scene-readiness` (`references/skill-scene-readiness.md`; no claim to verify yet)
22
+ - the user explicitly asked for a draft, not a verified deliverable → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; Delegates out-of-scope requests to blender-troubleshooting)
23
+ - runtime status is Not Run and the user knows it (no verification needed when Not Run is the explicit state) → use `render-export-evidence` (`references/skill-render-export-evidence.md`; no verification needed when Not Run is the explicit state)
24
+
25
+ ## Input & output contract
26
+ - Required input `candidate_delivery_package` (`object`): Complete set of planning, quality validation, runtime attempt, and artifact evidence records
27
+ - Required input `proposed_truth_state_claims` (`object`): Proposed Runtime status and Artifact status labels to audit against the 7-point release gate
28
+ - Optional input `active_blocker_or_failed_gate_notes` (`array`): Any upstream Warn/Fail quality verdicts or unresolved runtime blockers
29
+ - Output contract: `seven_point_release_gate_table`, `enforced_downgrade_only_truth_states`, `release_clearance_or_remediation_route` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. read the proposed handoff (response text, artifact list, evidence fields)
33
+ 2. run the 7-point verification checklist
34
+ 3. downgrade any unsupported claim explicitly
35
+ 4. gate handoff on all 7 checks passing or explicit caveats
36
+
37
+ ## Cross-skill handoffs
38
+ - [boundary_delegation] Entry wiring (blendops-help) → `blendops-help` (`references/skill-blendops-help.md`) — `when.all: [request.scope equals "general_help"]`
39
+ - [upstream_reference] Entry wiring (workflow-stage-router) → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
40
+ - [conditional] If verdict is Pass (plain-language-response) → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
41
+ - [upstream_reference] If verdict is Pass (render-export-evidence) → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
42
+ - [upstream_reference] If verdict is Pass (runtime-attempt-report) → `runtime-attempt-report` (`references/skill-runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
43
+ - [upstream_reference] scene/asset quality gap (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
44
+ - [upstream_reference] scene/asset quality gap (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
45
+ - [upstream_reference] scene/asset quality gap (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
46
+ - [upstream_reference] scene/asset quality gap (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
47
+ - [upstream_reference] scene/asset quality gap (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
48
+ - [fallback] runtime/bridge failure (blender-troubleshooting) → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
49
+ - [fallback] runtime/bridge failure (runtime-readiness) → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
50
+ - [fallback] runtime/bridge failure (bridge-conflicts) → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
51
+
52
+ ## Safety boundaries & non-goals
53
+ - Runtime boundary: This skill does not run Blender, mutate scenes, or generate artifacts. It reads the proposed handoff and existing evidence, and either confirms or downgrades the truth label.
54
+ - running Blender
55
+ - generating evidence
56
+ - upgrading claims
57
+ - replacing `render-export-evidence` (that classifies; this gates handoff)
@@ -0,0 +1,45 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/preview-report/SKILL.md and skills/preview-report/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # preview-report
3
+
4
+ Purpose: Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume after a render or export run.
5
+
6
+ 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.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `stakeholder-preview-packet-formatter` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - after `render-export-evidence` produces measurements
12
+ - before `glb-web-handoff` is composed
13
+ - before `plain-language-response` writes the final summary
14
+ - Trigger phrases: "summarize the render", "write up the export evidence", "what's the preview status"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - measuring artifacts directly → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence instead)
18
+ - raw debug logs or crash triage → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; use blender-troubleshooting instead)
19
+ - gating handoff readiness → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification instead)
20
+
21
+ ## Input & output contract
22
+ - Required input `classified_artifact_evidence` (`object`): Verified or Produced artifact evidence record from render-export-evidence
23
+ - Required input `quality_checker_summary` (`object`): Pass/Warn/Fail summary from scene-readiness and specialist validators
24
+ - Optional input `known_visual_caveats` (`array`): Optional non-blocking visual warnings or pending stakeholder review questions
25
+ - Output contract: `stakeholder_preview_evidence_packet`, `truth_state_and_provenance_summary`, `pre_handoff_gate_submission` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
26
+
27
+ ## Quick-start steps
28
+ 1. pick the report kind (`preview` / `render` / `export` / `full`)
29
+ 2. copy measured values and truth labels from `render-export-evidence` (downgrade-only, never upgrade)
30
+ 3. attach artifact paths and runtime path (`Path 1 host a` / `Path 1 host b` / `Path 2` / `CLI`) per row verbatim
31
+ 4. mark unmeasured or unproduced fields as `Not Run` / `Not Produced` (no-run reports are full `Not Run` / `Not Produced` placeholders)
32
+
33
+ ## Cross-skill handoffs
34
+ - [upstream_reference] Measured evidence input (supplies measurements + truth states) → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
35
+ - [progression] Handoff gate (gates handoffs before downstream delivery) → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
36
+ - [progression] Web handoff consumer → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
37
+ - [progression] Final non-Blender user response consumer → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
38
+ - [fallback] Raw debug log triage (out of scope here) → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
39
+
40
+ ## Safety boundaries & non-goals
41
+ - Runtime boundary: 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`.
42
+ - Run Blender.
43
+ - Render or export.
44
+ - Parse log files (out of scope; consume measurement output of `render-export-evidence`).
45
+ - Promote a label without evidence.
@@ -0,0 +1,54 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/product-grid-scene-planner/SKILL.md and skills/product-grid-scene-planner/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # product-grid-scene-planner
3
+
4
+ Purpose: Plan a multi-product grid scene (e-commerce, catalog, comparison) before any modeling or render attempt; consistent lighting, camera, and grid spacing.
5
+
6
+ Translate a multi-product grid intent (e-commerce / catalog / comparison) into a structured scene plan. Distinct from `product-hero-scene-planner` (single product, hero) and `interior-scene` (room scene).
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `multi-product-catalog-grid-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - intent is multi-product display (4+ products in same scene)
12
+ - e-commerce catalog grid
13
+ - product comparison view
14
+ - showroom-style grid
15
+ - Trigger phrases: "grid of products", "lineup of", "catalog showing N items", "comparison render"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - single product hero → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
19
+ - character portrait → use `character-portrait` (`references/skill-character-portrait.md`; use character-portrait)
20
+ - outdoor environment scene → use `environment-shot` (`references/skill-environment-shot.md`; use environment-shot)
21
+ - interior room scene → use `interior-scene` (`references/skill-interior-scene.md`; use interior-scene)
22
+
23
+ ## Input & output contract
24
+ - Required input `locked_3d_brief` (`object`): Locked 3D brief specifying product lineup count, grid rows/columns, and comparison goal
25
+ - Required input `product_variant_inventory` (`array`): List of product SKUs or variants with real-world dimensions for relative scale normalization
26
+ - Optional input `catalog_aspect_and_margin_rules` (`object`): Optional e-commerce card aspect ratio and uniform padding requirements
27
+ - Output contract: `multi_product_grid_layout_matrix`, `scale_normalization_and_spacing_spec`, `uniform_catalog_camera_and_lighting_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
28
+
29
+ ## Quick-start steps
30
+ 1. pin product list (count + per-product type and relative real-world size)
31
+ 2. normalize product scale across cells (or split incompatible scales into separate grids)
32
+ 3. pin grid layout (rows × cols + spacing)
33
+ 4. pin per-cell consistency level (strict / loose for camera angle, lighting, background)
34
+ 5. pin shared material / lighting / background palette
35
+ 6. record assumptions register and hand off to asset discovery, format decision, and quality checkers
36
+
37
+ ## Cross-skill handoffs
38
+ - [upstream_reference] Upstream brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
39
+ - [upstream_reference] Single hero product alternative → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
40
+ - [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
41
+ - [progression] Variant / SKU file output format → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
42
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
43
+ - [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
44
+ - [progression] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
45
+ - [progression] Overall scene quality validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
46
+ - [upstream_reference] Catalog sign-off & stop conditions (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
47
+ - [upstream_reference] Catalog sign-off & stop conditions (done-criteria) → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
48
+
49
+ ## Safety boundaries & non-goals
50
+ - Runtime boundary: Planning-only skill — does not run Blender, model, source assets, or render. Runtime status must remain `Not Run` and Artifact status must remain `Not Produced` (truth states are downgrade-only, never upgrade). Hand off asset needs to `asset-discovery`, file output rules to `output-format-decision`, and validation to quality checkers.
51
+ - Model the products.
52
+ - Source the products.
53
+ - Render.
54
+ - Run Blender.