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,238 @@
1
+ ---
2
+ name: asset-style-check
3
+ description: Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.
4
+ ---
5
+
6
+ # asset-style-check
7
+
8
+ ## Purpose
9
+ Catch style mismatches between assets before they end up in the same scene where the inconsistency reads as compositing error.
10
+
11
+ ## Quick start
12
+ - list every asset planned for the scene
13
+ - evaluate each on style axes (realism / detail / color / surface)
14
+ - flag drift between assets
15
+ - recommend remediation (drop / restyle / replace)
16
+
17
+ ## When to use
18
+ - after `asset-license-checker` clears the assets
19
+ - before scene build
20
+ - when a scene preview shows visible style mismatch
21
+ - when assets come from multiple sources
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - single isolated asset where no multi-asset or scene-brief consistency check is requested → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
26
+ - pure planning before candidate assets are picked → use `../asset-discovery/SKILL.md` (use asset-discovery)
27
+ - intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles → use `../asset-license-checker/SKILL.md` (Delegates out-of-scope requests to asset-license-checker)
28
+ - checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light → use `../asset-license-checker/SKILL.md` (lighting-material-plan)
29
+ <!-- blendops:generated:end exclusions -->
30
+
31
+ ## Trigger phrases
32
+ <!-- blendops:generated:start triggers -->
33
+ - "do these assets fit together"
34
+ - "style check the assets"
35
+ - "scene feels like a collage"
36
+ <!-- blendops:generated:end triggers -->
37
+
38
+ ## Prerequisites / readiness
39
+ - candidate asset list with previews sourced via `asset-discovery`
40
+ - all candidate assets cleared by `asset-license-checker`
41
+ - scene brief visual style locked (via `intent-to-3d-brief-writer` if needed)
42
+ - target scene quality bar set
43
+
44
+ ## Input schema
45
+
46
+ ### Required inputs
47
+
48
+ | Input | Why it is required |
49
+ |---|---|
50
+ | Asset list with previews | Subject of the check |
51
+ | Brief style locked | Reference for consistency |
52
+
53
+ ### Optional inputs
54
+
55
+ | Input | Use |
56
+ |---|---|
57
+ | Reference image / mood board | Style baseline |
58
+ | Existing scene preview | Real-world consistency check |
59
+
60
+ ### Assumptions to confirm
61
+ - Brief style is unambiguous.
62
+ - Asset previews are representative of final use.
63
+
64
+ ## Output schema
65
+
66
+ ### Primary output
67
+ A per-asset row table containing: asset name, realism axis, detail axis, color axis, surface axis, drift verdict (`None | Minor | Major`), validation verdict (`Pass | Warn | Fail`), and remediation hint (`none | drop | restyle | replace`).
68
+
69
+ ### Secondary output
70
+ - top-line scene consistency verdict (`Pass | Warn | Fail`)
71
+ - summary list of assets to drop, restyle, or replace
72
+ - downstream handoff routing
73
+ - evidence and truth-state block (kept strictly separate from `Pass | Warn | Fail` validation verdicts)
74
+
75
+ ### Evidence / caveat output
76
+
77
+ ```txt
78
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
79
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
80
+ Evidence used: <links, paths, logs, or "none">
81
+ Limitations: <known gaps>
82
+
83
+ ```
84
+
85
+ Note: Truth states are downgrade-only (never upgrade without verified evidence) and remain strictly separate from per-asset `Pass | Warn | Fail` validation verdicts.
86
+
87
+ ## Required laws
88
+ - `../../laws/evidence-before-done.md`
89
+ - `../../laws/non-blender-user-language.md`
90
+ - `../../laws/no-arbitrary-python-interface.md`
91
+ - `../../laws/official-runtime-only.md`
92
+
93
+ ## Official runtime boundary
94
+
95
+ Validation-only skill — never modifies or re-styles assets, and never executes Blender or Python. Per-asset verdicts (`Pass | Warn | Fail`) and drift classifications (`None | Minor | Major`) are derived solely from documented asset previews and the locked style brief, and are tracked separately from runtime/artifact truth states (which default to `Not Produced` for artifacts and are downgrade-only).
96
+
97
+ ## Operating procedure
98
+ 1. Confirm the asset list is sourced from `asset-discovery` and cleared by `asset-license-checker`.
99
+ 2. Read the locked brief style baseline (if missing or ambiguous, hand off to `intent-to-3d-brief-writer`).
100
+ 3. For each asset, evaluate all 4 style axes (`realism`, `detail`, `color`, `surface`) against the locked brief (see `references/style-axes.md`).
101
+ 4. Assign a drift verdict (`None | Minor | Major`) and a validation verdict (`Pass | Warn | Fail`) per asset row.
102
+ 5. Provide remediation hints only (`drop | restyle | replace`) for any asset with `Minor` or `Major` drift — never modify or re-style the asset here.
103
+ 6. Route approved rows (`Pass`) to `asset-library-plan` for organization and `scene-readiness` for broad scene review; route rejected rows (`Fail`) to `asset-fallback-strategy` or back to `asset-discovery`.
104
+
105
+ ## Decision tree
106
+
107
+ ```txt
108
+ Brief explicitly locks mixed-style art direction?
109
+ → Evaluate each asset against its assigned role in the brief; allowed contrast = None drift (Pass row)
110
+ Asset matches brief baseline across all 4 axes (realism / detail / color / surface)?
111
+ → Drift: None | Verdict: Pass | Remediation: none
112
+ Asset off on 1 axis?
113
+ → Drift: Minor | Verdict: Warn | Remediation: restyle or drop (verify intent)
114
+ Asset off on 2+ axes, or clashes severely with hero asset?
115
+ → Drift: Major | Verdict: Fail | Remediation: replace or drop (hand off to asset-fallback-strategy)
116
+ Two or more assets in the same scene have Major drift between them without explicit mixed-style brief?
117
+ → Top-line Verdict: Fail; cannot combine without breaking visual hierarchy
118
+ ```
119
+
120
+ ## Playbooks
121
+
122
+ ### Playbook A: All-realistic product hero
123
+ All assets realistic; same detail density; PBR materials. One stylized prop → drop or restyle.
124
+
125
+ ### Playbook B: Stylized character + flat background
126
+ Character is stylized; background must be equally simplified. Detailed background asset → drop.
127
+
128
+ ### Playbook C: Mixed-style intentional (collage / editorial)
129
+ Brief explicitly mixed-style; verify with brief; drift becomes feature, not bug.
130
+
131
+ ## Mode handling
132
+
133
+ ### Text-only mode
134
+
135
+ Evaluate rows from documented previews and metadata. Set `Runtime status: Not Run` and `Artifact status: Not Produced`.
136
+
137
+ ### Runtime-ready mode
138
+
139
+ Evaluate rows using rendered scene preview snapshots alongside asset previews. Downgrade truth states if any preview is incomplete; never upgrade truth states beyond verified evidence.
140
+
141
+ ### Blocked runtime mode
142
+
143
+ Skip rows that depend on a live rendered preview and mark limitations clearly. Keep `Runtime status: Not Run` (or `Failed` if attempted and blocked) and `Artifact status: Not Produced`.
144
+
145
+ ## Validation checklist
146
+ - [ ] Every asset has a 4-axis row (`realism`, `detail`, `color`, `surface`) evaluated against the locked brief
147
+ - [ ] Every asset row includes both a drift verdict (`None / Minor / Major`) and a validation verdict (`Pass / Warn / Fail`)
148
+ - [ ] Top-line consistency verdict (`Pass / Warn / Fail`) is stated
149
+ - [ ] Remediation hints (`drop / restyle / replace`) are provided for any drift without modifying assets
150
+ - [ ] No license, polycount budget, or topology checks are mixed into the evaluation
151
+ - [ ] Runtime and artifact truth states (default `Not Produced`, downgrade-only) are reported separately from `Pass / Warn / Fail` verdicts
152
+
153
+ ## Pass / Warn / Fail rubric
154
+
155
+ | Scope | Verdict | Criteria |
156
+ | --- | --- | --- |
157
+ | Per-asset row | Pass | Matches locked brief across all 4 axes (`realism`, `detail`, `color`, `surface`), or matches explicit mixed-style brief rule; drift is `None`. |
158
+ | Per-asset row | Warn | `Minor` drift on 1 axis against the locked brief; usable with a `restyle` or `drop` remediation hint. |
159
+ | Per-asset row | Fail | `Major` drift on 2+ axes against the locked brief; requires `replace` or `drop` via `asset-fallback-strategy`. |
160
+ | Top-line scene | Pass | All asset rows are `Pass` (or `Warn` with accepted remediation); locked brief style is respected. |
161
+ | Top-line scene | Warn | One or more assets show `Minor` drift (`Warn`), but no unresolved `Major` drift exists. |
162
+ | Top-line scene | Fail | Any asset has unresolved `Major` drift (`Fail`) or two+ assets clash, creating a visible collage error against the brief. |
163
+
164
+ Note: `Pass / Warn / Fail` validation verdicts measure style consistency only and must never be conflated with Runtime or Artifact truth states.
165
+
166
+ ## Failure handling
167
+ - `Major` drift (`Fail` row) → recommend `replace` or `drop`; hand off rejected assets to `asset-fallback-strategy` or `asset-discovery`.
168
+ - Brief unclear or unlocked regarding visual style → stop evaluation and hand off to `intent-to-3d-brief-writer`.
169
+ - Claim that "mixed style is intentional" → accept ONLY if the locked brief explicitly specifies mixed styles; otherwise mark drift and hand off to `intent-to-3d-brief-writer` or `scope-guard`.
170
+
171
+ ## Troubleshooting
172
+
173
+ | Problem | Response |
174
+ |---|---|
175
+ | Hard to tell style from preview | Request higher-quality preview; mark asset row `Warn` with limitation noted until clarified. |
176
+ | Style is on the boundary | Lock the style axis early against the brief; do not invite repeat boundary calls. |
177
+ | User changes style mid-scene | Treat as scope creep; hand off to `scope-guard`. |
178
+
179
+ ## Best practices
180
+ - Lock style early; revisions are cheap pre-build.
181
+ - Always evaluate against the brief, not against vibe.
182
+ - Prefer 1 source for related assets to reduce drift risk.
183
+ - Keep this skill narrow — do not check license / budget / topology here.
184
+
185
+ ## Good examples
186
+ - "`shoe-base.glb`: realism=realistic, detail=high, color=neutral, surface=PBR | Drift: `None` | Verdict: `Pass` | Remediation: `none`. `shoe-laces.glb`: realism=realistic, detail=high, color=neutral, surface=PBR | Drift: `None` | Verdict: `Pass` | Remediation: `none`. `shoe-environment-stylized.glb`: realism=stylized, detail=low, color=saturated, surface=flat | Drift: `Major` | Verdict: `Fail` | Remediation: `replace` via `asset-fallback-strategy`."
187
+
188
+ ## Bad examples
189
+ - "Assets look like they go together." — no axis-by-axis verdict.
190
+
191
+ ## User-facing response template
192
+
193
+ ```txt
194
+ Brief style: <one line locked baseline>
195
+
196
+ | Asset | Realism | Detail | Color | Surface | Drift (None/Minor/Major) | Verdict (Pass/Warn/Fail) | Remediation (none/drop/restyle/replace) |
197
+ |---|---|---|---|---|---|---|---|
198
+
199
+ Top-line consistency: Pass / Warn / Fail
200
+ Assets to drop / restyle / replace: <list or "none">
201
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
202
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
203
+ Evidence used: <links, paths, logs, or "none">
204
+ Limitations: <known gaps>
205
+ Next: asset-library-plan & scene-readiness (Pass) / asset-fallback-strategy (Fail)
206
+ ```
207
+
208
+ ## Anti-patterns
209
+ - "Vibe match" verdicts.
210
+ - Skipping the brief reference.
211
+ - Mixing license / budget / topology checks here.
212
+ - Inventing axis values.
213
+
214
+ ## Cross-skill handoff
215
+ <!-- blendops:generated:start handoffs -->
216
+ - [upstream_reference] Upstream discovery → `../asset-discovery/SKILL.md`
217
+ - [upstream_reference] Upstream license gate → `../asset-license-checker/SKILL.md`
218
+ - [upstream_reference] Upstream brief lock → `../intent-to-3d-brief-writer/SKILL.md`
219
+ - [boundary_delegation] Scope enforcement → `../scope-guard/SKILL.md`
220
+ - [fallback] Rejected asset fallback → `../asset-fallback-strategy/SKILL.md`
221
+ - [progression] Approved asset organization → `../asset-library-plan/SKILL.md`
222
+ - [progression] Broad scene review → `../scene-readiness/SKILL.md`
223
+ - [progression] Material & lookdev boundary (lighting-material-plan) → `../lighting-material-plan/SKILL.md`
224
+ - [progression] Material & lookdev boundary (material-quality-checker) → `../material-quality-checker/SKILL.md`
225
+ - [progression] Budget & topology boundary → `../polycount-budget-checker/SKILL.md`
226
+ <!-- blendops:generated:end handoffs -->
227
+
228
+ ## Non-goals
229
+ - Never modify or re-style assets.
230
+ - Never check asset licenses (belongs to `asset-license-checker`).
231
+ - Never check polycount budgets or mesh topology (belongs to `polycount-budget-checker`).
232
+ - Never execute Blender or Python code.
233
+
234
+ ## References
235
+ - `references/style-axes.md`
236
+ - `references/drift-classification.md`
237
+ - `references/intentional-mixed-style.md`
238
+ - `../../docs/skill-system.md`
@@ -0,0 +1,251 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "asset-style-check",
4
+ "version": "1.0.0",
5
+ "category": "asset-and-sourcing",
6
+ "role": "cross-asset-visual-coherence-validator",
7
+ "purpose": "Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "do these assets fit together",
11
+ "style check the assets",
12
+ "scene feels like a collage"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "single isolated asset where no multi-asset or scene-brief consistency check is requested",
17
+ "delegateTo": "asset-discovery",
18
+ "reason": "Delegates out-of-scope requests to asset-discovery"
19
+ },
20
+ {
21
+ "condition": "pure planning before candidate assets are picked",
22
+ "delegateTo": "asset-discovery",
23
+ "reason": "use asset-discovery"
24
+ },
25
+ {
26
+ "condition": "intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles",
27
+ "delegateTo": "asset-license-checker",
28
+ "reason": "Delegates out-of-scope requests to asset-license-checker"
29
+ },
30
+ {
31
+ "condition": "checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light",
32
+ "delegateTo": "asset-license-checker",
33
+ "reason": "lighting-material-plan"
34
+ }
35
+ ],
36
+ "inputs": {
37
+ "required": [
38
+ {
39
+ "name": "candidate_asset_list",
40
+ "type": "array",
41
+ "description": "Sourced 3D models, materials, and props to evaluate for visual coherence"
42
+ },
43
+ {
44
+ "name": "brief_style_direction",
45
+ "type": "string",
46
+ "description": "Pinned visual style, proportion language, texel density, and surface wear target from brief"
47
+ }
48
+ ],
49
+ "optional": [
50
+ {
51
+ "name": "hero_anchor_asset",
52
+ "type": "string",
53
+ "description": "Primary hero asset used as the visual benchmark for secondary props"
54
+ }
55
+ ]
56
+ },
57
+ "outputs": {
58
+ "primary": [
59
+ "style_coherence_matrix",
60
+ "mismatched_asset_flags",
61
+ "remediation_or_fallback_recommendations"
62
+ ],
63
+ "truthStatePolicy": {
64
+ "runtimeDefault": "Not Run",
65
+ "artifactDefault": "Not Produced",
66
+ "mutationRule": "downgrade_only"
67
+ }
68
+ },
69
+ "handoffs": [
70
+ {
71
+ "target": "asset-discovery",
72
+ "type": "upstream_reference",
73
+ "label": "Upstream discovery",
74
+ "when": {
75
+ "all": [
76
+ {
77
+ "field": "brief.locked",
78
+ "operator": "equals",
79
+ "value": true
80
+ },
81
+ {
82
+ "field": "assets.discoveryComplete",
83
+ "operator": "equals",
84
+ "value": false
85
+ }
86
+ ]
87
+ }
88
+ },
89
+ {
90
+ "target": "asset-license-checker",
91
+ "type": "upstream_reference",
92
+ "label": "Upstream license gate",
93
+ "when": {
94
+ "all": [
95
+ {
96
+ "field": "assets.externalUsed",
97
+ "operator": "equals",
98
+ "value": true
99
+ },
100
+ {
101
+ "field": "assets.licenseCleared",
102
+ "operator": "equals",
103
+ "value": false
104
+ }
105
+ ]
106
+ }
107
+ },
108
+ {
109
+ "target": "intent-to-3d-brief-writer",
110
+ "type": "upstream_reference",
111
+ "label": "Upstream brief lock",
112
+ "when": {
113
+ "all": [
114
+ {
115
+ "field": "goal.clarity",
116
+ "operator": "equals",
117
+ "value": "clear"
118
+ },
119
+ {
120
+ "field": "brief.locked",
121
+ "operator": "equals",
122
+ "value": false
123
+ }
124
+ ]
125
+ }
126
+ },
127
+ {
128
+ "target": "scope-guard",
129
+ "type": "boundary_delegation",
130
+ "label": "Scope enforcement",
131
+ "when": {
132
+ "all": [
133
+ {
134
+ "field": "scope.driftDetected",
135
+ "operator": "equals",
136
+ "value": true
137
+ }
138
+ ]
139
+ }
140
+ },
141
+ {
142
+ "target": "asset-fallback-strategy",
143
+ "type": "fallback",
144
+ "label": "Rejected asset fallback",
145
+ "when": {
146
+ "all": [
147
+ {
148
+ "field": "assets.fallbackNeeded",
149
+ "operator": "equals",
150
+ "value": true
151
+ }
152
+ ]
153
+ }
154
+ },
155
+ {
156
+ "target": "asset-library-plan",
157
+ "type": "progression",
158
+ "label": "Approved asset organization",
159
+ "when": {
160
+ "all": [
161
+ {
162
+ "field": "assets.discoveryComplete",
163
+ "operator": "equals",
164
+ "value": true
165
+ },
166
+ {
167
+ "field": "stage.current",
168
+ "operator": "equals",
169
+ "value": "library_organization"
170
+ }
171
+ ]
172
+ }
173
+ },
174
+ {
175
+ "target": "scene-readiness",
176
+ "type": "progression",
177
+ "label": "Broad scene review",
178
+ "when": {
179
+ "all": [
180
+ {
181
+ "field": "quality.domain",
182
+ "operator": "equals",
183
+ "value": "holistic"
184
+ },
185
+ {
186
+ "field": "stage.current",
187
+ "operator": "equals",
188
+ "value": "quality_validation"
189
+ }
190
+ ]
191
+ }
192
+ },
193
+ {
194
+ "target": "lighting-material-plan",
195
+ "type": "progression",
196
+ "label": "Material & lookdev boundary (lighting-material-plan)",
197
+ "when": {
198
+ "all": [
199
+ {
200
+ "field": "brief.locked",
201
+ "operator": "equals",
202
+ "value": true
203
+ },
204
+ {
205
+ "field": "stage.current",
206
+ "operator": "equals",
207
+ "value": "lookdev_planning"
208
+ }
209
+ ]
210
+ }
211
+ },
212
+ {
213
+ "target": "material-quality-checker",
214
+ "type": "progression",
215
+ "label": "Material & lookdev boundary (material-quality-checker)",
216
+ "when": {
217
+ "all": [
218
+ {
219
+ "field": "quality.domain",
220
+ "operator": "equals",
221
+ "value": "material"
222
+ },
223
+ {
224
+ "field": "quality.verdict",
225
+ "operator": "equals",
226
+ "value": "not_run"
227
+ }
228
+ ]
229
+ }
230
+ },
231
+ {
232
+ "target": "polycount-budget-checker",
233
+ "type": "progression",
234
+ "label": "Budget & topology boundary",
235
+ "when": {
236
+ "all": [
237
+ {
238
+ "field": "quality.domain",
239
+ "operator": "equals",
240
+ "value": "polycount"
241
+ },
242
+ {
243
+ "field": "budget.verdict",
244
+ "operator": "equals",
245
+ "value": "Not Run"
246
+ }
247
+ ]
248
+ }
249
+ }
250
+ ]
251
+ }
@@ -0,0 +1,40 @@
1
+ # Drift classification
2
+
3
+ ## When drift is OK
4
+
5
+ - Brief explicitly calls for mixed style.
6
+ - Subject vs background intentional contrast (focus play).
7
+ - Editorial / collage aesthetic.
8
+
9
+ ## When drift is NOT OK
10
+
11
+ - Default product hero / portrait / arch viz: drift breaks visual hierarchy.
12
+ - Multi-product grid: drift breaks catalog uniformity.
13
+ - Branded marketing: drift dilutes brand consistency.
14
+
15
+ ## Severity scale
16
+
17
+ | Severity | What it looks like | Action |
18
+ |---|---|---|
19
+ | None | Assets share all 4 axes | Continue |
20
+ | Minor | One axis slightly off | Note; usually accept |
21
+ | Major | Two axes off | Replace or restyle |
22
+ | Severe | 3+ axes off | Block; cannot mix |
23
+
24
+ ## Top-line aggregation
25
+
26
+ - All assets None → Pass.
27
+ - One Minor → Warn.
28
+ - Any Major or Severe → Fail.
29
+
30
+ ## Remediation options
31
+
32
+ 1. **Replace**: find a different asset that fits.
33
+ 2. **Restyle**: reauthor the asset to match (modeling work).
34
+ 3. **Drop**: remove the asset from the scene.
35
+ 4. **Reframe brief**: explicit decision to accept mixed style.
36
+
37
+ Most often: replace is best (cheapest, cleanest).
38
+
39
+ ## Related skill
40
+ `../SKILL.md`
@@ -0,0 +1,39 @@
1
+ # Intentional mixed-style
2
+
3
+ When the brief explicitly calls for mixed style, the consistency check inverts: drift becomes feature, uniformity becomes risk.
4
+
5
+ ## Common intentional-mixed cases
6
+
7
+ ### Editorial collage
8
+ Subject realistic, background flat 2D, props cartoon. Each chosen for narrative contrast.
9
+
10
+ ### Hybrid 2D + 3D
11
+ 3D subject composited over 2D illustrated background. Style boundary is the design.
12
+
13
+ ### Style frame transitions
14
+ Multiple panels / shots showing the same character in different styles.
15
+
16
+ ### Mood-driven contrast
17
+ Subject high-detail to draw eye, surroundings deliberately simplified.
18
+
19
+ ## What to verify when mixed-style is intentional
20
+
21
+ - The brief explicitly states the mixed-style intent.
22
+ - Each "style island" is internally consistent (e.g., the stylized props all match each other even if they don't match the subject).
23
+ - Visual hierarchy still works (subject reads first).
24
+ - The mix is repeatable across the deliverable (not random).
25
+
26
+ ## Common mistakes in "intentional mixed-style"
27
+
28
+ - "It's intentional" used as escape hatch for actually-broken assets.
29
+ - No internal consistency within style islands.
30
+ - Visual hierarchy lost (eye does not know where to land).
31
+ - Mix changes mid-deliverable (frame 1 has different mix than frame 2).
32
+
33
+ ## Verdict in mixed-style case
34
+
35
+ - If brief is explicit + style islands consistent + hierarchy works → Pass even with axis-level drift.
36
+ - If brief is vague + drift is just there → Fail; not actually intentional.
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,46 @@
1
+ # Style axes
2
+
3
+ ## 4 axes
4
+
5
+ ### 1. Realism
6
+ - Photorealistic ↔ stylized ↔ flat / cartoon
7
+ - Determine from materials, proportions, surface complexity.
8
+
9
+ ### 2. Detail density
10
+ - High (PBR + micro-detail + small props)
11
+ - Medium (clear surfaces, fewer extras)
12
+ - Low (simplified shapes, large color blocks)
13
+
14
+ ### 3. Color treatment
15
+ - Natural (real-world hues, daylight)
16
+ - Graded (cinematic / brand color grade applied)
17
+ - Stylized palette (limited / saturated)
18
+
19
+ ### 4. Surface complexity
20
+ - Realistic (full PBR, accurate roughness / metallic / normal)
21
+ - Painterly (hand-feel; stylized brush strokes)
22
+ - Flat (uniform color blocks; minimal shading)
23
+
24
+ ## Per-asset evaluation
25
+
26
+ For each asset, position it on each axis. Use ranges if uncertain (e.g., "medium-low detail").
27
+
28
+ ## Brief baseline
29
+
30
+ Read the brief style. Position the brief on each axis. Each asset must fall within the brief's tolerance per axis.
31
+
32
+ ## Drift severity
33
+
34
+ - 0 axes off → None
35
+ - 1 axis off → Minor
36
+ - 2 axes off → Major
37
+ - 3+ axes off → Severe (treat as Fail)
38
+
39
+ ## Common mismatches
40
+
41
+ - Realistic subject + stylized prop → Major drift on realism + surface.
42
+ - High-detail subject + low-detail background → Major if subject is centered; Minor if intentional depth-of-field.
43
+ - Saturated palette asset in muted-palette scene → Minor or Major depending on how prominent.
44
+
45
+ ## Related skill
46
+ `../SKILL.md`