blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,237 @@
1
+ ---
2
+ name: environment-shot
3
+ description: Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
4
+ ---
5
+
6
+ # environment-shot
7
+
8
+ ## Purpose
9
+ Translate a wide place-establishing intent (locale, time of day, weather, atmosphere, foreground/midground/background depth layers, and focal subject or explicit "none") into a structured scene plan with an explicit assumptions register. Distinct from `character-portrait` (single subject), `product-hero-scene-planner` (manufactured products), and `interior-scene` (interior rooms/furniture/surfaces — an establishing shot of an interior room belongs there when furniture or surfaces dominate). Hands off asset rows to `asset-discovery` and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
10
+
11
+ ## Quick start
12
+ - confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
13
+ - pin locale, time of day, weather, and atmosphere
14
+ - pin foreground (FG), midground (MG), and background (BG) depth layers
15
+ - pin focal subject (or explicitly declare `none`)
16
+ - record an explicit assumptions register
17
+ - flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
18
+
19
+ ## When to use
20
+ - intent is establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
21
+ - before any modeling, Geometry Nodes, or scene building
22
+ - when consumer is editorial, cinematic, or brand
23
+
24
+ ## When not to use
25
+ <!-- blendops:generated:start exclusions -->
26
+ - character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
27
+ - product hero → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
28
+ - interior arch viz with focus on furniture / surfaces → use `../interior-scene/SKILL.md` (use interior-scene)
29
+ <!-- blendops:generated:end exclusions -->
30
+
31
+ ## Trigger phrases
32
+ <!-- blendops:generated:start triggers -->
33
+ - "establishing shot of"
34
+ - "wide shot of"
35
+ - "city / forest / desert / ocean scene"
36
+ - "set the scene"
37
+ <!-- blendops:generated:end triggers -->
38
+
39
+ ## Prerequisites / readiness
40
+ - brief from `intent-to-3d-brief-writer` is locked
41
+ - locale scope is realizable and bounded (never invented)
42
+ - target aspect ratio and use case are known
43
+
44
+ ## Input schema
45
+
46
+ ### Required inputs
47
+
48
+ | Input | Why it is required |
49
+ |---|---|
50
+ | Realizable locale | Drives bounded asset and depth-layer scope without inventing unrequested worldbuilding |
51
+ | Time of day | Drives sunlight direction, sky tone, and lighting mood |
52
+ | Weather + atmosphere | Drives visibility, haze/fog, and surface condition |
53
+ | Focal subject intent | Identifies the visual anchor (or explicitly confirms `none`) |
54
+
55
+ ### Optional inputs
56
+
57
+ | Input | Use |
58
+ |---|---|
59
+ | Reference images | Calibrate place scope, depth layers, and mood |
60
+ | Aspect ratio | Guides framing across FG / MG / BG layers |
61
+ | Era / period | Aligns asset discovery rows |
62
+
63
+ ### Assumptions to confirm
64
+ - Single time-of-day snapshot (unless animation is explicitly requested upstream).
65
+ - Locale scope is realizable and bounded, not invented.
66
+ - Interior rooms dominated by furniture or surfaces are routed to `interior-scene`.
67
+ - Planning-only output: `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced`.
68
+
69
+ ## Output schema
70
+
71
+ ### Primary output
72
+ A structured place-establishing plan covering: Locale (bounded scope), Time of day, Weather, Atmosphere, Depth layers (FG / MG / BG), Focal subject (or explicit `none`), Mood / style, and an Assumptions register.
73
+
74
+ ### Secondary output
75
+ - asset rows flagged for `asset-discovery`
76
+ - validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`
77
+ - explicit `Runtime status: Not Run` and `Artifact status: Not Produced` labels
78
+
79
+ ### Evidence / caveat output
80
+
81
+ ```txt
82
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
83
+ Artifact status: Not Produced | Produced | Verified | Failed
84
+ Evidence used: <links, paths, logs, or "none">
85
+ Limitations: <known gaps>
86
+ ```
87
+
88
+ ## Required laws
89
+ - `../../laws/evidence-before-done.md`
90
+ - `../../laws/non-blender-user-language.md`
91
+ - `../../laws/no-arbitrary-python-interface.md`
92
+ - `../../laws/official-runtime-only.md`
93
+
94
+ ## Official runtime boundary
95
+
96
+ Planning-only skill: no modeling, no Geometry Nodes, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief or locale scope is unclear, hand off to `intent-to-3d-brief-writer`.
97
+
98
+ ## Operating procedure
99
+ 1. Read the brief from `intent-to-3d-brief-writer`; confirm wide place-establishing scope and ensure locale scope is realizable (not invented).
100
+ 2. Route to `interior-scene` if the scene is an interior room where furniture or surfaces dominate.
101
+ 3. Pin time of day, weather, and atmosphere (per `references/time-and-weather-rules.md`).
102
+ 4. Define wide camera placement and framing intent (per `references/wide-shot-camera-rules.md`).
103
+ 5. Plan foreground (FG), midground (MG), and background (BG) depth layers (per `references/depth-layering-rules.md`).
104
+ 6. Identify the focal subject or explicitly document `none`.
105
+ 7. Record all open assumptions in the assumptions register.
106
+ 8. List required assets for `asset-discovery` and emit validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness` with `Runtime status: Not Run` and `Artifact status: Not Produced`.
107
+
108
+ ## Decision tree
109
+
110
+ ```txt
111
+ Scene is an interior room where furniture or surfaces dominate?
112
+ → Stop; route to interior-scene
113
+ Focus is a single character or a manufactured product?
114
+ → Stop; route to character-portrait or product-hero-scene-planner
115
+ Locale scope is unbounded or unclear (would require inventing scope)?
116
+ → Stop; hand off to intent-to-3d-brief-writer to bound locale scope
117
+ Locale + time-of-day combination implausible (e.g. "Antarctic noon" with deep dark mood)?
118
+ → Warn; clarify intent
119
+ "City scene" + tight close-up framing?
120
+ → Warn; this is not establishing — re-frame or use different planner
121
+ Weather conflicts with brief mood (sunny + noir)?
122
+ → Fail; pick one
123
+ Focal subject not chosen but every asset has same visual weight?
124
+ → Fail; eye has nowhere to land
125
+ ```
126
+
127
+ ## Playbooks
128
+
129
+ ### Playbook A: City sunset establishing (16:9 cinematic)
130
+ 35mm wide; camera elevated; warm sun direction; haze layer; subject = skyline silhouette; foreground rooftops; background sky gradient.
131
+
132
+ ### Playbook B: Forest mid-day (1:1 brand campaign)
133
+ 24mm wide; camera at human eye-line; key sun + dappled light; foreground branches; midground tree trunks; background distant haze.
134
+
135
+ ### Playbook C: Stylized cyberpunk street (2.39:1 cinematic)
136
+ 24–35mm; rain wet ground reflections; neon practicals; light haze + atmospheric fog; foreground silhouette; midground signage / cars; background distant towers.
137
+
138
+ ## Mode handling
139
+
140
+ ### Text-only mode
141
+ Produce the environment plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
142
+
143
+ ### Runtime-ready mode
144
+ Planning-only even when runtime is available downstream: keep `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgrade), and hand off to `asset-discovery` and quality checkers.
145
+
146
+ ### Blocked runtime mode
147
+ Produce the environment plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and log blockers under `Limitations`.
148
+
149
+ ## Validation checklist
150
+ - [ ] Realizable, non-invented locale scope confirmed
151
+ - [ ] Time of day, weather, and atmosphere pinned
152
+ - [ ] Depth layers (FG / MG / BG) explicitly defined
153
+ - [ ] Focal subject (or explicit `none`) documented
154
+ - [ ] Assumptions register included
155
+ - [ ] Asset rows flagged for `asset-discovery`
156
+ - [ ] Validation handoffs named (`composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`)
157
+ - [ ] `Runtime status: Not Run` and `Artifact status: Not Produced` explicitly set
158
+
159
+ ## Pass / Warn / Fail rubric
160
+
161
+ | Verdict | Criteria |
162
+ | --- | --- |
163
+ | Pass | Realizable locale scope; consistent time/weather/atmosphere; explicit FG/MG/BG depth layers; focal subject (or explicit `none`); assumptions register complete; truth states locked to `Not Run` / `Not Produced`; handoffs named. |
164
+ | Warn | Minor non-blocking assumption open in the assumptions register; asset list partial. |
165
+ | Fail | Invented or unbounded locale scope; interior room dominated by furniture/surfaces; contradictory time/weather/mood; missing FG/MG/BG layers; missing focal subject decision; truth states upgraded above `Not Run` / `Not Produced`. |
166
+
167
+ ## Failure handling
168
+ - Locale scope too broad or unclear → hand off to `intent-to-3d-brief-writer` (never invent scope).
169
+ - Mood and weather contradict → stop and ask user to pick one consistent direction.
170
+ - Asset availability unknown → flag missing items for `asset-discovery`.
171
+
172
+ ## Troubleshooting
173
+
174
+ | Problem | Response |
175
+ |---|---|
176
+ | Sun direction conflicts with shadows in reference | Verify time-of-day + sun azimuth; clarify reference. |
177
+ | Atmospheric haze hides focal subject | Reduce haze density or move subject closer. |
178
+ | Background too detailed | Simplify; use atmospheric perspective. |
179
+
180
+ ## Best practices
181
+ - Lock time-of-day + weather + atmosphere together; they form a system.
182
+ - Always plan FG / MG / BG depth layers.
183
+ - Pair establishing shot with the next narrative step (often character portrait or product reveal).
184
+
185
+ ## Good examples
186
+ - "Locale: cyberpunk city street, near-future. Time: night, neon lit. Weather: light rain. Atmosphere: haze 0.05 density, volumetric scattering. Sky: minimal (occluded by buildings). Camera: 24mm, eye-level, slight low-angle tilt. FG: silhouetted figure. MG: neon signage + parked cars. BG: distant towers + fog. Focal subject: figure silhouette right-third. Mood: gritty, atmospheric."
187
+
188
+ ## Bad examples
189
+ - "Wide shot of a city." — no time, weather, lens, depth.
190
+
191
+ ## User-facing response template
192
+
193
+ ```txt
194
+ Locale (bounded scope): <where + realizable boundaries>
195
+ Time of day: <time / sun state>
196
+ Weather: <weather state>
197
+ Atmosphere: <haze / fog / visibility>
198
+ Camera & framing: <wide position / altitude / tilt>
199
+ Depth layers: FG: <…> | MG: <…> | BG: <…>
200
+ Focal subject: <subject + placement, or explicit "none">
201
+ Mood + style: <line>
202
+ Assumptions register: <explicit list of confirmed assumptions>
203
+
204
+ Assets to discover: <rows for asset-discovery>
205
+ Runtime status: Not Run
206
+ Artifact status: Not Produced
207
+ Evidence used: <links, paths, logs, or "none">
208
+ Limitations: <known gaps>
209
+ Next: asset-discovery | composition-quality-checker | lighting-quality-checker | scene-readiness
210
+ ```
211
+
212
+ ## Anti-patterns
213
+ - Mixing single-character portraits (`character-portrait`), manufactured product shots (`product-hero-scene-planner`), or furniture/surface-dominant interior rooms (`interior-scene`) into wide place planning.
214
+ - Inventing unbounded locale scope instead of handing off to `intent-to-3d-brief-writer`.
215
+ - Skipping FG / MG / BG depth layers or failing to declare a focal subject (or explicit `none`).
216
+ - Prescribing Geometry Nodes, modeling steps, or renders, or upgrading truth states above `Not Run` / `Not Produced`.
217
+
218
+ ## Cross-skill handoff
219
+ <!-- blendops:generated:start handoffs -->
220
+ - [upstream_reference] Brief writer → `../intent-to-3d-brief-writer/SKILL.md`
221
+ - [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
222
+ - [progression] Composition validation → `../composition-quality-checker/SKILL.md`
223
+ - [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
224
+ - [progression] Quality readiness → `../scene-readiness/SKILL.md`
225
+ <!-- blendops:generated:end handoffs -->
226
+
227
+ ## Non-goals
228
+ - Model the environment.
229
+ - Generate Geometry Node setups.
230
+ - Render.
231
+ - Run Blender.
232
+
233
+ ## References
234
+ - `references/time-and-weather-rules.md`
235
+ - `references/wide-shot-camera-rules.md`
236
+ - `references/depth-layering-rules.md`
237
+ - `../../docs/skill-system.md`
@@ -0,0 +1,162 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "environment-shot",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "environment-establishing-shot-architect",
7
+ "purpose": "Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "establishing shot of",
11
+ "wide shot of",
12
+ "city / forest / desert / ocean scene",
13
+ "set the scene"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "character portrait",
18
+ "delegateTo": "character-portrait",
19
+ "reason": "use character-portrait"
20
+ },
21
+ {
22
+ "condition": "product hero",
23
+ "delegateTo": "product-hero-scene-planner",
24
+ "reason": "use product-hero-scene-planner"
25
+ },
26
+ {
27
+ "condition": "interior arch viz with focus on furniture / surfaces",
28
+ "delegateTo": "interior-scene",
29
+ "reason": "use interior-scene"
30
+ }
31
+ ],
32
+ "inputs": {
33
+ "required": [
34
+ {
35
+ "name": "locked_3d_brief",
36
+ "type": "object",
37
+ "description": "Locked 3D brief specifying locale, mood, focal anchor, and delivery channel"
38
+ },
39
+ {
40
+ "name": "atmosphere_and_time_of_day",
41
+ "type": "object",
42
+ "description": "Target time of day, weather condition, and atmospheric haze/fog parameters"
43
+ }
44
+ ],
45
+ "optional": [
46
+ {
47
+ "name": "asset_discovery_constraints",
48
+ "type": "object",
49
+ "description": "Available environment kitbash or terrain assets from asset-discovery"
50
+ }
51
+ ]
52
+ },
53
+ "outputs": {
54
+ "primary": [
55
+ "foreground_midground_background_layer_plan",
56
+ "sun_sky_atmosphere_specification",
57
+ "horizon_and_scale_anchor_plan"
58
+ ],
59
+ "truthStatePolicy": {
60
+ "runtimeDefault": "Not Run",
61
+ "artifactDefault": "Not Produced",
62
+ "mutationRule": "downgrade_only"
63
+ }
64
+ },
65
+ "handoffs": [
66
+ {
67
+ "target": "intent-to-3d-brief-writer",
68
+ "type": "upstream_reference",
69
+ "label": "Brief writer",
70
+ "when": {
71
+ "all": [
72
+ {
73
+ "field": "goal.clarity",
74
+ "operator": "equals",
75
+ "value": "clear"
76
+ },
77
+ {
78
+ "field": "brief.locked",
79
+ "operator": "equals",
80
+ "value": false
81
+ }
82
+ ]
83
+ }
84
+ },
85
+ {
86
+ "target": "asset-discovery",
87
+ "type": "upstream_reference",
88
+ "label": "Asset discovery",
89
+ "when": {
90
+ "all": [
91
+ {
92
+ "field": "brief.locked",
93
+ "operator": "equals",
94
+ "value": true
95
+ },
96
+ {
97
+ "field": "assets.discoveryComplete",
98
+ "operator": "equals",
99
+ "value": false
100
+ }
101
+ ]
102
+ }
103
+ },
104
+ {
105
+ "target": "composition-quality-checker",
106
+ "type": "progression",
107
+ "label": "Composition validation",
108
+ "when": {
109
+ "all": [
110
+ {
111
+ "field": "quality.domain",
112
+ "operator": "equals",
113
+ "value": "composition"
114
+ },
115
+ {
116
+ "field": "quality.verdict",
117
+ "operator": "equals",
118
+ "value": "not_run"
119
+ }
120
+ ]
121
+ }
122
+ },
123
+ {
124
+ "target": "lighting-quality-checker",
125
+ "type": "progression",
126
+ "label": "Lighting validation",
127
+ "when": {
128
+ "all": [
129
+ {
130
+ "field": "quality.domain",
131
+ "operator": "equals",
132
+ "value": "lighting"
133
+ },
134
+ {
135
+ "field": "quality.verdict",
136
+ "operator": "equals",
137
+ "value": "not_run"
138
+ }
139
+ ]
140
+ }
141
+ },
142
+ {
143
+ "target": "scene-readiness",
144
+ "type": "progression",
145
+ "label": "Quality readiness",
146
+ "when": {
147
+ "all": [
148
+ {
149
+ "field": "quality.domain",
150
+ "operator": "equals",
151
+ "value": "holistic"
152
+ },
153
+ {
154
+ "field": "stage.current",
155
+ "operator": "equals",
156
+ "value": "quality_validation"
157
+ }
158
+ ]
159
+ }
160
+ }
161
+ ]
162
+ }
@@ -0,0 +1,49 @@
1
+ # Depth layering rules
2
+
3
+ A wide establishing shot reads flat without distinct depth layers. Plan FG / MG / BG explicitly.
4
+
5
+ ## Three-layer model
6
+
7
+ ### Foreground (FG)
8
+ - Closest to camera; usually silhouettes or partial occluding elements.
9
+ - Provides scale + frame within frame.
10
+ - Examples: tree branches, rooftops, vehicles, characters in silhouette.
11
+
12
+ ### Midground (MG)
13
+ - The subject area; carries focal subject if any.
14
+ - Most detailed; reads as primary visual layer.
15
+ - Examples: main building, focal vehicle, character group.
16
+
17
+ ### Background (BG)
18
+ - Distant; provides context + atmospheric perspective.
19
+ - Less detailed; simplified by haze.
20
+ - Examples: distant skyline, mountains, sky.
21
+
22
+ ## Atmospheric perspective rules
23
+
24
+ - BG is lighter / cooler / less saturated than MG.
25
+ - Haze density increases with distance.
26
+ - Sharpness decreases with distance.
27
+ - Color temperature shifts toward sky color in BG.
28
+
29
+ ## Common failures
30
+
31
+ - All three layers same brightness → reads flat.
32
+ - Background more detailed than midground → eye reads BG first; subject lost.
33
+ - Foreground occlusion blocks focal subject.
34
+ - No FG → environment feels distant and unreachable.
35
+ - No BG → subject feels stage-set, isolated.
36
+
37
+ ## Verdict guidance
38
+
39
+ - All 3 layers present + atmospheric perspective applied → Pass.
40
+ - 2 layers only → Warn (reduced depth).
41
+ - 1 layer only → Fail (no depth; not establishing).
42
+ - Layers present but BG dominates → Fail (hierarchy broken).
43
+
44
+ ## Stylization caveat
45
+
46
+ For stylized / flat / abstract environments, depth layers may collapse intentionally. Verify against brief; if "flat 2D-style" is the brief, depth rules relax.
47
+
48
+ ## Related skill
49
+ `../SKILL.md`
@@ -0,0 +1,35 @@
1
+ # Time of day + weather rules
2
+
3
+ ## Time of day → light + sky
4
+
5
+ | Time | Sun azimuth | Sun strength | Sky tint | HDRI suggestion |
6
+ |---|---|---|---|---|
7
+ | Dawn | low east, ~10° | 0.5–1.0 | warm pink-orange | dawn HDRI |
8
+ | Mid-morning | ~30° | 1.5–2.5 | clear blue | sunny day |
9
+ | Noon | overhead, ~80° | 3–5 | bright blue | overcast or clear |
10
+ | Golden hour | low west, ~10° | 1–2 | deep orange-red | golden hour |
11
+ | Blue hour (post-sunset) | below horizon | 0 (no direct sun) | deep blue-purple | dusk |
12
+ | Night | below horizon | 0 | dark blue / black | night sky |
13
+ | Stylized "neon night" | below horizon | minor | mostly occluded | dark sky + practicals dominate |
14
+
15
+ ## Weather → atmosphere + sky
16
+
17
+ | Weather | Sun visibility | Atmosphere density | Notes |
18
+ |---|---|---|---|
19
+ | Clear | direct | 0.0–0.02 | Sharp shadows |
20
+ | Partly cloudy | broken | 0.02–0.05 | Variable shadows |
21
+ | Overcast | diffuse | 0.05–0.1 | Soft shadows |
22
+ | Light rain | diffuse | 0.05–0.15 | Wet ground reflections |
23
+ | Heavy rain | diffuse / occluded | 0.1–0.3 | Reduced visibility |
24
+ | Fog | occluded | 0.3+ | Subject at distance lost |
25
+ | Snow | diffuse | varies | Ground albedo high |
26
+
27
+ ## Common contradictions
28
+
29
+ - Sunny + noir mood → Fail; pick one.
30
+ - Heavy fog + sharp distant skyline → Fail (visibility contradicts).
31
+ - Dawn warm tint + cool blue mood → Warn unless intentional split.
32
+ - Stylized neon night + realistic sky HDRI → Fail; pick one paradigm.
33
+
34
+ ## Related skill
35
+ `../SKILL.md`
@@ -0,0 +1,51 @@
1
+ # Wide-shot camera rules
2
+
3
+ ## Lens choice
4
+
5
+ | Use case | Equivalent focal length |
6
+ |---|---|
7
+ | Cinematic ultrawide vista | 14–20mm |
8
+ | Standard wide establishing | 24–35mm |
9
+ | Compressed cityscape | 50–85mm (compresses depth) |
10
+ | Telephoto distant landscape | 100mm+ (very compressed) |
11
+
12
+ ## Altitude
13
+
14
+ | Altitude | Effect |
15
+ |---|---|
16
+ | Ground / eye-level (1.6–1.8m) | Human perspective; relatable |
17
+ | Slightly elevated (3–10m) | Hero shot of subject in environment |
18
+ | Drone height (20–100m) | Aerial overview; reduces human scale |
19
+ | Top-down / orthographic | Map-like; abstract |
20
+
21
+ ## Tilt
22
+
23
+ | Tilt | Effect |
24
+ |---|---|
25
+ | Level (no tilt) | Stable, neutral |
26
+ | Slight up (Dutch +5°) | Heroic, looking up |
27
+ | Slight down (Dutch −5°) | Authoritative, surveying |
28
+ | Strong tilt (>15°) | Disorienting; use rarely |
29
+
30
+ ## Common wide-shot positions
31
+
32
+ - **Hero approach**: ground level, slight up tilt, subject silhouette dominates frame.
33
+ - **Establishing aerial**: 30m elevation, level, full landscape visible.
34
+ - **Worm's eye**: ground level, strong up tilt, subject looms.
35
+ - **Top-down**: orthographic, map view, abstract.
36
+
37
+ ## Avoid
38
+
39
+ - Strong fisheye distortion on architectural establishing shots.
40
+ - Eye-level wide angle on small subject (subject reads as tiny dot).
41
+ - Extreme tilt without narrative justification.
42
+
43
+ ## Aspect-specific notes
44
+
45
+ - 16:9 → standard establishing
46
+ - 2.39:1 → exaggerate horizontal scope; compress vertical
47
+ - 9:16 → portrait orientation; elevate subject placement; minimize sky if no clouds
48
+ - 1:1 → minimal negative space; tight crop required
49
+
50
+ ## Related skill
51
+ `../SKILL.md`
@@ -0,0 +1,39 @@
1
+ # EVAL — glb-animation-handoff
2
+
3
+ ## Text-only eval prompt
4
+ Use glb-animation-handoff to write the playback contract for a GLB with an "idle + hover" two-clip animation, target Three.js / R3F.
5
+
6
+ ## Expected behavior
7
+ - both clips listed with type, length, FPS, loop, trigger, blend, root motion, interpolation
8
+ - consumer-stack-specific caveats listed (mixer time scale, animationActions, useAnimations hook caveats)
9
+ - animation channel + bone counts vs budget
10
+ - export evidence status `Not Run` (no measurement performed in text-only mode)
11
+ - handoff to glb-web-handoff named
12
+
13
+ ## Pass / Warn / Fail criteria
14
+ - Pass: full clip rows + caveats + honest evidence labels + handoff named
15
+ - Warn: clip rows present but FPS / blend / trigger ambiguous
16
+ - Fail: claims smooth playback without measurement, conflicting root-motion treatment, or invents clip names not in the brief
17
+
18
+ ## Common failure modes
19
+ - omitting FPS
20
+ - mixing baked + parented root motion
21
+ - forgetting to mark export evidence
22
+ - treating animation as a single uniform stream instead of distinct clips
23
+
24
+ ## Evidence expectations
25
+ - per-clip rows
26
+ - explicit measurement-vs-planning distinction
27
+ - consumer-stack caveats per chosen stack
28
+
29
+ ## Sample passing response outline
30
+ - Clip contract table
31
+ - Consumer stack: r3f
32
+ - Stack caveats: useAnimations hook returns actions; consumer must call .play() inside useEffect on mount; cleanup with .stop()
33
+ - Animation channels: 24 of 50 budget
34
+ - Compliance: Not Run
35
+
36
+ ## Sample failing response outline
37
+ - "Animations work" without contract rows
38
+ - Single FPS unspecified
39
+ - "Will be smooth in three.js" with no measurement