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,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/bridge-conflicts/SKILL.md and skills/bridge-conflicts/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # bridge-conflicts (reference summary)
3
+
4
+ ## Purpose
5
+ Diagnose MCP bridge conflicts (Path 1 Official Blender Lab MCP 5.1+ vs Path 2 mcp-for-blender, port 9876 collisions, host mismatch) and hand off to runtime-readiness.
6
+
7
+ Resolve the single-bridge constraint when more than one MCP runtime path is configured against the same Blender instance (or when ports collide). Blender accepts only one MCP bridge session per instance (default port 9876) — so running Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) concurrently, connecting two MCP clients to one Blender instance, colliding on port 9876, or enabling both Path 1 host (a) and host (b) on one session causes inconsistent signals.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/bridge-conflicts/SKILL.md`
11
+ - **Contract:** `skills/bridge-conflicts/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `port-and-addon-conflict-resolver`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - `runtime-readiness` reports inconsistent signals (e.g. host reports connected but tool calls return the wrong tool surface)
18
+ - both Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) add-ons are enabled in the same Blender instance
19
+ - two MCP clients are pointing at the same Blender instance (e.g. Claude Desktop with Connector + Cursor with manual MCP)
20
+ - Path 1 host (a) and host (b) are both active on a single session
21
+ - log or port output shows a collision on default port `9876`
22
+
23
+ ## Trigger cues
24
+ - "tool surface looks wrong"
25
+ - "smoke test passed yesterday but recipe fails today"
26
+ - "Lab MCP and ahujasid both installed"
27
+ - "Claude Desktop and Cursor both pointing at Blender"
28
+ - "port 9876 already in use"
29
+ - "single-bridge constraint violation"
30
+
31
+ ## When not to use
32
+ - no readiness signal yet (run runtime-readiness first) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; run runtime-readiness first)
33
+ - no runtime path has been chosen yet → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; route to runtime-path-picker)
34
+ - the user wants to switch or set up a path from scratch → delegate to `runtime-setup` (`references/skills/runtime-setup.md`; route to runtime-setup)
35
+ - the bridge matrix is clean and only one path is active, but smoke tests still fail → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; route to blender-troubleshooting)
36
+ - the user explicitly wants both paths configured for separate Blender instances on different ports (requires explicit port isolation) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; requires explicit port isolation)
37
+
38
+ ## Inputs & output/evidence contract
39
+ ### Required inputs
40
+ - `target_blender_instance` (`string`): Running Blender session identifier or binary path experiencing bridge or port collisions
41
+ - `configured_mcp_hosts_and_addons` (`object`): Inventory of enabled Blender add-ons (Lab MCP vs mcp-for-blender) and active MCP client connections
42
+
43
+ ### Optional inputs
44
+ - `port_9876_diagnostics` (`string`): Optional socket/port binding diagnostics around default port 9876
45
+
46
+ ### Primary outputs
47
+ - `bridge_conflict_diagnosis_matrix`
48
+ - `single_bridge_isolation_steps`
49
+ - `post_resolution_readiness_recheck_route`
50
+
51
+ ## Quick-start procedure
52
+ 1. list every active / configured bridge for the target Blender session
53
+ 2. check for port collision (commonly `localhost:9876`)
54
+ 3. identify which path is intended; which is residual
55
+ 4. propose the cheapest disable / port-isolation step
56
+ 5. hand off to `runtime-readiness` to re-verify
57
+
58
+ ## Handoff notes
59
+ - **[upstream_reference]** When runtime-readiness reports inconsistent signals → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
60
+ - **[fallback]** If the bridge matrix is clean but failures persist → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
61
+ - **[upstream_reference]** If the user wants to change paths or set up a path → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
62
+ - **[upstream_reference]** If the intended runtime path has not been chosen yet → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** This skill never disables add-ons, edits MCP client configs, changes ports, kills processes, or runs Blender. It only diagnoses the conflict, proposes the cheapest resolution for the operator to perform, and hands off to `runtime-readiness`.
66
+ - Disabling add-ons, editing MCP client configs, changing ports, killing processes, or running Blender
67
+ - Upgrading Runtime or Artifact truth states
68
+ - Replacing `runtime-readiness`, `runtime-path-picker`, `runtime-setup`, or `blender-troubleshooting`
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/camera-composition/SKILL.md and skills/camera-composition/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # camera-composition (reference summary)
3
+
4
+ ## Purpose
5
+ Provide detailed composition and camera planning for product hero outputs.
6
+
7
+ Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/camera-composition/SKILL.md`
11
+ - **Contract:** `skills/camera-composition/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `camera-rig-and-composition-deep-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
18
+ - defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
19
+ - aligning hero framing and negative space with web/UI copy overlays
20
+
21
+ ## Trigger cues
22
+ - "improve composition and camera"
23
+ - "choose hero framing"
24
+ - "set camera strategy for product hero"
25
+
26
+ ## When not to use
27
+ - as proof of rendered output quality or to validate an existing framing → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
28
+ - to design lighting rigs or surface materials/lookdev → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
29
+ - to lock final pixel resolution or output aspect specs → delegate to `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`; use resolution-aspect-decision)
30
+ - to choose delivery file formats → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; use output-format-decision)
31
+ - when subject intent is undefined → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `domain_scene_plan` (`object`): Upstream scene layout plan defining subject scale, staging, and depth layers
36
+ - `framing_goal` (`string`): Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)
37
+
38
+ ### Optional inputs
39
+ - `pinned_aspect_ratio` (`string`): Aspect ratio lock from resolution-aspect-decision
40
+
41
+ ### Primary outputs
42
+ - `camera_rig_specification`
43
+ - `focal_length_and_dof_plan`
44
+ - `composition_anchor_guidelines`
45
+
46
+ ## Quick-start procedure
47
+ 1. confirm this skill fits your goal
48
+ 2. provide required inputs first
49
+ 3. keep runtime claims evidence-bound
50
+ 4. follow suggested next-skill handoff
51
+
52
+ ## Handoff notes
53
+ - **[upstream_reference]** Upstream input from → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
54
+ - **[conditional]** Lateral output specs (if needed) (output-format-decision) → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
55
+ - **[conditional]** Lateral output specs (if needed) (resolution-aspect-decision) → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
56
+ - **[progression]** Next (lookdev & lighting) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
57
+ - **[progression]** Then (validation) (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
58
+ - **[progression]** Then (validation) (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
59
+
60
+ ## Safety boundaries & non-goals
61
+ - **Runtime boundary:** Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. Runtime status stays `Not Run` and artifacts stay `Not Produced` (truth states are downgrade-only, never upgraded without verified evidence).
62
+ - executing Blender commands, writing Python scripts, or generating scene/render artifacts
63
+ - designing lighting setups or materials (owned by `lighting-material-plan`)
64
+ - validating or scoring completed scene framing (owned by `composition-quality-checker`)
65
+ - locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
@@ -0,0 +1,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/character-portrait/SKILL.md and skills/character-portrait/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # character-portrait (reference summary)
3
+
4
+ ## Purpose
5
+ Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
6
+
7
+ Translate a single-subject character-portrait intent (subject identity, pose, expression, wardrobe, framing, lighting, background) into a structured scene plan with an explicit assumptions register. Distinct from `product-hero-scene-planner` (manufactured products), `environment-shot` (places), and `interior-scene` (rooms). Multi-character ensembles are out of scope. Hands off framing deep-dives to `camera-composition`, lookdev deep-dives to `lighting-material-plan`, assets to `asset-discovery`, and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/character-portrait/SKILL.md`
11
+ - **Contract:** `skills/character-portrait/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `character-portrait-and-turntable-architect`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - intent is explicitly a character / person / creature portrait
18
+ - before any modeling or scene file is built
19
+ - when the consumer is editorial / brand / catalog / cinematic
20
+
21
+ ## Trigger cues
22
+ - "portrait of"
23
+ - "character looking at the camera"
24
+ - "headshot"
25
+ - "hero shot of [person / mascot / creature]"
26
+
27
+ ## When not to use
28
+ - product hero scenes → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
29
+ - environment establishing shots → delegate to `environment-shot` (`references/skills/environment-shot.md`; use environment-shot)
30
+ - interior arch viz → delegate to `interior-scene` (`references/skills/interior-scene.md`; use interior-scene)
31
+ - multi-character ensemble (this skill is single-subject) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; this skill is single-subject)
32
+
33
+ ## Inputs & output/evidence contract
34
+ ### Required inputs
35
+ - `locked_3d_brief` (`object`): Locked 3D brief specifying character subject, expression/pose, and framing intent
36
+ - `character_asset_posture` (`object`): Available character model/rig status and material readiness from asset discovery
37
+
38
+ ### Optional inputs
39
+ - `turntable_or_still_preference` (`string`): Whether the deliverable is a portrait still, bust turntable, or full-body pose
40
+
41
+ ### Primary outputs
42
+ - `character_staging_and_pose_plan`
43
+ - `eyeline_and_portrait_camera_anchors`
44
+ - `skin_hair_rim_lighting_hooks`
45
+
46
+ ## Quick-start procedure
47
+ 1. confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
48
+ 2. confirm likeness rights before use if the subject is a real person
49
+ 3. pin subject identity, pose, expression, wardrobe, framing, lighting, and background
50
+ 4. record an explicit assumptions register
51
+ 5. flag needed assets for `asset-discovery`
52
+ 6. emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Upstream brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
56
+ - **[progression]** Framing deep-dive → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
57
+ - **[progression]** Lookdev deep-dive → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
58
+ - **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
59
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
60
+ - **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
61
+ - **[progression]** Scene quality validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
62
+
63
+ ## Safety boundaries & non-goals
64
+ - **Runtime boundary:** Planning-only skill: no modeling, no animation, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief is unclear, hand off to `intent-to-3d-brief-writer`.
65
+ - Model the character.
66
+ - Animate the character.
67
+ - Render.
68
+ - Run Blender.
@@ -0,0 +1,62 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cli-appendix-job-outline/SKILL.md and skills/cli-appendix-job-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # cli-appendix-job-outline (reference summary)
3
+
4
+ ## Purpose
5
+ Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.
6
+
7
+ Structure **CLI fallback appendix** jobs (batch render, batch export, scripted scene setup) using Blender's documented command-line interface — without presenting arbitrary Python as the user-facing product surface.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/cli-appendix-job-outline/SKILL.md`
11
+ - **Contract:** `skills/cli-appendix-job-outline/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `runtime-and-execution` / `headless-cli-batch-job-planner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - CI / render farm / repeatable exports
18
+ - MCP unavailable or disallowed by policy
19
+ - deterministic batch operations vs exploratory modeling
20
+
21
+ ## Trigger cues
22
+ - "headless blender"
23
+ - "batch render CLI"
24
+ - "blender --background"
25
+ - "render farm outline"
26
+
27
+ ## When not to use
28
+ - interactive viewport iteration primary goal → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
29
+ - user expects Connector chat loop → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
30
+
31
+ ## Inputs & output/evidence contract
32
+ ### Required inputs
33
+ - `target_blend_scene_and_outputs` (`object`): Source .blend file expectations and target render/export output deliverables
34
+ - `execution_environment_constraints` (`string`): Headless CI, render node, or local batch constraints selected via runtime-path-picker
35
+
36
+ ### Optional inputs
37
+ - `frame_range_or_batch_items` (`array`): Optional frame range or batch variant list for headless execution
38
+
39
+ ### Primary outputs
40
+ - `headless_cli_job_outline`
41
+ - `appendix_governance_and_backup_gates`
42
+ - `expected_output_evidence_hooks`
43
+
44
+ ## Quick-start procedure
45
+ 1. classify job type via `skills/cli-appendix-job-outline/references/job-type-matrix.md`
46
+ 2. capture ordering cautions `skills/cli-appendix-job-outline/references/flag-order-reminders.md`
47
+ 3. state limitations `skills/cli-appendix-job-outline/references/stateless-limitations.md`
48
+ 4. point user to upstream CLI manual for exact flags
49
+
50
+ ## Handoff notes
51
+ - **[upstream_reference]** Pick MCP vs CLI → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
52
+ - **[upstream_reference]** Interactive MCP host outline → `path-one-host-outline` (`references/skills/path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
53
+ - **[progression]** Export format choices → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
54
+ - **[progression]** Actual CLI output evidence recording → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
55
+ - **[progression]** Runtime attempt reporting → `runtime-attempt-report` (`references/skills/runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
56
+
57
+ ## Safety boundaries & non-goals
58
+ - **Runtime boundary:** Planning outline only — BlendOps never executes Blender and never presents arbitrary Python as the product surface. This CLI workflow is an **appendix only**, never a peer path without an eval record, and BlendOps has **no in-repo CLI evidence file yet**. Point users to the upstream Blender manual for exact CLI flags.
59
+ - Generating or debugging user-facing Python (`bpy`) scripts.
60
+ - Executing `blender --background` jobs or inspecting output files directly.
61
+ - Selecting between MCP Path 1, Path 2, and CLI (owned by `runtime-path-picker`).
62
+ - Certifying rendered frames or exported GLBs (owned by `render-export-evidence`).
@@ -0,0 +1,68 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/color-management-decision/SKILL.md and skills/color-management-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # color-management-decision (reference summary)
3
+
4
+ ## Purpose
5
+ Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.
6
+
7
+ Avoid the most common Blender color mistake: rendering with the wrong color space and then "fixing" it in post. Pick the color management strategy upfront based on the consumer's color pipeline.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/color-management-decision/SKILL.md`
11
+ - **Contract:** `skills/color-management-decision/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `render-and-output-decisions` / `view-transform-and-colorspace-selector`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render / lookdev pass
18
+ - when consumer color pipeline is known
19
+ - when a previous render had unexpected color shifts
20
+
21
+ ## Trigger cues
22
+ - "what color space"
23
+ - "Filmic vs Standard"
24
+ - "ACEScg for our pipeline"
25
+ - "colors look weird"
26
+
27
+ ## When not to use
28
+ - Post-render color grading or soft-proofing (handled by compositor / DCC after render). → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
29
+ - Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker). → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
30
+ - Selecting file formats or bit depths (output-format-decision). → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
31
+ - Choosing the render engine (cycles-vs-eevee-decision). → delegate to `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
32
+ - Monitor hardware calibration (out of scope). → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
33
+ - Raw modeling without lookdev (color management does not affect geometry accuracy). → delegate to `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `target_delivery_pipeline` (`string`): Target display or compositing pipeline (web sRGB, product brand match, ACEScg VFX, HDR)
38
+ - `blender_version_posture` (`string`): Target Blender version family (3.6 LTS Filmic, 4.0+ AgX, 5.1+ AgX/ACES)
39
+
40
+ ### Optional inputs
41
+ - `brand_hex_swatch_constraints` (`array`): Optional strict brand hex colors requiring Standard vs tone-mapped tradeoffs
42
+
43
+ ### Primary outputs
44
+ - `pinned_view_transform_and_look`
45
+ - `display_and_working_colorspace_spec`
46
+ - `cross_engine_and_web_color_caveats`
47
+
48
+ ## Quick-start procedure
49
+ 1. Identify the consumer pipeline (`web sRGB` / `film/VFX ACES linear` / `game engine` / `print` / `GLB-Three.js`).
50
+ 2. Pin the 4-line render color config: `Display Device`, `View Transform`, `Look`, and `Sequencer`.
51
+ 3. Define per-output color transforms if multiple outputs exist.
52
+ 4. Emit the 4-line config record, caveats, truth states (`Not Run` / `Not Produced`), and handoff.
53
+
54
+ ## Handoff notes
55
+ - **[progression]** Output format selection → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
56
+ - **[progression]** Material texture color spaces → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
57
+ - **[progression]** Render engine choice → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
58
+ - **[progression]** GLB Three.js delivery → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
59
+ - **[progression]** Render evidence verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
60
+
61
+ ## Safety boundaries & non-goals
62
+ - **Runtime boundary:** Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
63
+ - Validate per-material texture color spaces (`material-quality-checker`).
64
+ - Choose output file formats or bit depths (`output-format-decision`).
65
+ - Choose the render engine (`cycles-vs-eevee-decision`).
66
+ - Perform post-render color grading (belongs to compositor / DCC).
67
+ - Calibrate a physical monitor (out of scope).
68
+ - Run Blender or execute renders.
@@ -0,0 +1,71 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/composition-quality-checker/SKILL.md and skills/composition-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # composition-quality-checker (reference summary)
3
+
4
+ ## Purpose
5
+ Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
6
+
7
+ Run a focused per-row Pass/Warn/Fail check on the camera and framing setup against composition rules (rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility) — emitting per-row verdicts, a top-line status, and remediation hints only, without expanding into camera planning, aspect-ratio locking, material validation, or lighting validation.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/composition-quality-checker/SKILL.md`
11
+ - **Contract:** `skills/composition-quality-checker/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `quality-validators` / `framing-and-silhouette-validator`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - after a camera change request
19
+ - as a sub-check during full quality review
20
+ - when a render "feels off" but lighting and materials check out
21
+
22
+ ## Trigger cues
23
+ - "is the framing okay"
24
+ - "check composition"
25
+ - "subject feels off-center"
26
+ - "too much negative space"
27
+
28
+ ## When not to use
29
+ - planning or editing camera framing → delegate to `camera-composition` (`references/skills/camera-composition.md`; use camera-composition)
30
+ - locking aspect ratio or resolution → delegate to `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`; use resolution-aspect-decision)
31
+ - material validation → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; use material-quality-checker)
32
+ - lighting validation → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker)
33
+ - broad scene Pass/Warn/Fail readiness review → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
34
+ - classifying render or export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
35
+
36
+ ## Inputs & output/evidence contract
37
+ ### Required inputs
38
+ - `camera_and_framing_spec` (`object`): Camera focal length, sensor, angle, and subject placement from camera-composition
39
+ - `pinned_aspect_ratio_and_subject` (`object`): Locked aspect ratio and primary/secondary focal hierarchy from brief
40
+
41
+ ### Optional inputs
42
+ - `viewport_or_render_preview_notes` (`string`): Optional framing observations from a viewport or preview capture
43
+
44
+ ### Primary outputs
45
+ - `composition_verdict_table`
46
+ - `silhouette_and_headroom_assessment`
47
+ - `camera_replan_remediation_hints`
48
+
49
+ ## Quick-start procedure
50
+ 1. read camera lens / FOV, position, and target description
51
+ 2. read framing intent and locked aspect ratio from the brief
52
+ 3. check rule of thirds, subject placement, and headroom/lead-room
53
+ 4. check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
54
+ 5. emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
55
+
56
+ ## Handoff notes
57
+ - **[progression]** Broad scene readiness review (consumes these rows) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
58
+ - **[retry]** Camera & framing re-plan → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
59
+ - **[retry]** Aspect ratio & resolution locks → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
60
+ - **[progression]** Artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
61
+ - **[upstream_reference]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
62
+ - **[upstream_reference]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
63
+
64
+ ## Safety boundaries & non-goals
65
+ - **Runtime boundary:** This skill validates camera plans or measured scene snapshots only. It never moves the camera, never runs Blender, and never executes Python. Artifacts stay `Not Produced` unless concrete output evidence exists (classified by `render-export-evidence`), and truth states are strictly downgrade-only.
66
+ - Move or edit the camera (owned by `camera-composition`).
67
+ - Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
68
+ - Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
69
+ - Replace broad scene review (`scene-readiness`).
70
+ - Classify render or export artifact evidence (`render-export-evidence`).
71
+ - Run Blender or execute Python.
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cycles-vs-eevee-decision/SKILL.md and skills/cycles-vs-eevee-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # cycles-vs-eevee-decision (reference summary)
3
+
4
+ ## Purpose
5
+ 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.
6
+
7
+ Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/cycles-vs-eevee-decision/SKILL.md`
11
+ - **Contract:** `skills/cycles-vs-eevee-decision/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `render-and-output-decisions` / `render-engine-tradeoff-selector`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - before render
18
+ - when feature support drives engine choice
19
+ - when time vs quality tradeoff matters
20
+ - when previous render was wrong engine
21
+
22
+ ## Trigger cues
23
+ - "Cycles or Eevee"
24
+ - "what render engine"
25
+ - "is Eevee enough"
26
+ - "render is too slow"
27
+
28
+ ## When not to use
29
+ - for a known repeat render (engine already chosen) → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; engine already chosen)
30
+ - for non-render work (modeling / animation prep) → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; modeling / animation prep)
31
+
32
+ ## Inputs & output/evidence contract
33
+ ### Required inputs
34
+ - `deliverable_use_case` (`string`): Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source
35
+ - `optical_feature_requirements` (`array`): Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)
36
+ - `render_time_and_hardware_budget` (`string`): Per-frame render time ceiling and available GPU/CPU compute posture
37
+
38
+ ### Optional inputs
39
+ - `blender_version_token` (`string`): Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming
40
+
41
+ ### Primary outputs
42
+ - `selected_render_engine_record`
43
+ - `sample_and_denoiser_targets`
44
+ - `engine_tradeoff_and_fallback_caveats`
45
+
46
+ ## Quick-start procedure
47
+ 1. Name the use case (hero / preview / animation / lookdev / flat clay).
48
+ 2. Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
49
+ 3. Evaluate time budget per frame and available hardware.
50
+ 4. 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).
51
+ 5. Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
52
+
53
+ ## Handoff notes
54
+ - **[upstream_reference]** Lighting and material setup aligned with engine choice → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
55
+ - **[upstream_reference]** Color configuration decision → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
56
+ - **[progression]** Output container / codec decision → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
57
+ - **[upstream_reference]** Render resolution and aspect ratio decision → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
58
+ - **[progression]** Post-render output verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
59
+
60
+ ## Safety boundaries & non-goals
61
+ - **Runtime boundary:** Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
62
+ - Never run Blender or execute a render or preview render.
63
+ - Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
64
+ - Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
65
+ - Never verify rendered files (`render-export-evidence`).
@@ -0,0 +1,70 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/done-criteria/SKILL.md and skills/done-criteria/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # done-criteria (reference summary)
3
+
4
+ ## Purpose
5
+ Define explicit "done" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.
6
+
7
+ Pin a single, explicit stop condition for one recipe BEFORE work begins—consisting of one concrete sentence, an explicit out-of-scope list, and a handoff trigger—so the agent stops at the right point instead of drifting into endless polish. Firing the stop condition routes the deliverable to the next skill; it never upgrades any runtime or artifact truth state. Inspired by Anthropic Superpowers `/just-say-when-it's-done` analog.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/done-criteria/SKILL.md`
11
+ - **Contract:** `skills/done-criteria/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `process-discipline` / `done-condition-and-iteration-cap-pinner`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - BEFORE starting work on any non-trivial single Blender recipe
18
+ - after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
19
+ - when previous attempts drifted into endless polish or unclear completion boundaries
20
+
21
+ ## Trigger cues
22
+ - "when are we done"
23
+ - "let's set the bar"
24
+ - "what does done look like"
25
+
26
+ ## When not to use
27
+ - pure exploration or brainstorming → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; use blender-brainstorming; goal is divergence)
28
+ - tiny single-shot requests → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
29
+ - splitting a broad multi-recipe request beforehand → delegate to `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`; use blender-recipe-decomposer first)
30
+ - authoring measurable acceptance rows from scratch → delegate to `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`; use acceptance-criteria-builder first)
31
+ - enforcing per-stage checklist gates during execution → delegate to `stage-gates` (`references/skills/stage-gates.md`; use stage-gates)
32
+ - after work has already started and scope is drifting mid-flight → delegate to `scope-guard` (`references/skills/scope-guard.md`; use scope-guard)
33
+ - performing the final verification gate before delivery → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; use pre-handoff-verification)
34
+
35
+ ## Inputs & output/evidence contract
36
+ ### Required inputs
37
+ - `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining deliverable intent
38
+ - `acceptance_criteria_rows` (`array`): Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder
39
+
40
+ ### Optional inputs
41
+ - `iteration_budget_preference` (`integer`): Maximum refinement passes before halting or escalating
42
+
43
+ ### Primary outputs
44
+ - `definition_of_done_checklist`
45
+ - `max_iteration_caps_per_stage`
46
+ - `halt_and_escalation_triggers`
47
+
48
+ ## Quick-start procedure
49
+ 1. write one stop condition per recipe (one sentence, concrete)
50
+ 2. write what is OUT OF SCOPE for "done"
51
+ 3. write the handoff trigger (which skill receives the deliverable when stop condition fires)
52
+ 4. enforce: do not polish past the stop condition; do not declare done before it
53
+
54
+ ## Handoff notes
55
+ - **[upstream_reference]** Intent brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
56
+ - **[boundary_delegation]** Scope splitting beforehand → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
57
+ - **[upstream_reference]** Measurable acceptance rows → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
58
+ - **[progression]** Per-stage workflow gates → `stage-gates` (`references/skills/stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
59
+ - **[progression]** Mid-flight scope drift → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
60
+ - **[progression]** Artifact and render evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
61
+ - **[progression]** Final pre-handoff gate → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
62
+
63
+ ## Safety boundaries & non-goals
64
+ - **Runtime boundary:** Process and discipline skill only—no Python code and no Blender execution. This skill writes the stop condition before work starts and routes handoff when the condition is met; it never executes runtime tasks or upgrades truth states.
65
+ - Run Blender or execute Python.
66
+ - Split multi-recipe scope (`blender-recipe-decomposer`).
67
+ - Author raw measurable acceptance rows (`acceptance-criteria-builder`).
68
+ - Enforce per-stage checklist gates (`stage-gates`).
69
+ - Police mid-flight scope drift (`scope-guard`).
70
+ - Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
@@ -0,0 +1,65 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/environment-shot/SKILL.md and skills/environment-shot/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # environment-shot (reference summary)
3
+
4
+ ## Purpose
5
+ Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
6
+
7
+ Translate a wide place-establishing intent (locale, time of day, weather, atmosphere, foreground/midground/background depth layers, and focal subject or explicit "none") into a structured scene plan with an explicit assumptions register. Distinct from `character-portrait` (single subject), `product-hero-scene-planner` (manufactured products), and `interior-scene` (interior rooms/furniture/surfaces — an establishing shot of an interior room belongs there when furniture or surfaces dominate). Hands off asset rows to `asset-discovery` and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
8
+
9
+ ## Metadata & truth boundary
10
+ - **Canonical skill:** `skills/environment-shot/SKILL.md`
11
+ - **Contract:** `skills/environment-shot/contract.json` (`v1.0.0`)
12
+ - **Category / role:** `scene-planners` / `environment-establishing-shot-architect`
13
+ - **Capability tier:** `L0`
14
+ - **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
15
+
16
+ ## When to use
17
+ - intent is establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
18
+ - before any modeling, Geometry Nodes, or scene building
19
+ - when consumer is editorial, cinematic, or brand
20
+
21
+ ## Trigger cues
22
+ - "establishing shot of"
23
+ - "wide shot of"
24
+ - "city / forest / desert / ocean scene"
25
+ - "set the scene"
26
+
27
+ ## When not to use
28
+ - character portrait → delegate to `character-portrait` (`references/skills/character-portrait.md`; use character-portrait)
29
+ - product hero → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
30
+ - interior arch viz with focus on furniture / surfaces → delegate to `interior-scene` (`references/skills/interior-scene.md`; use interior-scene)
31
+
32
+ ## Inputs & output/evidence contract
33
+ ### Required inputs
34
+ - `locked_3d_brief` (`object`): Locked 3D brief specifying locale, mood, focal anchor, and delivery channel
35
+ - `atmosphere_and_time_of_day` (`object`): Target time of day, weather condition, and atmospheric haze/fog parameters
36
+
37
+ ### Optional inputs
38
+ - `asset_discovery_constraints` (`object`): Available environment kitbash or terrain assets from asset-discovery
39
+
40
+ ### Primary outputs
41
+ - `foreground_midground_background_layer_plan`
42
+ - `sun_sky_atmosphere_specification`
43
+ - `horizon_and_scale_anchor_plan`
44
+
45
+ ## Quick-start procedure
46
+ 1. confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
47
+ 2. pin locale, time of day, weather, and atmosphere
48
+ 3. pin foreground (FG), midground (MG), and background (BG) depth layers
49
+ 4. pin focal subject (or explicitly declare `none`)
50
+ 5. record an explicit assumptions register
51
+ 6. flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
52
+
53
+ ## Handoff notes
54
+ - **[upstream_reference]** Brief writer → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
55
+ - **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
56
+ - **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
57
+ - **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
58
+ - **[progression]** Quality readiness → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
59
+
60
+ ## Safety boundaries & non-goals
61
+ - **Runtime boundary:** Planning-only skill: no modeling, no Geometry Nodes, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief or locale scope is unclear, hand off to `intent-to-3d-brief-writer`.
62
+ - Model the environment.
63
+ - Generate Geometry Node setups.
64
+ - Render.
65
+ - Run Blender.