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,245 @@
1
+ ---
2
+ name: asset-license-checker
3
+ description: Audit commercial rights, CC-BY attribution, NC/SA traps, and brand/trademark restrictions for downloaded 3D meshes, HDRIs, textures, and fonts.
4
+ ---
5
+
6
+ # asset-license-checker
7
+
8
+ ## Purpose
9
+ Catch license risk before assets go into a scene that will be rendered, exported, or shipped. This is a planning / validation skill — does not modify assets, does not consult lawyers.
10
+
11
+ ## Quick start
12
+ - Receive the sourced external asset list from `asset-discovery` (models, textures, HDRIs, fonts, sounds, brushes).
13
+ - Record source URL, documented license name, and stated permissions per asset.
14
+ - Flag risk per asset (`Pass` / `Warn` / `Fail`) and specify required attribution lines and attribution plan.
15
+ - Gate progression: hand off to `asset-style-check`, `asset-library-plan`, or `workflow-stage-router` only if all rows are `Pass` or explicitly accepted `Warn`; route any `Fail` rows to `asset-fallback-strategy`.
16
+
17
+ ## When to use
18
+ - Immediately after `asset-discovery` produces a candidate asset list.
19
+ - Before handing off to `asset-style-check`, `asset-library-plan`, or scene planners (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`).
20
+ - Before `pre-handoff-verification`, `render-export-evidence`, `glb-web-handoff`, or `glb-animation-handoff`.
21
+ - Whenever a previously sourced asset's license or attribution requirement is unclear.
22
+
23
+ ## When not to use
24
+ <!-- blendops:generated:start exclusions -->
25
+ - Sourcing or searching for candidate assets → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
26
+ - Checking visual consistency, scale, or aesthetic fit across assets → use `../asset-style-check/SKILL.md` (Delegates out-of-scope requests to asset-style-check)
27
+ - Replacing or working around rejected/blocked assets → use `../asset-fallback-strategy/SKILL.md` (Delegates out-of-scope requests to asset-fallback-strategy)
28
+ - Structuring folders, naming conventions, or catalog storage → use `../asset-library-plan/SKILL.md` (Delegates out-of-scope requests to asset-library-plan)
29
+ - First-party assets authored entirely in-house with no external dependencies. → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
30
+ - Legal advice or binding legal interpretation (this skill flags risk only; escalate ambiguity to legal). → use `../asset-style-check/SKILL.md` (Delegates out-of-scope requests to asset-style-check)
31
+ <!-- blendops:generated:end exclusions -->
32
+
33
+ ## Trigger phrases
34
+ <!-- blendops:generated:start triggers -->
35
+ - "is this license OK"
36
+ - "can I use this commercially"
37
+ - "what's the license"
38
+ - "license check"
39
+ <!-- blendops:generated:end triggers -->
40
+
41
+ ## Prerequisites / readiness
42
+ - Sourced asset list from `asset-discovery` with source URLs/origins recorded.
43
+ - Intended use case stated (commercial, non-commercial, internal, or open-source).
44
+ - Target attribution plan defined (where and how attribution lines will be rendered, or whether attribution cannot be supported).
45
+
46
+ ## Input schema
47
+
48
+ ### Required inputs
49
+
50
+ | Input | Why it is required |
51
+ |---|---|
52
+ | Asset list (name + source) | Scope of check |
53
+ | Intended use case | Drives compatibility |
54
+ | Target attribution policy | Some licenses require attribution |
55
+
56
+ ### Optional inputs
57
+
58
+ | Input | Use |
59
+ |---|---|
60
+ | Existing internal license whitelist | Pre-approved sources |
61
+ | Brand legal policy | Per-company override rules |
62
+
63
+ ### Assumptions to confirm
64
+ - Asset license file or page is publicly readable.
65
+ - License version is current (licenses sometimes change).
66
+ - The user's intended use is accurately stated.
67
+
68
+ ## Output schema
69
+
70
+ ### Primary output
71
+ A per-asset row table: asset name, source URL, documented license name, attribution required (Y/N), commercial allowed (Y/N), modification allowed (Y/N), redistribution allowed (Y/N), validation verdict (`Pass` / `Warn` / `Fail`), and notes.
72
+
73
+ ### Secondary output
74
+ - Required attribution lines and attribution rendering plan (where applicable).
75
+ - Blocked assets (`Fail`) routed to `asset-fallback-strategy`.
76
+ - Top-line gate status (`Pass` / `Warn` / `Fail`).
77
+
78
+ ### Evidence / caveat output
79
+ Validation verdicts (`Pass` / `Warn` / `Fail`) apply per asset and are separate from runtime and artifact truth states. Truth states are downgrade-only (never upgrade), and `Artifact status` defaults to `Not Produced`:
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
+ Validation skill — does not modify assets, does not run Blender. Verdicts are based on documented license terms, not legal interpretation. **Not legal advice**: when in doubt, recommend the user consult their legal team.
97
+
98
+ ## Operating procedure
99
+
100
+ 1. Ingest the external asset list from `asset-discovery`.
101
+ 2. Ensure every external asset has its own row; unknown or missing license immediately blocks use (`Fail`).
102
+ 3. Look up documented license terms per `references/license-source-rules.md` (do not interpret ambiguous legal language).
103
+ 4. Map documented permissions (commercial, modification, redistribution, attribution) against the stated intended use and attribution plan.
104
+ 5. Assign a per-asset validation verdict (`Pass` / `Warn` / `Fail`) separate from runtime/artifact truth states.
105
+ 6. Compile exact attribution lines and verify an attribution plan exists wherever attribution is required.
106
+ 7. Route any `Fail` assets to `asset-fallback-strategy` (or back to `asset-discovery` for re-sourcing).
107
+ 8. Gate downstream progression: proceed to `asset-style-check`, `asset-library-plan`, or `workflow-stage-router` only if all rows are `Pass` or explicitly accepted `Warn`.
108
+
109
+ ## Decision tree
110
+
111
+ ```txt
112
+ License unknown, missing, or unverified source?
113
+ → Fail (blocks use until source and license are confirmed)
114
+ "CC0 / public domain" with documented dedication?
115
+ → Pass for the stated use (still record attribution plan as N/A)
116
+ Documented terms forbid intended use (e.g., non-commercial-only license for a commercial project, or no modification/redistribution when required)?
117
+ → Fail (route asset to asset-fallback-strategy)
118
+ Attribution required by license, but no attribution plan exists?
119
+ → Fail (blocks use until attribution plan is confirmed)
120
+ Documented terms permit intended use, but contain ambiguity?
121
+ → Warn (escalate ambiguity to legal; requires explicit user/legal acceptance to proceed)
122
+ ```
123
+
124
+ ## Playbooks
125
+
126
+ ### Playbook A: Commercial delivery
127
+
128
+ Require explicit documented commercial permission for every asset row. If attribution is required, verify the attribution plan is approved before gating; otherwise mark `Fail` and route to `asset-fallback-strategy`. Escalate any custom or ambiguous terms to legal.
129
+
130
+ ### Playbook B: Internal / non-commercial review
131
+
132
+ Verify documented terms cover internal or non-commercial use. Track all required attribution lines so internal prototypes cannot advance to commercial handoff (`pre-handoff-verification`) without re-running `asset-license-checker`.
133
+
134
+ ### Playbook C: Redistributed or shared package
135
+
136
+ Verify documented redistribution and modification permissions for every external asset row, ensure package-level attribution lines are included in the attribution plan, and escalate cross-license compatibility questions to legal.
137
+
138
+ ## Mode handling
139
+
140
+ ### Text-only mode
141
+ Evaluate license rows strictly from the provided asset specification and documented source text. No Python and no Blender execution. Set `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgrade).
142
+
143
+ ### Runtime-ready mode
144
+ Evaluate license rows against user-supplied license files or manifest records. Maintain `Runtime status: Not Run` (this skill never runs Blender) and downgrade truth states if any expected documentation artifact is missing.
145
+
146
+ ### Blocked runtime mode
147
+ If source URLs or license files are unreadable or missing, assign per-asset verdict `Fail` (unknown license blocks use), keep `Artifact status: Not Produced`, and route blocked assets to `asset-fallback-strategy`.
148
+
149
+ ## Validation checklist
150
+ - [ ] Every external asset has a dedicated row in the table.
151
+ - [ ] Source URL and documented license name are recorded per row (unknown license marked `Fail`).
152
+ - [ ] Permissions per row recorded (`commercial` / `modification` / `redistribution` / `attribution`).
153
+ - [ ] Per-asset validation verdict (`Pass` / `Warn` / `Fail`) assigned separately from truth states.
154
+ - [ ] Required attribution lines and attribution plan recorded where applicable.
155
+ - [ ] Runtime and artifact truth states included (`Artifact status` defaults to `Not Produced`; downgrade-only).
156
+ - [ ] Scene gate enforced: downstream handoff allowed only on all-`Pass` or explicitly accepted `Warn`; `Fail` rows routed to `asset-fallback-strategy`.
157
+
158
+ ## Pass / Warn / Fail rubric
159
+
160
+ | Verdict | Criteria |
161
+ | --- | --- |
162
+ | Pass | License is explicitly documented, permissions match intended use, and required attribution is covered by a concrete attribution plan. |
163
+ | Warn | Documented permissions appear compatible, but terms contain ambiguity requiring legal review or the attribution plan needs explicit user confirmation. |
164
+ | Fail | License is unknown/missing, documented terms forbid intended use, attribution is required without an attribution plan, or rights are reserved without explicit permission. |
165
+
166
+ ## Failure handling
167
+ - Unknown or missing license → assign `Fail` and block asset use immediately.
168
+ - Attribution required without a rendering plan → assign `Fail` and block until an attribution plan is established.
169
+ - Vague or unverified assurance ("probably fine") → never assign `Pass`; mark `Warn` (if documented terms exist but need legal review) or `Fail` (if undocumented), and escalate ambiguity to legal.
170
+ - Any `Fail` verdict → block downstream scene progression and hand off rejected assets to `asset-fallback-strategy` or `asset-discovery`.
171
+ - Truth states → downgrade-only; never upgrade `Runtime status` or `Artifact status`.
172
+
173
+ ## Troubleshooting
174
+
175
+ | Problem | Response |
176
+ |---|---|
177
+ | License page unreachable / missing | Assign `Fail` (unknown license blocks use); route to `asset-fallback-strategy` or `asset-discovery`. |
178
+ | License terms changed since download | Flag as `Warn` or `Fail` depending on whether dated proof of prior terms exists; do not assume grandfathering — escalate to legal. |
179
+ | Mixed-license asset bundle | Split bundle so every individual external sub-asset gets its own row and verdict. |
180
+ | AI-generated external asset | Treat as unknown/ambiguous unless platform terms are explicitly documented for the intended use; escalate ambiguity to legal. |
181
+
182
+ ## Best practices
183
+ - Record license at acquisition time, not at build time.
184
+ - Maintain an internal whitelist for repeat sources.
185
+ - Never ship without verifying every external asset's license.
186
+ - "Not legal advice" — escalate ambiguity to legal.
187
+
188
+ ## Good examples
189
+ - "Asset: `studio_hdri.exr`, source: documented vendor URL, license: explicitly documented public-domain/permissive terms, commercial: Y, mod: Y, redist: Y, attribution: N. Verdict: `Pass`."
190
+ - "Asset: `hero_chair.glb`, source: documented marketplace URL, license: attribution-required license, commercial: Y, attribution plan: credits screen line recorded. Verdict: `Pass`."
191
+
192
+ ## Bad examples
193
+ - "Asset is from internet." — no source, no license.
194
+
195
+ ## User-facing response template
196
+
197
+ ```txt
198
+ Intended use: <commercial / non-commercial / internal / open-source>
199
+ Attribution plan: <where attribution will render or "none">
200
+
201
+ | Asset | Source | License | Comm | Mod | Redist | Attribution | Verdict | Notes |
202
+ |---|---|---|---|---|---|---|---|---|
203
+
204
+ Required attribution lines:
205
+ - <line 1 or "none">
206
+
207
+ Assets blocked (Fail — route to asset-fallback-strategy): <list or "none">
208
+ Top-line gate verdict: <Pass / Warn / Fail>
209
+ Note: Not legal advice; escalate any license ambiguity to your legal team.
210
+
211
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
212
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
213
+ Evidence used: <links, paths, logs, or "none">
214
+ Limitations: <known gaps>
215
+ Next: <if all Pass or explicitly accepted Warn: asset-style-check / asset-library-plan / workflow-stage-router | if any Fail: asset-fallback-strategy / asset-discovery>
216
+ ```
217
+
218
+ ## Anti-patterns
219
+ - "Should be fine" verdicts.
220
+ - Skipping the attribution plan.
221
+ - Treating "all rights reserved" assets as usable.
222
+ - Inventing license terms.
223
+
224
+ ## Cross-skill handoff
225
+ <!-- blendops:generated:start handoffs -->
226
+ - [upstream_reference] Upstream asset sourcing → `../asset-discovery/SKILL.md`
227
+ - [progression] Visual style validation → `../asset-style-check/SKILL.md`
228
+ - [fallback] Rejected/blocked asset handling → `../asset-fallback-strategy/SKILL.md`
229
+ - [progression] Asset library organization → `../asset-library-plan/SKILL.md`
230
+ - [progression] Stage routing & scene planning gate → `../workflow-stage-router/SKILL.md`
231
+ <!-- blendops:generated:end handoffs -->
232
+
233
+ ## Non-goals
234
+ - Give legal advice or interpret complex contracts (escalate ambiguity to legal).
235
+ - Source or discover candidate assets (`asset-discovery`).
236
+ - Check visual style or aesthetic consistency (`asset-style-check`).
237
+ - Plan fallbacks or replacements for failed assets (`asset-fallback-strategy`).
238
+ - Organize asset libraries or folder structures (`asset-library-plan`).
239
+ - Modify asset files, write Python, or run Blender.
240
+
241
+ ## References
242
+ - `references/common-license-mapping.md`
243
+ - `references/license-source-rules.md`
244
+ - `references/attribution-rendering-patterns.md`
245
+ - `../../docs/skill-system.md`
@@ -0,0 +1,172 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "asset-license-checker",
4
+ "version": "1.0.0",
5
+ "category": "asset-and-sourcing",
6
+ "role": "asset-license-and-provenance-gate",
7
+ "purpose": "Verify license compliance for downloaded 3D assets, textures, HDRIs, fonts before scene build or export.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "is this license OK",
11
+ "can I use this commercially",
12
+ "what's the license",
13
+ "license check"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "Sourcing or searching for candidate assets",
18
+ "delegateTo": "asset-discovery",
19
+ "reason": "Delegates out-of-scope requests to asset-discovery"
20
+ },
21
+ {
22
+ "condition": "Checking visual consistency, scale, or aesthetic fit across assets",
23
+ "delegateTo": "asset-style-check",
24
+ "reason": "Delegates out-of-scope requests to asset-style-check"
25
+ },
26
+ {
27
+ "condition": "Replacing or working around rejected/blocked assets",
28
+ "delegateTo": "asset-fallback-strategy",
29
+ "reason": "Delegates out-of-scope requests to asset-fallback-strategy"
30
+ },
31
+ {
32
+ "condition": "Structuring folders, naming conventions, or catalog storage",
33
+ "delegateTo": "asset-library-plan",
34
+ "reason": "Delegates out-of-scope requests to asset-library-plan"
35
+ },
36
+ {
37
+ "condition": "First-party assets authored entirely in-house with no external dependencies.",
38
+ "delegateTo": "asset-discovery",
39
+ "reason": "Delegates out-of-scope requests to asset-discovery"
40
+ },
41
+ {
42
+ "condition": "Legal advice or binding legal interpretation (this skill flags risk only; escalate ambiguity to legal).",
43
+ "delegateTo": "asset-style-check",
44
+ "reason": "Delegates out-of-scope requests to asset-style-check"
45
+ }
46
+ ],
47
+ "inputs": {
48
+ "required": [
49
+ {
50
+ "name": "candidate_assets",
51
+ "type": "array",
52
+ "description": "Candidate external 3D models, textures, and HDRIs with source URLs and license labels"
53
+ },
54
+ {
55
+ "name": "intended_distribution_use",
56
+ "type": "string",
57
+ "description": "Target distribution context (commercial product marketing, web redistribution, internal preview)"
58
+ }
59
+ ],
60
+ "optional": [
61
+ {
62
+ "name": "attribution_delivery_surface",
63
+ "type": "string",
64
+ "description": "Where attribution credits can be displayed if CC-BY-4.0 assets are used"
65
+ }
66
+ ]
67
+ },
68
+ "outputs": {
69
+ "primary": [
70
+ "per_asset_license_verdict_table",
71
+ "attribution_obligations_list",
72
+ "quarantined_or_blocked_assets"
73
+ ],
74
+ "truthStatePolicy": {
75
+ "runtimeDefault": "Not Run",
76
+ "artifactDefault": "Not Produced",
77
+ "mutationRule": "downgrade_only"
78
+ }
79
+ },
80
+ "handoffs": [
81
+ {
82
+ "target": "asset-discovery",
83
+ "type": "upstream_reference",
84
+ "label": "Upstream asset sourcing",
85
+ "when": {
86
+ "all": [
87
+ {
88
+ "field": "brief.locked",
89
+ "operator": "equals",
90
+ "value": true
91
+ },
92
+ {
93
+ "field": "assets.discoveryComplete",
94
+ "operator": "equals",
95
+ "value": false
96
+ }
97
+ ]
98
+ }
99
+ },
100
+ {
101
+ "target": "asset-style-check",
102
+ "type": "progression",
103
+ "label": "Visual style validation",
104
+ "when": {
105
+ "all": [
106
+ {
107
+ "field": "assets.licenseCleared",
108
+ "operator": "equals",
109
+ "value": true
110
+ },
111
+ {
112
+ "field": "stage.current",
113
+ "operator": "equals",
114
+ "value": "style_check"
115
+ }
116
+ ]
117
+ }
118
+ },
119
+ {
120
+ "target": "asset-fallback-strategy",
121
+ "type": "fallback",
122
+ "label": "Rejected/blocked asset handling",
123
+ "when": {
124
+ "all": [
125
+ {
126
+ "field": "assets.fallbackNeeded",
127
+ "operator": "equals",
128
+ "value": true
129
+ }
130
+ ]
131
+ }
132
+ },
133
+ {
134
+ "target": "asset-library-plan",
135
+ "type": "progression",
136
+ "label": "Asset library organization",
137
+ "when": {
138
+ "all": [
139
+ {
140
+ "field": "assets.discoveryComplete",
141
+ "operator": "equals",
142
+ "value": true
143
+ },
144
+ {
145
+ "field": "stage.current",
146
+ "operator": "equals",
147
+ "value": "library_organization"
148
+ }
149
+ ]
150
+ }
151
+ },
152
+ {
153
+ "target": "workflow-stage-router",
154
+ "type": "progression",
155
+ "label": "Stage routing & scene planning gate",
156
+ "when": {
157
+ "all": [
158
+ {
159
+ "field": "preflight.passed",
160
+ "operator": "equals",
161
+ "value": true
162
+ },
163
+ {
164
+ "field": "inventory.exists",
165
+ "operator": "equals",
166
+ "value": true
167
+ }
168
+ ]
169
+ }
170
+ }
171
+ ]
172
+ }
@@ -0,0 +1,48 @@
1
+ # Attribution rendering patterns
2
+
3
+ When an asset's license requires attribution, the attribution must actually appear in the deliverable. Plan where it appears.
4
+
5
+ ## Where to place attribution
6
+
7
+ | Deliverable | Attribution location |
8
+ |---|---|
9
+ | Web hero card | Footer or "credits" section linked from page |
10
+ | GLB shipped to consumer | License file alongside GLB; consumer renders if commercial |
11
+ | Marketing video | Closing credits |
12
+ | Social post | Caption or alt-text |
13
+ | App / game | About / credits screen |
14
+ | Blog post / article | Footer or per-image caption |
15
+ | Internal-only deliverable | Internal documentation |
16
+
17
+ ## Attribution format per license
18
+
19
+ ### CC-BY 4.0
20
+ "Title" (link) by Author (link) is licensed under CC-BY 4.0.
21
+
22
+ ### CC-BY-SA 4.0
23
+ Same as CC-BY plus a note that derivatives must use the same license.
24
+
25
+ ### MIT (for code-licensed assets like fonts with MIT)
26
+ Include the full MIT license text.
27
+
28
+ ### Custom / Proprietary
29
+ Follow the licensor's required format exactly.
30
+
31
+ ## Common mistakes
32
+
33
+ - Attribution exists but is not visible to end users (in source comments only, not rendered).
34
+ - Attribution lists "various sources" without naming them.
35
+ - Attribution placed only in download metadata, not in the running app.
36
+ - Forgetting to update attributions when assets change.
37
+
38
+ ## Verifying attribution
39
+
40
+ Before claiming Pass:
41
+ - Where will the attribution appear in the final deliverable?
42
+ - Is that location accessible to end users?
43
+ - Does it match the license's required format?
44
+
45
+ If any answer is "unclear", verdict stays Warn.
46
+
47
+ ## Related skill
48
+ `../SKILL.md`
@@ -0,0 +1,39 @@
1
+ # Common license → permissions mapping
2
+
3
+ | License | Commercial | Modification | Redistribution | Attribution |
4
+ |---|---|---|---|---|
5
+ | CC0 / Public Domain | Y | Y | Y | N (recommended but not required) |
6
+ | CC-BY 4.0 | Y | Y | Y | Y (required, specific format) |
7
+ | CC-BY-SA 4.0 | Y | Y | Y (under same license) | Y |
8
+ | CC-BY-NC 4.0 | N | Y | Y (non-commercial only) | Y |
9
+ | CC-BY-NC-SA 4.0 | N | Y | Y (non-commercial, same license) | Y |
10
+ | CC-BY-ND 4.0 | Y | N (no derivatives) | Y | Y |
11
+ | MIT | Y | Y | Y | Y (license text) |
12
+ | Apache 2.0 | Y | Y | Y | Y |
13
+ | GPL v3 | Y | Y | Y (under GPL) | Y |
14
+ | LGPL | Y | Y (library use) | Y | Y |
15
+ | Proprietary / EULA | Read EULA | Read EULA | Read EULA | Read EULA |
16
+ | All Rights Reserved | N (without explicit grant) | N | N | N/A |
17
+ | "Free for personal use" | **N (commercial blocked)** | Read terms | Read terms | Read terms |
18
+
19
+ ## Pitfalls
20
+
21
+ - "Free" does not mean "free for any use". Always read the specific terms.
22
+ - "Free for personal use" excludes commercial; this is the most common mismatch.
23
+ - CC-NC variants exclude commercial. Brand campaigns are commercial.
24
+ - "Royalty-free" usually means "you can use without paying again per use", not "free of any license".
25
+
26
+ ## Asset platforms and default licenses
27
+
28
+ | Platform | Common default | Notes |
29
+ |---|---|---|
30
+ | polyhaven.com | CC0 | All public-domain assets |
31
+ | ambientcg.com | CC0 | All public-domain assets |
32
+ | sketchfab.com | Mixed (CC variants + commercial) | Read per asset |
33
+ | BlendSwap.com | Mixed | Read per asset |
34
+ | TurboSquid | Standard royalty-free EULA | Read per asset |
35
+ | GrabCAD | Mostly free for non-commercial | Verify |
36
+ | AI-generated (Midjourney, etc.) | Tool-specific terms | Read tool's commercial-use policy |
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,38 @@
1
+ # License-source rules
2
+
3
+ A license is valid evidence only if it can be sourced. Vague "I think this is CC0" is Warn at best.
4
+
5
+ ## Acceptable license sources
6
+
7
+ 1. License field in the asset's metadata file (preferred).
8
+ 2. Public license page on the source platform (URL recorded).
9
+ 3. License text bundled with the asset (LICENSE.txt or similar).
10
+ 4. Direct correspondence with the licensor (email proof).
11
+
12
+ ## Unacceptable
13
+
14
+ - "I remember it was CC0."
15
+ - A second-hand description from another site.
16
+ - A blog post that describes the asset.
17
+ - Verbal confirmation without a written record.
18
+
19
+ ## Recording
20
+
21
+ For each asset, capture:
22
+ - License name (canonical, e.g., "CC0 1.0", not just "CC")
23
+ - Source URL of the license page
24
+ - Date checked
25
+ - Asset version / file hash if available
26
+
27
+ This becomes part of the per-asset row in the verdict table.
28
+
29
+ ## License changes over time
30
+
31
+ Licenses can change retroactively for new versions but typically not for previously-downloaded files. Record the version number / download date as evidence of which license applies.
32
+
33
+ ## Bundled assets with mixed licenses
34
+
35
+ Asset packs often bundle assets under multiple licenses. Treat each sub-asset separately; do not apply the most-restrictive license uniformly (it may over-block).
36
+
37
+ ## Related skill
38
+ `../SKILL.md`
@@ -0,0 +1,26 @@
1
+ # EVAL — asset-style-check
2
+
3
+ ## Text-only eval prompt
4
+ Apply asset-style-check on a 4-asset list (3 realistic PBR + 1 stylized cartoon) for an all-realistic product hero brief.
5
+
6
+ ## Expected behavior
7
+ - per-asset 4-axis (realism / detail / color / surface) rows
8
+ - drift verdict per row
9
+ - top-line: Fail (1 stylized in all-realistic brief)
10
+ - remediation: replace or restyle the stylized asset
11
+ - handoff to fallback strategy
12
+
13
+ ## Pass / Warn / Fail criteria
14
+ - Pass: 4 rows + brief reference + verdicts + remediation
15
+ - Warn: rows present but axis values guessed
16
+ - Fail: "vibe" verdicts, no axis-by-axis evaluation
17
+
18
+ ## Sample passing response outline
19
+ - Brief style line
20
+ - 4 rows
21
+ - Top-line + remediation list
22
+ - Next handoff
23
+
24
+ ## Sample failing response outline
25
+ - "Looks fine"
26
+ - No axis evaluation