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,69 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-animation-handoff/SKILL.md and skills/glb-animation-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # glb-animation-handoff (reference summary)
3
+
4
+ ## Purpose
5
+ Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.
6
+
7
+ When a GLB ships with animation, capture the exact playback contract the consumer needs (which clips exist, how to start them, what loops, what does not) so the web side does not guess.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/glb-animation-handoff/SKILL.md`
11
+ - **Contract:** `skills/glb-animation-handoff/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `rig-and-animation-clip-handoff-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - the GLB has at least one animation clip
18
+ - before final glb-web-handoff
19
+ - when the consumer is a web app (Three.js / R3F / Babylon / model-viewer)
20
+ - when the user mentions "idle", "loop", "transition", "interactive trigger"
21
+
22
+ ## Trigger cues
23
+ - "make it loop"
24
+ - "trigger animation on hover"
25
+ - "idle and active states"
26
+ - "smooth transition between"
27
+
28
+ ## When not to use
29
+ - static GLBs with no animation → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
30
+ - video pre-renders → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
31
+ - platforms that re-author animation downstream (game engines re-rigging the asset) → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; game engines re-rigging the asset)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `animation_clip_inventory` (`array`): List of NLA/action clips with frame lengths, FPS, and skeletal/morph types
36
+ - `interactive_playback_triggers` (`object`): Target loop/one-shot semantics, crossfade durations, root-motion policy, and consumer triggers
37
+
38
+ ### Optional inputs
39
+ - `mobile_rig_budget_ceilings` (`object`): Bone count, morph target, and keyframe channel ceilings from mobile-glb-budget
40
+
41
+ ### Primary outputs
42
+ - `per_clip_animation_contract_table`
43
+ - `root_motion_and_interpolation_pins`
44
+ - `consumer_playback_verification_checklist`
45
+
46
+ ## Quick-start procedure
47
+ 1. enumerate every animation clip in the scene plan or exported GLB
48
+ 2. mark the type of each clip (skeletal / morph / both)
49
+ 3. pin FPS, loop semantics, transitions, root-motion treatment
50
+ 4. flag web-playback caveats per clip (Three.js animationMixer, glTF spec quirks)
51
+
52
+ ## Handoff notes
53
+ - **[upstream_reference]** Missing clip list / scene plan (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
54
+ - **[upstream_reference]** Missing clip list / scene plan (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
55
+ - **[upstream_reference]** Missing clip list / scene plan (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
56
+ - **[upstream_reference]** Missing clip list / scene plan (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
57
+ - **[upstream_reference]** Missing clip list / scene plan (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
58
+ - **[upstream_reference]** Channel, bone, and morph ceilings → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
59
+ - **[upstream_reference]** Export verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
60
+ - **[progression]** Web delivery handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
61
+ - **[progression]** React Three Fiber component shape → `r3f-component-plan` (`references/skills/r3f-component-plan.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "react_three_fiber"]`
62
+ - **[progression]** Final user-facing wording → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** This skill is documentation-only. It never exports GLB, runs Blender, writes Python, or claims that a clip plays correctly without measured evidence (`render-export-evidence` for export proof plus manual viewer test for playback).
66
+ - Run Blender or export GLB files.
67
+ - Author, retarget, or modify animations.
68
+ - Generate Python or `bpy` snippets.
69
+ - Promise web-side playback smoothness or upgrade truth states.
@@ -0,0 +1,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-web-handoff/SKILL.md and skills/glb-web-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # glb-web-handoff (reference summary)
3
+
4
+ ## Purpose
5
+ Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.
6
+
7
+ Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/glb-web-handoff/SKILL.md`
11
+ - **Contract:** `skills/glb-web-handoff/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `web-glb-delivery-packager`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
18
+ - when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
19
+ - when preparing truthful next checks before passing final wording to `plain-language-response`
20
+
21
+ ## Trigger cues
22
+ - "prepare web handoff"
23
+ - "is GLB ready"
24
+ - "summarize export status"
25
+
26
+ ## When not to use
27
+ - to claim GLB or export success without concrete evidence → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
28
+ - to replace runtime export verification → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
29
+ - to validate upstream scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
30
+ - to classify raw render/export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
31
+ - to define mobile or file-size performance budgets → delegate to `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`; use mobile-glb-budget)
32
+ - to define animation playback or rig contracts → delegate to `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`; use glb-animation-handoff)
33
+ - to write the final user-facing response wording → delegate to `plain-language-response` (`references/skills/plain-language-response.md`; use plain-language-response)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `verified_or_planned_glb_artifact` (`object`): GLB artifact evidence record (from render-export-evidence) or planned export specification
38
+ - `target_web_viewer_stack` (`string`): Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)
39
+
40
+ ### Optional inputs
41
+ - `animation_and_budget_contracts` (`object`): Optional linked contracts from glb-animation-handoff and mobile-glb-budget
42
+
43
+ ### Primary outputs
44
+ - `web_glb_delivery_handoff_packet`
45
+ - `scale_orientation_and_compression_manifest`
46
+ - `viewer_integration_caveats`
47
+
48
+ ## Quick-start procedure
49
+ 1. confirm this skill fits your goal
50
+ 2. provide required inputs first
51
+ 3. keep runtime claims evidence-bound
52
+ 4. follow suggested next-skill handoff
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Upstream scene readiness validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
56
+ - **[upstream_reference]** Upstream artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
57
+ - **[upstream_reference]** Mobile and file-size budget constraints → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
58
+ - **[upstream_reference]** Animation playback and rig handoff contracts → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
59
+ - **[progression]** Final user-facing response wording → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
60
+
61
+ ## Safety boundaries & non-goals
62
+ - **Runtime boundary:** Never claim GLB or export success without concrete evidence tied to the current run, and never replace runtime export verification. Keep runtime vocabulary strictly within the 2-path (Path 1 Official Blender Lab MCP 5.1+, Path 2 community `mcp-for-blender`) + CLI appendix model. This skill never runs Blender or Python and never upgrades Runtime or Artifact truth states (downgrade-only).
63
+ - Generating Python scripts or executing Blender exports
64
+ - Replacing runtime export verification
65
+ - Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
66
+ - Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
67
+ - Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
68
+ - Making unsupported web stack or loader compatibility guarantees
@@ -0,0 +1,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/intent-to-3d-brief-writer/SKILL.md and skills/intent-to-3d-brief-writer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # intent-to-3d-brief-writer (reference summary)
3
+
4
+ ## Purpose
5
+ Convert a non-Blender-user's natural-language request into a structured 3D brief (subject, mood, deliverables, constraints, evidence expectations). Use as first step before any planner.
6
+
7
+ Translate a confirmed user intent (from `blender-brainstorming` or a clear initial request) into a structured 3D brief that downstream planners and `acceptance-criteria-builder` can consume without re-asking. Inspired by the "Analysis phase" pattern in BMad-Method (PRD / project brief), adapted for 3D scene work and non-Blender users.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/intent-to-3d-brief-writer/SKILL.md`
11
+ - **Contract:** `skills/intent-to-3d-brief-writer/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `canonical-8-slot-brief-author`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - right after `blender-brainstorming` confirms user intent
18
+ - when the user provides a structured request that just needs format normalization
19
+ - before any planner skill (`product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`)
20
+ - before `acceptance-criteria-builder` consumes brief rows to build criteria
21
+ - when multiple planners need to share the same source-of-truth brief
22
+
23
+ ## Trigger cues
24
+ - "lock the brief"
25
+ - "write the brief from this conversation"
26
+ - "what's the formal scope?"
27
+ - "before planning, write the spec"
28
+
29
+ ## When not to use
30
+ - intent is still ambiguous (run blender-brainstorming first) → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; run blender-brainstorming first)
31
+ - the user is mid-execution and asks for a re-brief → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; route to blender-troubleshooting instead)
32
+ - the user pushes for immediate execution → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; route to runtime-readiness)
33
+ - the request is iteration on existing output ("make it darker") — that's a planner-level edit, not a new brief → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `raw_user_goal_and_context` (`string`): User request or brainstormed concept to lock into the canonical 8-slot 3D brief
38
+ - `target_deliverable_surface` (`string`): Intended output format (hero still, product grid, portrait, environment, interior, or web GLB)
39
+
40
+ ### Optional inputs
41
+ - `selected_recipe_or_pack` (`string`): Recipe or pack selected via recipe-fit-assessor
42
+
43
+ ### Primary outputs
44
+ - `canonical_8_slot_3d_brief`
45
+ - `explicit_assumptions_register`
46
+ - `scope_exclusions_and_next_skill`
47
+
48
+ ## Quick-start procedure
49
+ 1. read confirmed intent from prior step (`blender-brainstorming` or original request)
50
+ 2. fill the 8 brief slots (mark unconfirmed items as `Unknown`, never invent)
51
+ 3. echo the brief to the user for confirmation
52
+ 4. hand off to downstream planners (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder` once confirmed
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Preceding step → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
56
+ - **[progression]** Consuming skills (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
57
+ - **[progression]** Consuming skills (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
58
+ - **[progression]** Consuming skills (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
59
+ - **[alternative]** Consuming skills (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
60
+ - **[conditional]** If execution is requested → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
61
+ - **[fallback]** If mid-execution re-briefing occurs → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
62
+
63
+ ## Safety boundaries & non-goals
64
+ - **Runtime boundary:** This skill does not install Blender, run Blender, configure MCP, or claim artifacts. Output is a structured text brief.
65
+ - making the plan (planner's job)
66
+ - running Blender
67
+ - setting up runtime
68
+ - writing the final user response (`plain-language-response`'s job)
@@ -0,0 +1,73 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/interior-scene/SKILL.md and skills/interior-scene/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # interior-scene (reference summary)
3
+
4
+ ## Purpose
5
+ Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.
6
+
7
+ Translate an interior architectural visualization intent (room or interior space planned for catalog, brand, or showcase) into a complete, structured room plan with an assumptions register. Distinct from `environment-shot` (outdoor/wide places; an establishing shot of an interior room belongs HERE when furniture and surfaces dominate), `product-hero-scene-planner` (single manufactured product), and `character-portrait` (single subject).
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/interior-scene/SKILL.md`
11
+ - **Contract:** `skills/interior-scene/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `interior-archviz-scene-architect`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
18
+ - architectural visualization, catalog, brand showcase, hospitality, or residential room planning
19
+ - before any modeling, furniture sourcing, or rendering
20
+
21
+ ## Trigger cues
22
+ - "interior of"
23
+ - "living room scene"
24
+ - "office showcase"
25
+ - "hotel lobby"
26
+ - "kitchen showroom"
27
+
28
+ ## When not to use
29
+ - outdoor establishing → delegate to `environment-shot` (`references/skills/environment-shot.md`; use environment-shot)
30
+ - single hero product → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
31
+ - character portrait → delegate to `character-portrait` (`references/skills/character-portrait.md`; use character-portrait)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `locked_3d_brief` (`object`): Locked 3D brief specifying room type, architectural style, focal zone, and daylight/artificial mood
36
+ - `room_dimensions_and_openings` (`object`): Architectural envelope, window/door openings, and primary furniture anchor zones
37
+
38
+ ### Optional inputs
39
+ - `sourced_furniture_and_finish_assets` (`array`): Available furniture and architectural material assets from asset-discovery
40
+
41
+ ### Primary outputs
42
+ - `interior_zone_and_circulation_plan`
43
+ - `window_portal_and_fixture_lighting_plan`
44
+ - `two_point_vertical_camera_constraints`
45
+
46
+ ## Quick-start procedure
47
+ 1. lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
48
+ 2. pin architecture basics (walls, floor, ceiling, windows, doors)
49
+ 3. pin furniture + props + material palette
50
+ 4. pin lighting (natural + artificial mix) + mood + time of day
51
+ 5. pin camera angle + lens
52
+ 6. emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Upstream brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
56
+ - **[upstream_reference]** Outdoor / wide establishing shot redirect → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
57
+ - **[upstream_reference]** Single hero product redirect → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
58
+ - **[upstream_reference]** Single character portrait redirect → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
59
+ - **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
60
+ - **[upstream_reference]** Performance / polycount budget → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
61
+ - **[upstream_reference]** Style consistency check → `asset-style-check` (`references/skills/asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
62
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
63
+ - **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
64
+ - **[progression]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
65
+ - **[progression]** Scene quality validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
66
+
67
+ ## Safety boundaries & non-goals
68
+ - **Runtime boundary:** Planning-only skill — does not model, source furniture, render, or execute Blender. Runtime status stays `Not Run` and artifact status stays `Not Produced` (downgrade-only, never upgrade). Hand off asset sourcing to `asset-discovery`, budget questions to `mobile-glb-budget`, style checks to `asset-style-check`, and validation to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
69
+ - Model the room or geometry.
70
+ - Source furniture or download assets (belongs to `asset-discovery`).
71
+ - Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
72
+ - Audit cross-asset style consistency or validate composition, lighting, materials, or scene quality (belongs to `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`).
73
+ - Render or run Blender.
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-material-plan/SKILL.md and skills/lighting-material-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # lighting-material-plan (reference summary)
3
+
4
+ ## Purpose
5
+ Build detailed lighting and material direction with portability and caveat handling for Blender/web-3D outputs.
6
+
7
+ Create a high-quality, practical lighting/material plan that balances visual intent and web portability constraints.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/lighting-material-plan/SKILL.md`
11
+ - **Contract:** `skills/lighting-material-plan/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `lighting-rig-and-lookdev-deep-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - look-development strategy is needed
18
+ - lighting/material choices drive scene mood
19
+ - web/GLB portability caveats must be explicit
20
+
21
+ ## Trigger cues
22
+ - "plan lighting and materials"
23
+ - "design cyberpunk lookdev"
24
+ - "define PBR and reflection strategy"
25
+
26
+ ## When not to use
27
+ - to claim final rendered quality or executed results → delegate to `camera-composition` (`references/skills/camera-composition.md`; Delegates out-of-scope requests to camera-composition)
28
+ - to skip composition/camera context from camera-composition → delegate to `camera-composition` (`references/skills/camera-composition.md`; Delegates out-of-scope requests to camera-composition)
29
+ - to validate existing lighting or materials → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker and material-quality-checker)
30
+ - to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision) → delegate to `color-management-decision` (`references/skills/color-management-decision.md`; output-format-decision)
31
+ - to execute Blender or generate Python scripts → delegate to `color-management-decision` (`references/skills/color-management-decision.md`; Delegates out-of-scope requests to color-management-decision)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `domain_scene_plan` (`object`): Upstream scene layout and subject surface description
36
+ - `camera_framing_plan` (`object`): Locked camera angles and hero silhouette requirements from camera-composition
37
+
38
+ ### Optional inputs
39
+ - `target_render_engine_hint` (`string`): Preferred engine (Cycles, Eevee, or WebGL/GLB PBR export target)
40
+
41
+ ### Primary outputs
42
+ - `key_fill_rim_lighting_plan`
43
+ - `pbr_material_and_roughness_spec`
44
+ - `hdri_and_reflection_strategy`
45
+
46
+ ## Quick-start procedure
47
+ 1. confirm this skill fits your goal
48
+ 2. provide required inputs first
49
+ 3. keep runtime claims evidence-bound
50
+ 4. follow suggested next-skill handoff
51
+
52
+ ## Handoff notes
53
+ - **[upstream_reference]** Upstream input from (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
54
+ - **[progression]** Upstream input from (color-management-decision) → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
55
+ - **[progression]** Upstream input from (cycles-vs-eevee-decision) → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
56
+ - **[progression]** Upstream input from (output-format-decision) → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
57
+ - **[progression]** Next validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
58
+ - **[progression]** Next validation (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
59
+ - **[progression]** Then scene check → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
60
+ - **[progression]** Then delivery → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
61
+
62
+ ## Safety boundaries & non-goals
63
+ - **Runtime boundary:** This is a planning-only skill: no Blender execution, no Python, and no artifact generation. Runtime status always remains `Not Run` and artifact status always remains `Not Produced` (truth states are downgrade-only, never upgrade). If referencing Eevee engine tokens from upstream `cycles-vs-eevee-decision`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` only for 4.2–4.x — never present Eevee Next as the current name.
64
+ - shader/runtime implementation code
65
+ - rendered quality claims without evidence
@@ -0,0 +1,70 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-quality-checker/SKILL.md and skills/lighting-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # lighting-quality-checker (reference summary)
3
+
4
+ ## Purpose
5
+ Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
6
+
7
+ Run a focused pass/warn/fail check on the scene's lighting setup per light — covering intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance, and mood match — without expanding into material, composition, or lookdev planning concerns.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/lighting-quality-checker/SKILL.md`
11
+ - **Contract:** `skills/lighting-quality-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `quality-validators` / `exposure-ratio-and-shadow-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - after a lighting change request
19
+ - as a sub-check during full quality review
20
+ - when the rendered preview looks "off" but the issue is unclear
21
+
22
+ ## Trigger cues
23
+ - "is the lighting okay"
24
+ - "check shadow softness"
25
+ - "lighting feels off"
26
+ - "is the HDRI balanced"
27
+
28
+ ## When not to use
29
+ - upstream lookdev and lighting planning → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
30
+ - material validation → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; use material-quality-checker)
31
+ - composition / camera validation → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
32
+ - broad pass/warn/fail scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
33
+ - classifying render or export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
34
+ - to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; this skill validates and gives remediation hints only; it never edits)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `lighting_rig_specification` (`object`): Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan
39
+ - `color_management_pins` (`object`): Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision
40
+
41
+ ### Optional inputs
42
+ - `render_or_preview_exposure_notes` (`string`): Optional highlight clipping or shadow crush observations from preview output
43
+
44
+ ### Primary outputs
45
+ - `lighting_quality_verdict_table`
46
+ - `key_fill_rim_and_clipping_audit`
47
+ - `lighting_remediation_instructions`
48
+
49
+ ## Quick-start procedure
50
+ 1. enumerate every explicit light and HDRI in the scene plan or measured scene
51
+ 2. check intensity ranges per light
52
+ 3. check shadow softness consistency
53
+ 4. check color temperature consistency
54
+ 5. check HDRI presence + balance with explicit lights
55
+ 6. check mood match against the brief
56
+ 7. emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
57
+
58
+ ## Handoff notes
59
+ - **[progression]** Broad readiness review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
60
+ - **[upstream_reference]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
61
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
62
+ - **[retry]** Lighting re-plan → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
63
+ - **[progression]** Render evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
64
+
65
+ ## Safety boundaries & non-goals
66
+ - **Runtime boundary:** This skill validates plans or measured scene snapshots only. It never modifies lights, runs Blender, or renders. Use measured scene description (plan output, runtime tool snapshot) — never invent values.
67
+ - Edit lights.
68
+ - Generate light setup recipes.
69
+ - Replace `scene-readiness`.
70
+ - Run Blender.
@@ -0,0 +1,71 @@
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 (reference summary)
3
+
4
+ ## Purpose
5
+ Validate PBR material sanity, texture budgets, and web/runtime compatibility per material before render or export.
6
+
7
+ 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.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/material-quality-checker/SKILL.md`
11
+ - **Contract:** `skills/material-quality-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `quality-validators` / `pbr-and-shader-portability-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - before GLB export
19
+ - after a material change request
20
+ - as a sub-check during full quality review
21
+
22
+ ## Trigger cues
23
+ - "are the materials okay"
24
+ - "check PBR sanity"
25
+ - "texture budget for materials"
26
+ - "will the materials work in Three.js"
27
+
28
+ ## When not to use
29
+ - upstream lookdev and material planning → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
30
+ - lighting validation → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker)
31
+ - composition / camera validation → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
32
+ - broad pass/warn/fail scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
33
+ - web integration and viewer handoff → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; use glb-web-handoff)
34
+ - to fix or edit materials (this skill validates and emits remediation hints only; it never edits) → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; this skill validates and emits remediation hints only; it never edits)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `material_and_shader_inventory` (`array`): Principled BSDF parameter ranges, texture maps, UV channels, and normal map conventions
39
+ - `target_consumption_surface` (`string`): Whether materials target offline Cycles/Eevee rendering or glTF 2.0 PBR web export
40
+
41
+ ### Optional inputs
42
+ - `texture_memory_budget` (`object`): Maximum texture resolution and VRAM budget from mobile-glb-budget
43
+
44
+ ### Primary outputs
45
+ - `pbr_material_verdict_table`
46
+ - `gltf_shader_portability_risks`
47
+ - `material_remediation_steps`
48
+
49
+ ## Quick-start procedure
50
+ 1. enumerate every material referenced in the scene plan or measured scene
51
+ 2. check PBR sanity (albedo range, normal map sign, roughness/metallic plausibility)
52
+ 3. check texture budget (resolution, count, format)
53
+ 4. check consumer-stack compatibility (KHR extensions, unsupported features for chosen target)
54
+ 5. emit per-material verdicts + a top-line status
55
+
56
+ ## Handoff notes
57
+ - **[retry]** Upstream lookdev & material planning → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
58
+ - **[upstream_reference]** Mobile/web texture budget definition → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
59
+ - **[progression]** Broad readiness review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
60
+ - **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
61
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
62
+ - **[progression]** Polycount budget → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
63
+ - **[progression]** Render / GLB export evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
64
+ - **[progression]** Web handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
65
+
66
+ ## Safety boundaries & non-goals
67
+ - **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.
68
+ - Edit materials.
69
+ - Generate shader code.
70
+ - Replace `scene-readiness` (this skill is one of its inputs).
71
+ - Run Blender.
@@ -0,0 +1,73 @@
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 (reference summary)
3
+
4
+ ## Purpose
5
+ Set explicit triangle / texture / draw-call / file-size / animation budgets for GLB targeted at mobile-web before any export decision.
6
+
7
+ 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.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/mobile-glb-budget/SKILL.md`
11
+ - **Contract:** `skills/mobile-glb-budget/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `evidence-and-handoff` / `mobile-webgl-budget-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before scene plan is locked
18
+ - before any GLB export attempt
19
+ - when user says "for mobile" / "for the web" / "phone" / "low-end devices"
20
+ - when designing a scene that must run alongside other web content
21
+
22
+ ## Trigger cues
23
+ - "what's a good polycount for mobile"
24
+ - "how big can the GLB be"
25
+ - "will this load on iPhone"
26
+ - "what should I aim for on a phone"
27
+
28
+ ## When not to use
29
+ - desktop-only renders without web handoff → delegate to `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`; Delegates out-of-scope requests to polycount-budget-checker)
30
+ - offline pre-rendered video (no real-time budget needed) → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; no real-time budget needed)
31
+ - replacing engineering load testing (this skill sets a planning budget, not a real-world benchmark) → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; this skill sets a planning budget, not a real-world benchmark)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `target_device_tier_and_network` (`string`): Target mobile/web hardware tier (iOS Safari, mid-range Android, desktop WebGL) and load budget
36
+ - `scene_deliverable_type` (`string`): Whether the GLB is a single hero product, multi-item configurator, or animated character
37
+
38
+ ### Optional inputs
39
+ - `compression_pipeline_support` (`object`): Whether the host app supports Draco, Meshopt, or KTX2 BasisU transcoding
40
+
41
+ ### Primary outputs
42
+ - `pinned_glb_performance_budget_table`
43
+ - `triangle_drawcall_and_texture_ceilings`
44
+ - `compression_and_lod_requirements`
45
+
46
+ ## Quick-start procedure
47
+ 1. pick the device tier (low-end Android, mid-mobile, high-mobile, desktop-fallback)
48
+ 2. read the budget row for that tier
49
+ 3. pin the budget into the scene plan before mutation
50
+ 4. treat any later violation as a blocker, not a warning
51
+
52
+ ## Handoff notes
53
+ - **[progression]** Scene planning (consumes pinned budget) (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
54
+ - **[progression]** Scene planning (consumes pinned budget) (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
55
+ - **[alternative]** Scene planning (consumes pinned budget) (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
56
+ - **[alternative]** Scene planning (consumes pinned budget) (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
57
+ - **[alternative]** Scene planning (consumes pinned budget) (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
58
+ - **[alternative]** Scene planning (consumes pinned budget) (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
59
+ - **[alternative]** Scene planning (consumes pinned budget) (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
60
+ - **[progression]** Count and texture budget validation (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
61
+ - **[progression]** Count and texture budget validation (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
62
+ - **[progression]** Count and texture budget validation (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
63
+ - **[progression]** Measured export compliance → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
64
+ - **[progression]** Web delivery handoff (consumes pinned budget) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
65
+ - **[progression]** Animation contracts (owns animation contract details within pinned channel/bone/morph ceilings) → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
66
+
67
+ ## Safety boundaries & non-goals
68
+ - **Runtime boundary:** BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix** (see `docs/runtime-stack-strategy.md`):
69
+ - Run a real-world benchmark.
70
+ - Install Blender.
71
+ - Run Blender.
72
+ - Choose a render engine.
73
+ - Write web-side optimization code.