blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,249 @@
1
+ ---
2
+ name: cycles-vs-eevee-decision
3
+ description: Pick Cycles, Eevee, or Workbench for a render based on quality bar, time budget, and feature requirements (caustics, subsurface, etc.). Note: Eevee was named Eevee Next on Blender 4.2-4.x only.
4
+ ---
5
+
6
+ # cycles-vs-eevee-decision
7
+
8
+ ## Purpose
9
+ Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
10
+
11
+ ## Quick start
12
+ - Name the use case (hero / preview / animation / lookdev / flat clay).
13
+ - Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
14
+ - Evaluate time budget per frame and available hardware.
15
+ - Pick the engine: `Cycles`, `Eevee`, or `Workbench` (note: Eevee used the name Eevee Next and token `BLENDER_EEVEE_NEXT` on Blender 4.2–4.x only; it is `Eevee` with token `BLENDER_EEVEE` on 4.0–4.1 and 5.x).
16
+ - Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
17
+
18
+ ## When to use
19
+ - before render
20
+ - when feature support drives engine choice
21
+ - when time vs quality tradeoff matters
22
+ - when previous render was wrong engine
23
+
24
+ ## When not to use
25
+ <!-- blendops:generated:start exclusions -->
26
+ - for a known repeat render (engine already chosen) → use `../lighting-material-plan/SKILL.md` (engine already chosen)
27
+ - for non-render work (modeling / animation prep) → use `../output-format-decision/SKILL.md` (modeling / animation prep)
28
+ <!-- blendops:generated:end exclusions -->
29
+
30
+ ## Trigger phrases
31
+ <!-- blendops:generated:start triggers -->
32
+ - "Cycles or Eevee"
33
+ - "what render engine"
34
+ - "is Eevee enough"
35
+ - "render is too slow"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - use case known
40
+ - features needed known (caustics? SSS? volumetrics?)
41
+ - machine specs known (GPU? memory?)
42
+ - time budget known
43
+
44
+ ## Input schema
45
+
46
+ ### Required inputs
47
+
48
+ | Input | Why it is required |
49
+ |---|---|
50
+ | Use case | Hero vs preview drives quality threshold |
51
+ | Feature requirements | Determines engine compatibility |
52
+ | Time budget per frame | Drives engine + samples |
53
+
54
+ ### Optional inputs
55
+
56
+ | Input | Use |
57
+ |---|---|
58
+ | GPU available | Cycles GPU dramatically faster |
59
+ | Reference quality bar | Calibrate samples |
60
+
61
+ ### Assumptions to confirm
62
+ - The user accepts the tradeoff (Eevee is fast but approximates GI; Cycles is slow but accurate).
63
+ - Multi-engine workflow (Eevee preview, Cycles final) is common and valid.
64
+
65
+ ## Output schema
66
+
67
+ ### Primary output
68
+ A 4-item engine record per use case:
69
+ 1. Engine (`Cycles` / `Eevee` / `Workbench`, plus version token `BLENDER_EEVEE` for 4.0–4.1 and 5.x or `BLENDER_EEVEE_NEXT` for 4.2–4.x if a token is needed)
70
+ 2. Samples (pinned target sample count from consumer/project spec or reference table)
71
+ 3. GPU device (pinned target compute device for the operator to set in scene render properties, or `CPU` fallback)
72
+ 4. Caveats (feature tradeoffs, time budget notes, hardware assumptions)
73
+
74
+ ### Secondary output
75
+ - Per-stream engine record if using a multi-engine workflow (for example, `Eevee` for lookdev preview and `Cycles` for final hero render)
76
+ - Evidence and truth-state block
77
+
78
+ ### Evidence / caveat output
79
+
80
+ ```txt
81
+ Runtime status: Not Run
82
+ Artifact status: Not Produced
83
+ Evidence used: <project spec, hardware spec, or "none">
84
+ Limitations: <unconfirmed hardware/time budget, denoiser/render optimization deferred>
85
+ ```
86
+
87
+ > **Truth-state rule:** Pinning an engine is a planning decision and never produces a render. Default to `Runtime status: Not Run` and `Artifact status: Not Produced`. Truth states are downgrade-only and must never be upgraded by this skill.
88
+
89
+ ## Required laws
90
+ - `../../laws/evidence-before-done.md`
91
+ - `../../laws/non-blender-user-language.md`
92
+ - `../../laws/no-arbitrary-python-interface.md`
93
+ - `../../laws/official-runtime-only.md`
94
+
95
+ ## Official runtime boundary
96
+
97
+ Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
98
+
99
+ ## Operating procedure
100
+
101
+ 1. Identify the use case, required shading/lighting features, and per-frame time budget.
102
+ 2. Consult `references/engine-feature-matrix.md` to match feature requirements to `Cycles`, `Eevee`, or `Workbench`.
103
+ 3. If specifying an internal Blender engine token for `Eevee`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` on Blender 4.2–4.x only. Never present `Eevee Next` as the current name.
104
+ 4. Pin target samples per `references/samples-by-quality.md` and GPU/CPU compute device per `references/gpu-device-rules.md` (without configuring denoisers, tile sizes, or engine-specific optimizations).
105
+ 5. List caveats and set truth states to `Runtime status: Not Run` and `Artifact status: Not Produced`.
106
+ 6. Hand off sibling decisions (`color-management-decision`, `output-format-decision`, `resolution-aspect-decision`) and post-render verification (`render-export-evidence`).
107
+
108
+ ## Decision tree
109
+
110
+ ```txt
111
+ Need path-traced caustics, complex refraction, or physically accurate volumetric/indirect light?
112
+ → Cycles
113
+ Final hero quality where time budget and GPU/CPU hardware allow path tracing?
114
+ → Cycles
115
+ Real-time viewport preview, fast iteration, or lookdev?
116
+ → Eevee (token: BLENDER_EEVEE on 4.0-4.1 & 5.x; BLENDER_EEVEE_NEXT on 4.2-4.x)
117
+ High-frame-count animation with a tight per-frame time budget where approximated GI is acceptable?
118
+ → Eevee (or Cycles only if confirmed hardware + time budget accommodate path tracing)
119
+ Stylized / non-photorealistic raster look?
120
+ → Eevee or Workbench
121
+ Pure flat silhouette, matcap, or clay check?
122
+ → Workbench
123
+ ```
124
+
125
+ ## Playbooks
126
+
127
+ ### Playbook A: Hero path-traced render
128
+
129
+ Pick `Cycles`, pin sample count from `references/samples-by-quality.md` and target GPU device from `references/gpu-device-rules.md`, and note time-budget caveats. Leave denoiser and advanced render-setting tuning out of scope.
130
+
131
+ ### Playbook B: Fast preview / lookdev pass
132
+
133
+ Pick `Eevee` (`BLENDER_EEVEE` on 4.0–4.1 and 5.x; `BLENDER_EEVEE_NEXT` on 4.2–4.x), pin preview sample count and GPU execution, and note global illumination approximation caveats.
134
+
135
+ ### Playbook C: Tight-budget multi-frame animation
136
+
137
+ Pick `Eevee` when per-frame time budget rules out path tracing and feature requirements do not mandate `Cycles`; document any refraction or indirect-lighting tradeoffs in Caveats.
138
+
139
+ ### Playbook D: Stylized or clay pass
140
+
141
+ Pick `Eevee` or `Workbench` based on whether shader evaluation (`Eevee`) or flat/matcap inspection (`Workbench`) is required; pin sample count and hardware target.
142
+
143
+ ## Mode handling
144
+
145
+ ### Text-only mode
146
+
147
+ Return the engine record (engine + samples + GPU device + caveats) with `Runtime status: Not Run` and `Artifact status: Not Produced`.
148
+
149
+ ### Runtime-ready mode
150
+
151
+ Return the exact same engine record with `Runtime status: Not Run` and `Artifact status: Not Produced` for the operator to apply in scene render properties. Never claim a render preview was run or verified; actual rendered file verification belongs to `render-export-evidence`.
152
+
153
+ ### Blocked runtime mode
154
+
155
+ Return the engine record, caveats, and truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
156
+
157
+ ## Validation checklist
158
+
159
+ * [ ] Use case, feature needs, and time budget evaluated
160
+ * [ ] Engine chosen (`Cycles`, `Eevee`, or `Workbench`—never presenting `Eevee Next` as the current name)
161
+ * [ ] Correct engine token used if version-specific token is referenced (`BLENDER_EEVEE` on 4.0–4.1/5.x; `BLENDER_EEVEE_NEXT` on 4.2–4.x)
162
+ * [ ] Samples and GPU/CPU device pinned without bundling denoiser or tile optimizations
163
+ * [ ] Caveats and downgrade-only truth states (`Not Run` / `Not Produced`) included
164
+
165
+ ## Pass / Warn / Fail rubric
166
+
167
+ | Verdict | Criteria |
168
+ |---|---|
169
+ | Pass | Engine matches features + quality + time; samples appropriate; caveats explicit. |
170
+ | Warn | Borderline call (Eevee for hero with weak GI rendering); time budget tight. |
171
+ | Fail | Engine does not support required feature (Eevee for caustics); samples severely under-budget; "use Cycles" for animation that needs Eevee. |
172
+
173
+ ## Failure handling
174
+ - Required feature unsupported → switch to engine that supports it; reject the impossible config.
175
+ - Time budget impossible at chosen samples → either lower samples (Warn) or change engine.
176
+ - GPU not available → Cycles falls back to CPU (much slower); recommend Eevee for previews.
177
+
178
+ ## Troubleshooting
179
+
180
+ | Problem | Response |
181
+ | --- | --- |
182
+ | `Cycles` exceeds per-frame time budget | Confirm GPU device is pinned over CPU, lower pinned sample target within quality tolerance, or switch non-final passes to `Eevee`. |
183
+ | `Eevee` lacks required caustics or accurate refraction | Switch those shots to `Cycles` and document the per-frame time impact in Caveats. |
184
+ | Indirect bounce lighting in `Eevee` misses hero realism bar | Switch the final pass to `Cycles` while keeping `Eevee` for lookdev iteration. |
185
+ | Volumetric lighting lacks path-traced accuracy in `Eevee` | Pin `Cycles` for shots requiring physically accurate volumetric light transport. |
186
+
187
+ ## Best practices
188
+
189
+ * Use `Eevee` for fast lookdev/iteration and `Cycles` for final path-traced hero delivery when both speed and physical accuracy matter.
190
+ * Always use current `Eevee` naming, noting `Eevee Next` (`BLENDER_EEVEE_NEXT`) only when targeting Blender 4.2–4.x.
191
+ * Keep this decision strictly to `engine + samples + GPU device + caveats`—leave denoiser specifics, tile sizes, color management, output format, and resolution to their dedicated skills or operator tuning.
192
+ * Pass the pinned engine record downstream so `render-export-evidence` can record it alongside verified output artifacts after rendering.
193
+
194
+ ## Good examples
195
+
196
+ * "Use case: Hero product render requiring accurate glass refraction. Engine: `Cycles`. Samples: pinned per project quality tier. GPU device: pinned to available hardware GPU. Caveats: higher per-frame render time than `Eevee`; denoiser specifics out of scope. `Runtime status: Not Run`, `Artifact status: Not Produced`."
197
+
198
+ ## Bad examples
199
+ - "Just use Cycles." — no context.
200
+
201
+ ## User-facing response template
202
+
203
+ ```txt
204
+ Use case: <hero / preview / animation / lookdev / stylized>
205
+ Feature requirements: <caustics, SSS, volumetrics, GI, etc.>
206
+ Time budget per frame: <target time budget>
207
+ Blender version (if token needed): <4.0-4.1 / 4.2-4.x / 5.x>
208
+
209
+ Engine config:
210
+ Engine: <Cycles / Eevee / Workbench>
211
+ Engine token (if needed): <BLENDER_EEVEE (4.0-4.1, 5.x) / BLENDER_EEVEE_NEXT (4.2-4.x)>
212
+ Samples: <pinned sample count>
213
+ GPU device: <pinned GPU device or CPU fallback>
214
+ Caveats: <tradeoffs, time/hardware assumptions>
215
+
216
+ Runtime status: Not Run
217
+ Artifact status: Not Produced
218
+ Evidence used: <spec inputs or "none">
219
+ Limitations: <known gaps; denoiser and render-setting optimization out of scope>
220
+ Next: color-management-decision -> resolution-aspect-decision -> output-format-decision -> render-export-evidence
221
+ ```
222
+
223
+ ## Anti-patterns
224
+ - "Always Cycles" without considering time.
225
+ - "Always Eevee" without considering features.
226
+ - Skipping GPU device choice.
227
+ - Choosing engine for animation without time-budget math.
228
+
229
+ ## Cross-skill handoff
230
+ <!-- blendops:generated:start handoffs -->
231
+ - [upstream_reference] Lighting and material setup aligned with engine choice → `../lighting-material-plan/SKILL.md`
232
+ - [upstream_reference] Color configuration decision → `../color-management-decision/SKILL.md`
233
+ - [progression] Output container / codec decision → `../output-format-decision/SKILL.md`
234
+ - [upstream_reference] Render resolution and aspect ratio decision → `../resolution-aspect-decision/SKILL.md`
235
+ - [progression] Post-render output verification → `../render-export-evidence/SKILL.md`
236
+ <!-- blendops:generated:end handoffs -->
237
+
238
+ ## Non-goals
239
+
240
+ * Never run Blender or execute a render or preview render.
241
+ * Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
242
+ * Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
243
+ * Never verify rendered files (`render-export-evidence`).
244
+
245
+ ## References
246
+ - `references/engine-feature-matrix.md`
247
+ - `references/samples-by-quality.md`
248
+ - `references/gpu-device-rules.md`
249
+ - `../../docs/skill-system.md`
@@ -0,0 +1,142 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "cycles-vs-eevee-decision",
4
+ "version": "1.0.0",
5
+ "category": "render-and-output-decisions",
6
+ "role": "render-engine-tradeoff-selector",
7
+ "purpose": "Pick Cycles, Eevee, or Workbench for a render based on quality bar, time budget, and feature requirements (caustics, subsurface, etc.). Note: Eevee was named Eevee Next on Blender 4.2-4.x only.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "Cycles or Eevee",
11
+ "what render engine",
12
+ "is Eevee enough",
13
+ "render is too slow"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "for a known repeat render (engine already chosen)",
18
+ "delegateTo": "lighting-material-plan",
19
+ "reason": "engine already chosen"
20
+ },
21
+ {
22
+ "condition": "for non-render work (modeling / animation prep)",
23
+ "delegateTo": "output-format-decision",
24
+ "reason": "modeling / animation prep"
25
+ }
26
+ ],
27
+ "inputs": {
28
+ "required": [
29
+ {
30
+ "name": "deliverable_use_case",
31
+ "type": "string",
32
+ "description": "Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source"
33
+ },
34
+ {
35
+ "name": "optical_feature_requirements",
36
+ "type": "array",
37
+ "description": "Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)"
38
+ },
39
+ {
40
+ "name": "render_time_and_hardware_budget",
41
+ "type": "string",
42
+ "description": "Per-frame render time ceiling and available GPU/CPU compute posture"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "blender_version_token",
48
+ "type": "string",
49
+ "description": "Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "selected_render_engine_record",
56
+ "sample_and_denoiser_targets",
57
+ "engine_tradeoff_and_fallback_caveats"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "lighting-material-plan",
68
+ "type": "upstream_reference",
69
+ "label": "Lighting and material setup aligned with engine choice",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "brief.locked",
74
+ "operator": "equals",
75
+ "value": true
76
+ },
77
+ {
78
+ "field": "stage.current",
79
+ "operator": "equals",
80
+ "value": "lookdev_planning"
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "color-management-decision",
87
+ "type": "upstream_reference",
88
+ "label": "Color configuration decision",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "decision.colorLocked",
93
+ "operator": "equals",
94
+ "value": false
95
+ }
96
+ ]
97
+ }
98
+ },
99
+ {
100
+ "target": "output-format-decision",
101
+ "type": "progression",
102
+ "label": "Output container / codec decision",
103
+ "when": {
104
+ "all": [
105
+ {
106
+ "field": "decision.formatLocked",
107
+ "operator": "equals",
108
+ "value": false
109
+ }
110
+ ]
111
+ }
112
+ },
113
+ {
114
+ "target": "resolution-aspect-decision",
115
+ "type": "upstream_reference",
116
+ "label": "Render resolution and aspect ratio decision",
117
+ "when": {
118
+ "all": [
119
+ {
120
+ "field": "decision.aspectLocked",
121
+ "operator": "equals",
122
+ "value": false
123
+ }
124
+ ]
125
+ }
126
+ },
127
+ {
128
+ "target": "render-export-evidence",
129
+ "type": "progression",
130
+ "label": "Post-render output verification",
131
+ "when": {
132
+ "all": [
133
+ {
134
+ "field": "stage.current",
135
+ "operator": "equals",
136
+ "value": "post_execution_audit"
137
+ }
138
+ ]
139
+ }
140
+ }
141
+ ]
142
+ }
@@ -0,0 +1,39 @@
1
+ # Engine feature matrix
2
+
3
+ | Feature | Cycles | Eevee Next (Blender 4.2+) | Eevee (legacy) | Workbench |
4
+ |---|---|---|---|---|
5
+ | Path-traced GI (accurate) | Y | Approximated | Approximated | N |
6
+ | Caustics | Y (with caustic flag) | Approximate | Approximate | N |
7
+ | Subsurface Scattering | Y (accurate) | Y (approximate) | Y (approximate) | N |
8
+ | Volumetrics with light interaction | Y | Y (improved Eevee Next) | Y (limited) | N |
9
+ | Refraction (accurate IOR) | Y | Y (with shadows) | Limited | N |
10
+ | Hair / particles fully | Y | Y | Y (limited) | Y (basic) |
11
+ | Real-time preview | N | Y | Y | Y |
12
+ | Denoiser | OPTIX / OIDN | Built-in | N | N |
13
+ | Render times | Slow (minutes) | Fast (seconds) | Fast (seconds) | Instant |
14
+ | GPU support | OPTIX / CUDA / HIP / METAL / ONEAPI / CPU | GPU rasterization | GPU rasterization | GPU |
15
+
16
+ ## When each engine wins
17
+
18
+ | Use case | Engine |
19
+ |---|---|
20
+ | Final hero with realistic light | Cycles |
21
+ | Lookdev / iteration | Eevee Next |
22
+ | Animation with tight budget | Eevee Next (or Cycles GPU + denoiser if budget allows) |
23
+ | Stylized / non-PBR | Eevee Next |
24
+ | Clay / wireframe / shading test | Workbench |
25
+ | HDR scene with caustics | Cycles |
26
+ | Real-time interactive preview | Eevee Next |
27
+
28
+ ## Eevee Next vs Eevee (legacy)
29
+
30
+ Eevee Next (Blender 4.2+) significantly improves:
31
+ - GI quality (Light Probe Volumes)
32
+ - Volumetrics
33
+ - Refraction
34
+ - Render quality at default settings
35
+
36
+ Use Eevee Next over legacy Eevee for any new project on Blender 4.2+.
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,51 @@
1
+ # GPU device rules (Cycles)
2
+
3
+ ## Device options
4
+
5
+ | Device | Hardware | Speed (relative) |
6
+ |---|---|---|
7
+ | OPTIX | NVIDIA RTX (RTX 20 / 30 / 40 / Ada / Hopper) | Fastest (RT cores accelerate) |
8
+ | CUDA | NVIDIA (any modern) | Fast (no RT cores acceleration) |
9
+ | METAL | Apple Silicon (M1 / M2 / M3 / M4) | Fast on Apple GPU |
10
+ | HIP | AMD (RDNA 2 / 3 / 4) | Fast |
11
+ | ONEAPI | Intel Arc / iGPU | Moderate |
12
+ | CPU | Any CPU | Slowest (10-50x slower than GPU) |
13
+
14
+ ## Choosing on a multi-GPU / iGPU system
15
+
16
+ - OPTIX > CUDA on the same NVIDIA card; always pick OPTIX if available.
17
+ - METAL on Apple Silicon; never CPU-only on Apple Silicon for Cycles.
18
+ - HIP on modern AMD; CPU fallback if older AMD.
19
+ - Combine GPU+CPU rendering: append `+CPU` to GPU device (e.g., `OPTIX+CPU`); only marginal improvement on most systems.
20
+
21
+ ## Memory considerations
22
+
23
+ - GPU rendering is limited by VRAM.
24
+ - Out-of-VRAM symptoms: render fails / falls back to CPU / artifacts.
25
+ - With OPTIX / CUDA / HIP, Blender can spill to system RAM with performance hit.
26
+ - Reduce: texture sizes, mesh polycount, hair density.
27
+
28
+ ## CLI usage
29
+
30
+ For headless / CI:
31
+
32
+ ```
33
+ blender -b file.blend -P script.py -- --cycles-device OPTIX
34
+ ```
35
+
36
+ The `-- --cycles-device` syntax separates Blender args from CLI override.
37
+
38
+ ## Memory + samples interaction
39
+
40
+ - High samples + high resolution + complex scene → may exceed VRAM.
41
+ - Reduce one of: samples, resolution, scene complexity.
42
+ - Or render in tiles (Cycles supports tile-based rendering).
43
+
44
+ ## Common errors
45
+
46
+ - "CUDA out of memory" → reduce textures or resolution.
47
+ - "OPTIX not available" → driver / Blender version mismatch; verify Blender version supports OPTIX.
48
+ - "Slow Cycles on RTX" → forgot to enable OPTIX; verify Render properties → Device.
49
+
50
+ ## Related skill
51
+ `../SKILL.md`
@@ -0,0 +1,53 @@
1
+ # Samples by quality bar
2
+
3
+ ## Cycles
4
+
5
+ | Quality bar | Samples | Time per frame (typical) |
6
+ |---|---|---|
7
+ | Preview / draft | 32 | < 1 minute |
8
+ | Lookdev | 64-128 | 1-3 minutes |
9
+ | Animation frame | 64-256 (with denoiser) | 1-5 minutes |
10
+ | Hero final | 128-512 (with denoiser) | 5-30 minutes |
11
+ | Print / archival final | 512-2048+ | 30 minutes - hours |
12
+
13
+ Always enable denoiser (OPTIX or Open Image Denoise) for animation and final.
14
+
15
+ ## Eevee Next
16
+
17
+ | Quality bar | Render samples | Light Probe samples | Time per frame |
18
+ |---|---|---|---|
19
+ | Preview / draft | Default 16 | Default 16 | < 1 second |
20
+ | Lookdev | 32-64 | 32-64 | 1-3 seconds |
21
+ | Animation | 32-64 | 64-128 | 1-5 seconds |
22
+ | Hero final (Eevee suitable) | 128-256 | 128-256 | 5-30 seconds |
23
+
24
+ ## Eevee (legacy)
25
+
26
+ Similar to Eevee Next but without the improved GI sampling. Adjust accordingly.
27
+
28
+ ## Adaptive sampling (Cycles)
29
+
30
+ Cycles supports adaptive sampling — render fewer samples in low-noise regions. Enable for hero work to reduce time without quality loss.
31
+
32
+ Threshold:
33
+ - 0.01 = high quality, slow
34
+ - 0.05 = balanced
35
+ - 0.1 = fast, more noise
36
+
37
+ ## Per-feature sample considerations
38
+
39
+ - Caustics need extra samples (256+).
40
+ - Volumetrics need extra samples or higher light probe quality.
41
+ - Subsurface scattering benefits from higher samples.
42
+ - Stylized / NPR work can run with fewer samples.
43
+
44
+ ## Verifying sample count
45
+
46
+ After test render, look for:
47
+ - Noise / grain in dark areas → samples too low.
48
+ - Splotchy / patchy lighting → samples too low or denoiser too aggressive.
49
+ - Smooth gradients → samples adequate.
50
+ - Acceptable but not perfect → likely good for animation.
51
+
52
+ ## Related skill
53
+ `../SKILL.md`
@@ -0,0 +1,33 @@
1
+ # EVAL — done-criteria
2
+
3
+ ## Text-only eval prompt
4
+ Use done-criteria on a hero render recipe (cyberpunk shoe, runtime-ready mode).
5
+
6
+ ## Expected behavior
7
+ - one concrete stop condition
8
+ - 3-5 out-of-scope items
9
+ - handoff trigger named
10
+ - mode stated
11
+ - evidence label honest
12
+
13
+ ## Pass / Warn / Fail criteria
14
+ - Pass: concrete one-sentence condition + out-of-scope + handoff
15
+ - Warn: condition slightly soft; out-of-scope partial
16
+ - Fail: vague "looks good", multiple stacked conditions, no out-of-scope
17
+
18
+ ## Common failure modes
19
+ - "done when it looks great"
20
+ - multiple stop conditions
21
+ - no out-of-scope list
22
+ - declaring done without evidence
23
+
24
+ ## Sample passing response outline
25
+ - Stop condition row
26
+ - Out-of-scope list (3-5)
27
+ - Handoff trigger
28
+ - Mode + limitations
29
+
30
+ ## Sample failing response outline
31
+ - "When it looks good"
32
+ - Multiple stacked conditions
33
+ - No out-of-scope