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,53 @@
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
3
+
4
+ Purpose: Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
5
+
6
+ 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.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `framing-and-silhouette-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - after a camera change request
13
+ - as a sub-check during full quality review
14
+ - when a render "feels off" but lighting and materials check out
15
+ - Trigger phrases: "is the framing okay", "check composition", "subject feels off-center", "too much negative space"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - planning or editing camera framing → use `camera-composition` (`references/skill-camera-composition.md`; use camera-composition)
19
+ - locking aspect ratio or resolution → use `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`; use resolution-aspect-decision)
20
+ - material validation → use `material-quality-checker` (`references/skill-material-quality-checker.md`; use material-quality-checker)
21
+ - lighting validation → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker)
22
+ - broad scene Pass/Warn/Fail readiness review → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
23
+ - classifying render or export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
24
+
25
+ ## Input & output contract
26
+ - Required input `camera_and_framing_spec` (`object`): Camera focal length, sensor, angle, and subject placement from camera-composition
27
+ - Required input `pinned_aspect_ratio_and_subject` (`object`): Locked aspect ratio and primary/secondary focal hierarchy from brief
28
+ - Optional input `viewport_or_render_preview_notes` (`string`): Optional framing observations from a viewport or preview capture
29
+ - Output contract: `composition_verdict_table`, `silhouette_and_headroom_assessment`, `camera_replan_remediation_hints` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. read camera lens / FOV, position, and target description
33
+ 2. read framing intent and locked aspect ratio from the brief
34
+ 3. check rule of thirds, subject placement, and headroom/lead-room
35
+ 4. check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
36
+ 5. emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
37
+
38
+ ## Cross-skill handoffs
39
+ - [progression] Broad scene readiness review (consumes these rows) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
40
+ - [retry] Camera & framing re-plan → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
41
+ - [retry] Aspect ratio & resolution locks → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
42
+ - [progression] Artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
43
+ - [upstream_reference] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
44
+ - [upstream_reference] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
45
+
46
+ ## Safety boundaries & non-goals
47
+ - 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.
48
+ - Move or edit the camera (owned by `camera-composition`).
49
+ - Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
50
+ - Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
51
+ - Replace broad scene review (`scene-readiness`).
52
+ - Classify render or export artifact evidence (`render-export-evidence`).
53
+ - Run Blender or execute Python.
@@ -0,0 +1,47 @@
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
3
+
4
+ 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.
5
+
6
+ Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `render-engine-tradeoff-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - when feature support drives engine choice
13
+ - when time vs quality tradeoff matters
14
+ - when previous render was wrong engine
15
+ - Trigger phrases: "Cycles or Eevee", "what render engine", "is Eevee enough", "render is too slow"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - for a known repeat render (engine already chosen) → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; engine already chosen)
19
+ - for non-render work (modeling / animation prep) → use `output-format-decision` (`references/skill-output-format-decision.md`; modeling / animation prep)
20
+
21
+ ## Input & output contract
22
+ - Required input `deliverable_use_case` (`string`): Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source
23
+ - Required input `optical_feature_requirements` (`array`): Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)
24
+ - Required input `render_time_and_hardware_budget` (`string`): Per-frame render time ceiling and available GPU/CPU compute posture
25
+ - Optional input `blender_version_token` (`string`): Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming
26
+ - Output contract: `selected_render_engine_record`, `sample_and_denoiser_targets`, `engine_tradeoff_and_fallback_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
27
+
28
+ ## Quick-start steps
29
+ 1. Name the use case (hero / preview / animation / lookdev / flat clay).
30
+ 2. Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
31
+ 3. Evaluate time budget per frame and available hardware.
32
+ 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).
33
+ 5. Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
34
+
35
+ ## Cross-skill handoffs
36
+ - [upstream_reference] Lighting and material setup aligned with engine choice → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
37
+ - [upstream_reference] Color configuration decision → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
38
+ - [progression] Output container / codec decision → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
39
+ - [upstream_reference] Render resolution and aspect ratio decision → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
40
+ - [progression] Post-render output verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
41
+
42
+ ## Safety boundaries & non-goals
43
+ - Runtime boundary: Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
44
+ - Never run Blender or execute a render or preview render.
45
+ - Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
46
+ - Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
47
+ - Never verify rendered files (`render-export-evidence`).
@@ -0,0 +1,53 @@
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
3
+
4
+ Purpose: 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.
5
+
6
+ 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.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `done-condition-and-iteration-cap-pinner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - BEFORE starting work on any non-trivial single Blender recipe
12
+ - after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
13
+ - when previous attempts drifted into endless polish or unclear completion boundaries
14
+ - Trigger phrases: "when are we done", "let's set the bar", "what does done look like"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - pure exploration or brainstorming → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming; goal is divergence)
18
+ - tiny single-shot requests → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
19
+ - splitting a broad multi-recipe request beforehand → use `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`; use blender-recipe-decomposer first)
20
+ - authoring measurable acceptance rows from scratch → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; use acceptance-criteria-builder first)
21
+ - enforcing per-stage checklist gates during execution → use `stage-gates` (`references/skill-stage-gates.md`; use stage-gates)
22
+ - after work has already started and scope is drifting mid-flight → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard)
23
+ - performing the final verification gate before delivery → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
24
+
25
+ ## Input & output contract
26
+ - Required input `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining deliverable intent
27
+ - Required input `acceptance_criteria_rows` (`array`): Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder
28
+ - Optional input `iteration_budget_preference` (`integer`): Maximum refinement passes before halting or escalating
29
+ - Output contract: `definition_of_done_checklist`, `max_iteration_caps_per_stage`, `halt_and_escalation_triggers` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. write one stop condition per recipe (one sentence, concrete)
33
+ 2. write what is OUT OF SCOPE for "done"
34
+ 3. write the handoff trigger (which skill receives the deliverable when stop condition fires)
35
+ 4. enforce: do not polish past the stop condition; do not declare done before it
36
+
37
+ ## Cross-skill handoffs
38
+ - [upstream_reference] Intent brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
39
+ - [boundary_delegation] Scope splitting beforehand → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
40
+ - [upstream_reference] Measurable acceptance rows → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
41
+ - [progression] Per-stage workflow gates → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
42
+ - [progression] Mid-flight scope drift → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
43
+ - [progression] Artifact and render evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
44
+ - [progression] Final pre-handoff gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
45
+
46
+ ## Safety boundaries & non-goals
47
+ - 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.
48
+ - Run Blender or execute Python.
49
+ - Split multi-recipe scope (`blender-recipe-decomposer`).
50
+ - Author raw measurable acceptance rows (`acceptance-criteria-builder`).
51
+ - Enforce per-stage checklist gates (`stage-gates`).
52
+ - Police mid-flight scope drift (`scope-guard`).
53
+ - Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
@@ -0,0 +1,47 @@
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
3
+
4
+ Purpose: Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
5
+
6
+ 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`.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `environment-establishing-shot-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - intent is establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
12
+ - before any modeling, Geometry Nodes, or scene building
13
+ - when consumer is editorial, cinematic, or brand
14
+ - Trigger phrases: "establishing shot of", "wide shot of", "city / forest / desert / ocean scene", "set the scene"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - character portrait → use `character-portrait` (`references/skill-character-portrait.md`; use character-portrait)
18
+ - product hero → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
19
+ - interior arch viz with focus on furniture / surfaces → use `interior-scene` (`references/skill-interior-scene.md`; use interior-scene)
20
+
21
+ ## Input & output contract
22
+ - Required input `locked_3d_brief` (`object`): Locked 3D brief specifying locale, mood, focal anchor, and delivery channel
23
+ - Required input `atmosphere_and_time_of_day` (`object`): Target time of day, weather condition, and atmospheric haze/fog parameters
24
+ - Optional input `asset_discovery_constraints` (`object`): Available environment kitbash or terrain assets from asset-discovery
25
+ - Output contract: `foreground_midground_background_layer_plan`, `sun_sky_atmosphere_specification`, `horizon_and_scale_anchor_plan` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
26
+
27
+ ## Quick-start steps
28
+ 1. confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
29
+ 2. pin locale, time of day, weather, and atmosphere
30
+ 3. pin foreground (FG), midground (MG), and background (BG) depth layers
31
+ 4. pin focal subject (or explicitly declare `none`)
32
+ 5. record an explicit assumptions register
33
+ 6. flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
34
+
35
+ ## Cross-skill handoffs
36
+ - [upstream_reference] Brief writer → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
37
+ - [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
38
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
39
+ - [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
40
+ - [progression] Quality readiness → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
41
+
42
+ ## Safety boundaries & non-goals
43
+ - 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`.
44
+ - Model the environment.
45
+ - Generate Geometry Node setups.
46
+ - Render.
47
+ - Run Blender.
@@ -0,0 +1,51 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-animation-handoff/SKILL.md and skills/glb-animation-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # glb-animation-handoff
3
+
4
+ Purpose: Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.
5
+
6
+ When a GLB ships with animation, capture the exact playback contract the consumer needs (which clips exist, how to start them, what loops, what does not) so the web side does not guess.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `rig-and-animation-clip-handoff-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - the GLB has at least one animation clip
12
+ - before final glb-web-handoff
13
+ - when the consumer is a web app (Three.js / R3F / Babylon / model-viewer)
14
+ - when the user mentions "idle", "loop", "transition", "interactive trigger"
15
+ - Trigger phrases: "make it loop", "trigger animation on hover", "idle and active states", "smooth transition between"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - static GLBs with no animation → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
19
+ - video pre-renders → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
20
+ - platforms that re-author animation downstream (game engines re-rigging the asset) → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; game engines re-rigging the asset)
21
+
22
+ ## Input & output contract
23
+ - Required input `animation_clip_inventory` (`array`): List of NLA/action clips with frame lengths, FPS, and skeletal/morph types
24
+ - Required input `interactive_playback_triggers` (`object`): Target loop/one-shot semantics, crossfade durations, root-motion policy, and consumer triggers
25
+ - Optional input `mobile_rig_budget_ceilings` (`object`): Bone count, morph target, and keyframe channel ceilings from mobile-glb-budget
26
+ - Output contract: `per_clip_animation_contract_table`, `root_motion_and_interpolation_pins`, `consumer_playback_verification_checklist` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
27
+
28
+ ## Quick-start steps
29
+ 1. enumerate every animation clip in the scene plan or exported GLB
30
+ 2. mark the type of each clip (skeletal / morph / both)
31
+ 3. pin FPS, loop semantics, transitions, root-motion treatment
32
+ 4. flag web-playback caveats per clip (Three.js animationMixer, glTF spec quirks)
33
+
34
+ ## Cross-skill handoffs
35
+ - [upstream_reference] Missing clip list / scene plan (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
36
+ - [upstream_reference] Missing clip list / scene plan (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
37
+ - [upstream_reference] Missing clip list / scene plan (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
38
+ - [upstream_reference] Missing clip list / scene plan (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
39
+ - [upstream_reference] Missing clip list / scene plan (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
40
+ - [upstream_reference] Channel, bone, and morph ceilings → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
41
+ - [upstream_reference] Export verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
42
+ - [progression] Web delivery handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
43
+ - [progression] React Three Fiber component shape → `r3f-component-plan` (`references/skill-r3f-component-plan.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "react_three_fiber"]`
44
+ - [progression] Final user-facing wording → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
45
+
46
+ ## Safety boundaries & non-goals
47
+ - Runtime boundary: This skill is documentation-only. It never exports GLB, runs Blender, writes Python, or claims that a clip plays correctly without measured evidence (`render-export-evidence` for export proof plus manual viewer test for playback).
48
+ - Run Blender or export GLB files.
49
+ - Author, retarget, or modify animations.
50
+ - Generate Python or `bpy` snippets.
51
+ - Promise web-side playback smoothness or upgrade truth states.
@@ -0,0 +1,51 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-web-handoff/SKILL.md and skills/glb-web-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # glb-web-handoff
3
+
4
+ Purpose: Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.
5
+
6
+ Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `web-glb-delivery-packager` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
12
+ - when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
13
+ - when preparing truthful next checks before passing final wording to `plain-language-response`
14
+ - Trigger phrases: "prepare web handoff", "is GLB ready", "summarize export status"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - to claim GLB or export success without concrete evidence → use `scene-readiness` (`references/skill-scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
18
+ - to replace runtime export verification → use `render-export-evidence` (`references/skill-render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
19
+ - to validate upstream scene readiness → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
20
+ - to classify raw render/export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
21
+ - to define mobile or file-size performance budgets → use `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`; use mobile-glb-budget)
22
+ - to define animation playback or rig contracts → use `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`; use glb-animation-handoff)
23
+ - to write the final user-facing response wording → use `plain-language-response` (`references/skill-plain-language-response.md`; use plain-language-response)
24
+
25
+ ## Input & output contract
26
+ - Required input `verified_or_planned_glb_artifact` (`object`): GLB artifact evidence record (from render-export-evidence) or planned export specification
27
+ - Required input `target_web_viewer_stack` (`string`): Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)
28
+ - Optional input `animation_and_budget_contracts` (`object`): Optional linked contracts from glb-animation-handoff and mobile-glb-budget
29
+ - Output contract: `web_glb_delivery_handoff_packet`, `scale_orientation_and_compression_manifest`, `viewer_integration_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. confirm this skill fits your goal
33
+ 2. provide required inputs first
34
+ 3. keep runtime claims evidence-bound
35
+ 4. follow suggested next-skill handoff
36
+
37
+ ## Cross-skill handoffs
38
+ - [upstream_reference] Upstream scene readiness validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
39
+ - [upstream_reference] Upstream artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
40
+ - [upstream_reference] Mobile and file-size budget constraints → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
41
+ - [upstream_reference] Animation playback and rig handoff contracts → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
42
+ - [progression] Final user-facing response wording → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
43
+
44
+ ## Safety boundaries & non-goals
45
+ - Runtime boundary: Never claim GLB or export success without concrete evidence tied to the current run, and never replace runtime export verification. Keep runtime vocabulary strictly within the 2-path (Path 1 Official Blender Lab MCP 5.1+, Path 2 community `mcp-for-blender`) + CLI appendix model. This skill never runs Blender or Python and never upgrades Runtime or Artifact truth states (downgrade-only).
46
+ - Generating Python scripts or executing Blender exports
47
+ - Replacing runtime export verification
48
+ - Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
49
+ - Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
50
+ - Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
51
+ - Making unsupported web stack or loader compatibility guarantees
@@ -0,0 +1,50 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/intent-to-3d-brief-writer/SKILL.md and skills/intent-to-3d-brief-writer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # intent-to-3d-brief-writer
3
+
4
+ Purpose: Convert a non-Blender-user's natural-language request into a structured 3D brief (subject, mood, deliverables, constraints, evidence expectations). Use as first step before any planner.
5
+
6
+ Translate a confirmed user intent (from `blender-brainstorming` or a clear initial request) into a structured 3D brief that downstream planners and `acceptance-criteria-builder` can consume without re-asking. Inspired by the "Analysis phase" pattern in BMad-Method (PRD / project brief), adapted for 3D scene work and non-Blender users.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `canonical-8-slot-brief-author` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - right after `blender-brainstorming` confirms user intent
12
+ - when the user provides a structured request that just needs format normalization
13
+ - before any planner skill (`product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`)
14
+ - before `acceptance-criteria-builder` consumes brief rows to build criteria
15
+ - when multiple planners need to share the same source-of-truth brief
16
+ - Trigger phrases: "lock the brief", "write the brief from this conversation", "what's the formal scope?", "before planning, write the spec"
17
+
18
+ ## When not to use (delegation boundaries)
19
+ - intent is still ambiguous (run blender-brainstorming first) → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; run blender-brainstorming first)
20
+ - the user is mid-execution and asks for a re-brief → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; route to blender-troubleshooting instead)
21
+ - the user pushes for immediate execution → use `runtime-readiness` (`references/skill-runtime-readiness.md`; route to runtime-readiness)
22
+ - the request is iteration on existing output ("make it darker") — that's a planner-level edit, not a new brief → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
23
+
24
+ ## Input & output contract
25
+ - Required input `raw_user_goal_and_context` (`string`): User request or brainstormed concept to lock into the canonical 8-slot 3D brief
26
+ - Required input `target_deliverable_surface` (`string`): Intended output format (hero still, product grid, portrait, environment, interior, or web GLB)
27
+ - Optional input `selected_recipe_or_pack` (`string`): Recipe or pack selected via recipe-fit-assessor
28
+ - Output contract: `canonical_8_slot_3d_brief`, `explicit_assumptions_register`, `scope_exclusions_and_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
29
+
30
+ ## Quick-start steps
31
+ 1. read confirmed intent from prior step (`blender-brainstorming` or original request)
32
+ 2. fill the 8 brief slots (mark unconfirmed items as `Unknown`, never invent)
33
+ 3. echo the brief to the user for confirmation
34
+ 4. hand off to downstream planners (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder` once confirmed
35
+
36
+ ## Cross-skill handoffs
37
+ - [upstream_reference] Preceding step → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
38
+ - [progression] Consuming skills (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
39
+ - [progression] Consuming skills (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
40
+ - [progression] Consuming skills (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
41
+ - [alternative] Consuming skills (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
42
+ - [conditional] If execution is requested → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
43
+ - [fallback] If mid-execution re-briefing occurs → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
44
+
45
+ ## Safety boundaries & non-goals
46
+ - Runtime boundary: This skill does not install Blender, run Blender, configure MCP, or claim artifacts. Output is a structured text brief.
47
+ - making the plan (planner's job)
48
+ - running Blender
49
+ - setting up runtime
50
+ - writing the final user response (`plain-language-response`'s job)
@@ -0,0 +1,54 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/interior-scene/SKILL.md and skills/interior-scene/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # interior-scene
3
+
4
+ Purpose: Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.
5
+
6
+ Translate an interior architectural visualization intent (room or interior space planned for catalog, brand, or showcase) into a complete, structured room plan with an assumptions register. Distinct from `environment-shot` (outdoor/wide places; an establishing shot of an interior room belongs HERE when furniture and surfaces dominate), `product-hero-scene-planner` (single manufactured product), and `character-portrait` (single subject).
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `interior-archviz-scene-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
12
+ - architectural visualization, catalog, brand showcase, hospitality, or residential room planning
13
+ - before any modeling, furniture sourcing, or rendering
14
+ - Trigger phrases: "interior of", "living room scene", "office showcase", "hotel lobby", "kitchen showroom"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - outdoor establishing → use `environment-shot` (`references/skill-environment-shot.md`; use environment-shot)
18
+ - single hero product → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
19
+ - character portrait → use `character-portrait` (`references/skill-character-portrait.md`; use character-portrait)
20
+
21
+ ## Input & output contract
22
+ - Required input `locked_3d_brief` (`object`): Locked 3D brief specifying room type, architectural style, focal zone, and daylight/artificial mood
23
+ - Required input `room_dimensions_and_openings` (`object`): Architectural envelope, window/door openings, and primary furniture anchor zones
24
+ - Optional input `sourced_furniture_and_finish_assets` (`array`): Available furniture and architectural material assets from asset-discovery
25
+ - Output contract: `interior_zone_and_circulation_plan`, `window_portal_and_fixture_lighting_plan`, `two_point_vertical_camera_constraints` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
26
+
27
+ ## Quick-start steps
28
+ 1. lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
29
+ 2. pin architecture basics (walls, floor, ceiling, windows, doors)
30
+ 3. pin furniture + props + material palette
31
+ 4. pin lighting (natural + artificial mix) + mood + time of day
32
+ 5. pin camera angle + lens
33
+ 6. emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers
34
+
35
+ ## Cross-skill handoffs
36
+ - [upstream_reference] Upstream brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
37
+ - [upstream_reference] Outdoor / wide establishing shot redirect → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
38
+ - [upstream_reference] Single hero product redirect → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
39
+ - [upstream_reference] Single character portrait redirect → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
40
+ - [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
41
+ - [upstream_reference] Performance / polycount budget → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
42
+ - [upstream_reference] Style consistency check → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
43
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
44
+ - [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
45
+ - [progression] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
46
+ - [progression] Scene quality validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
47
+
48
+ ## Safety boundaries & non-goals
49
+ - Runtime boundary: Planning-only skill — does not model, source furniture, render, or execute Blender. Runtime status stays `Not Run` and artifact status stays `Not Produced` (downgrade-only, never upgrade). Hand off asset sourcing to `asset-discovery`, budget questions to `mobile-glb-budget`, style checks to `asset-style-check`, and validation to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
50
+ - Model the room or geometry.
51
+ - Source furniture or download assets (belongs to `asset-discovery`).
52
+ - Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
53
+ - Audit cross-asset style consistency or validate composition, lighting, materials, or scene quality (belongs to `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`).
54
+ - Render or run Blender.
@@ -0,0 +1,48 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-material-plan/SKILL.md and skills/lighting-material-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # lighting-material-plan
3
+
4
+ Purpose: Build detailed lighting and material direction with portability and caveat handling for Blender/web-3D outputs.
5
+
6
+ Create a high-quality, practical lighting/material plan that balances visual intent and web portability constraints.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `lighting-rig-and-lookdev-deep-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - look-development strategy is needed
12
+ - lighting/material choices drive scene mood
13
+ - web/GLB portability caveats must be explicit
14
+ - Trigger phrases: "plan lighting and materials", "design cyberpunk lookdev", "define PBR and reflection strategy"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - to claim final rendered quality or executed results → use `camera-composition` (`references/skill-camera-composition.md`; Delegates out-of-scope requests to camera-composition)
18
+ - to skip composition/camera context from camera-composition → use `camera-composition` (`references/skill-camera-composition.md`; Delegates out-of-scope requests to camera-composition)
19
+ - to validate existing lighting or materials → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker and material-quality-checker)
20
+ - to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision) → use `color-management-decision` (`references/skill-color-management-decision.md`; output-format-decision)
21
+ - to execute Blender or generate Python scripts → use `color-management-decision` (`references/skill-color-management-decision.md`; Delegates out-of-scope requests to color-management-decision)
22
+
23
+ ## Input & output contract
24
+ - Required input `domain_scene_plan` (`object`): Upstream scene layout and subject surface description
25
+ - Required input `camera_framing_plan` (`object`): Locked camera angles and hero silhouette requirements from camera-composition
26
+ - Optional input `target_render_engine_hint` (`string`): Preferred engine (Cycles, Eevee, or WebGL/GLB PBR export target)
27
+ - Output contract: `key_fill_rim_lighting_plan`, `pbr_material_and_roughness_spec`, `hdri_and_reflection_strategy` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
28
+
29
+ ## Quick-start steps
30
+ 1. confirm this skill fits your goal
31
+ 2. provide required inputs first
32
+ 3. keep runtime claims evidence-bound
33
+ 4. follow suggested next-skill handoff
34
+
35
+ ## Cross-skill handoffs
36
+ - [upstream_reference] Upstream input from (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
37
+ - [progression] Upstream input from (color-management-decision) → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
38
+ - [progression] Upstream input from (cycles-vs-eevee-decision) → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
39
+ - [progression] Upstream input from (output-format-decision) → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
40
+ - [progression] Next validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
41
+ - [progression] Next validation (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
42
+ - [progression] Then scene check → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
43
+ - [progression] Then delivery → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
44
+
45
+ ## Safety boundaries & non-goals
46
+ - Runtime boundary: This is a planning-only skill: no Blender execution, no Python, and no artifact generation. Runtime status always remains `Not Run` and artifact status always remains `Not Produced` (truth states are downgrade-only, never upgrade). If referencing Eevee engine tokens from upstream `cycles-vs-eevee-decision`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` only for 4.2–4.x — never present Eevee Next as the current name.
47
+ - shader/runtime implementation code
48
+ - rendered quality claims without evidence
@@ -0,0 +1,52 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-quality-checker/SKILL.md and skills/lighting-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # lighting-quality-checker
3
+
4
+ Purpose: Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
5
+
6
+ Run a focused pass/warn/fail check on the scene's lighting setup per light — covering intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance, and mood match — without expanding into material, composition, or lookdev planning concerns.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `exposure-ratio-and-shadow-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render
12
+ - after a lighting change request
13
+ - as a sub-check during full quality review
14
+ - when the rendered preview looks "off" but the issue is unclear
15
+ - Trigger phrases: "is the lighting okay", "check shadow softness", "lighting feels off", "is the HDRI balanced"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - upstream lookdev and lighting planning → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; use lighting-material-plan)
19
+ - material validation → use `material-quality-checker` (`references/skill-material-quality-checker.md`; use material-quality-checker)
20
+ - composition / camera validation → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
21
+ - broad pass/warn/fail scene readiness → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
22
+ - classifying render or export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
23
+ - to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → use `scene-readiness` (`references/skill-scene-readiness.md`; this skill validates and gives remediation hints only; it never edits)
24
+
25
+ ## Input & output contract
26
+ - Required input `lighting_rig_specification` (`object`): Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan
27
+ - Required input `color_management_pins` (`object`): Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision
28
+ - Optional input `render_or_preview_exposure_notes` (`string`): Optional highlight clipping or shadow crush observations from preview output
29
+ - Output contract: `lighting_quality_verdict_table`, `key_fill_rim_and_clipping_audit`, `lighting_remediation_instructions` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. enumerate every explicit light and HDRI in the scene plan or measured scene
33
+ 2. check intensity ranges per light
34
+ 3. check shadow softness consistency
35
+ 4. check color temperature consistency
36
+ 5. check HDRI presence + balance with explicit lights
37
+ 6. check mood match against the brief
38
+ 7. emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
39
+
40
+ ## Cross-skill handoffs
41
+ - [progression] Broad readiness review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
42
+ - [upstream_reference] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
43
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
44
+ - [retry] Lighting re-plan → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
45
+ - [progression] Render evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
46
+
47
+ ## Safety boundaries & non-goals
48
+ - Runtime boundary: This skill validates plans or measured scene snapshots only. It never modifies lights, runs Blender, or renders. Use measured scene description (plan output, runtime tool snapshot) — never invent values.
49
+ - Edit lights.
50
+ - Generate light setup recipes.
51
+ - Replace `scene-readiness`.
52
+ - Run Blender.
@@ -0,0 +1,32 @@
1
+ # Skill Map
2
+
3
+ Canonical BlendOps references inside this single upload-ready Skill package.
4
+
5
+ | Intent | Use reference |
6
+ |---|---|
7
+ | unclear next step | `skill-blendops-help.md` |
8
+ | vague creative request, intent exploration | `skill-blender-brainstorming.md` |
9
+ | convert intent → 8-slot 3D brief | `skill-intent-to-3d-brief-writer.md` |
10
+ | asset acquisition strategy | `skill-asset-discovery.md` |
11
+ | runtime setup prerequisites | `skill-runtime-setup.md` |
12
+ | runtime readiness | `skill-runtime-readiness.md` |
13
+ | MCP bridge conflicts (Path 1 + Path 2 + port 9876) | `skill-bridge-conflicts.md` |
14
+ | product hero scene plan | `skill-product-hero-scene-planner.md` |
15
+ | composition/camera | `skill-camera-composition.md` |
16
+ | lighting/material | `skill-lighting-material-plan.md` |
17
+ | scene quality gate | `skill-scene-readiness.md` |
18
+ | output looks wrong, root-cause analysis | `skill-blender-troubleshooting.md` |
19
+ | render/export evidence | `skill-render-export-evidence.md` |
20
+ | 7-point gate before any "ready" / `Verified` claim | `skill-pre-handoff-verification.md` |
21
+ | GLB/web handoff | `skill-glb-web-handoff.md` |
22
+ | plain-language final output | `skill-plain-language-response.md` |
23
+ | recipe / pack fit | `skill-recipe-fit-assessor.md` |
24
+ | pack pre-flight readiness | `skill-pack-prerequisite-checker.md` |
25
+ | resume / next skill routing | `skill-workflow-stage-router.md` |
26
+ | acceptance checklist authoring | `skill-acceptance-criteria-builder.md` |
27
+ | Path 1 vs Path 2 vs CLI decision | `skill-runtime-path-picker.md` |
28
+ | Path 1 Connector vs manual MCP | `skill-path-one-host-outline.md` |
29
+ | CLI appendix batch jobs | `skill-cli-appendix-job-outline.md` |
30
+ | runtime attempt provenance write-up | `skill-runtime-attempt-report.md` |
31
+
32
+ Apply law and evidence references before final output.