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,271 @@
1
+ ---
2
+ name: glb-animation-handoff
3
+ description: Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.
4
+ ---
5
+
6
+ # glb-animation-handoff
7
+
8
+ ## Purpose
9
+ 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.
10
+
11
+ ## Quick start
12
+ - enumerate every animation clip in the scene plan or exported GLB
13
+ - mark the type of each clip (skeletal / morph / both)
14
+ - pin FPS, loop semantics, transitions, root-motion treatment
15
+ - flag web-playback caveats per clip (Three.js animationMixer, glTF spec quirks)
16
+
17
+ ## When to use
18
+ - the GLB has at least one animation clip
19
+ - before final glb-web-handoff
20
+ - when the consumer is a web app (Three.js / R3F / Babylon / model-viewer)
21
+ - when the user mentions "idle", "loop", "transition", "interactive trigger"
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - static GLBs with no animation → use `../glb-web-handoff/SKILL.md` (Delegates out-of-scope requests to glb-web-handoff)
26
+ - video pre-renders → use `../output-format-decision/SKILL.md` (Delegates out-of-scope requests to output-format-decision)
27
+ - platforms that re-author animation downstream (game engines re-rigging the asset) → use `../product-hero-scene-planner/SKILL.md` (game engines re-rigging the asset)
28
+ <!-- blendops:generated:end exclusions -->
29
+
30
+ ## Trigger phrases
31
+ <!-- blendops:generated:start triggers -->
32
+ - "make it loop"
33
+ - "trigger animation on hover"
34
+ - "idle and active states"
35
+ - "smooth transition between"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - scene plan or exported GLB lists clip names
40
+ - target web stack known (Three.js / R3F / Babylon / model-viewer)
41
+ - expected user trigger pattern known (auto-loop / hover / click / scroll)
42
+
43
+ ## Input schema
44
+
45
+ ### Required inputs
46
+
47
+ | Input | Why it is required |
48
+ |---|---|
49
+ | Clip list (names + lengths in frames or seconds) | Consumer must know what exists without inventing clips |
50
+ | Clip type per clip (`skeletal` / `morph` / `both`) | Determines rig vs morph target handling |
51
+ | Target FPS | Determines time-base mapping for the consumer |
52
+ | Loop / one-shot / chain semantics per clip | Determines playback behavior |
53
+ | Trigger model | Auto / hover / click / scroll / programmatic |
54
+ | Blend duration | Crossfade duration for chained or interactive transitions |
55
+ | Root-motion treatment (`bake` or `strip`) | Binary choice per clip; never ambiguous or combined |
56
+ | Interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`) | Always pinned per clip |
57
+
58
+ ### Optional inputs
59
+
60
+ | Input | Use |
61
+ |---|---|
62
+ | Channel, bone, and morph ceilings | Sourced from `mobile-glb-budget` to keep contract within budget |
63
+ | Target consumer stack | Tailors caveats for Three.js, R3F, Babylon, or model-viewer |
64
+
65
+ ### Assumptions to confirm
66
+ - Animation timing is recorded in seconds (not just frames) for portability.
67
+ - Interpolation type (`LINEAR` / `STEP` / `CUBICSPLINE`) and binary root-motion treatment (`bake` or `strip`) are explicitly pinned for every clip.
68
+ - Channel, bone, and morph target ceilings are pinned by `mobile-glb-budget`.
69
+
70
+ ## Output schema
71
+
72
+ ### Primary output
73
+ A structured animation contract before `glb-web-handoff`: per-clip rows with type (`skeletal` / `morph` / `both`), length, FPS, `loop` / `one-shot` / `chain`, trigger, blend, binary root-motion (`bake` or `strip`), and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`).
74
+
75
+ ### Secondary output
76
+ - consumer-stack-specific caveats (Three.js / R3F / Babylon / model-viewer)
77
+ - a "what to verify after export" checklist (paired with `render-export-evidence` and manual viewer test)
78
+ - explicit assumptions, budget ceiling references (`mobile-glb-budget`), and named next handoff
79
+
80
+ ### Evidence / caveat output
81
+
82
+ ```txt
83
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
84
+ Artifact status: Not Produced | Produced | Verified | Failed
85
+ Evidence used: <links, paths, logs, or "none">
86
+ Limitations: <known gaps>
87
+ ```
88
+
89
+ Default for planning documentation is `Runtime status: Not Run` and `Artifact status: Not Produced`. Truth states are downgrade-only, never upgraded by this skill.
90
+
91
+ ## Required laws
92
+ - `../../laws/evidence-before-done.md`
93
+ - `../../laws/non-blender-user-language.md`
94
+ - `../../laws/no-arbitrary-python-interface.md`
95
+ - `../../laws/official-runtime-only.md`
96
+
97
+ ## Official runtime boundary
98
+
99
+ 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).
100
+
101
+ If runtime execution is needed, refer to `../../docs/runtime-stack-strategy.md` and hand off export verification to `render-export-evidence`.
102
+
103
+ ## Operating procedure
104
+
105
+ 1. Read the existing clip list from the upstream scene plan or verified export report (never invent clips).
106
+ 2. Confirm animation channel, bone, and morph ceilings from `mobile-glb-budget`.
107
+ 3. For each clip, fill the contract row: type (`skeletal` / `morph` / `both`), length, FPS, `loop` / `one-shot` / `chain`, trigger, blend, root-motion (`bake` or `strip`), and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`).
108
+ 4. Apply consumer-stack caveats (`references/web-stack-caveats.md`), animation-type caveats (`references/animation-types.md`), and transition rules (`references/transition-rules.md`).
109
+ 5. Attach the "what to verify after export" checklist covering `render-export-evidence` and manual viewer testing.
110
+ 6. Record truth states (`Runtime status: Not Run`, `Artifact status: Not Produced` default; downgrade-only, never upgrade).
111
+ 7. Hand off to `glb-web-handoff` (and `r3f-component-plan` if R3F, then `plain-language-response` for final user wording).
112
+
113
+ ## Decision tree
114
+
115
+ ```txt
116
+ Clip list unknown?
117
+ → Do not invent clips; hand off to product-hero-scene-planner, character-portrait, environment-shot, interior-scene, or product-grid-scene-planner first
118
+ Channel, bone, or morph ceiling unpinned or exceeded?
119
+ → Hand off to mobile-glb-budget
120
+ Multiple clips meant to chain or transition?
121
+ → Document blend duration explicitly per clip pair
122
+ Root motion present?
123
+ → Pick binary treatment per clip: bake OR strip (never both, never undefined)
124
+ Export proof or playback verification needed?
125
+ → Hand off to render-export-evidence + require manual viewer test
126
+ ```
127
+
128
+ ## Playbooks
129
+
130
+ ### Playbook A: Idle-only loop
131
+
132
+ Single skeletal idle clip, auto-loop on mount. Pin type, length, FPS, `loop`, auto trigger, `0ms` blend, root-motion (`strip` or `bake`), and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`).
133
+
134
+ ### Playbook B: Idle + active (hover/click)
135
+
136
+ Two clips. Pin FPS, length, trigger, crossfade blend duration (e.g., 200–400ms), return-to-idle chain semantics, binary root-motion (`bake` or `strip`), and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`) for each clip.
137
+
138
+ ### Playbook C: Scroll-driven scrub
139
+
140
+ Single clip driven by scroll progress (`one-shot` / programmatic scrub trigger). Pin length, FPS, blend (`0ms`), binary root-motion (`bake` or `strip`), and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`). Never promise playback smoothness.
141
+
142
+ ## Mode handling
143
+
144
+ ### Text-only mode
145
+
146
+ Produce the animation contract from the scene plan; set `Runtime status: Not Run` and `Artifact status: Not Produced`.
147
+
148
+ ### Runtime-ready mode
149
+
150
+ Keep this skill's contract truth states downgrade-only (default `Runtime status: Not Run`, `Artifact status: Not Produced`; never upgrade here). Route export verification to `render-export-evidence` and require a manual viewer test to verify clip count, lengths, and playback behavior against the contract.
151
+
152
+ ### Blocked runtime mode
153
+
154
+ Produce the planning contract with `Runtime status: Not Run` and `Artifact status: Not Produced`, and explicitly list which verification items remain blocked pending `render-export-evidence` and manual viewer testing.
155
+
156
+ ## Validation checklist
157
+
158
+ * [ ] Every clip from the scene plan is listed (no invented clips)
159
+ * [ ] Type pinned per clip (`skeletal` / `morph` / `both`)
160
+ * [ ] Length and FPS pinned per clip
161
+ * [ ] `loop` / `one-shot` / `chain` semantics explicit per clip
162
+ * [ ] Trigger model and blend duration explicit per clip
163
+ * [ ] Root-motion treatment chosen as binary (`bake` or `strip`, never both)
164
+ * [ ] Interpolation pinned per clip (`LINEAR` / `STEP` / `CUBICSPLINE`)
165
+ * [ ] Channel, bone, and morph counts checked against ceilings from `mobile-glb-budget`
166
+ * [ ] Consumer-stack caveats and what-to-verify checklist included
167
+ * [ ] Truth states default to `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgraded)
168
+ * [ ] No smoothness promises and no Python snippets
169
+ * [ ] Next handoff skill explicitly named (`glb-web-handoff`)
170
+
171
+ ## Pass / Warn / Fail rubric
172
+
173
+ | Verdict | Criteria |
174
+ |---|---|
175
+ | Pass | All per-clip contract fields pinned (including FPS, binary root-motion, and interpolation), stack caveats and verify checklist included, truth states honest and downgrade-only, handoff named. |
176
+ | Warn | Contract present but blend duration, trigger detail, or stack caveats are incomplete. |
177
+ | Fail | Inventing clips, promising smoothness, omitting FPS / interpolation / binary root-motion, including Python snippets, upgrading truth states, or claiming clips play correctly without `render-export-evidence` + manual viewer test. |
178
+
179
+ ## Failure handling
180
+
181
+ * If clip list is unknown → do not invent clips; hand off to the appropriate scene planner (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, or `product-grid-scene-planner`).
182
+ * If consumer stack is unknown → list caveats per stack and ask the user to confirm before `glb-web-handoff`.
183
+ * If channel, bone, or morph counts exceed ceilings → hand off to `mobile-glb-budget`.
184
+ * If export proof is missing → keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and hand off to `render-export-evidence`.
185
+
186
+ ## Troubleshooting
187
+
188
+ | Problem | Response |
189
+ |---|---|
190
+ | Clip plays at wrong speed in web viewer | Check that the contracted FPS and clip length in seconds match the consumer stack playback settings during manual viewer test. |
191
+ | Clip transition pops or loops abruptly | Verify `loop` / `one-shot` / `chain` semantics, blend duration, and pinned interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`) in the contract. |
192
+ | Bone or channel limits exceeded on target device | Hand off to `mobile-glb-budget` to enforce bone, morph, and animation channel ceilings. |
193
+ | Unverified export or missing clips in file | Hand off to `render-export-evidence` for export verification and perform a manual viewer test. |
194
+
195
+ ## Best practices
196
+
197
+ * Always pin FPS and interpolation (`LINEAR` / `STEP` / `CUBICSPLINE`) per clip, even when the user thinks defaults are sufficient.
198
+ * Treat root motion as a strict binary choice (`bake` or `strip`), never undefined or mixed.
199
+ * Always pair with `mobile-glb-budget` for channel, bone, and morph ceilings.
200
+ * Never invent clips and never promise playback smoothness.
201
+
202
+ ## Good examples
203
+
204
+ * "Clips: `idle` (`skeletal`, `4s`, `30fps`, `loop`, `auto`, blend `0ms`, root-motion `strip`, `LINEAR`), `wave` (`skeletal`, `2s`, `30fps`, `one-shot` chain to `idle`, `hover`, blend `250ms`, root-motion `strip`, `LINEAR`). Ceilings (via `mobile-glb-budget`): channels 24/50, bones 32/64, morphs 0/8. What to verify: confirm export via `render-export-evidence` and manual viewer test. `Runtime status: Not Run`, `Artifact status: Not Produced`. Next: `glb-web-handoff`."
205
+
206
+ ## Bad examples
207
+
208
+ - "It animates." — no contract.
209
+ - "Will be smooth." — no FPS, no blend, no measurement.
210
+
211
+ ## User-facing response template
212
+
213
+ ```txt
214
+ Clip contract:
215
+ <clip name>: <skeletal|morph|both> | <length s> | <fps> | <loop|one-shot|chain> | <trigger> | <blend ms> | <bake|strip> | <LINEAR|STEP|CUBICSPLINE>
216
+
217
+ Consumer stack: <three.js / r3f / babylon / model-viewer>
218
+ Stack-specific caveats: <list>
219
+
220
+ Budget check (from mobile-glb-budget):
221
+ Animation channels: <N> of <ceiling>
222
+ Bones: <N> of <ceiling>
223
+ Morph targets: <N> of <ceiling>
224
+
225
+ What to verify after export:
226
+ - [ ] Export proof verified via render-export-evidence
227
+ - [ ] Clip names, lengths, FPS, and loop/chain behavior checked in manual viewer test
228
+ - [ ] Root-motion (bake vs strip) and blend transitions verified in target consumer stack
229
+
230
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
231
+ Artifact status: Not Produced | Produced | Verified | Failed
232
+ Evidence used: <links, paths, logs, or "none">
233
+ Limitations: <gaps>
234
+ Next: glb-web-handoff
235
+ ```
236
+
237
+ ## Anti-patterns
238
+
239
+ * Inventing clip names not present in the scene plan.
240
+ * Promising playback smoothness under any circumstance.
241
+ * Leaving root-motion treatment ambiguous or mixing `bake` and `strip` silently.
242
+ * Omitting FPS or interpolation type (`LINEAR` / `STEP` / `CUBICSPLINE`).
243
+ * Including Blender Python (`bpy.ops`) snippets.
244
+ * Using `Artifact status: Not Run` or upgrading truth states instead of keeping them downgrade-only.
245
+
246
+ ## Cross-skill handoff
247
+ <!-- blendops:generated:start handoffs -->
248
+ - [upstream_reference] Missing clip list / scene plan (character-portrait) → `../character-portrait/SKILL.md`
249
+ - [upstream_reference] Missing clip list / scene plan (environment-shot) → `../environment-shot/SKILL.md`
250
+ - [upstream_reference] Missing clip list / scene plan (interior-scene) → `../interior-scene/SKILL.md`
251
+ - [upstream_reference] Missing clip list / scene plan (product-grid-scene-planner) → `../product-grid-scene-planner/SKILL.md`
252
+ - [upstream_reference] Missing clip list / scene plan (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
253
+ - [upstream_reference] Channel, bone, and morph ceilings → `../mobile-glb-budget/SKILL.md`
254
+ - [upstream_reference] Export verification → `../render-export-evidence/SKILL.md`
255
+ - [progression] Web delivery handoff → `../glb-web-handoff/SKILL.md`
256
+ - [progression] React Three Fiber component shape → `../r3f-component-plan/SKILL.md`
257
+ - [progression] Final user-facing wording → `../plain-language-response/SKILL.md`
258
+ <!-- blendops:generated:end handoffs -->
259
+
260
+ ## Non-goals
261
+
262
+ * Run Blender or export GLB files.
263
+ * Author, retarget, or modify animations.
264
+ * Generate Python or `bpy` snippets.
265
+ * Promise web-side playback smoothness or upgrade truth states.
266
+
267
+ ## References
268
+ - `references/animation-types.md`
269
+ - `references/web-stack-caveats.md`
270
+ - `references/transition-rules.md`
271
+ - `../../docs/skill-system.md`
@@ -0,0 +1,247 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "glb-animation-handoff",
4
+ "version": "1.0.0",
5
+ "category": "evidence-and-handoff",
6
+ "role": "rig-and-animation-clip-handoff-planner",
7
+ "purpose": "Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "make it loop",
11
+ "trigger animation on hover",
12
+ "idle and active states",
13
+ "smooth transition between"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "static GLBs with no animation",
18
+ "delegateTo": "glb-web-handoff",
19
+ "reason": "Delegates out-of-scope requests to glb-web-handoff"
20
+ },
21
+ {
22
+ "condition": "video pre-renders",
23
+ "delegateTo": "output-format-decision",
24
+ "reason": "Delegates out-of-scope requests to output-format-decision"
25
+ },
26
+ {
27
+ "condition": "platforms that re-author animation downstream (game engines re-rigging the asset)",
28
+ "delegateTo": "product-hero-scene-planner",
29
+ "reason": "game engines re-rigging the asset"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "animation_clip_inventory",
36
+ "type": "array",
37
+ "description": "List of NLA/action clips with frame lengths, FPS, and skeletal/morph types"
38
+ },
39
+ {
40
+ "name": "interactive_playback_triggers",
41
+ "type": "object",
42
+ "description": "Target loop/one-shot semantics, crossfade durations, root-motion policy, and consumer triggers"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "mobile_rig_budget_ceilings",
48
+ "type": "object",
49
+ "description": "Bone count, morph target, and keyframe channel ceilings from mobile-glb-budget"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "per_clip_animation_contract_table",
56
+ "root_motion_and_interpolation_pins",
57
+ "consumer_playback_verification_checklist"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "character-portrait",
68
+ "type": "upstream_reference",
69
+ "label": "Missing clip list / scene plan (character-portrait)",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "brief.locked",
74
+ "operator": "equals",
75
+ "value": true
76
+ },
77
+ {
78
+ "field": "recipe.domain",
79
+ "operator": "equals",
80
+ "value": "character_portrait"
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "environment-shot",
87
+ "type": "upstream_reference",
88
+ "label": "Missing clip list / scene plan (environment-shot)",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "brief.locked",
93
+ "operator": "equals",
94
+ "value": true
95
+ },
96
+ {
97
+ "field": "recipe.domain",
98
+ "operator": "equals",
99
+ "value": "environment_shot"
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "interior-scene",
106
+ "type": "upstream_reference",
107
+ "label": "Missing clip list / scene plan (interior-scene)",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "brief.locked",
112
+ "operator": "equals",
113
+ "value": true
114
+ },
115
+ {
116
+ "field": "recipe.domain",
117
+ "operator": "equals",
118
+ "value": "interior_archviz"
119
+ }
120
+ ]
121
+ }
122
+ },
123
+ {
124
+ "target": "product-grid-scene-planner",
125
+ "type": "upstream_reference",
126
+ "label": "Missing clip list / scene plan (product-grid-scene-planner)",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "brief.locked",
131
+ "operator": "equals",
132
+ "value": true
133
+ },
134
+ {
135
+ "field": "recipe.domain",
136
+ "operator": "equals",
137
+ "value": "product_grid"
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "product-hero-scene-planner",
144
+ "type": "upstream_reference",
145
+ "label": "Missing clip list / scene plan (product-hero-scene-planner)",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "brief.locked",
150
+ "operator": "equals",
151
+ "value": true
152
+ },
153
+ {
154
+ "field": "recipe.domain",
155
+ "operator": "equals",
156
+ "value": "product_hero"
157
+ }
158
+ ]
159
+ }
160
+ },
161
+ {
162
+ "target": "mobile-glb-budget",
163
+ "type": "upstream_reference",
164
+ "label": "Channel, bone, and morph ceilings",
165
+ "when": {
166
+ "all": [
167
+ {
168
+ "field": "artifact.type",
169
+ "operator": "equals",
170
+ "value": "glb"
171
+ },
172
+ {
173
+ "field": "budget.pinned",
174
+ "operator": "equals",
175
+ "value": false
176
+ }
177
+ ]
178
+ }
179
+ },
180
+ {
181
+ "target": "render-export-evidence",
182
+ "type": "upstream_reference",
183
+ "label": "Export verification",
184
+ "when": {
185
+ "all": [
186
+ {
187
+ "field": "stage.current",
188
+ "operator": "equals",
189
+ "value": "post_execution_audit"
190
+ }
191
+ ]
192
+ }
193
+ },
194
+ {
195
+ "target": "glb-web-handoff",
196
+ "type": "progression",
197
+ "label": "Web delivery handoff",
198
+ "when": {
199
+ "all": [
200
+ {
201
+ "field": "artifact.type",
202
+ "operator": "equals",
203
+ "value": "glb"
204
+ },
205
+ {
206
+ "field": "handoff.consumerStack",
207
+ "operator": "equals",
208
+ "value": "web_glb"
209
+ }
210
+ ]
211
+ }
212
+ },
213
+ {
214
+ "target": "r3f-component-plan",
215
+ "type": "progression",
216
+ "label": "React Three Fiber component shape",
217
+ "when": {
218
+ "all": [
219
+ {
220
+ "field": "artifact.type",
221
+ "operator": "equals",
222
+ "value": "glb"
223
+ },
224
+ {
225
+ "field": "handoff.consumerStack",
226
+ "operator": "equals",
227
+ "value": "react_three_fiber"
228
+ }
229
+ ]
230
+ }
231
+ },
232
+ {
233
+ "target": "plain-language-response",
234
+ "type": "progression",
235
+ "label": "Final user-facing wording",
236
+ "when": {
237
+ "all": [
238
+ {
239
+ "field": "stage.current",
240
+ "operator": "equals",
241
+ "value": "final_communication"
242
+ }
243
+ ]
244
+ }
245
+ }
246
+ ]
247
+ }
@@ -0,0 +1,36 @@
1
+ # Animation Types in GLB
2
+
3
+ ## Skeletal (skin + armature)
4
+ - Drives bone transforms; mesh follows via skinning weights.
5
+ - glTF stores: armature node hierarchy + inverse-bind matrices + skin reference + animation samplers per bone.
6
+ - Web playback: `mixer.clipAction(clip)` plays the entire bone hierarchy.
7
+ - Constraint: per-mesh bone count ceiling varies by web stack. Three.js has no fixed cap but high bone counts hurt mobile performance.
8
+
9
+ ## Morph targets (shape keys)
10
+ - Drives vertex deltas; no skeleton.
11
+ - glTF stores: morph target arrays per primitive + animation samplers on weights.
12
+ - Web playback: `mesh.morphTargetInfluences[i]` controlled by mixer or manually.
13
+ - Constraint: morph targets balloon GLB file size; budget tightly on mobile.
14
+
15
+ ## Both (skeletal + morph)
16
+ - Common for face rigs (jaw bone + face shape keys).
17
+ - glTF supports both simultaneously per primitive.
18
+ - Constraint: doubles channel count; needs explicit budget allocation.
19
+
20
+ ## Object-level transform animation
21
+ - Animates root or parent node translate / rotate / scale directly (no skin, no morph).
22
+ - Cheapest option for "spinning logo" or "floating product" cases.
23
+ - Often preferred when no deformation is required.
24
+
25
+ ## Recommendation per use case
26
+
27
+ | Use case | Recommended type |
28
+ |---|---|
29
+ | Idle product hover | Object-level transform animation |
30
+ | Character idle / walk | Skeletal |
31
+ | Face expressions | Skeletal jaw + morph for fine shapes |
32
+ | Product configurator (color swap) | Material variant, **not** animation |
33
+ | Cloth / soft body | Pre-baked vertex animation (rare in glTF; consider video fallback) |
34
+
35
+ ## Related skill
36
+ `../SKILL.md`
@@ -0,0 +1,55 @@
1
+ # Transition + Root Motion Rules
2
+
3
+ ## Transitions between clips
4
+
5
+ **Rule 1 — explicit blend duration**: every documented transition must have a blend duration in milliseconds. Defaults silently differ across stacks.
6
+
7
+ **Rule 2 — preserve last keyframe coherence**: when transition is "blend", the last frame of clip A and the first frame of clip B should be visually close to avoid pop.
8
+
9
+ **Rule 3 — return-to-idle policy**: hover/click activations must define what happens when the trigger ends:
10
+ - snap back to idle
11
+ - crossfade back over N ms
12
+ - play out current clip first, then crossfade
13
+ - (not allowed) leave the model frozen
14
+
15
+ ## Common blend durations
16
+
17
+ | Transition type | Recommended blend | Notes |
18
+ |---|---|---|
19
+ | Idle → idle variant | 300–500 ms | Subtle |
20
+ | Idle → action (hover) | 150–250 ms | Quick response |
21
+ | Action → idle (return) | 300–500 ms | Smoother return |
22
+ | Action → action chain | 100–200 ms | Tight |
23
+ | Scrub-driven (no blend) | 0 ms | Use scrub time directly |
24
+
25
+ ## Root motion treatment
26
+
27
+ Choose **exactly one** treatment per GLB; never mix:
28
+
29
+ ### Option A — Bake root motion into clip
30
+ - Translate keys live on the root node inside the animation.
31
+ - Web side simply plays; the model translates as part of the clip.
32
+ - Pro: simple consumer code.
33
+ - Con: cannot reposition the model dynamically without offsetting.
34
+
35
+ ### Option B — Strip root motion, apply at runtime
36
+ - Animation only deforms relative to root; root stays fixed.
37
+ - Web side moves the parent transform programmatically.
38
+ - Pro: allows interactive positioning.
39
+ - Con: consumer must implement the offset.
40
+
41
+ ## Forbidden mixed cases
42
+
43
+ - Clip A baked + clip B stripped (jarring pops on blend).
44
+ - Skeletal root translation + parent transform translation simultaneously (positions drift).
45
+ - Documenting "neutral" as a treatment (no such thing — pick A or B).
46
+
47
+ ## Recording in handoff contract
48
+
49
+ The contract row must contain one of:
50
+ - `root-motion: baked`
51
+ - `root-motion: stripped (consumer applies parent transform)`
52
+ - `root-motion: none (object-level animation, no skinned movement)`
53
+
54
+ ## Related skill
55
+ `../SKILL.md`
@@ -0,0 +1,40 @@
1
+ # Web stack caveats per consumer
2
+
3
+ These are documentation-only assumptions; the consumer must validate against their stack version.
4
+
5
+ ## Three.js (vanilla)
6
+
7
+ - Use `GLTFLoader` → returns `gltf.animations` clip array.
8
+ - `AnimationMixer` per object instance; do not share mixers across cloned objects.
9
+ - Default `timeScale = 1.0`; verify FPS embedded in clips matches scene FPS.
10
+ - `clipAction.setLoop(LoopRepeat | LoopOnce | LoopPingPong)`.
11
+ - Crossfade via `clipAction.crossFadeTo(otherAction, durationSec, warpTimeScale)`.
12
+
13
+ ## React Three Fiber (R3F)
14
+
15
+ - `useGLTF('/path/to.glb')` returns memoized scene + animations.
16
+ - `useAnimations(clips, scene)` returns `{ actions, mixer, names }`.
17
+ - Call `actions.idle.play()` inside `useEffect` on mount; clean up with `.stop()`.
18
+ - Mixer ticks via R3F frameloop automatically; do not manually call `mixer.update()`.
19
+ - Suspense boundary required around the component due to async GLB load.
20
+
21
+ ## Babylon.js
22
+
23
+ - `SceneLoader.ImportMeshAsync` returns `{ animationGroups }`.
24
+ - Each `AnimationGroup` plays/stops/blends independently.
25
+ - Different animation API surface than Three.js; clips translate but blends are stack-specific.
26
+
27
+ ## google/model-viewer (web component)
28
+
29
+ - `<model-viewer src="x.glb" autoplay animation-name="idle">`.
30
+ - Single active clip at a time; switch via `animation-name` attribute.
31
+ - No crossfade in pure model-viewer; transitions must be authored as a single longer clip with intermediate frames.
32
+
33
+ ## Stack-agnostic caveats
34
+
35
+ - Negative scale on a parent node breaks normals in some loaders; bake transforms before export.
36
+ - Animation that targets a missing node fails silently in some loaders, errors in others.
37
+ - Cubic spline interpolation requires 3x more keyframe data — file-size cost is real.
38
+
39
+ ## Related skill
40
+ `../SKILL.md`
@@ -0,0 +1,33 @@
1
+ # EVAL — glb-web-handoff
2
+
3
+ ## Text-only eval prompt
4
+ Use glb-web-handoff to produce a handoff report with explicit artifact status and caveats.
5
+
6
+ ## Expected behavior
7
+ - GLB/preview status
8
+ - assumptions and limitations
9
+ - next verification actions
10
+
11
+ ## Pass / Warn / Fail criteria
12
+ - Pass: no artifact overclaims + clear caveats
13
+ - Warn: partial caveats or assumptions
14
+ - Fail: web readiness claim without evidence
15
+
16
+ ## Common failure modes
17
+ - claiming export succeeded without proof
18
+ - no compatibility caveats
19
+
20
+ ## Evidence expectations
21
+ - artifact status per item
22
+ - assumption/caveat section
23
+ - next checks section
24
+
25
+ ## Sample passing response outline
26
+ - Scope and mode stated clearly
27
+ - Evidence expectations listed
28
+ - Pass/warn/fail reasoning tied to checks
29
+
30
+ ## Sample failing response outline
31
+ - Overclaims runtime/artifact success
32
+ - Missing caveats or blocker details
33
+ - No clear next action