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,30 @@
1
+ # Mobile-web GLB Budget Tiers
2
+
3
+ These are **planning ceilings**, not benchmarks. Always pair with measurement (`render-export-evidence` + `scene-readiness`) before claiming compliance.
4
+
5
+ ## Tier table
6
+
7
+ | Tier | Triangles | GLB file (Draco) | Textures | Draw calls | Bones | Morph targets |
8
+ |---|---|---|---|---|---|---|
9
+ | Low-end Android (Snapdragon 4xx, 2GB RAM) | ≤ 25K | ≤ 2 MB | 2 × 512 px | ≤ 10 | ≤ 25 | 0 |
10
+ | Mid-mobile (mass-market 2024+) | ≤ 50K | ≤ 4 MB | 4 × 1024 px | ≤ 20 | ≤ 50 | ≤ 4 |
11
+ | High-mobile (flagship phones) | ≤ 100K | ≤ 8 MB | 6 × 2048 px | ≤ 50 | ≤ 100 | ≤ 8 |
12
+ | Desktop fallback | ≤ 250K | ≤ 20 MB | 8 × 2048 px | ≤ 100 | ≤ 200 | ≤ 16 |
13
+
14
+ ## Context modifiers
15
+
16
+ - **AR viewer**: drop one tier (e.g. mid-mobile → low-end values).
17
+ - **Configurator with material variants**: +50% material count, but cap GLB at the tier's base.
18
+ - **Hero card / e-commerce**: tier values as-is.
19
+ - **Environment / scene with multiple objects**: budget the *whole scene*, not per-object.
20
+
21
+ ## Headroom rule
22
+
23
+ Reserve 20% headroom against the hard cap. A "50K triangle" budget plan should aim for 40K and treat 50K as the absolute ceiling.
24
+
25
+ ## Why per-tier numbers matter
26
+
27
+ A 50K-triangle GLB on a low-end Android can stutter; the same GLB on a flagship is trivial. Do not give a single global "mobile" number.
28
+
29
+ ## Related skill
30
+ `../SKILL.md`
@@ -0,0 +1,34 @@
1
+ # Degradation Plan (drop order when over budget)
2
+
3
+ When a measured GLB exceeds budget, drop in this order. Stop as soon as the budget passes.
4
+
5
+ ## Order of degradation
6
+
7
+ 1. **Texture resolution** — halve the largest texture first (2048 → 1024 → 512). Cheapest visual loss for biggest file-size win.
8
+ 2. **Texture count** — combine variant maps (roughness + metallic + AO) into one ORM channel-packed map.
9
+ 3. **Mesh decimation** — apply a 50% decimation to the highest-triangle mesh in the scene.
10
+ 4. **Sub-mesh hidden geometry** — remove faces never visible from the camera path.
11
+ 5. **Morph target count** — drop secondary expressions / minor variants.
12
+ 6. **Bone count** — bake unused bones into the mesh; clamp influences per vertex to 4.
13
+ 7. **Material variants** — collapse near-duplicate materials into one.
14
+ 8. **Animation channels** — bake long animations into shorter clips.
15
+
16
+ ## Always-keep rule
17
+
18
+ Do not degrade if the result breaks the user's visual intent stated in the brief. If steps 1–4 cannot meet the budget, escalate to the user with options instead of silently degrading further.
19
+
20
+ ## Record the degradation
21
+
22
+ Every degradation step taken must appear in the handoff report:
23
+ - step number
24
+ - before/after metric values
25
+ - visual impact note ("texture detail lost on close-up", "silhouette unchanged after step 3", etc.)
26
+
27
+ ## Do not
28
+
29
+ - silently drop required materials
30
+ - silently drop animations the user asked for
31
+ - skip recording degradation steps in the handoff report
32
+
33
+ ## Related skill
34
+ `../SKILL.md`
@@ -0,0 +1,43 @@
1
+ # Budget Violation Rules
2
+
3
+ When a measured GLB exceeds the pinned budget, treat the violation as a **handoff blocker** unless the user explicitly accepts the degradation.
4
+
5
+ ## Block-handoff violations
6
+
7
+ | Metric | Block if … |
8
+ |---|---|
9
+ | Triangle count | > 100% of cap |
10
+ | GLB file size | > 100% of cap |
11
+ | Single texture pixel area | > tier max (e.g. >1024² on mid-mobile) |
12
+ | Total texture pixel budget | > 150% of cap |
13
+ | Draw calls | > 100% of cap |
14
+ | Bones | > 100% of cap (skinning cost is non-linear) |
15
+ | Morph targets | > tier max (>0 on low-end Android) |
16
+
17
+ ## Warn-only violations
18
+
19
+ | Metric | Warn if … |
20
+ |---|---|
21
+ | Triangle count | 80–100% of cap |
22
+ | GLB file size | 80–100% of cap |
23
+ | Distinct materials | 80–100% of cap |
24
+ | Animation channels | 80–100% of cap |
25
+
26
+ ## Always-fail violations
27
+
28
+ These bypass any "user accepts" override because they break web playback:
29
+
30
+ - GLB references a missing texture file
31
+ - GLB exceeds 16-bit vertex index range without per-primitive split (some loaders fail)
32
+ - Animation references missing bone or morph target
33
+ - Texture format unsupported by `gltf` (e.g. EXR not converted)
34
+
35
+ ## Reporting
36
+
37
+ Always report violations with:
38
+ - the offending metric, the measured value, the budgeted cap, the tier
39
+ - whether the violation is Block / Warn / Always-fail
40
+ - the suggested degradation step (see `degradation-plan.md`)
41
+
42
+ ## Related skill
43
+ `../SKILL.md`
@@ -0,0 +1,27 @@
1
+ # EVAL — output-format-decision
2
+
3
+ ## Text-only eval prompt
4
+ Apply output-format-decision for a web hero output (PNG/WebP, sRGB, 1920×1080, alpha optional).
5
+
6
+ ## Expected behavior
7
+ - format chosen (PNG or WebP)
8
+ - 8-bit
9
+ - sRGB color space
10
+ - compression rule
11
+ - alpha rule
12
+ - caveats
13
+ - handoff to render-export-evidence
14
+
15
+ ## Pass / Warn / Fail criteria
16
+ - Pass: 4-line format record + caveats + handoff
17
+ - Warn: ambiguous compression
18
+ - Fail: wrong format (EXR for web), missing bit depth, "any format" answer
19
+
20
+ ## Sample passing response outline
21
+ - Consumer + color config header
22
+ - Output stream(s) with all 5 fields
23
+ - Caveats
24
+
25
+ ## Sample failing response outline
26
+ - "Save as PNG"
27
+ - No bit depth or color space
@@ -0,0 +1,222 @@
1
+ ---
2
+ name: output-format-decision
3
+ description: Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.
4
+ ---
5
+
6
+ # output-format-decision
7
+
8
+ ## Purpose
9
+ Avoid mismatched output formats (e.g., JPEG for VFX, EXR for web, TIFF for social). Match format to consumer pipeline.
10
+
11
+ ## Quick start
12
+ - name the consumer
13
+ - pick one format per output stream
14
+ - pin bit depth + compression + alpha rules
15
+ - emit a 4-line config
16
+
17
+ ## When to use
18
+ - before render
19
+ - when consumer requires specific format
20
+ - when transparency / HDR / loss tolerance matters
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - raw modeling without rendering → use `../cycles-vs-eevee-decision/SKILL.md` (Delegates out-of-scope requests to cycles-vs-eevee-decision)
25
+ - 3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff) → use `../glb-animation-handoff/SKILL.md` (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)
26
+ - verifying saved files on disk after rendering → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
27
+ <!-- blendops:generated:end exclusions -->
28
+
29
+ ## Trigger phrases
30
+ <!-- blendops:generated:start triggers -->
31
+ - "PNG or JPEG"
32
+ - "do we need EXR"
33
+ - "what format for the web"
34
+ <!-- blendops:generated:end triggers -->
35
+
36
+ ## Prerequisites / readiness
37
+ - consumer pipeline known
38
+ - color management decision made (`color-management-decision`)
39
+
40
+ ## Input schema
41
+
42
+ ### Required inputs
43
+
44
+ | Input | Why it is required |
45
+ |---|---|
46
+ | Consumer | Drives format choice per output stream |
47
+ | Color management config | Consumed from `color-management-decision` to align bit depth and container support |
48
+ | Transparency required? | Drives alpha channel and container choice (e.g., PNG/WebP/OpenEXR vs JPG) |
49
+
50
+ ### Optional inputs
51
+
52
+ | Input | Use |
53
+ |---|---|
54
+ | File-size budget | Guides lossless vs lossy compression decision |
55
+
56
+ ### Assumptions to confirm
57
+ - The consumer pipeline can read the chosen container/codec (verify if non-default).
58
+ - Lossy compression is acceptable when chosen.
59
+
60
+ ## Output schema
61
+
62
+ ### Primary output
63
+ A 4-line format record per output stream: format, bit depth, compression, alpha.
64
+
65
+ ### Secondary output
66
+ - per-output stream rules
67
+ - caveats per choice
68
+ - evidence label
69
+
70
+ ### Evidence / caveat output
71
+
72
+ ```txt
73
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
74
+ Artifact status: Not Produced | Produced | Verified | Failed
75
+ Evidence used: <links, paths, logs, or "none">
76
+ Limitations: <known gaps>
77
+ ```
78
+
79
+ * Default states for this decision skill: `Runtime status: Not Run`, `Artifact status: Not Produced`.
80
+ * Truth states are downgrade-only, never upgrade. Pinning a format never produces a file.
81
+
82
+ ## Required laws
83
+ - `../../laws/evidence-before-done.md`
84
+ - `../../laws/non-blender-user-language.md`
85
+ - `../../laws/no-arbitrary-python-interface.md`
86
+ - `../../laws/official-runtime-only.md`
87
+
88
+ ## Official runtime boundary
89
+
90
+ Decision skill — does not run Blender. Pins format; operator applies to scene render output.
91
+
92
+ ## Operating procedure
93
+ 1. Identify consumer pipeline + consume color config from `color-management-decision`.
94
+ 2. Select format per `references/format-decision-matrix.md`.
95
+ 3. Pin bit depth + compression + alpha per output stream.
96
+ 4. List stream rules and caveats.
97
+ 5. Hand off format record to operator (and to `resolution-aspect-decision` if resolution is unpinned, or `render-export-evidence` once rendered).
98
+
99
+ ## Decision tree
100
+
101
+ ```txt
102
+ Web hero (consuming sRGB config)?
103
+ → PNG (lossless) or WebP (lossy/lossless); 8-bit; alpha if needed
104
+ JPEG-only consumer?
105
+ → JPG; 8-bit; no alpha; lossy quality 85-95
106
+ VFX / film pipeline (consuming Linear config)?
107
+ → OpenEXR; 16-bit half float; ZIP compression; alpha as channel
108
+ Print?
109
+ → TIFF; 16-bit; LZW or no compression; alpha optional per print prep
110
+ Social / mobile (WebP-first)?
111
+ → WebP; 8-bit; alpha optional; lossy quality 85-90
112
+ HDR display delivery?
113
+ → PNG 16-bit or OpenEXR; verify consumer supports HDR container
114
+ ```
115
+
116
+ ## Playbooks
117
+
118
+ ### Playbook A: Web hero PNG
119
+ PNG, 8-bit per channel, lossless compression, alpha if needed (consumes color config from `color-management-decision`).
120
+
121
+ ### Playbook B: VFX EXR
122
+ OpenEXR, 16-bit half float, ZIP compression, alpha as channel. Multi-pass support (consumes Linear config from `color-management-decision`).
123
+
124
+ ### Playbook C: Mobile-first social
125
+ WebP, 8-bit, quality 85-90 compression, alpha optional (consumes color config from `color-management-decision`).
126
+
127
+ ### Playbook D: Print
128
+ TIFF, 16-bit, LZW or no compression, alpha optional (consumes color config from `color-management-decision`; resolution owned by `resolution-aspect-decision`).
129
+
130
+ ## Mode handling
131
+
132
+ ### Text-only mode
133
+ Emit format record + per-stream rules + caveats (`Runtime status: Not Run`, `Artifact status: Not Produced`).
134
+
135
+ ### Runtime-ready mode
136
+ Emit format record for the operator to apply in Blender render output settings. Pinning a format never produces or verifies a file; hand off post-render file verification to `render-export-evidence`.
137
+
138
+ ### Blocked runtime mode
139
+ Emit format record only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
140
+
141
+ ## Validation checklist
142
+ - [ ] Consumer + color config identified
143
+ - [ ] Format chosen
144
+ - [ ] Bit depth chosen
145
+ - [ ] Compression chosen
146
+ - [ ] Alpha rule explicit
147
+ - [ ] Caveats listed
148
+
149
+ ## Pass / Warn / Fail rubric
150
+
151
+ | Verdict | Criteria |
152
+ |---|---|
153
+ | Pass | Format + bit depth + compression + alpha pinned; matches consumer; caveats listed. |
154
+ | Warn | Format pinned but compression / alpha ambiguous. |
155
+ | Fail | Wrong format for consumer (JPEG for VFX, EXR for web), missing bit depth, "any format" answer. |
156
+
157
+ ## Failure handling
158
+ - Consumer unknown → ask once; if still unknown, default to PNG, 8-bit, lossless compression, alpha enabled (paired with upstream `color-management-decision`).
159
+ - Multiple consumers → define one format record per output stream (or pin the most restrictive format if single-stream delivery is required).
160
+
161
+ ## Troubleshooting
162
+
163
+ | Problem | Response |
164
+ |---|---|
165
+ | File too large | Reduce bit depth, increase compression, or switch stream to WebP / JPG |
166
+ | HDR data lost | Switch container/bit depth to OpenEXR (16-bit half float) or PNG 16-bit |
167
+ | Alpha disappeared | Verify chosen format supports alpha (PNG / WebP / OpenEXR / TIFF yes; JPG no) |
168
+ | Color shift in delivered file | Hand off to `color-management-decision` to verify color config and consumer display transform |
169
+
170
+ ## Best practices
171
+ - Define one format record per consumer output stream; never convert or re-encode files post-render.
172
+ - For web: use WebP or PNG based on consumer support and alpha/compression requirements.
173
+ - For VFX: always pin OpenEXR; never pin JPG or 8-bit PNG for compositing pipelines.
174
+ - Pass the pinned format record to `render-export-evidence` for post-render verification.
175
+
176
+ ## Good examples
177
+ - "Web hero stream: PNG, 8-bit, lossless compression, alpha enabled (using upstream color config from `color-management-decision`)."
178
+
179
+ ## Bad examples
180
+ - "Save as PNG." — missing bit depth, compression, and alpha rules.
181
+
182
+ ## User-facing response template
183
+
184
+ ```txt
185
+ Consumer: <web / VFX / print / social / mobile>
186
+ Color config: <reference color-management-decision output>
187
+
188
+ Output(s):
189
+ <stream>: <format>, <bit depth>, <compression>, <alpha>
190
+
191
+ Caveats: <list>
192
+ Limitations: <gaps>
193
+ Next: render-export-evidence
194
+ ```
195
+
196
+ ## Anti-patterns
197
+ - "Any format will work."
198
+ - JPEG for VFX.
199
+ - 8-bit for HDR delivery.
200
+ - Lossy compression where archival is required.
201
+
202
+ ## Cross-skill handoff
203
+ <!-- blendops:generated:start handoffs -->
204
+ - [upstream_reference] Color management → `../color-management-decision/SKILL.md`
205
+ - [upstream_reference] Resolution & aspect ratio → `../resolution-aspect-decision/SKILL.md`
206
+ - [upstream_reference] Engine choice → `../cycles-vs-eevee-decision/SKILL.md`
207
+ - [progression] Render file verification → `../render-export-evidence/SKILL.md`
208
+ - [progression] 3D / GLB exports (out of scope here) (glb-animation-handoff) → `../glb-animation-handoff/SKILL.md`
209
+ - [boundary_delegation] 3D / GLB exports (out of scope here) (mobile-glb-budget) → `../mobile-glb-budget/SKILL.md`
210
+ - [progression] 3D / GLB exports (out of scope here) (glb-web-handoff) → `../glb-web-handoff/SKILL.md`
211
+ <!-- blendops:generated:end handoffs -->
212
+
213
+ ## Non-goals
214
+ - Convert formats post-render.
215
+ - Run Blender.
216
+ - Compress / re-encode files.
217
+
218
+ ## References
219
+ - `references/format-decision-matrix.md`
220
+ - `references/bit-depth-rules.md`
221
+ - `references/compression-tradeoffs.md`
222
+ - `../../docs/skill-system.md`
@@ -0,0 +1,179 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "output-format-decision",
4
+ "version": "1.0.0",
5
+ "category": "render-and-output-decisions",
6
+ "role": "still-animation-and-3d-format-selector",
7
+ "purpose": "Pick the right output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency, and consumer support.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "PNG or JPEG",
11
+ "do we need EXR",
12
+ "what format for the web"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "raw modeling without rendering",
17
+ "delegateTo": "cycles-vs-eevee-decision",
18
+ "reason": "Delegates out-of-scope requests to cycles-vs-eevee-decision"
19
+ },
20
+ {
21
+ "condition": "3D/GLB exports (out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff)",
22
+ "delegateTo": "glb-animation-handoff",
23
+ "reason": "out of scope — use glb-web-handoff, mobile-glb-budget, or glb-animation-handoff"
24
+ },
25
+ {
26
+ "condition": "verifying saved files on disk after rendering",
27
+ "delegateTo": "render-export-evidence",
28
+ "reason": "use render-export-evidence"
29
+ }
30
+ ],
31
+ "inputs": {
32
+ "required": [
33
+ {
34
+ "name": "deliverable_channel_and_use",
35
+ "type": "string",
36
+ "description": "Downstream consumer surface (web hero image, compositing EXR pipeline, turntable video, interactive WebGL)"
37
+ },
38
+ {
39
+ "name": "alpha_and_bit_depth_needs",
40
+ "type": "object",
41
+ "description": "Transparency (straight vs premultiplied alpha) and dynamic range (8-bit, 16-bit, 32-bit float) requirements"
42
+ }
43
+ ],
44
+ "optional": [
45
+ {
46
+ "name": "file_size_ceiling",
47
+ "type": "string",
48
+ "description": "Optional delivery file size cap from mobile-glb-budget or web spec"
49
+ }
50
+ ]
51
+ },
52
+ "outputs": {
53
+ "primary": [
54
+ "pinned_container_and_codec_spec",
55
+ "bit_depth_and_alpha_mode_record",
56
+ "color_space_and_export_verification_hooks"
57
+ ],
58
+ "truthStatePolicy": {
59
+ "runtimeDefault": "Not Run",
60
+ "artifactDefault": "Not Produced",
61
+ "mutationRule": "downgrade_only"
62
+ }
63
+ },
64
+ "handoffs": [
65
+ {
66
+ "target": "color-management-decision",
67
+ "type": "upstream_reference",
68
+ "label": "Color management",
69
+ "when": {
70
+ "all": [
71
+ {
72
+ "field": "decision.colorLocked",
73
+ "operator": "equals",
74
+ "value": false
75
+ }
76
+ ]
77
+ }
78
+ },
79
+ {
80
+ "target": "resolution-aspect-decision",
81
+ "type": "upstream_reference",
82
+ "label": "Resolution & aspect ratio",
83
+ "when": {
84
+ "all": [
85
+ {
86
+ "field": "decision.aspectLocked",
87
+ "operator": "equals",
88
+ "value": false
89
+ }
90
+ ]
91
+ }
92
+ },
93
+ {
94
+ "target": "cycles-vs-eevee-decision",
95
+ "type": "upstream_reference",
96
+ "label": "Engine choice",
97
+ "when": {
98
+ "all": [
99
+ {
100
+ "field": "decision.engineLocked",
101
+ "operator": "equals",
102
+ "value": false
103
+ }
104
+ ]
105
+ }
106
+ },
107
+ {
108
+ "target": "render-export-evidence",
109
+ "type": "progression",
110
+ "label": "Render file verification",
111
+ "when": {
112
+ "all": [
113
+ {
114
+ "field": "stage.current",
115
+ "operator": "equals",
116
+ "value": "post_execution_audit"
117
+ }
118
+ ]
119
+ }
120
+ },
121
+ {
122
+ "target": "glb-animation-handoff",
123
+ "type": "progression",
124
+ "label": "3D / GLB exports (out of scope here) (glb-animation-handoff)",
125
+ "when": {
126
+ "all": [
127
+ {
128
+ "field": "artifact.hasAnimation",
129
+ "operator": "equals",
130
+ "value": true
131
+ },
132
+ {
133
+ "field": "stage.current",
134
+ "operator": "equals",
135
+ "value": "animation_handoff"
136
+ }
137
+ ]
138
+ }
139
+ },
140
+ {
141
+ "target": "mobile-glb-budget",
142
+ "type": "boundary_delegation",
143
+ "label": "3D / GLB exports (out of scope here) (mobile-glb-budget)",
144
+ "when": {
145
+ "all": [
146
+ {
147
+ "field": "artifact.type",
148
+ "operator": "equals",
149
+ "value": "glb"
150
+ },
151
+ {
152
+ "field": "budget.pinned",
153
+ "operator": "equals",
154
+ "value": false
155
+ }
156
+ ]
157
+ }
158
+ },
159
+ {
160
+ "target": "glb-web-handoff",
161
+ "type": "progression",
162
+ "label": "3D / GLB exports (out of scope here) (glb-web-handoff)",
163
+ "when": {
164
+ "all": [
165
+ {
166
+ "field": "artifact.type",
167
+ "operator": "equals",
168
+ "value": "glb"
169
+ },
170
+ {
171
+ "field": "handoff.consumerStack",
172
+ "operator": "equals",
173
+ "value": "web_glb"
174
+ }
175
+ ]
176
+ }
177
+ }
178
+ ]
179
+ }
@@ -0,0 +1,56 @@
1
+ # Bit-depth rules
2
+
3
+ ## 8-bit (256 levels per channel)
4
+
5
+ - Default for web / mobile / standard delivery.
6
+ - Banding visible only in slow gradients (sky, smooth lighting).
7
+ - File size smallest.
8
+
9
+ ## 10-bit (1024 levels per channel)
10
+
11
+ - HDR display delivery (HDR10, Dolby Vision).
12
+ - Smoother gradients.
13
+ - File size larger; consumer support not universal.
14
+
15
+ ## 12-bit (4096 levels)
16
+
17
+ - Cinema / film mastering.
18
+ - Used in some intermediate codecs.
19
+ - Rarely needed for web / mobile.
20
+
21
+ ## 16-bit (65536 levels)
22
+
23
+ - VFX / film working format.
24
+ - Print archival.
25
+ - Smooth gradients without banding.
26
+ - File size 2x of 8-bit; pipeline must support.
27
+
28
+ ## 16-bit half float (OpenEXR)
29
+
30
+ - HDR data preserved (values > 1.0).
31
+ - Standard for VFX / film.
32
+ - Consumer must support EXR loader.
33
+
34
+ ## 32-bit float (OpenEXR)
35
+
36
+ - Highest precision.
37
+ - Used for technical passes (depth, normal, motion vector).
38
+ - Massive file sizes; only when bit-depth is critical.
39
+
40
+ ## When to upgrade bit depth
41
+
42
+ | Symptom | Solution |
43
+ |---|---|
44
+ | Banding in gradient | 8-bit → 10-bit or 16-bit |
45
+ | HDR clipped to white | 8-bit → EXR 16-bit half |
46
+ | Color shift after compositing | 8-bit → 16-bit working format |
47
+ | File-size acceptable | Stay at 8-bit |
48
+
49
+ ## When to NOT upgrade
50
+
51
+ - Web hero where 8-bit is fine; bit depth bloats file with no perceived gain.
52
+ - Mobile where bandwidth matters.
53
+ - Archival of already-finished work; archive at delivery bit depth.
54
+
55
+ ## Related skill
56
+ `../SKILL.md`
@@ -0,0 +1,62 @@
1
+ # Compression tradeoffs
2
+
3
+ ## Lossless
4
+
5
+ - PNG (DEFLATE)
6
+ - TIFF LZW
7
+ - WebP lossless
8
+ - OpenEXR ZIP / PIZ
9
+ - TGA RLE
10
+
11
+ Pro: pixel-exact recovery.
12
+ Con: file size ~30-70% of uncompressed.
13
+
14
+ When: hero deliverables, archival, intermediate passes.
15
+
16
+ ## Lossy
17
+
18
+ - JPEG (DCT)
19
+ - WebP lossy
20
+ - AVIF
21
+ - HEIC
22
+
23
+ Pro: file size ~5-20% of uncompressed.
24
+ Con: pixel-exact recovery impossible; artifacts at low quality.
25
+
26
+ When: web mobile, social, sharing, draft previews.
27
+
28
+ ## Per-format quality
29
+
30
+ | Format | Quality range | Practical sweet spot |
31
+ |---|---|---|
32
+ | JPG | 1-100 | 85-95 |
33
+ | WebP lossy | 1-100 | 85-90 |
34
+ | AVIF | 1-100 | 50-70 (more efficient than JPG) |
35
+ | HEIC | 1-100 | 70-85 |
36
+
37
+ Below 80 → visible artifacts on smooth gradients.
38
+
39
+ ## Lossless tier comparison
40
+
41
+ | Format | Compression efficiency |
42
+ |---|---|
43
+ | PNG | Moderate |
44
+ | TIFF LZW | Moderate |
45
+ | WebP lossless | High (smaller than PNG for same content) |
46
+ | EXR PIZ | High for HDR float data |
47
+
48
+ ## Choosing
49
+
50
+ - Hero / archival → lossless.
51
+ - Web hero where size matters → WebP lossless > PNG.
52
+ - Social / mobile → lossy WebP/JPG at quality 85-90.
53
+ - VFX → EXR ZIP/PIZ (still lossless, designed for float data).
54
+
55
+ ## Anti-patterns
56
+
57
+ - JPEG for hero brand visual (artifacts on smooth gradients).
58
+ - Quality 50 lossy for portraits (compression rings around edges).
59
+ - Lossless for social-feed thumbnails (wasted bandwidth).
60
+
61
+ ## Related skill
62
+ `../SKILL.md`
@@ -0,0 +1,34 @@
1
+ # Format decision matrix
2
+
3
+ | Consumer | Format | Bit depth | Color space | Compression | Alpha |
4
+ |---|---|---|---|---|---|
5
+ | Web hero | PNG | 8-bit | sRGB | Lossless | Optional |
6
+ | Web hero (modern browser) | WebP | 8-bit | sRGB | Quality 85-95 | Optional |
7
+ | JPEG-only | JPG | 8-bit | sRGB | Quality 85-95 | No |
8
+ | VFX / Film | OpenEXR | 16-bit half | Linear | ZIP | Channel |
9
+ | Print | TIFF | 16-bit | sRGB / soft-proof CMYK | LZW / None | Optional |
10
+ | Social / mobile | WebP / JPG | 8-bit | sRGB | Quality 85-90 | Optional |
11
+ | HDR display | PNG 16 / EXR | 16-bit | sRGB / Linear | Lossless | Optional |
12
+ | Game engine albedo | PNG / WebP | 8-bit | sRGB | Lossless / Quality 90+ | Optional |
13
+ | Game engine data (roughness, etc.) | PNG / WebP | 8-bit | Linear | Lossless | No |
14
+ | Animation video | MP4 / WebM | 8-bit | sRGB | H.264 / VP9 / AV1 | No |
15
+
16
+ ## Why each row
17
+
18
+ - **Web hero**: PNG default; WebP for smaller files; no JPG for hero (artifacting).
19
+ - **VFX / Film**: EXR mandatory; lossy formats lose HDR data and downstream grade headroom.
20
+ - **Print**: TIFF preserves bit depth for print prep tools.
21
+ - **Social / mobile**: WebP wins on size; JPG fallback.
22
+ - **HDR display**: PNG 16 or EXR; verify consumer supports HDR.
23
+ - **Game engine**: PNG / WebP per channel role; verify engine-specific texture import settings.
24
+ - **Animation video**: MP4 H.264 default; WebM VP9 / AV1 for modern browsers.
25
+
26
+ ## Anti-patterns
27
+
28
+ - JPEG for VFX (loses HDR + introduces compression artifacts).
29
+ - EXR for web (overkill, large file, browser support inconsistent).
30
+ - 8-bit for HDR delivery (banding visible).
31
+ - Lossy compression on archival masters.
32
+
33
+ ## Related skill
34
+ `../SKILL.md`