blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,51 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-license-checker/SKILL.md and skills/asset-license-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-license-checker
3
+
4
+ Purpose: Verify license compliance for downloaded 3D assets, textures, HDRIs, fonts before scene build or export.
5
+
6
+ Catch license risk before assets go into a scene that will be rendered, exported, or shipped. This is a planning / validation skill — does not modify assets, does not consult lawyers.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `asset-license-and-provenance-gate` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - Immediately after `asset-discovery` produces a candidate asset list.
12
+ - Before handing off to `asset-style-check`, `asset-library-plan`, or scene planners (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`).
13
+ - Before `pre-handoff-verification`, `render-export-evidence`, `glb-web-handoff`, or `glb-animation-handoff`.
14
+ - Whenever a previously sourced asset's license or attribution requirement is unclear.
15
+ - Trigger phrases: "is this license OK", "can I use this commercially", "what's the license", "license check"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - Sourcing or searching for candidate assets → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
19
+ - Checking visual consistency, scale, or aesthetic fit across assets → use `asset-style-check` (`references/skill-asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
20
+ - Replacing or working around rejected/blocked assets → use `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`; Delegates out-of-scope requests to asset-fallback-strategy)
21
+ - Structuring folders, naming conventions, or catalog storage → use `asset-library-plan` (`references/skill-asset-library-plan.md`; Delegates out-of-scope requests to asset-library-plan)
22
+ - First-party assets authored entirely in-house with no external dependencies. → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
23
+ - Legal advice or binding legal interpretation (this skill flags risk only; escalate ambiguity to legal). → use `asset-style-check` (`references/skill-asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
24
+
25
+ ## Input & output contract
26
+ - Required input `candidate_assets` (`array`): Candidate external 3D models, textures, and HDRIs with source URLs and license labels
27
+ - Required input `intended_distribution_use` (`string`): Target distribution context (commercial product marketing, web redistribution, internal preview)
28
+ - Optional input `attribution_delivery_surface` (`string`): Where attribution credits can be displayed if CC-BY-4.0 assets are used
29
+ - Output contract: `per_asset_license_verdict_table`, `attribution_obligations_list`, `quarantined_or_blocked_assets` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. Receive the sourced external asset list from `asset-discovery` (models, textures, HDRIs, fonts, sounds, brushes).
33
+ 2. Record source URL, documented license name, and stated permissions per asset.
34
+ 3. Flag risk per asset (`Pass` / `Warn` / `Fail`) and specify required attribution lines and attribution plan.
35
+ 4. Gate progression: hand off to `asset-style-check`, `asset-library-plan`, or `workflow-stage-router` only if all rows are `Pass` or explicitly accepted `Warn`; route any `Fail` rows to `asset-fallback-strategy`.
36
+
37
+ ## Cross-skill handoffs
38
+ - [upstream_reference] Upstream asset sourcing → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
39
+ - [progression] Visual style validation → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
40
+ - [fallback] Rejected/blocked asset handling → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
41
+ - [progression] Asset library organization → `asset-library-plan` (`references/skill-asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
42
+ - [progression] Stage routing & scene planning gate → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
43
+
44
+ ## Safety boundaries & non-goals
45
+ - Runtime boundary: Validation skill — does not modify assets, does not run Blender. Verdicts are based on documented license terms, not legal interpretation. **Not legal advice**: when in doubt, recommend the user consult their legal team.
46
+ - Give legal advice or interpret complex contracts (escalate ambiguity to legal).
47
+ - Source or discover candidate assets (`asset-discovery`).
48
+ - Check visual style or aesthetic consistency (`asset-style-check`).
49
+ - Plan fallbacks or replacements for failed assets (`asset-fallback-strategy`).
50
+ - Organize asset libraries or folder structures (`asset-library-plan`).
51
+ - Modify asset files, write Python, or run Blender.
@@ -0,0 +1,52 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-style-check/SKILL.md and skills/asset-style-check/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # asset-style-check
3
+
4
+ Purpose: Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.
5
+
6
+ Catch style mismatches between assets before they end up in the same scene where the inconsistency reads as compositing error.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `cross-asset-visual-coherence-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - after `asset-license-checker` clears the assets
12
+ - before scene build
13
+ - when a scene preview shows visible style mismatch
14
+ - when assets come from multiple sources
15
+ - Trigger phrases: "do these assets fit together", "style check the assets", "scene feels like a collage"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - single isolated asset where no multi-asset or scene-brief consistency check is requested → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
19
+ - pure planning before candidate assets are picked → use `asset-discovery` (`references/skill-asset-discovery.md`; use asset-discovery)
20
+ - intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles → use `asset-license-checker` (`references/skill-asset-license-checker.md`; Delegates out-of-scope requests to asset-license-checker)
21
+ - checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light → use `asset-license-checker` (`references/skill-asset-license-checker.md`; lighting-material-plan)
22
+
23
+ ## Input & output contract
24
+ - Required input `candidate_asset_list` (`array`): Sourced 3D models, materials, and props to evaluate for visual coherence
25
+ - Required input `brief_style_direction` (`string`): Pinned visual style, proportion language, texel density, and surface wear target from brief
26
+ - Optional input `hero_anchor_asset` (`string`): Primary hero asset used as the visual benchmark for secondary props
27
+ - Output contract: `style_coherence_matrix`, `mismatched_asset_flags`, `remediation_or_fallback_recommendations` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
28
+
29
+ ## Quick-start steps
30
+ 1. list every asset planned for the scene
31
+ 2. evaluate each on style axes (realism / detail / color / surface)
32
+ 3. flag drift between assets
33
+ 4. recommend remediation (drop / restyle / replace)
34
+
35
+ ## Cross-skill handoffs
36
+ - [upstream_reference] Upstream discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
37
+ - [upstream_reference] Upstream license gate → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
38
+ - [upstream_reference] Upstream brief lock → `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 enforcement → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
40
+ - [fallback] Rejected asset fallback → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
41
+ - [progression] Approved asset organization → `asset-library-plan` (`references/skill-asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
42
+ - [progression] Broad scene review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
43
+ - [progression] Material & lookdev boundary (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
44
+ - [progression] Material & lookdev boundary (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
45
+ - [progression] Budget & topology boundary → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
46
+
47
+ ## Safety boundaries & non-goals
48
+ - Runtime boundary: Validation-only skill — never modifies or re-styles assets, and never executes Blender or Python. Per-asset verdicts (`Pass | Warn | Fail`) and drift classifications (`None | Minor | Major`) are derived solely from documented asset previews and the locked style brief, and are tracked separately from runtime/artifact truth states (which default to `Not Produced` for artifacts and are downgrade-only).
49
+ - Never modify or re-style assets.
50
+ - Never check asset licenses (belongs to `asset-license-checker`).
51
+ - Never check polycount budgets or mesh topology (belongs to `polycount-budget-checker`).
52
+ - Never execute Blender or Python code.
@@ -0,0 +1,43 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-brainstorming/SKILL.md and skills/blender-brainstorming/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-brainstorming
3
+
4
+ Purpose: Socratic exploration of a non-Blender-user's 3D intent before scene planning. Use when the request is vague, has multiple plausible interpretations, or needs creative scoping.
5
+
6
+ Run a structured Socratic brainstorming pass on a vague non-Blender-user 3D request before any scene planner, runtime readiness, or evidence skill is invoked. Surface the user's actual intent, missing constraints, and decision points so downstream skills do not waste effort on the wrong direction.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `pre-brief-ideation-and-clarification` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - the user request is short, ambiguous, or missing critical context (subject, mood, deliverable, evidence expectations)
12
+ - multiple plausible interpretations exist (e.g. "make me a cool product render" — what product, what mood, web or print, GLB or render?)
13
+ - the user is non-Blender-technical and may not realize what BlendOps must know to plan well
14
+ - before any planner skill (`product-hero-scene-planner`, `camera-composition`, …)
15
+ - Trigger phrases: "I want a 3D render of..." (vague)", "Make me something cool with...", "Help me plan a Blender scene" (no constraints given)", "I'm not sure what I want exactly...", "Brainstorm with me about..."
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - the user already provided a structured brief (route directly to intent-to-3d-brief-writer to lock the brief before any planner runs) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; route directly to intent-to-3d-brief-writer to lock the brief before any planner runs)
19
+ - the user explicitly asked to skip clarification (record explicit assumptions and route to intent-to-3d-brief-writer) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; record explicit assumptions and route to intent-to-3d-brief-writer)
20
+ - the user pushes for immediate execution rather than exploration → use `runtime-readiness` (`references/skill-runtime-readiness.md`; route to runtime-readiness)
21
+
22
+ ## Input & output contract
23
+ - Required input `initial_user_idea` (`string`): Vague, exploratory, or open-ended 3D concept from the user
24
+ - Optional input `brand_or_mood_references` (`array`): Optional mood keywords, reference products, or target audience notes
25
+ - Output contract: `divergent_concept_options`, `clarifying_questions_shortlist`, `recommended_direction_for_brief` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
26
+
27
+ ## Quick-start steps
28
+ 1. ask 3-5 minimum clarifying questions
29
+ 2. propose 2-3 alternative scopings
30
+ 3. end with a one-paragraph intent summary the user can confirm
31
+ 4. hand off to `intent-to-3d-brief-writer` once intent is confirmed
32
+
33
+ ## Cross-skill handoffs
34
+ - [progression] Lock the confirmed brief downstream → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
35
+ - [progression] User pushes for execution mid-brainstorm → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
36
+ - [progression] Explain blocked runtime status to user → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
37
+
38
+ ## Safety boundaries & non-goals
39
+ - Runtime boundary: This skill does not install Blender, run Blender, or configure any MCP path. It is text-only conversation.
40
+ - runtime setup
41
+ - artifact production
42
+ - deciding the final scene plan (that's the planner's job)
43
+ - one-shot interpretation of vague requests
@@ -0,0 +1,48 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-recipe-decomposer/SKILL.md and skills/blender-recipe-decomposer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-recipe-decomposer
3
+
4
+ Purpose: Break over-scoped Blender intent into 2-5 cohesive recipes with brief seeds, stop conditions, order, dependencies, shared assets, and handoffs.
5
+
6
+ When user intent is too big for one recipe (multiple deliverables, mixed modes, conflicting briefs), split it into smaller recipes that each fit the BlendOps recipe shape (brief → plan → assets → runtime → handoff).
7
+
8
+ Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `multi-deliverable-recipe-splitter` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - intent has multiple distinct deliverables (e.g., hero render + animation + GLB + variant grid)
12
+ - intent crosses multiple scene types (portrait + environment in one ask)
13
+ - previous attempts collapsed under their own scope
14
+ - before any planner runs
15
+ - Trigger phrases: "I want all of these", "this is a lot", "we'll need several outputs", "across these scenes"
16
+
17
+ ## When not to use (delegation boundaries)
18
+ - single deliverable that is already right-sized (hand off directly to intent-to-3d-brief-writer) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; hand off directly to intent-to-3d-brief-writer)
19
+ - pure exploration or open ideation → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming instead)
20
+ - after recipes are already split or running → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard for added scope or done-criteria to evaluate completion)
21
+
22
+ ## Input & output contract
23
+ - Required input `multi_deliverable_request` (`string`): User request spanning multiple scenes, deliverables, or incompatible output channels
24
+ - Required input `candidate_recipes` (`array`): Candidate BlendOps recipes or packs identified by recipe-fit-assessor
25
+ - Optional input `delivery_priority_order` (`array`): Optional user preference on which deliverable to ship first
26
+ - Output contract: `ordered_sub_workflow_tracks`, `shared_asset_and_brief_dependencies`, `first_track_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
27
+
28
+ ## Quick-start steps
29
+ 1. enumerate distinct deliverables in the user intent
30
+ 2. group them into 2-5 cohesive recipes and plan shared assets early
31
+ 3. give each recipe a name, one-line brief seed, one-line stop condition seed, explicit out-of-scope boundary, and handoff target
32
+ 4. pin recipe start order (linear or parallel-OK) and dependencies
33
+
34
+ ## Cross-skill handoffs
35
+ - [progression] Full brief authoring for each split recipe → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
36
+ - [progression] Pinning formal done conditions per recipe → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
37
+ - [progression] Workflow stage gates per recipe → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
38
+ - [progression] Handling scope added after splitting → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
39
+ - [upstream_reference] Pre-decomposition ideation when deliverables are unclear → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
40
+
41
+ ## Safety boundaries & non-goals
42
+ - Runtime boundary: Process / discipline skill — does not run Blender. Splits intent into recipe specs only.
43
+ - Run Blender, write Python, or render/export any artifacts.
44
+ - Author full 3D briefs (belongs to `intent-to-3d-brief-writer`).
45
+ - Pin formal acceptance/stop gates (belongs to `done-criteria`).
46
+ - Run per-recipe checklist stage gates (belongs to `stage-gates`).
47
+ - Enforce scope creep after recipes are already split (belongs to `scope-guard`).
48
+ - Make or upgrade runtime or artifact truth claims.
@@ -0,0 +1,59 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-troubleshooting/SKILL.md and skills/blender-troubleshooting/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blender-troubleshooting
3
+
4
+ Purpose: Structured 4-phase root-cause analysis when Blender output looks wrong. Use when render, export, scene, or handoff doesn't match intent and you need disciplined debug, not guesses.
5
+
6
+ Run a structured 4-phase root-cause analysis when a Blender output (render, export, GLB, preview, or final response) does not match the confirmed intent. Surface the actual cause before proposing any fix. Inspired by the `/systematic-debugging` skill in Anthropic Superpowers, adapted for Blender / non-Blender-user domain.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `scene-and-runtime-failure-diagnostician` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - a render came out black, blown out, missing assets, or just "wrong"
12
+ - a GLB export is empty, mis-scaled, or fails validation
13
+ - the non-Blender-user response sounds wrong (jargon-heavy, contradicted by evidence)
14
+ - the runtime smoke test passed but the recipe failed
15
+ - intent was clear but result diverges in a specific, reproducible way
16
+ - Trigger phrases: "the render looks wrong", "the GLB doesn't open / looks empty / is wrong scale", "the output doesn't match what I asked for", "why did it produce X instead of Y?", "debug this Blender output"
17
+
18
+ ## When not to use (delegation boundaries)
19
+ - the user has not yet stated a clear expected outcome (run intent-to-3d-brief-writer first) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; run intent-to-3d-brief-writer first)
20
+ - runtime has never been attempted (run runtime-readiness first) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; run runtime-readiness first)
21
+ - the request is creative iteration ("can we make it more dramatic"), not debugging → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
22
+ - the user wants a one-shot fix without diagnostic discipline → 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)
23
+
24
+ ## Input & output contract
25
+ - Required input `observed_symptom_or_error` (`string`): Observed render defect, broken GLB export, scale mismatch, or MCP execution failure
26
+ - Required input `active_workflow_context` (`object`): Current scene plan, runtime path, and recent actions preceding the failure
27
+ - Optional input `runtime_attempt_notes` (`string`): Optional error output or attempt timeline from runtime-attempt-report
28
+ - Output contract: `root_cause_classification`, `minimal_remediation_plan`, `reverification_target_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
29
+
30
+ ## Quick-start steps
31
+ 1. collect the symptom statement, expected outcome, and observed outcome
32
+ 2. run the 4 phases: reproduce → narrow → identify root cause → propose fix
33
+ 3. gate every conclusion on observable evidence
34
+ 4. hand off the fix proposal to the relevant planner / readiness / evidence skill
35
+
36
+ ## Cross-skill handoffs
37
+ - [upstream_reference] If divergence at intent (blender-brainstorming) → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
38
+ - [upstream_reference] If divergence at intent (intent-to-3d-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]`
39
+ - [conditional] If divergence at planning (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
40
+ - [conditional] If divergence at planning (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] If divergence at planning (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
42
+ - [alternative] If divergence at planning (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
43
+ - [alternative] If divergence at planning (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
44
+ - [alternative] If divergence at planning (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"]`
45
+ - [alternative] If divergence at planning (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"]`
46
+ - [upstream_reference] If divergence at execution (runtime-readiness) → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
47
+ - [fallback] If divergence at execution (bridge-conflicts) → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
48
+ - [upstream_reference] If divergence at execution (runtime-path-picker) → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
49
+ - [conditional] If divergence at output (glb-animation-handoff) → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
50
+ - [conditional] If divergence at output (glb-web-handoff) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
51
+ - [conditional] If divergence at output (render-export-evidence) → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
52
+ - [conditional] If divergence at response → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
53
+
54
+ ## Safety boundaries & non-goals
55
+ - Runtime boundary: This skill does not install Blender, run Blender, mutate scenes, render, export, or claim artifacts. It guides diagnosis. Any actual re-run goes through the relevant runtime skill (`runtime-readiness`, `render-export-evidence`).
56
+ - running Blender
57
+ - writing fix code
58
+ - guessing without evidence
59
+ - replacing the runtime evidence skill
@@ -0,0 +1,62 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blendops-help/SKILL.md and skills/blendops-help/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # blendops-help
3
+
4
+ Purpose: Route users to the right BlendOps skill, document, or next safe action without overclaiming runtime, artifact, or package readiness.
5
+
6
+ Help an agent or user decide the single safest next action in BlendOps when the goal is unclear, current status is unknown, or an entry point into skills, docs, runtime readiness, packaging, or release review is needed.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `ambiguous-intent-entry-router` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+ Routing precedence: group `entry-and-stage-routing`, rank `1` | activationGate: `goalClarity="ambiguous_or_mixed"`, `recipeSelected=false`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
10
+
11
+ ## When to use & trigger cues
12
+ - the user asks “what should I do next?” and the goal or current state is unclear
13
+ - the user is unsure how to enter the BlendOps skill catalog or documentation
14
+ - runtime, artifact, packaging, or release status is unknown and needs initial triage
15
+ - no workflow artifacts exist yet and the user needs a safe starting skill or doc
16
+ - an agent needs a concise entry-point recommendation before starting work
17
+ - Trigger phrases: "What should I do next?", "Which BlendOps skill should I use?", "Is this ready?", "Can I run the runtime eval?", "How do I package/install BlendOps?", "What is blocked?"
18
+
19
+ ## When not to use (delegation boundaries)
20
+ - The goal is clear, preflight is passed, and stage or artifact inventory already exists → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate)
21
+ - The goal is clear and the user wants to select the right recipe or pack → use `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`; Scores candidate recipes/packs and detects multi-deliverable scope)
22
+ - A recipe or pack is already selected and needs preflight readiness verification → use `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`; Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness)
23
+ - The user explicitly asks to turn an idea into a structured 3D brief → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Locks the canonical 8-slot 3D brief before scene planning)
24
+ - The user asks to plan a product-hero scene directly → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Handles domain-specific scene planning once brief and recipe are known)
25
+ - The user asks for render or export artifact verification → use `render-export-evidence` (`references/skill-render-export-evidence.md`; Classifies artifact truth states from on-disk paths and validation notes)
26
+ - The user asks for Blender MCP runtime preflight verification → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Verifies Path 1 or Path 2 runtime readiness without claiming execution)
27
+
28
+ ## Input & output contract
29
+ - Required input `user_request` (`string`): Ambiguous, mixed, or entry-level user question about BlendOps capabilities or next action
30
+ - Optional input `current_status_context` (`object`): Optional context about known files, docs, or blockers
31
+ - Output contract: `recommended_next_action`, `target_skill_or_doc`, `why_this_is_safe` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
32
+
33
+ ## Quick-start steps
34
+ 1. Ask for the current goal and status if missing.
35
+ 2. If the goal is already clear and artifacts exist, hand off immediately to `workflow-stage-router`.
36
+ 3. Otherwise, identify whether the entry need is brief/planning setup, runtime readiness, evidence verification, install/package docs, or release review.
37
+ 4. Route to the single smallest safe skill or doc.
38
+ 5. Preserve release, runtime, and artifact truth (downgrade-only, never upgrade).
39
+
40
+ ## Cross-skill handoffs
41
+ - [progression] Recipe or pack selection when goal becomes clear → `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`) — `when.all: [goal.clarity equals "clear"; recipe.selected equals false]`
42
+ - [conditional] Pack preflight readiness check when recipe is already chosen → `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`) — `when.all: [recipe.selected equals true; preflight.passed equals false]`
43
+ - [conditional] In-flight workflow routing (clear goal + existing artifacts) → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [goal.clarity equals "clear"; preflight.passed equals true; inventory.exists equals true]`
44
+ - [progression] Initial 3D brief creation → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [brief.locked equals false]`
45
+ - [conditional] Runtime path selection → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [request.topic equals "runtime_selection"]`
46
+ - [conditional] Official runtime setup → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [request.topic equals "runtime_setup"]`
47
+ - [conditional] Runtime readiness preflight → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [request.topic equals "runtime_readiness"]`
48
+ - [fallback] MCP bridge port/session conflict → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
49
+ - [alternative] Scene planning → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.id equals "product-hero-v0"]`
50
+ - [conditional] Render/export evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [request.topic equals "artifact_evidence"]`
51
+ - [fallback] Failed workflow gate / pre-handoff check → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [gate.status equals "failed"]`
52
+ - [conditional] GLB handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [request.topic equals "glb_handoff"]`
53
+ - [progression] Final response → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
54
+
55
+ ## Safety boundaries & non-goals
56
+ - Runtime boundary: Before runtime work, point to `docs/runtime-stack-strategy.md`, `runtime-path-picker`, and `runtime-readiness`.
57
+ - Replace or duplicate `workflow-stage-router` precedence logic once the goal is clear and artifacts exist.
58
+ - Install Blender or runtimes.
59
+ - Run Blender or execute Python.
60
+ - Create or mutate scene data.
61
+ - Render/export artifacts.
62
+ - Publish packages or marketplace listings.
@@ -0,0 +1,48 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/bridge-conflicts/SKILL.md and skills/bridge-conflicts/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # bridge-conflicts
3
+
4
+ Purpose: Diagnose MCP bridge conflicts (Path 1 Official Blender Lab MCP 5.1+ vs Path 2 mcp-for-blender, port 9876 collisions, host mismatch) and hand off to runtime-readiness.
5
+
6
+ Resolve the single-bridge constraint when more than one MCP runtime path is configured against the same Blender instance (or when ports collide). Blender accepts only one MCP bridge session per instance (default port 9876) — so running Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) concurrently, connecting two MCP clients to one Blender instance, colliding on port 9876, or enabling both Path 1 host (a) and host (b) on one session causes inconsistent signals.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `port-and-addon-conflict-resolver` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - `runtime-readiness` reports inconsistent signals (e.g. host reports connected but tool calls return the wrong tool surface)
12
+ - both Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) add-ons are enabled in the same Blender instance
13
+ - two MCP clients are pointing at the same Blender instance (e.g. Claude Desktop with Connector + Cursor with manual MCP)
14
+ - Path 1 host (a) and host (b) are both active on a single session
15
+ - log or port output shows a collision on default port `9876`
16
+ - Trigger phrases: "tool surface looks wrong", "smoke test passed yesterday but recipe fails today", "Lab MCP and ahujasid both installed", "Claude Desktop and Cursor both pointing at Blender", "port 9876 already in use", "single-bridge constraint violation"
17
+
18
+ ## When not to use (delegation boundaries)
19
+ - no readiness signal yet (run runtime-readiness first) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; run runtime-readiness first)
20
+ - no runtime path has been chosen yet → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; route to runtime-path-picker)
21
+ - the user wants to switch or set up a path from scratch → use `runtime-setup` (`references/skill-runtime-setup.md`; route to runtime-setup)
22
+ - the bridge matrix is clean and only one path is active, but smoke tests still fail → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; route to blender-troubleshooting)
23
+ - the user explicitly wants both paths configured for separate Blender instances on different ports (requires explicit port isolation) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; requires explicit port isolation)
24
+
25
+ ## Input & output contract
26
+ - Required input `target_blender_instance` (`string`): Running Blender session identifier or binary path experiencing bridge or port collisions
27
+ - Required input `configured_mcp_hosts_and_addons` (`object`): Inventory of enabled Blender add-ons (Lab MCP vs mcp-for-blender) and active MCP client connections
28
+ - Optional input `port_9876_diagnostics` (`string`): Optional socket/port binding diagnostics around default port 9876
29
+ - Output contract: `bridge_conflict_diagnosis_matrix`, `single_bridge_isolation_steps`, `post_resolution_readiness_recheck_route` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
30
+
31
+ ## Quick-start steps
32
+ 1. list every active / configured bridge for the target Blender session
33
+ 2. check for port collision (commonly `localhost:9876`)
34
+ 3. identify which path is intended; which is residual
35
+ 4. propose the cheapest disable / port-isolation step
36
+ 5. hand off to `runtime-readiness` to re-verify
37
+
38
+ ## Cross-skill handoffs
39
+ - [upstream_reference] When runtime-readiness reports inconsistent signals → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
40
+ - [fallback] If the bridge matrix is clean but failures persist → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
41
+ - [upstream_reference] If the user wants to change paths or set up a path → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
42
+ - [upstream_reference] If the intended runtime path has not been chosen yet → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
43
+
44
+ ## Safety boundaries & non-goals
45
+ - Runtime boundary: This skill never disables add-ons, edits MCP client configs, changes ports, kills processes, or runs Blender. It only diagnoses the conflict, proposes the cheapest resolution for the operator to perform, and hands off to `runtime-readiness`.
46
+ - Disabling add-ons, editing MCP client configs, changing ports, killing processes, or running Blender
47
+ - Upgrading Runtime or Artifact truth states
48
+ - Replacing `runtime-readiness`, `runtime-path-picker`, `runtime-setup`, or `blender-troubleshooting`
@@ -0,0 +1,48 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/camera-composition/SKILL.md and skills/camera-composition/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # camera-composition
3
+
4
+ Purpose: Provide detailed composition and camera planning for product hero outputs.
5
+
6
+ Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `camera-rig-and-composition-deep-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
12
+ - defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
13
+ - aligning hero framing and negative space with web/UI copy overlays
14
+ - Trigger phrases: "improve composition and camera", "choose hero framing", "set camera strategy for product hero"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - as proof of rendered output quality or to validate an existing framing → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
18
+ - to design lighting rigs or surface materials/lookdev → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; use lighting-material-plan)
19
+ - to lock final pixel resolution or output aspect specs → use `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`; use resolution-aspect-decision)
20
+ - to choose delivery file formats → use `output-format-decision` (`references/skill-output-format-decision.md`; use output-format-decision)
21
+ - when subject intent is undefined → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
22
+
23
+ ## Input & output contract
24
+ - Required input `domain_scene_plan` (`object`): Upstream scene layout plan defining subject scale, staging, and depth layers
25
+ - Required input `framing_goal` (`string`): Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)
26
+ - Optional input `pinned_aspect_ratio` (`string`): Aspect ratio lock from resolution-aspect-decision
27
+ - Output contract: `camera_rig_specification`, `focal_length_and_dof_plan`, `composition_anchor_guidelines` (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 → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
37
+ - [conditional] Lateral output specs (if needed) (output-format-decision) → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
38
+ - [conditional] Lateral output specs (if needed) (resolution-aspect-decision) → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
39
+ - [progression] Next (lookdev & lighting) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
40
+ - [progression] Then (validation) (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
41
+ - [progression] Then (validation) (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
42
+
43
+ ## Safety boundaries & non-goals
44
+ - Runtime boundary: Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. Runtime status stays `Not Run` and artifacts stay `Not Produced` (truth states are downgrade-only, never upgraded without verified evidence).
45
+ - executing Blender commands, writing Python scripts, or generating scene/render artifacts
46
+ - designing lighting setups or materials (owned by `lighting-material-plan`)
47
+ - validating or scoring completed scene framing (owned by `composition-quality-checker`)
48
+ - locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
@@ -0,0 +1,50 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/character-portrait/SKILL.md and skills/character-portrait/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # character-portrait
3
+
4
+ Purpose: Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
5
+
6
+ Translate a single-subject character-portrait intent (subject identity, pose, expression, wardrobe, framing, lighting, background) into a structured scene plan with an explicit assumptions register. Distinct from `product-hero-scene-planner` (manufactured products), `environment-shot` (places), and `interior-scene` (rooms). Multi-character ensembles are out of scope. Hands off framing deep-dives to `camera-composition`, lookdev deep-dives to `lighting-material-plan`, assets to `asset-discovery`, and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `character-portrait-and-turntable-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - intent is explicitly a character / person / creature portrait
12
+ - before any modeling or scene file is built
13
+ - when the consumer is editorial / brand / catalog / cinematic
14
+ - Trigger phrases: "portrait of", "character looking at the camera", "headshot", "hero shot of [person / mascot / creature]"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - product hero scenes → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
18
+ - environment establishing shots → use `environment-shot` (`references/skill-environment-shot.md`; use environment-shot)
19
+ - interior arch viz → use `interior-scene` (`references/skill-interior-scene.md`; use interior-scene)
20
+ - multi-character ensemble (this skill is single-subject) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; this skill is single-subject)
21
+
22
+ ## Input & output contract
23
+ - Required input `locked_3d_brief` (`object`): Locked 3D brief specifying character subject, expression/pose, and framing intent
24
+ - Required input `character_asset_posture` (`object`): Available character model/rig status and material readiness from asset discovery
25
+ - Optional input `turntable_or_still_preference` (`string`): Whether the deliverable is a portrait still, bust turntable, or full-body pose
26
+ - Output contract: `character_staging_and_pose_plan`, `eyeline_and_portrait_camera_anchors`, `skin_hair_rim_lighting_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
27
+
28
+ ## Quick-start steps
29
+ 1. confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
30
+ 2. confirm likeness rights before use if the subject is a real person
31
+ 3. pin subject identity, pose, expression, wardrobe, framing, lighting, and background
32
+ 4. record an explicit assumptions register
33
+ 5. flag needed assets for `asset-discovery`
34
+ 6. emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
35
+
36
+ ## Cross-skill handoffs
37
+ - [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]`
38
+ - [progression] Framing deep-dive → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
39
+ - [progression] Lookdev deep-dive → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
40
+ - [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
41
+ - [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
42
+ - [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
43
+ - [progression] Scene quality validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
44
+
45
+ ## Safety boundaries & non-goals
46
+ - Runtime boundary: Planning-only skill: no modeling, no animation, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief is unclear, hand off to `intent-to-3d-brief-writer`.
47
+ - Model the character.
48
+ - Animate the character.
49
+ - Render.
50
+ - Run Blender.
@@ -0,0 +1,44 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cli-appendix-job-outline/SKILL.md and skills/cli-appendix-job-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # cli-appendix-job-outline
3
+
4
+ Purpose: Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.
5
+
6
+ Structure **CLI fallback appendix** jobs (batch render, batch export, scripted scene setup) using Blender's documented command-line interface — without presenting arbitrary Python as the user-facing product surface.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `headless-cli-batch-job-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - CI / render farm / repeatable exports
12
+ - MCP unavailable or disallowed by policy
13
+ - deterministic batch operations vs exploratory modeling
14
+ - Trigger phrases: "headless blender", "batch render CLI", "blender --background", "render farm outline"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - interactive viewport iteration primary goal → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
18
+ - user expects Connector chat loop → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
19
+
20
+ ## Input & output contract
21
+ - Required input `target_blend_scene_and_outputs` (`object`): Source .blend file expectations and target render/export output deliverables
22
+ - Required input `execution_environment_constraints` (`string`): Headless CI, render node, or local batch constraints selected via runtime-path-picker
23
+ - Optional input `frame_range_or_batch_items` (`array`): Optional frame range or batch variant list for headless execution
24
+ - Output contract: `headless_cli_job_outline`, `appendix_governance_and_backup_gates`, `expected_output_evidence_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
25
+
26
+ ## Quick-start steps
27
+ 1. classify job type via `skills/cli-appendix-job-outline/references/job-type-matrix.md`
28
+ 2. capture ordering cautions `skills/cli-appendix-job-outline/references/flag-order-reminders.md`
29
+ 3. state limitations `skills/cli-appendix-job-outline/references/stateless-limitations.md`
30
+ 4. point user to upstream CLI manual for exact flags
31
+
32
+ ## Cross-skill handoffs
33
+ - [upstream_reference] Pick MCP vs CLI → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
34
+ - [upstream_reference] Interactive MCP host outline → `path-one-host-outline` (`references/skill-path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
35
+ - [progression] Export format choices → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
36
+ - [progression] Actual CLI output evidence recording → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
37
+ - [progression] Runtime attempt reporting → `runtime-attempt-report` (`references/skill-runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
38
+
39
+ ## Safety boundaries & non-goals
40
+ - Runtime boundary: Planning outline only — BlendOps never executes Blender and never presents arbitrary Python as the product surface. This CLI workflow is an **appendix only**, never a peer path without an eval record, and BlendOps has **no in-repo CLI evidence file yet**. Point users to the upstream Blender manual for exact CLI flags.
41
+ - Generating or debugging user-facing Python (`bpy`) scripts.
42
+ - Executing `blender --background` jobs or inspecting output files directly.
43
+ - Selecting between MCP Path 1, Path 2, and CLI (owned by `runtime-path-picker`).
44
+ - Certifying rendered frames or exported GLBs (owned by `render-export-evidence`).
@@ -0,0 +1,50 @@
1
+ <!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/color-management-decision/SKILL.md and skills/color-management-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
2
+ # color-management-decision
3
+
4
+ Purpose: Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.
5
+
6
+ Avoid the most common Blender color mistake: rendering with the wrong color space and then "fixing" it in post. Pick the color management strategy upfront based on the consumer's color pipeline.
7
+
8
+ Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `view-transform-and-colorspace-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
9
+
10
+ ## When to use & trigger cues
11
+ - before render / lookdev pass
12
+ - when consumer color pipeline is known
13
+ - when a previous render had unexpected color shifts
14
+ - Trigger phrases: "what color space", "Filmic vs Standard", "ACEScg for our pipeline", "colors look weird"
15
+
16
+ ## When not to use (delegation boundaries)
17
+ - Post-render color grading or soft-proofing (handled by compositor / DCC after render). → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
18
+ - Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker). → use `material-quality-checker` (`references/skill-material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
19
+ - Selecting file formats or bit depths (output-format-decision). → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
20
+ - Choosing the render engine (cycles-vs-eevee-decision). → use `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
21
+ - Monitor hardware calibration (out of scope). → use `material-quality-checker` (`references/skill-material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
22
+ - Raw modeling without lookdev (color management does not affect geometry accuracy). → use `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
23
+
24
+ ## Input & output contract
25
+ - Required input `target_delivery_pipeline` (`string`): Target display or compositing pipeline (web sRGB, product brand match, ACEScg VFX, HDR)
26
+ - Required input `blender_version_posture` (`string`): Target Blender version family (3.6 LTS Filmic, 4.0+ AgX, 5.1+ AgX/ACES)
27
+ - Optional input `brand_hex_swatch_constraints` (`array`): Optional strict brand hex colors requiring Standard vs tone-mapped tradeoffs
28
+ - Output contract: `pinned_view_transform_and_look`, `display_and_working_colorspace_spec`, `cross_engine_and_web_color_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
29
+
30
+ ## Quick-start steps
31
+ 1. Identify the consumer pipeline (`web sRGB` / `film/VFX ACES linear` / `game engine` / `print` / `GLB-Three.js`).
32
+ 2. Pin the 4-line render color config: `Display Device`, `View Transform`, `Look`, and `Sequencer`.
33
+ 3. Define per-output color transforms if multiple outputs exist.
34
+ 4. Emit the 4-line config record, caveats, truth states (`Not Run` / `Not Produced`), and handoff.
35
+
36
+ ## Cross-skill handoffs
37
+ - [progression] Output format selection → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
38
+ - [progression] Material texture color spaces → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
39
+ - [progression] Render engine choice → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
40
+ - [progression] GLB Three.js delivery → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
41
+ - [progression] Render evidence verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
42
+
43
+ ## Safety boundaries & non-goals
44
+ - Runtime boundary: Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
45
+ - Validate per-material texture color spaces (`material-quality-checker`).
46
+ - Choose output file formats or bit depths (`output-format-decision`).
47
+ - Choose the render engine (`cycles-vs-eevee-decision`).
48
+ - Perform post-render color grading (belongs to compositor / DCC).
49
+ - Calibrate a physical monitor (out of scope).
50
+ - Run Blender or execute renders.