blendops 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/LICENSE +21 -0
  3. package/README.md +189 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +72 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/examples/glb-web-handoff/README.md +174 -0
  136. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  137. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  138. package/docs/knowledge-and-recipe-catalog.md +236 -0
  139. package/docs/recipes/README.md +27 -0
  140. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  141. package/docs/workflows/README.md +14 -0
  142. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  143. package/docs/workflows/product-hero-workflow.md +92 -0
  144. package/laws/README.md +32 -0
  145. package/laws/evidence-before-done.md +37 -0
  146. package/laws/no-arbitrary-python-interface.md +32 -0
  147. package/laws/non-blender-user-language.md +32 -0
  148. package/laws/official-runtime-only.md +78 -0
  149. package/package.json +99 -4
  150. package/packs/README.md +11 -0
  151. package/packs/product-hero-v0/PACK.md +114 -0
  152. package/registry/catalog-index.json +21344 -0
  153. package/registry/compatibility-matrix.json +533 -0
  154. package/registry/contract-context-fields.json +391 -0
  155. package/registry/knowledge-catalog.json +4648 -0
  156. package/registry/knowledge-sources.json +438 -0
  157. package/registry/recipe-catalog.json +2565 -0
  158. package/registry/runtime-capability-policy.json +525 -0
  159. package/registry/runtime-operations.json +4468 -0
  160. package/registry/skills.json +10231 -0
  161. package/registry/workflow-graph.json +7390 -0
  162. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  163. package/schemas/contract-context-fields.schema.json +147 -0
  164. package/schemas/execution-plan.schema.json +325 -0
  165. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  166. package/schemas/knowledge-record.schema.json +460 -0
  167. package/schemas/knowledge-source-registry.schema.json +268 -0
  168. package/schemas/operation-execution-ledger.schema.json +348 -0
  169. package/schemas/recipe-record.schema.json +469 -0
  170. package/schemas/runtime-capability-policy.schema.json +184 -0
  171. package/schemas/runtime-evidence-packet.schema.json +211 -0
  172. package/schemas/runtime-operations.schema.json +535 -0
  173. package/schemas/runtime-qualification-report.schema.json +540 -0
  174. package/schemas/runtime-session.schema.json +350 -0
  175. package/schemas/scene-spec.schema.json +624 -0
  176. package/schemas/skill-contract.schema.json +402 -0
  177. package/schemas/skill-eval.schema.json +509 -0
  178. package/scripts/build-knowledge-catalog.mjs +2376 -0
  179. package/scripts/compile-scene-plan.mjs +1945 -0
  180. package/scripts/export-claude-skills.mjs +634 -0
  181. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  182. package/scripts/inspect-glb.mjs +1627 -0
  183. package/scripts/install-skills.mjs +5369 -0
  184. package/scripts/runtime-orchestrator.mjs +7652 -0
  185. package/scripts/validate-capability-policy.mjs +531 -0
  186. package/scripts/validate-evidence-packet.mjs +256 -0
  187. package/skills/README.md +315 -0
  188. package/skills/_template/SKILL.md +296 -0
  189. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  190. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  191. package/skills/acceptance-criteria-builder/contract.json +205 -0
  192. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  193. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  195. package/skills/asset-discovery/EVAL.md +81 -0
  196. package/skills/asset-discovery/SKILL.md +252 -0
  197. package/skills/asset-discovery/contract.json +291 -0
  198. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  199. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  200. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  201. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  202. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  203. package/skills/asset-fallback-strategy/contract.json +190 -0
  204. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  205. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  206. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  207. package/skills/asset-library-plan/EVAL.md +28 -0
  208. package/skills/asset-library-plan/SKILL.md +263 -0
  209. package/skills/asset-library-plan/contract.json +177 -0
  210. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  211. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  212. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  213. package/skills/asset-license-checker/EVAL.md +33 -0
  214. package/skills/asset-license-checker/SKILL.md +245 -0
  215. package/skills/asset-license-checker/contract.json +172 -0
  216. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  217. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  218. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  219. package/skills/asset-style-check/EVAL.md +26 -0
  220. package/skills/asset-style-check/SKILL.md +238 -0
  221. package/skills/asset-style-check/contract.json +251 -0
  222. package/skills/asset-style-check/references/drift-classification.md +40 -0
  223. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  224. package/skills/asset-style-check/references/style-axes.md +46 -0
  225. package/skills/blender-brainstorming/EVAL.md +79 -0
  226. package/skills/blender-brainstorming/SKILL.md +228 -0
  227. package/skills/blender-brainstorming/contract.json +115 -0
  228. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  229. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  230. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  231. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  232. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  233. package/skills/blender-recipe-decomposer/contract.json +152 -0
  234. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  235. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  237. package/skills/blender-troubleshooting/EVAL.md +78 -0
  238. package/skills/blender-troubleshooting/SKILL.md +263 -0
  239. package/skills/blender-troubleshooting/contract.json +352 -0
  240. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  241. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  242. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  243. package/skills/blendops-help/EVAL.md +67 -0
  244. package/skills/blendops-help/SKILL.md +312 -0
  245. package/skills/blendops-help/contract.json +229 -0
  246. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  247. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  248. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  249. package/skills/bridge-conflicts/EVAL.md +83 -0
  250. package/skills/bridge-conflicts/SKILL.md +246 -0
  251. package/skills/bridge-conflicts/contract.json +145 -0
  252. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  253. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  254. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  255. package/skills/camera-composition/EVAL.md +32 -0
  256. package/skills/camera-composition/SKILL.md +196 -0
  257. package/skills/camera-composition/contract.json +180 -0
  258. package/skills/camera-composition/references/camera-presets.md +30 -0
  259. package/skills/camera-composition/references/camera-rubric.md +24 -0
  260. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  261. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  262. package/skills/character-portrait/EVAL.md +42 -0
  263. package/skills/character-portrait/SKILL.md +245 -0
  264. package/skills/character-portrait/contract.json +205 -0
  265. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  266. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  267. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  268. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  269. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  270. package/skills/cli-appendix-job-outline/contract.json +147 -0
  271. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  272. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  273. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  274. package/skills/color-management-decision/EVAL.md +28 -0
  275. package/skills/color-management-decision/SKILL.md +254 -0
  276. package/skills/color-management-decision/contract.json +162 -0
  277. package/skills/color-management-decision/references/look-comparison.md +44 -0
  278. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  279. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  280. package/skills/composition-quality-checker/EVAL.md +38 -0
  281. package/skills/composition-quality-checker/SKILL.md +260 -0
  282. package/skills/composition-quality-checker/contract.json +221 -0
  283. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  284. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  285. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  286. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  287. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  288. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  289. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  290. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  291. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  292. package/skills/done-criteria/EVAL.md +33 -0
  293. package/skills/done-criteria/SKILL.md +225 -0
  294. package/skills/done-criteria/contract.json +199 -0
  295. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  296. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  297. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  298. package/skills/environment-shot/EVAL.md +44 -0
  299. package/skills/environment-shot/SKILL.md +237 -0
  300. package/skills/environment-shot/contract.json +162 -0
  301. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  302. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  303. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  304. package/skills/glb-animation-handoff/EVAL.md +39 -0
  305. package/skills/glb-animation-handoff/SKILL.md +271 -0
  306. package/skills/glb-animation-handoff/contract.json +247 -0
  307. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  308. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  309. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  310. package/skills/glb-web-handoff/EVAL.md +33 -0
  311. package/skills/glb-web-handoff/SKILL.md +212 -0
  312. package/skills/glb-web-handoff/contract.json +171 -0
  313. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  314. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  315. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  316. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  317. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  318. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  319. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  320. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  321. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  322. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  323. package/skills/interior-scene/EVAL.md +44 -0
  324. package/skills/interior-scene/SKILL.md +261 -0
  325. package/skills/interior-scene/contract.json +277 -0
  326. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  327. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  328. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  329. package/skills/lighting-material-plan/EVAL.md +32 -0
  330. package/skills/lighting-material-plan/SKILL.md +194 -0
  331. package/skills/lighting-material-plan/contract.json +213 -0
  332. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  333. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  334. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  335. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  336. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  337. package/skills/lighting-quality-checker/EVAL.md +41 -0
  338. package/skills/lighting-quality-checker/SKILL.md +247 -0
  339. package/skills/lighting-quality-checker/contract.json +187 -0
  340. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  341. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  342. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  343. package/skills/material-quality-checker/EVAL.md +40 -0
  344. package/skills/material-quality-checker/SKILL.md +261 -0
  345. package/skills/material-quality-checker/contract.json +244 -0
  346. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  347. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  348. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  349. package/skills/mobile-glb-budget/EVAL.md +40 -0
  350. package/skills/mobile-glb-budget/SKILL.md +264 -0
  351. package/skills/mobile-glb-budget/contract.json +309 -0
  352. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  353. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  354. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  355. package/skills/output-format-decision/EVAL.md +27 -0
  356. package/skills/output-format-decision/SKILL.md +222 -0
  357. package/skills/output-format-decision/contract.json +179 -0
  358. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  359. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  360. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  361. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  362. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  363. package/skills/pack-prerequisite-checker/contract.json +214 -0
  364. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  365. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  366. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  367. package/skills/path-one-host-outline/EVAL.md +26 -0
  368. package/skills/path-one-host-outline/SKILL.md +251 -0
  369. package/skills/path-one-host-outline/contract.json +167 -0
  370. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  371. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  372. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  373. package/skills/plain-language-response/EVAL.md +33 -0
  374. package/skills/plain-language-response/SKILL.md +194 -0
  375. package/skills/plain-language-response/contract.json +242 -0
  376. package/skills/plain-language-response/references/caveat-language.md +25 -0
  377. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  378. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  379. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  380. package/skills/polycount-budget-checker/EVAL.md +40 -0
  381. package/skills/polycount-budget-checker/SKILL.md +251 -0
  382. package/skills/polycount-budget-checker/contract.json +196 -0
  383. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  384. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  385. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  386. package/skills/pre-handoff-verification/EVAL.md +84 -0
  387. package/skills/pre-handoff-verification/SKILL.md +252 -0
  388. package/skills/pre-handoff-verification/contract.json +295 -0
  389. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  390. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  391. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  392. package/skills/preview-report/EVAL.md +39 -0
  393. package/skills/preview-report/SKILL.md +254 -0
  394. package/skills/preview-report/contract.json +141 -0
  395. package/skills/preview-report/references/handoff-recipients.md +41 -0
  396. package/skills/preview-report/references/report-schema.md +60 -0
  397. package/skills/preview-report/references/truth-label-rules.md +36 -0
  398. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  399. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  400. package/skills/product-grid-scene-planner/contract.json +257 -0
  401. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  402. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  403. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  404. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  405. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  406. package/skills/product-hero-scene-planner/contract.json +228 -0
  407. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  408. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  409. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  410. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  411. package/skills/r3f-component-plan/EVAL.md +43 -0
  412. package/skills/r3f-component-plan/SKILL.md +290 -0
  413. package/skills/r3f-component-plan/contract.json +171 -0
  414. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  415. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  416. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  417. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  418. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  419. package/skills/recipe-fit-assessor/contract.json +220 -0
  420. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  421. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  422. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  423. package/skills/render-export-evidence/EVAL.md +86 -0
  424. package/skills/render-export-evidence/SKILL.md +339 -0
  425. package/skills/render-export-evidence/contract.json +206 -0
  426. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  427. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  428. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  429. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  430. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  431. package/skills/resolution-aspect-decision/contract.json +160 -0
  432. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  433. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  434. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  435. package/skills/runtime-attempt-report/EVAL.md +26 -0
  436. package/skills/runtime-attempt-report/SKILL.md +268 -0
  437. package/skills/runtime-attempt-report/contract.json +176 -0
  438. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  439. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  440. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  441. package/skills/runtime-path-picker/EVAL.md +26 -0
  442. package/skills/runtime-path-picker/SKILL.md +268 -0
  443. package/skills/runtime-path-picker/contract.json +191 -0
  444. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  445. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  446. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  447. package/skills/runtime-readiness/EVAL.md +33 -0
  448. package/skills/runtime-readiness/SKILL.md +218 -0
  449. package/skills/runtime-readiness/contract.json +190 -0
  450. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  451. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  452. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  453. package/skills/runtime-setup/EVAL.md +33 -0
  454. package/skills/runtime-setup/SKILL.md +209 -0
  455. package/skills/runtime-setup/contract.json +171 -0
  456. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  457. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  458. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  459. package/skills/scene-readiness/EVAL.md +33 -0
  460. package/skills/scene-readiness/SKILL.md +195 -0
  461. package/skills/scene-readiness/contract.json +198 -0
  462. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  463. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  464. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  465. package/skills/scene-readiness/references/verdict-language.md +22 -0
  466. package/skills/scope-guard/EVAL.md +33 -0
  467. package/skills/scope-guard/SKILL.md +222 -0
  468. package/skills/scope-guard/contract.json +171 -0
  469. package/skills/scope-guard/references/options-language-template.md +51 -0
  470. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  471. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  472. package/skills/stage-gates/EVAL.md +40 -0
  473. package/skills/stage-gates/SKILL.md +257 -0
  474. package/skills/stage-gates/contract.json +490 -0
  475. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  476. package/skills/stage-gates/references/gate-template.md +46 -0
  477. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  478. package/skills/workflow-stage-router/EVAL.md +25 -0
  479. package/skills/workflow-stage-router/SKILL.md +259 -0
  480. package/skills/workflow-stage-router/contract.json +150 -0
  481. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  482. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  483. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  484. package/skills.sh.json +102 -0
@@ -0,0 +1,196 @@
1
+ ---
2
+ name: camera-composition
3
+ description: Plan hero camera framing, 35-105mm focal lengths, composition hierarchy, and web copy-safe negative space before lighting or rendering.
4
+ ---
5
+
6
+ # camera-composition
7
+
8
+ ## Purpose
9
+ Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
10
+
11
+ ## Quick start
12
+ - confirm this skill fits your goal
13
+ - provide required inputs first
14
+ - keep runtime claims evidence-bound
15
+ - follow suggested next-skill handoff
16
+
17
+ ## When to use
18
+ - expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
19
+ - defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
20
+ - aligning hero framing and negative space with web/UI copy overlays
21
+
22
+ ## When not to use
23
+ <!-- blendops:generated:start exclusions -->
24
+ - as proof of rendered output quality or to validate an existing framing → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
25
+ - to design lighting rigs or surface materials/lookdev → use `../lighting-material-plan/SKILL.md` (use lighting-material-plan)
26
+ - to lock final pixel resolution or output aspect specs → use `../resolution-aspect-decision/SKILL.md` (use resolution-aspect-decision)
27
+ - to choose delivery file formats → use `../output-format-decision/SKILL.md` (use output-format-decision)
28
+ - when subject intent is undefined → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
29
+ <!-- blendops:generated:end exclusions -->
30
+
31
+ ## Trigger phrases
32
+ <!-- blendops:generated:start triggers -->
33
+ - "improve composition and camera"
34
+ - "choose hero framing"
35
+ - "set camera strategy for product hero"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - upstream scene concept from `product-hero-scene-planner` (or clear subject and destination context) available
40
+ - planning-only boundary accepted: runtime status remains `Not Run` and artifacts remain `Not Produced`
41
+
42
+ ## Input schema
43
+
44
+ ### Required inputs
45
+ - subject intent (from `product-hero-scene-planner` or user brief)
46
+ - target output context (web/app/game/render)
47
+
48
+ ### Optional inputs
49
+ - target aspect ratio constraints (from `resolution-aspect-decision` if already locked)
50
+ - UI/copy overlay constraints
51
+ - cinematic vs neutral tone preference
52
+
53
+ ### Assumptions to confirm
54
+ - need for negative space
55
+ - focal detail priority
56
+ - camera motion vs static hero shot intent
57
+
58
+ ## Output schema
59
+
60
+ ### Primary output
61
+ - composition-camera plan with plain-language rationale
62
+
63
+ ### Secondary output
64
+ - fallback framing variant for uncertain constraints
65
+
66
+ ### Evidence / caveat output
67
+ - unresolved visual assumptions
68
+ - explicit truth states: Runtime `Not Run`, Artifacts `Not Produced` (downgrade-only, never upgrade)
69
+
70
+ ## Required laws
71
+ - ../../laws/non-blender-user-language.md
72
+ - ../../laws/evidence-before-done.md
73
+ - ../../laws/official-runtime-only.md
74
+ - ../../laws/no-arbitrary-python-interface.md
75
+
76
+ ## Official runtime boundary
77
+ 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).
78
+
79
+ ## Operating procedure
80
+ 1. Define focal hierarchy (primary/secondary/background).
81
+ 2. Define hero-section objective and viewer attention path.
82
+ 3. Select aspect ratio framing strategy (deferring final resolution/aspect locks to `resolution-aspect-decision`).
83
+ 4. Reserve negative space for UI/text overlays if needed.
84
+ 5. Choose camera angle preset family.
85
+ 6. Set focal length guidance by mood (dramatic vs neutral).
86
+ 7. Define depth layering (foreground/midground/background).
87
+ 8. Define target silhouette/readability checks (for later validation by `composition-quality-checker`).
88
+ 9. Produce fallback framing variant for uncertainty.
89
+ 10. Translate plan into plain-language rationale.
90
+
91
+ ## Decision tree
92
+ - If copy overlay required → prioritize negative space and silhouette.
93
+ - If product detail priority high → tighter framing and controlled depth.
94
+ - If uncertainty high → provide two options and ask preference.
95
+
96
+ ## Playbooks
97
+ - Playbook A: Full brief path — expand upstream `product-hero-scene-planner` output into primary framing + fallback variant (`Runtime: Not Run`, `Artifacts: Not Produced`).
98
+ - Playbook B: Overlay-heavy path — prioritize negative space and silhouette separation for UI/copy constraints (`Runtime: Not Run`, `Artifacts: Not Produced`).
99
+ - Playbook C: High-uncertainty path — provide two distinct framing variants with trade-off rationale and explicit caveats (`Runtime: Not Run`, `Artifacts: Not Produced`).
100
+
101
+ ## Mode handling
102
+
103
+ ### Text-only mode
104
+ - provide primary composition/camera plan and fallback variant in plain language
105
+ - report `Runtime: Not Run` and `Artifacts: Not Produced`
106
+
107
+ ### Runtime-ready mode
108
+ - provide the composition/camera plan plus explicit target criteria for `composition-quality-checker` to validate once a scene exists
109
+ - keep `Runtime: Not Run` and `Artifacts: Not Produced` during planning
110
+
111
+ ### Blocked runtime mode
112
+ - deliver full composition/camera plan and fallback variant with explicit caveats
113
+ - keep `Runtime: Not Run` and `Artifacts: Not Produced`; make no visual success claims
114
+
115
+ ## Validation checklist
116
+ - [ ] focal hierarchy explicit
117
+ - [ ] hero framing objective and attention path explicit
118
+ - [ ] aspect ratio framing strategy documented (without overriding `resolution-aspect-decision`)
119
+ - [ ] negative space policy documented
120
+ - [ ] camera angle preset rationale documented
121
+ - [ ] focal length guidance by mood documented
122
+ - [ ] depth layering (foreground/midground/background) documented
123
+ - [ ] target silhouette/readability checks documented for `composition-quality-checker`
124
+ - [ ] fallback framing variant documented
125
+ - [ ] plain-language rationale included throughout
126
+ - [ ] truth states explicitly set to `Runtime: Not Run` and `Artifacts: Not Produced`
127
+
128
+ ## Pass / Warn / Fail rubric
129
+
130
+ | Category | Pass | Warn | Fail |
131
+ |---|---|---|---|
132
+ | Focal hierarchy | Clear primary/secondary/background priority | Partial hierarchy | Missing hierarchy |
133
+ | Framing strategy | Matches output context and includes fallback variant | Generic framing or weak fallback | Mismatched framing or missing fallback |
134
+ | Camera rationale | Specific plain-language angle, focal-length mood, and depth layering | Vague rationale or unexplained jargon | No rationale or includes Python/execution commands |
135
+ | Role & truth boundary | Stays in planning; reports `Runtime: Not Run` and `Artifacts: Not Produced` | Mild boundary overlap with lookdev/validation | Claims verified framing quality or upgrades truth states |
136
+
137
+ ## Failure handling
138
+ - Conflicting goals: provide trade-off options.
139
+ - Missing constraints: ask targeted follow-up.
140
+ - Unknown destination: use conservative web-hero defaults + caveat.
141
+
142
+ ## Troubleshooting
143
+ - Subject lost in frame: tighten framing focus, adjust camera angle preset, or increase spatial separation between foreground, midground, and background layers.
144
+ - No room for copy: widen negative space allowance and shift primary focal placement off-center.
145
+ - Flat spatial staging: adjust camera angle and focal-length perspective or increase depth-layer spacing (route lighting/material contrast issues to `lighting-material-plan`).
146
+ - Existing scene framing needs pass/fail grading: hand off to `composition-quality-checker`.
147
+
148
+ ## Best practices
149
+ - optimize for clarity before stylization
150
+ - tie each camera choice to user outcome
151
+ - preserve fallback path for uncertain constraints
152
+
153
+ ## Good examples
154
+ “Primary subject occupies center-right with left negative space for hero copy; camera 3/4 angle chosen for silhouette and depth readability.”
155
+
156
+ ## Bad examples
157
+ “Use cinematic camera.” (no context, no criteria)
158
+
159
+ ## User-facing response template
160
+ - Composition summary (focal hierarchy, attention path, negative space, depth layering, silhouette checks)
161
+ - Camera strategy summary (aspect strategy, angle preset, focal length by mood)
162
+ - Fallback framing variant
163
+ - Why this helps your goal (plain-language rationale)
164
+ - Truth states (`Runtime: Not Run`, `Artifacts: Not Produced`) and unverified assumptions
165
+ - Recommended next skill handoff
166
+
167
+ ## Anti-patterns
168
+ - skipping required laws or runtime boundary statements
169
+ - claiming runtime/artifact success without evidence
170
+ - claiming runtime or artifact states above `Not Run` / `Not Produced` (violating downgrade-only truth rules)
171
+ - writing Python code or Blender camera execution commands
172
+ - designing lighting rigs or material lookdev instead of handing off to `lighting-material-plan`
173
+ - validating rendered/viewport composition instead of handing off to `composition-quality-checker`
174
+ - locking final export resolution/aspect (`resolution-aspect-decision`) or file formats (`output-format-decision`)
175
+ - producing jargon-heavy camera specs without plain-language rationale
176
+
177
+ ## Cross-skill handoff
178
+ <!-- blendops:generated:start handoffs -->
179
+ - [upstream_reference] Upstream input from → `../product-hero-scene-planner/SKILL.md`
180
+ - [conditional] Lateral output specs (if needed) (output-format-decision) → `../output-format-decision/SKILL.md`
181
+ - [conditional] Lateral output specs (if needed) (resolution-aspect-decision) → `../resolution-aspect-decision/SKILL.md`
182
+ - [progression] Next (lookdev & lighting) → `../lighting-material-plan/SKILL.md`
183
+ - [progression] Then (validation) (scene-readiness) → `../scene-readiness/SKILL.md`
184
+ - [progression] Then (validation) (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
185
+ <!-- blendops:generated:end handoffs -->
186
+
187
+ ## Non-goals
188
+ - executing Blender commands, writing Python scripts, or generating scene/render artifacts
189
+ - designing lighting setups or materials (owned by `lighting-material-plan`)
190
+ - validating or scoring completed scene framing (owned by `composition-quality-checker`)
191
+ - locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
192
+
193
+ ## References
194
+ - https://www.blender.org/lab/mcp-server/
195
+ - https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
196
+ - https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
@@ -0,0 +1,180 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "camera-composition",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "camera-rig-and-composition-deep-planner",
7
+ "purpose": "Provide detailed composition and camera planning for product hero outputs.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "improve composition and camera",
11
+ "choose hero framing",
12
+ "set camera strategy for product hero"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "as proof of rendered output quality or to validate an existing framing",
17
+ "delegateTo": "composition-quality-checker",
18
+ "reason": "use composition-quality-checker"
19
+ },
20
+ {
21
+ "condition": "to design lighting rigs or surface materials/lookdev",
22
+ "delegateTo": "lighting-material-plan",
23
+ "reason": "use lighting-material-plan"
24
+ },
25
+ {
26
+ "condition": "to lock final pixel resolution or output aspect specs",
27
+ "delegateTo": "resolution-aspect-decision",
28
+ "reason": "use resolution-aspect-decision"
29
+ },
30
+ {
31
+ "condition": "to choose delivery file formats",
32
+ "delegateTo": "output-format-decision",
33
+ "reason": "use output-format-decision"
34
+ },
35
+ {
36
+ "condition": "when subject intent is undefined",
37
+ "delegateTo": "product-hero-scene-planner",
38
+ "reason": "Delegates out-of-scope requests to product-hero-scene-planner"
39
+ }
40
+ ],
41
+ "inputs": {
42
+ "required": [
43
+ {
44
+ "name": "domain_scene_plan",
45
+ "type": "object",
46
+ "description": "Upstream scene layout plan defining subject scale, staging, and depth layers"
47
+ },
48
+ {
49
+ "name": "framing_goal",
50
+ "type": "string",
51
+ "description": "Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)"
52
+ }
53
+ ],
54
+ "optional": [
55
+ {
56
+ "name": "pinned_aspect_ratio",
57
+ "type": "string",
58
+ "description": "Aspect ratio lock from resolution-aspect-decision"
59
+ }
60
+ ]
61
+ },
62
+ "outputs": {
63
+ "primary": [
64
+ "camera_rig_specification",
65
+ "focal_length_and_dof_plan",
66
+ "composition_anchor_guidelines"
67
+ ],
68
+ "truthStatePolicy": {
69
+ "runtimeDefault": "Not Run",
70
+ "artifactDefault": "Not Produced",
71
+ "mutationRule": "downgrade_only"
72
+ }
73
+ },
74
+ "handoffs": [
75
+ {
76
+ "target": "product-hero-scene-planner",
77
+ "type": "upstream_reference",
78
+ "label": "Upstream input from",
79
+ "when": {
80
+ "all": [
81
+ {
82
+ "field": "brief.locked",
83
+ "operator": "equals",
84
+ "value": true
85
+ },
86
+ {
87
+ "field": "recipe.domain",
88
+ "operator": "equals",
89
+ "value": "product_hero"
90
+ }
91
+ ]
92
+ }
93
+ },
94
+ {
95
+ "target": "output-format-decision",
96
+ "type": "conditional",
97
+ "label": "Lateral output specs (if needed) (output-format-decision)",
98
+ "when": {
99
+ "all": [
100
+ {
101
+ "field": "decision.formatLocked",
102
+ "operator": "equals",
103
+ "value": false
104
+ }
105
+ ]
106
+ }
107
+ },
108
+ {
109
+ "target": "resolution-aspect-decision",
110
+ "type": "conditional",
111
+ "label": "Lateral output specs (if needed) (resolution-aspect-decision)",
112
+ "when": {
113
+ "all": [
114
+ {
115
+ "field": "decision.aspectLocked",
116
+ "operator": "equals",
117
+ "value": false
118
+ }
119
+ ]
120
+ }
121
+ },
122
+ {
123
+ "target": "lighting-material-plan",
124
+ "type": "progression",
125
+ "label": "Next (lookdev & lighting)",
126
+ "when": {
127
+ "all": [
128
+ {
129
+ "field": "brief.locked",
130
+ "operator": "equals",
131
+ "value": true
132
+ },
133
+ {
134
+ "field": "stage.current",
135
+ "operator": "equals",
136
+ "value": "lookdev_planning"
137
+ }
138
+ ]
139
+ }
140
+ },
141
+ {
142
+ "target": "scene-readiness",
143
+ "type": "progression",
144
+ "label": "Then (validation) (scene-readiness)",
145
+ "when": {
146
+ "all": [
147
+ {
148
+ "field": "quality.domain",
149
+ "operator": "equals",
150
+ "value": "holistic"
151
+ },
152
+ {
153
+ "field": "stage.current",
154
+ "operator": "equals",
155
+ "value": "quality_validation"
156
+ }
157
+ ]
158
+ }
159
+ },
160
+ {
161
+ "target": "composition-quality-checker",
162
+ "type": "progression",
163
+ "label": "Then (validation) (composition-quality-checker)",
164
+ "when": {
165
+ "all": [
166
+ {
167
+ "field": "quality.domain",
168
+ "operator": "equals",
169
+ "value": "composition"
170
+ },
171
+ {
172
+ "field": "quality.verdict",
173
+ "operator": "equals",
174
+ "value": "not_run"
175
+ }
176
+ ]
177
+ }
178
+ }
179
+ ]
180
+ }
@@ -0,0 +1,30 @@
1
+ # Camera Presets & Framing Calibration
2
+
3
+ ## Purpose
4
+ Define reproducible camera angle, focal length, sensor, and clip-plane presets for product hero and turntable planning outputs without bloated jargon.
5
+
6
+ ## When to use
7
+ Whenever `camera-composition` translates a scene brief into camera orientation, focal perspective, and safe framing bounds.
8
+
9
+ ## Preset Families
10
+
11
+ | Preset | Typical Focal Length (36mm Full Frame) | Camera Elevation / Pitch | Ideal Subject Occupancy | Primary Use Case |
12
+ |---|---|---|---|---|
13
+ | **3/4 Hero Orbit** | `50mm – 85mm` (natural-to-flattering compression) | `12° – 22°` above equator, `30° – 45°` azimuth | `55% – 70%` vertical/viewport span | Default flagship product render & interactive web GLB landing pose |
14
+ | **Front-Elevation Clean** | `75mm – 105mm` (minimizes perspective keystone) | `0° – 5°` eye level, centered orthogonal look-at | `60% – 72%` viewport span | E-commerce specs, silhouette comparison, grid symmetry |
15
+ | **Low-Angle Heroic** | `35mm – 50mm` (controlled dramatic foreshortening) | `-6° – +5°` looking slightly upward | `60% – 75%` frame height | Footwear, hardware, automotive, high-energy campaigns |
16
+ | **Macro Detail Crop** | `85mm – 120mm` + tight shallow DoF (`f/2.8 – f/4`) | Tightly angled onto texture seam / badge / bevel | Subject detail fills `70% – 85%` | Stitch, machined aluminum, anodized logo close-ups |
17
+
18
+ ## Technical Sanity Rules
19
+ - **Avoid extreme wide angles (`< 28mm`)** on hard-surface products unless intentionally stylized — edge distortion stretches silhouette proportions.
20
+ - **Clip-plane hygiene**: Set `clip_start = 0.01m – 0.05m` (`0.001m` triggers viewport/shadow depth z-fighting) and tight `clip_end = 50m – 200m` for studio scenes.
21
+ - **Ground clearance**: Confirm object bottom sits cleanly at `Z = 0.0` (ground contact shadow visible) with `8% – 15%` breathing margin on all cropped edges.
22
+
23
+ ## Good example
24
+ "Selected `65mm` 3/4 Hero Orbit at `16°` elevation, keeping shoe spanning `62%` of frame height with `10%` floor shadow margin and right-side negative space for hero typography."
25
+
26
+ ## Bad example
27
+ "Put a camera in front of the product." (No focal length, elevation, occupancy, or edge clearance.)
28
+
29
+ ## Related skill
30
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,24 @@
1
+ # Camera Rubric
2
+
3
+ ## Purpose
4
+ Provide a structured 4-dimension scoring rubric for evaluating hero camera placement, framing, focal length, and layout compatibility prior to render or GLB export.
5
+
6
+ ## When to use
7
+ - During `composition-quality-checker` or `scene-readiness` review before approving a render/turntable.
8
+ - Whenever comparing candidate camera angles or validating hero framing against web overlay text zones.
9
+
10
+ ## Rubric Dimensions & Grading Thresholds
11
+
12
+ | Dimension | Pass Criteria | Warn (Fixable Before Final) | Fail (Block Handoff) |
13
+ |---|---|---|---|
14
+ | **Focal Clarity** | Subject sharp and unobstructed; lens `50-85 mm` (`<= 35 mm` only for deliberate wide environments); `f/5.6-f/8` keeps full product crisp | Slight DOF blur near secondary edge or `35-45 mm` slight perspective exaggeration | Wide-angle barrel distortion (`< 28 mm`) warping product silhouette, or focal blur hiding hero details |
15
+ | **Framing Intent** | Hero fills `45%-70%` of frame; `10%+` safe margin around bounding box; vertical/horizontal horizon level (`roll = 0 deg` unless tilted hero) | Hero slightly tight (`70%-80%`) or loose (`30%-45%`); minor asymmetry unmotivated | Key product feature clipped off-edge, horizon accidentally crooked, or hero `< 25%` of frame |
16
+ | **Depth Layering** | Foreground/hero/background cleanly separated via distance falloff, floor reflection fade, or subtle haze/rim edge | Backdrop separates from hero in midtones only; shadows blend slightly into dark floor | Flat "sticker" cutout look or black product silhouette lost against black void |
17
+ | **Target Context Readability** | Negative space preserves UI headline/CTA zone (e.g., left-third hero leaves right 40% clean for hero copy) without occluding silhouette | Copy safe zone slightly tight (`< 25%` unobstructed margin) under responsive mobile crop | Hero overlaps web typography zone or mobile `9:16` / desktop `16:9` crop cuts off core product |
18
+
19
+ ## Good vs. Bad Review Output
20
+ - **Good**: Score each of the 4 dimensions explicitly (`Pass / Warn / Fail`), state concrete evidence (`focal_length: 65mm`, `shift_x: 0.08`, `safe_margin: 12%`) or mark visual read `Not Run` if no render exists yet, and list one minimum camera adjustment per `Warn/Fail`.
21
+ - **Bad**: `"Camera looks 8/10, ready to export"` with zero per-dimension rationale or context fit check.
22
+
23
+ ## Related skill
24
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,24 @@
1
+ # Hero Composition Patterns
2
+
3
+ ## Purpose
4
+ Provide concrete, repeatable hero framing and camera setups matched to common product, e-commerce, and web-landing delivery goals.
5
+
6
+ ## When to use
7
+ - During `camera-composition` planning immediately after the hero subject footprint (`dimensions`, facing direction) is known.
8
+
9
+ ## Core Hero Composition Patterns
10
+
11
+ | Pattern | Camera Geometry & Focal Range | Best For | Key Guardrail |
12
+ |---|---|---|---|
13
+ | **Center-Dominant Hero** | `65-85 mm`, `10-15 deg` slightly above eye-level (`Z + 0.15 m`), straight-on or `15 deg` yaw | Luxury packaging, sneaker side/3-4 profile, standalone hero turntable | Leave `15%+` top/bottom margin so shadow and badge badges never touch frame edge |
14
+ | **Rule-of-Thirds Split (Web Landing)** | `50-70 mm`, product placed on left or right vertical third (`shift_x` or aim offset), hero occupies `40%-55%` frame | SaaS/marketing hero banners with headline + CTA on the opposite side | Verify `40%+` opposite-side uncluttered background and test desktop `16:9` -> mobile `4:5` safe crop |
15
+ | **Three-Quarter Dynamic Diagonal** | `50-65 mm`, `35-45 deg` yaw + subtle `12-20 deg` low-to-high pitch (`+3-5 deg` subtle roll only if energetic tech/sport) | Footwear, hardware electronics, wearable gadgets needing depth + sole/back detail | Confirm diagonal leading lines point **into** the frame rather than exiting a corner |
16
+ | **Macro Craft Detail Crop** | `85-105 mm` telephoto, tight partial crop on stitching, chamfer, metallic bevel, or brushed anodizing (`f/4-f/5.6`) | Secondary gallery shots, material credibility cards, craftsmanship proof | Only pair with a wider establishing shot; never use macro as the sole hero shot |
17
+ | **Elevated Isometric / Orthographic Grid** | `85-135 mm` long lens (or true ortho `ortho_scale`), `30-35 deg` elevation, `45 deg` yaw | Product catalog consistency, multi-SKU comparisons, configurator thumbnails | Lock exact camera distance & focal preset across every SKU in the batch |
18
+
19
+ ## Good vs. Bad Selection
20
+ - **Good**: `"Using Rule-of-Thirds Split (60mm, hero shifted right, left 45% dark matte gradient reserved for landing H1 + CTA), 12% margin above heel cap."`
21
+ - **Bad**: Picking a low-angle `24 mm` Dutch tilt for a clean minimalist skincare e-commerce thumbnail where straight verticals and multi-SKU consistency are required.
22
+
23
+ ## Related skill
24
+ [../SKILL.md](../SKILL.md)
@@ -0,0 +1,25 @@
1
+ # Web Layout Negative Space & Viewport Safe Zones
2
+
3
+ ## Purpose
4
+ Guarantee hero renders and interactive GLB camera rigs leave clean unobstructed viewport area for web headings, pricing blocks, CTA buttons, and mobile reflows.
5
+
6
+ ## When to use
7
+ Whenever outputs target hero sections, landing pages, split-screen showcases, or embedded React Three Fiber viewports.
8
+
9
+ ## Quantitative Safe-Zone Checklist
10
+
11
+ | Check | Target Rule | Failure Risk |
12
+ |---|---|---|
13
+ | **Copy-safe negative space** | Reserve `35% – 45%` clean horizontal strip (left or right third) or upper band for UI copy; keep gradient backdrop calm behind text. | Headline sits across busy specular geometry and fails WCAG text contrast. |
14
+ | **Focal off-center target offset** | Aim `lookAt` / OrbitControls target toward `X = ±0.20..0.30` normalized viewport offset rather than translating the mesh away from world `(0,0,0)`. | Offsetting geometry breaks turntable pivot centers later in Three.js / R3F. |
15
+ | **Desktop (`16:9` / `1440×900`) vs Mobile (`9:16` / `390×844`)** | Confirm silhouette stays intact inside center-weighted crop or document explicit camera FOV / distance adaptation for portrait viewports. | Product toe/handle clips off horizontal screen edges on mobile screens. |
16
+ | **Shadow & reflection tail clearance** | Keep `≥ 10%` padding below contact shadow and rim fade-out inside the canvas frame. | Hard rectangular shadow crop at bottom canvas edge looks broken on page background. |
17
+
18
+ ## Good example
19
+ "Target offset shifts sneaker cleanly to right 60% on desktop (`16:9`), preserving left 40% matte charcoal negative space (`#0F1117`) for H1 + CTA with zero silhouette overlap; mobile (`390×844`) resets target to centered `3/4` orbit."
20
+
21
+ ## Bad example
22
+ "Centered shoe filling 92% width — landing page headline overlaps the laces and bright rim highlight."
23
+
24
+ ## Related skill
25
+ - [SKILL.md](../SKILL.md)
@@ -0,0 +1,42 @@
1
+ # EVAL — character-portrait
2
+
3
+ ## Text-only eval prompt
4
+ Use character-portrait on a hero close-up brief: stylized 30s tech founder, confident editorial mood, 16:9 web hero card.
5
+
6
+ ## Expected behavior
7
+ - Subject section filled (identity / build / archetype / style)
8
+ - Pose / expression / gaze explicit
9
+ - Wardrobe + props listed
10
+ - Camera / framing / lens (50-85mm, eye-line upper third)
11
+ - Lighting plan (key / fill / rim + HDRI)
12
+ - Background + mood explicit
13
+ - Asset list flagged
14
+ - Handoff to discovery / composition / lighting / material / quality named
15
+ - Honest evidence label
16
+
17
+ ## Pass / Warn / Fail criteria
18
+ - Pass: all sections + handoff + no "TBD"
19
+ - Warn: one section ambiguous
20
+ - Fail: framing impossible (e.g. 18mm tight close-up), missing lighting, no asset list
21
+
22
+ ## Common failure modes
23
+ - inventing likeness without rights
24
+ - mixing multi-character scope
25
+ - skipping mood / style
26
+ - generating modeling instructions
27
+
28
+ ## Evidence expectations
29
+ - explicit decisions per row
30
+ - asset list for discovery handoff
31
+ - evidence label honest (Not Run for text-only)
32
+
33
+ ## Sample passing response outline
34
+ - Subject row + Pose row + Wardrobe row
35
+ - Camera / Lighting / Background / Mood rows
36
+ - Asset list
37
+ - Next: handoff named
38
+
39
+ ## Sample failing response outline
40
+ - "Person looking at camera"
41
+ - No framing rules
42
+ - Verified without render