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,260 @@
1
+ ---
2
+ name: composition-quality-checker
3
+ description: Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
4
+ ---
5
+
6
+ # composition-quality-checker
7
+
8
+ ## Purpose
9
+ Run a focused per-row Pass/Warn/Fail check on the camera and framing setup against composition rules (rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility) — emitting per-row verdicts, a top-line status, and remediation hints only, without expanding into camera planning, aspect-ratio locking, material validation, or lighting validation.
10
+
11
+ ## Quick start
12
+ - read camera lens / FOV, position, and target description
13
+ - read framing intent and locked aspect ratio from the brief
14
+ - check rule of thirds, subject placement, and headroom/lead-room
15
+ - check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
16
+ - emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
17
+
18
+ ## When to use
19
+ - before render
20
+ - after a camera change request
21
+ - as a sub-check during full quality review
22
+ - when a render "feels off" but lighting and materials check out
23
+
24
+ ## When not to use
25
+ <!-- blendops:generated:start exclusions -->
26
+ - planning or editing camera framing → use `../camera-composition/SKILL.md` (use camera-composition)
27
+ - locking aspect ratio or resolution → use `../resolution-aspect-decision/SKILL.md` (use resolution-aspect-decision)
28
+ - material validation → use `../material-quality-checker/SKILL.md` (use material-quality-checker)
29
+ - lighting validation → use `../lighting-quality-checker/SKILL.md` (use lighting-quality-checker)
30
+ - broad scene Pass/Warn/Fail readiness review → use `../scene-readiness/SKILL.md` (use scene-readiness)
31
+ - classifying render or export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
32
+ <!-- blendops:generated:end exclusions -->
33
+
34
+ ## Trigger phrases
35
+ <!-- blendops:generated:start triggers -->
36
+ - "is the framing okay"
37
+ - "check composition"
38
+ - "subject feels off-center"
39
+ - "too much negative space"
40
+ <!-- blendops:generated:end triggers -->
41
+
42
+ ## Prerequisites / readiness
43
+ - camera setup known (FOV / focal length / position / target / lens)
44
+ - framing intent known (from brief)
45
+ - subject identified
46
+
47
+ ## Input schema
48
+
49
+ ### Required inputs
50
+
51
+ | Input | Why it is required |
52
+ |---|---|
53
+ | Camera setup | Anchors lens/FOV plausibility and framing checks |
54
+ | Framing intent | Determines applicable composition expectations (close-up vs hero card vs wide) |
55
+ | Subject identification | Determines what counts as the primary subject for placement and hierarchy rules |
56
+ | Aspect ratio lock | Provided upstream (via `resolution-aspect-decision`) to evaluate framing boundaries |
57
+
58
+ ### Optional inputs
59
+
60
+ | Input | Use |
61
+ |---|---|
62
+ | Reference image or preview | Allows visual cross-check of framing and depth cues |
63
+
64
+ ### Assumptions to confirm
65
+ - Render aspect ratio is known and stable.
66
+ - "Subject" is unambiguous in the brief.
67
+ - Camera is locked (or animated path is documented).
68
+
69
+ ## Output schema
70
+
71
+ ### Primary output
72
+ A composition verdict table covering: rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility — each with a `Pass | Warn | Fail` verdict and notes.
73
+
74
+ ### Secondary output
75
+ - top-line validation status (`Pass | Warn | Fail`)
76
+ - worst-offender highlighting
77
+ - remediation hints only (never camera edits or execution commands)
78
+
79
+ ### Evidence / caveat output
80
+ Validation verdicts (`Pass | Warn | Fail`) are separate from runtime and artifact truth states. Truth states are downgrade-only (never upgrade), and `Artifact status` defaults to `Not Produced` unless concrete output evidence exists (classified via `render-export-evidence`).
81
+
82
+ ```txt
83
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
84
+ Artifact status: Not Produced | Produced | Verified | Failed
85
+ Evidence used: <links, paths, logs, or "none">
86
+ Limitations: <known gaps>
87
+ ```
88
+
89
+ ## Required laws
90
+ - `../../laws/evidence-before-done.md`
91
+ - `../../laws/non-blender-user-language.md`
92
+ - `../../laws/no-arbitrary-python-interface.md`
93
+ - `../../laws/official-runtime-only.md`
94
+
95
+ ## Official runtime boundary
96
+
97
+ This skill validates camera plans or measured scene snapshots only. It never moves the camera, never runs Blender, and never executes Python. Artifacts stay `Not Produced` unless concrete output evidence exists (classified by `render-export-evidence`), and truth states are strictly downgrade-only.
98
+
99
+ ## Operating procedure
100
+ 1. Read camera setup, framing intent, subject identification, and upstream aspect lock (from `resolution-aspect-decision`).
101
+ 2. Check rule of thirds alignment against framing intent.
102
+ 3. Check subject placement per intent.
103
+ 4. Check headroom and lead-room balance.
104
+ 5. Check negative space balance and visual hierarchy.
105
+ 6. Check depth cues (foreground/midground/background separation).
106
+ 7. Check lens / FOV plausibility for distortion or flattening against the brief.
107
+ 8. Assign per-row `Pass | Warn | Fail` verdicts and remediation hints.
108
+ 9. Compute top-line status and highlight worst offenders; record downgrade-only Runtime and Artifact truth states separately (defaulting Artifact status to `Not Produced`).
109
+ 10. Hand off to `scene-readiness` (broad review), `camera-composition` (camera re-plan), `resolution-aspect-decision` (aspect/resolution changes), or `render-export-evidence` (artifact evidence classification).
110
+
111
+ ## Decision tree
112
+
113
+ ```txt
114
+ Subject dead-center in 16:9 hero card?
115
+ → Pass for symmetric hero; Warn for documentary/editorial mood
116
+ Subject in dead corner?
117
+ → Fail unless intentional asymmetry called out in brief
118
+ Headroom > 30% of frame for portrait?
119
+ → Warn (too much empty space above)
120
+ Headroom 0% (subject's head touching top)?
121
+ → Fail
122
+ Lead room missing for moving subject?
123
+ → Fail (subject "pressed against" frame)
124
+ Negative space carrying intentional weight?
125
+ → Pass; verify with brief
126
+ FOV < 18mm equivalent on a hero close-up?
127
+ → Warn (likely distortion); verify intent
128
+ ```
129
+
130
+ ## Playbooks
131
+
132
+ ### Playbook A: Product hero card 16:9
133
+ Subject ~60% width, centered horizontally or on right third; clear negative space on the opposite side for headline / CTA; soft horizon line; FOV 50–85mm equivalent.
134
+
135
+ ### Playbook B: Square 1:1 social
136
+ Subject centered; negative space minimal; tight crop OK if not cropping silhouette.
137
+
138
+ ### Playbook C: Portrait 9:16 mobile
139
+ Subject in upper third; lower third reserved for text overlay; full silhouette visible.
140
+
141
+ ### Playbook D: Cinematic 2.39:1
142
+ Wide negative space allowed; subject often off-center using rule of thirds; horizon at upper or lower third.
143
+
144
+ ## Mode handling
145
+
146
+ ### Text-only mode
147
+ Per-row `Pass | Warn | Fail` verdicts are based on the written camera plan/brief only. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced`.
148
+
149
+ ### Runtime-ready mode
150
+ Per-row verdicts cross-check the measured scene snapshot or preview. Truth states remain separate from row verdicts, are downgrade-only, and require `render-export-evidence` before any artifact state above `Not Produced` is recorded.
151
+
152
+ ### Blocked runtime mode
153
+ Skip preview-dependent verification, flag limitations explicitly, keep `Artifact status: Not Produced`, and downgrade truth states accordingly.
154
+
155
+ ## Validation checklist
156
+ - [ ] Camera setup stated
157
+ - [ ] Framing intent stated
158
+ - [ ] Aspect ratio lock confirmed (from `resolution-aspect-decision`)
159
+ - [ ] Rule of thirds verdict
160
+ - [ ] Subject placement verdict
161
+ - [ ] Headroom / lead-room verdict
162
+ - [ ] Negative space verdict
163
+ - [ ] Visual hierarchy verdict
164
+ - [ ] Depth cues verdict
165
+ - [ ] Lens / FOV plausibility verdict
166
+ - [ ] Top-line status derived from rows (kept separate from Runtime/Artifact truth states)
167
+
168
+ ## Pass / Warn / Fail rubric
169
+
170
+ | Verdict | Criteria |
171
+ |---|---|
172
+ | Pass | All rows pass; framing matches brief; aspect ratio coherent. |
173
+ | Warn | One or two plausibility flags (centered when off-center expected, FOV at boundary); no hard violations. |
174
+ | Fail | Subject dead corner without justification; 0 or excessive headroom; lead-room missing for moving subject; FOV severely wrong (e.g. 8mm on hero close-up). |
175
+
176
+ ## Failure handling
177
+ - Camera path animated → flag every keyframe individually if possible, or mark as Warn for static-rule scope.
178
+ - "Negative space minimal" intent vs measured negative space wide → Fail, not Warn.
179
+ - Aspect ratio missing → Fail until provided.
180
+
181
+ ## Troubleshooting
182
+
183
+ | Problem | Remediation hint (do not execute) |
184
+ |---|---|
185
+ | Subject feels off-center or unbalanced | Hint: verify rule-of-thirds vs centered intent; route to `camera-composition` if camera re-aiming is needed. |
186
+ | Excessive or cramped headroom | Hint: adjust framing tightness or subject framing height in `camera-composition`. |
187
+ | Unintended close-up perspective distortion | Hint: increase camera distance and use a longer focal length / narrower FOV in `camera-composition`. |
188
+ | Flat staging with weak depth cues | Hint: increase foreground/background separation or staging depth in `camera-composition`. |
189
+ | Aspect ratio mismatch with target delivery | Hint: route to `resolution-aspect-decision` to lock the proper aspect ratio before re-planning framing. |
190
+
191
+ ## Best practices
192
+ - Confirm the upstream aspect-ratio lock from `resolution-aspect-decision` before judging framing margins.
193
+ - Apply composition checks relative to framing intent, not as rigid universal formulas.
194
+ - Treat negative space and depth cues as intentional design elements anchored to the brief.
195
+ - Provide remediation hints only — leave camera edits to `camera-composition` and broad scene sign-off to `scene-readiness`.
196
+
197
+ ## Good examples
198
+ - "16:9 hero card; subject right-third 60% width; headroom 18%; lead room not applicable (static); negative space left for CTA; FOV 50mm equivalent. Verdict: Pass."
199
+
200
+ ## Bad examples
201
+ - "Composition looks fine." — no per-row analysis.
202
+ - "Verified" without preview cross-check.
203
+
204
+ ## User-facing response template
205
+
206
+ ```txt
207
+ Aspect ratio lock: <from resolution-aspect-decision>
208
+ Framing intent: <hero card / portrait / wide / cinematic>
209
+
210
+ | Check | Verdict | Notes / Remediation Hint |
211
+ |---|---|---|
212
+ | Rule of thirds | Pass/Warn/Fail | |
213
+ | Subject placement | Pass/Warn/Fail | |
214
+ | Headroom / lead-room | Pass/Warn/Fail | |
215
+ | Negative space | Pass/Warn/Fail | |
216
+ | Visual hierarchy | Pass/Warn/Fail | |
217
+ | Depth cues | Pass/Warn/Fail | |
218
+ | Lens / FOV plausibility | Pass/Warn/Fail | |
219
+
220
+ Top-line verdict: <Pass / Warn / Fail>
221
+ Worst offenders: <list or "none">
222
+ Remediation hints: <hints only — no camera edits>
223
+
224
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
225
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
226
+ Evidence used: <links, paths, logs, or "none">
227
+ Limitations: <gaps>
228
+ Next: scene-readiness | camera-composition | resolution-aspect-decision | render-export-evidence
229
+ ```
230
+
231
+ ## Anti-patterns
232
+ - Editing the camera inside this skill.
233
+ - Inventing values.
234
+ - Marking Verified without preview.
235
+ - Mixing material / lighting checks here.
236
+
237
+ ## Cross-skill handoff
238
+ <!-- blendops:generated:start handoffs -->
239
+ - [progression] Broad scene readiness review (consumes these rows) → `../scene-readiness/SKILL.md`
240
+ - [retry] Camera & framing re-plan → `../camera-composition/SKILL.md`
241
+ - [retry] Aspect ratio & resolution locks → `../resolution-aspect-decision/SKILL.md`
242
+ - [progression] Artifact evidence classification → `../render-export-evidence/SKILL.md`
243
+ - [upstream_reference] Material validation → `../material-quality-checker/SKILL.md`
244
+ - [upstream_reference] Lighting validation → `../lighting-quality-checker/SKILL.md`
245
+ <!-- blendops:generated:end handoffs -->
246
+
247
+ ## Non-goals
248
+ - Move or edit the camera (owned by `camera-composition`).
249
+ - Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
250
+ - Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
251
+ - Replace broad scene review (`scene-readiness`).
252
+ - Classify render or export artifact evidence (`render-export-evidence`).
253
+ - Run Blender or execute Python.
254
+
255
+ ## References
256
+ - `references/composition-rules.md`
257
+ - `references/headroom-leadroom-rules.md`
258
+ - `references/aspect-ratio-rules.md`
259
+ - `../../laws/evidence-before-done.md`
260
+ - `../../docs/skill-system.md`
@@ -0,0 +1,221 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "composition-quality-checker",
4
+ "version": "1.0.0",
5
+ "category": "quality-validators",
6
+ "role": "framing-and-silhouette-validator",
7
+ "purpose": "Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "is the framing okay",
11
+ "check composition",
12
+ "subject feels off-center",
13
+ "too much negative space"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "planning or editing camera framing",
18
+ "delegateTo": "camera-composition",
19
+ "reason": "use camera-composition"
20
+ },
21
+ {
22
+ "condition": "locking aspect ratio or resolution",
23
+ "delegateTo": "resolution-aspect-decision",
24
+ "reason": "use resolution-aspect-decision"
25
+ },
26
+ {
27
+ "condition": "material validation",
28
+ "delegateTo": "material-quality-checker",
29
+ "reason": "use material-quality-checker"
30
+ },
31
+ {
32
+ "condition": "lighting validation",
33
+ "delegateTo": "lighting-quality-checker",
34
+ "reason": "use lighting-quality-checker"
35
+ },
36
+ {
37
+ "condition": "broad scene Pass/Warn/Fail readiness review",
38
+ "delegateTo": "scene-readiness",
39
+ "reason": "use scene-readiness"
40
+ },
41
+ {
42
+ "condition": "classifying render or export artifact evidence",
43
+ "delegateTo": "render-export-evidence",
44
+ "reason": "use render-export-evidence"
45
+ }
46
+ ],
47
+ "inputs": {
48
+ "required": [
49
+ {
50
+ "name": "camera_and_framing_spec",
51
+ "type": "object",
52
+ "description": "Camera focal length, sensor, angle, and subject placement from camera-composition"
53
+ },
54
+ {
55
+ "name": "pinned_aspect_ratio_and_subject",
56
+ "type": "object",
57
+ "description": "Locked aspect ratio and primary/secondary focal hierarchy from brief"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "viewport_or_render_preview_notes",
63
+ "type": "string",
64
+ "description": "Optional framing observations from a viewport or preview capture"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "composition_verdict_table",
71
+ "silhouette_and_headroom_assessment",
72
+ "camera_replan_remediation_hints"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "scene-readiness",
83
+ "type": "progression",
84
+ "label": "Broad scene readiness review (consumes these rows)",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "quality.domain",
89
+ "operator": "equals",
90
+ "value": "holistic"
91
+ },
92
+ {
93
+ "field": "stage.current",
94
+ "operator": "equals",
95
+ "value": "quality_validation"
96
+ }
97
+ ]
98
+ }
99
+ },
100
+ {
101
+ "target": "camera-composition",
102
+ "type": "retry",
103
+ "label": "Camera & framing re-plan",
104
+ "when": {
105
+ "all": [
106
+ {
107
+ "field": "quality.domain",
108
+ "operator": "equals",
109
+ "value": "composition"
110
+ },
111
+ {
112
+ "field": "quality.verdict",
113
+ "operator": "equals",
114
+ "value": "Fail"
115
+ }
116
+ ]
117
+ },
118
+ "retryPolicy": {
119
+ "maxAttempts": 2,
120
+ "exitCondition": {
121
+ "all": [
122
+ {
123
+ "field": "quality.verdict",
124
+ "operator": "in",
125
+ "value": [
126
+ "Pass",
127
+ "Warn"
128
+ ]
129
+ }
130
+ ]
131
+ }
132
+ }
133
+ },
134
+ {
135
+ "target": "resolution-aspect-decision",
136
+ "type": "retry",
137
+ "label": "Aspect ratio & resolution locks",
138
+ "when": {
139
+ "all": [
140
+ {
141
+ "field": "quality.domain",
142
+ "operator": "equals",
143
+ "value": "composition"
144
+ },
145
+ {
146
+ "field": "quality.verdict",
147
+ "operator": "equals",
148
+ "value": "Fail"
149
+ }
150
+ ]
151
+ },
152
+ "retryPolicy": {
153
+ "maxAttempts": 2,
154
+ "exitCondition": {
155
+ "all": [
156
+ {
157
+ "field": "quality.verdict",
158
+ "operator": "in",
159
+ "value": [
160
+ "Pass",
161
+ "Warn"
162
+ ]
163
+ }
164
+ ]
165
+ }
166
+ }
167
+ },
168
+ {
169
+ "target": "render-export-evidence",
170
+ "type": "progression",
171
+ "label": "Artifact evidence classification",
172
+ "when": {
173
+ "all": [
174
+ {
175
+ "field": "stage.current",
176
+ "operator": "equals",
177
+ "value": "post_execution_audit"
178
+ }
179
+ ]
180
+ }
181
+ },
182
+ {
183
+ "target": "material-quality-checker",
184
+ "type": "upstream_reference",
185
+ "label": "Material validation",
186
+ "when": {
187
+ "all": [
188
+ {
189
+ "field": "quality.domain",
190
+ "operator": "equals",
191
+ "value": "material"
192
+ },
193
+ {
194
+ "field": "quality.verdict",
195
+ "operator": "equals",
196
+ "value": "not_run"
197
+ }
198
+ ]
199
+ }
200
+ },
201
+ {
202
+ "target": "lighting-quality-checker",
203
+ "type": "upstream_reference",
204
+ "label": "Lighting validation",
205
+ "when": {
206
+ "all": [
207
+ {
208
+ "field": "quality.domain",
209
+ "operator": "equals",
210
+ "value": "lighting"
211
+ },
212
+ {
213
+ "field": "quality.verdict",
214
+ "operator": "equals",
215
+ "value": "not_run"
216
+ }
217
+ ]
218
+ }
219
+ }
220
+ ]
221
+ }
@@ -0,0 +1,37 @@
1
+ # Aspect ratio rules
2
+
3
+ The downstream consumer's required aspect ratio drives most composition decisions. Lock the aspect first; do not improvise.
4
+
5
+ ## Common downstream aspects
6
+
7
+ | Use case | Aspect | Notes |
8
+ |---|---|---|
9
+ | Web hero card | 16:9 (1920×1080) | Most common landing-page hero |
10
+ | Wide cinematic | 2.39:1 | Banner / billboard / cinematic |
11
+ | Square social | 1:1 | Instagram feed / catalog grid |
12
+ | Portrait social | 4:5 or 9:16 | Instagram portrait / TikTok / vertical mobile |
13
+ | App icon | 1:1 | Single subject only |
14
+ | Catalog grid | 4:3 or 1:1 | Often standardized |
15
+
16
+ ## Render at the target aspect
17
+
18
+ Always render at the consumer's aspect ratio, **not** at a different ratio with the intent to crop. Cropping introduces bias and breaks composition.
19
+
20
+ ## When the brief is silent
21
+
22
+ - Default to 16:9 for web hero.
23
+ - Default to 1:1 for social.
24
+ - Default to 9:16 for mobile-only contexts.
25
+ - Always confirm with user; do not assume.
26
+
27
+ ## Aspect ratio mismatch verdicts
28
+
29
+ | Situation | Verdict |
30
+ |---|---|
31
+ | Render aspect matches brief | Pass |
32
+ | Render aspect close (e.g. 16:10 vs 16:9) | Warn |
33
+ | Render aspect wrong direction (square brief, wide render) | Fail |
34
+ | Aspect not specified in brief | Fail (brief incomplete) |
35
+
36
+ ## Related skill
37
+ `../SKILL.md`
@@ -0,0 +1,58 @@
1
+ # Composition rules (rule of thirds, subject placement, hierarchy)
2
+
3
+ These are heuristics, not laws. Apply per framing intent.
4
+
5
+ ## Rule of thirds
6
+
7
+ Divide the frame into 9 equal parts (3 × 3). Place primary subjects on the lines or intersection points (not center) for editorial / cinematic intent.
8
+
9
+ | Framing | Subject position |
10
+ |---|---|
11
+ | Editorial portrait | Eye line on upper-third horizontal |
12
+ | Hero card with CTA | Subject on right-third (or left-third) vertical line |
13
+ | Cinematic landscape | Horizon on upper or lower third |
14
+ | Symmetric brand hero | Center is OK; rule of thirds optional |
15
+
16
+ ## Subject placement
17
+
18
+ | Intent | Placement |
19
+ |---|---|
20
+ | Symmetric brand hero | Centered |
21
+ | Editorial / dynamic | Off-center on third |
22
+ | Catalog product (with negative space for text) | Right or left third |
23
+ | Documentary (off-camera focus) | Far edge with negative space toward viewer's gaze |
24
+
25
+ ## Visual hierarchy
26
+
27
+ The eye reads:
28
+ 1. Brightest spot first
29
+ 2. Highest contrast next
30
+ 3. Sharpest focus next
31
+ 4. Largest object next
32
+ 5. Most saturated color next
33
+
34
+ Hierarchy verdicts:
35
+ - Pass: subject claims at least 3 of these.
36
+ - Warn: subject claims 1–2.
37
+ - Fail: subject claims 0 (eye reads a non-subject as primary).
38
+
39
+ ## Negative space
40
+
41
+ Negative space is **intentional**:
42
+ - "Soft hero" → wide negative space allowed for headline.
43
+ - "Editorial" → negative space carries mood.
44
+ - "Catalog" → negative space minimal; tight crop.
45
+
46
+ Verdict: match against intent. Wide negative space without brief justification → Warn or Fail.
47
+
48
+ ## Depth cues
49
+
50
+ - Atmospheric perspective (haze) for outdoor depth.
51
+ - Overlap (foreground occluding mid/background).
52
+ - Size diminishment.
53
+ - Bokeh / depth of field.
54
+
55
+ A 3D scene without depth cues reads as flat. Hero close-up may intentionally minimize depth; verify intent.
56
+
57
+ ## Related skill
58
+ `../SKILL.md`
@@ -0,0 +1,46 @@
1
+ # Headroom + lead room rules
2
+
3
+ ## Headroom (space above subject)
4
+
5
+ | Subject | Recommended headroom (% of frame height) |
6
+ |---|---|
7
+ | Tight portrait close-up | 5–10% |
8
+ | Medium portrait shot | 10–18% |
9
+ | Wide / full body | 15–25% |
10
+ | Hero product (architectural) | 10–20% |
11
+
12
+ ### Verdicts
13
+
14
+ - Pass: within recommended range.
15
+ - Warn: 0% (head touching top is uncomfortable for most uses) OR > 35% (excessive).
16
+ - Fail: head cropped (subject head extends above frame) when not stylistically justified.
17
+
18
+ ## Lead room (space in direction of motion or gaze)
19
+
20
+ | Subject | Lead room |
21
+ |---|---|
22
+ | Subject looking left | More space on left of subject |
23
+ | Subject moving right | More space on right of subject |
24
+ | Static centered subject | Lead room not applicable |
25
+
26
+ ### Verdicts
27
+
28
+ - Pass: lead room aligns with motion / gaze direction.
29
+ - Warn: lead room slightly off (within 10% of frame width).
30
+ - Fail: subject "pressed against" frame edge in motion / gaze direction → reads as trapped.
31
+
32
+ ## Common mistakes
33
+
34
+ - Placing the subject's eyes at the dead vertical center (instead of upper third).
35
+ - Excessive headroom for tight close-ups.
36
+ - Lead room behind the subject (anti-motion direction).
37
+ - Treating "centered" as universally safe (it is not for editorial intent).
38
+
39
+ ## Per-aspect adjustments
40
+
41
+ - 1:1 (square) → headroom can be slightly less; subject often centered.
42
+ - 9:16 (portrait mobile) → headroom and chinroom equally important; subject typically upper third.
43
+ - 2.39:1 (cinematic) → exaggerate horizontal lead room; verticals less critical.
44
+
45
+ ## Related skill
46
+ `../SKILL.md`
@@ -0,0 +1,26 @@
1
+ # EVAL — cycles-vs-eevee-decision
2
+
3
+ ## Text-only eval prompt
4
+ Apply cycles-vs-eevee-decision for a hero product render with caustics + SSS, time budget 10 minutes per frame, OPTIX GPU available.
5
+
6
+ ## Expected behavior
7
+ - engine: Cycles (caustics + SSS need it)
8
+ - samples: 256-512 with denoiser
9
+ - GPU device: OPTIX
10
+ - time budget realistic at chosen samples
11
+ - caveats listed
12
+ - handoff: render-export-evidence
13
+
14
+ ## Pass / Warn / Fail criteria
15
+ - Pass: engine + samples + GPU + caveats + handoff
16
+ - Warn: borderline samples for time budget
17
+ - Fail: Eevee for caustics, samples severely under-budget, no GPU device chosen
18
+
19
+ ## Sample passing response outline
20
+ - Use case + features + time + machine header
21
+ - Engine config (5 lines)
22
+ - Caveats
23
+
24
+ ## Sample failing response outline
25
+ - "Use Cycles"
26
+ - No samples / GPU / caveats