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,263 @@
1
+ ---
2
+ name: asset-library-plan
3
+ description: Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.
4
+ ---
5
+
6
+ # asset-library-plan
7
+
8
+ ## Purpose
9
+ Plan a maintainable internal asset library structure (folder tree, naming convention, per-asset metadata schema, license-tracking strategy, version-control rules, migration steps, and review process) so future recipes can:
10
+ - find existing assets quickly,
11
+ - avoid re-licensing the same source,
12
+ - reuse PBR materials and HDRIs,
13
+ - track versions and revisions,
14
+ - serve as the internal-library source for `asset-discovery` and `asset-fallback-strategy`.
15
+
16
+ ## Quick start
17
+ - pin folder structure (kebab-case, by category)
18
+ - pin naming convention (asset name + version + license slug)
19
+ - pin metadata schema (license, source, date, version, hash)
20
+ - pin version control rules (LFS for large binaries, plain text for metadata)
21
+ - emit a library-init plan
22
+
23
+ ## When to use
24
+ - starting a new BlendOps repo with multiple recipes
25
+ - existing library is disorganized; recipes can't find assets
26
+ - before scaling to 50+ assets
27
+
28
+ ## When not to use
29
+ <!-- blendops:generated:start exclusions -->
30
+ - single-recipe repo with < 5 assets → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
31
+ - pure planning before any asset categories or storage constraints are known → use `../asset-license-checker/SKILL.md` (Delegates out-of-scope requests to asset-license-checker)
32
+ - sourcing or acquiring external assets → use `../asset-discovery/SKILL.md` (use asset-discovery)
33
+ - verifying asset licenses → use `../asset-license-checker/SKILL.md` (use asset-license-checker)
34
+ - checking visual style consistency across assets → use `../asset-style-check/SKILL.md` (use asset-style-check)
35
+ - planning fallback substitutions when an asset is missing or fails → use `../asset-fallback-strategy/SKILL.md` (use asset-fallback-strategy)
36
+ - enforcing file size or polygon/asset count performance budgets → use `../mobile-glb-budget/SKILL.md` (use mobile-glb-budget)
37
+ <!-- blendops:generated:end exclusions -->
38
+
39
+ ## Trigger phrases
40
+ <!-- blendops:generated:start triggers -->
41
+ - "organize the assets"
42
+ - "asset library structure"
43
+ - "where should assets go"
44
+ - "name our assets"
45
+ <!-- blendops:generated:end triggers -->
46
+
47
+ ## Prerequisites / readiness
48
+ - baseline asset count + categories known
49
+ - version control system known (git + LFS / Perforce / DAM)
50
+ - internal team conventions (if any)
51
+
52
+ ## Input schema
53
+
54
+ ### Required inputs
55
+
56
+ | Input | Why it is required |
57
+ |---|---|
58
+ | Asset categories | Drives folder structure |
59
+ | Version control system | Drives binary storage rules |
60
+ | Existing convention (if any) | Maintain consistency |
61
+
62
+ ### Optional inputs
63
+
64
+ | Input | Use |
65
+ |---|---|
66
+ | Team size | Affects review process |
67
+ | Cloud storage / DAM | Alternative storage path |
68
+
69
+ ### Assumptions to confirm
70
+ - The library is shared across future recipes.
71
+ - License metadata must be queryable.
72
+ - Versioning is discrete (not "latest" symlinks; pinned versions).
73
+
74
+ ## Output schema
75
+
76
+ ### Primary output
77
+ A library plan: folder tree, naming convention, per-asset metadata schema, version control rules, license tracking strategy.
78
+
79
+ ### Secondary output
80
+ - migration steps if existing assets need re-organizing
81
+ - review process for adding new assets
82
+ - evidence label
83
+
84
+ ### Evidence / caveat output
85
+
86
+ ```txt
87
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
88
+ Artifact status: Not Produced | Produced | Verified | Failed
89
+ Evidence used: <links, paths, logs, or "none">
90
+ Limitations: <known gaps>
91
+ ```
92
+
93
+ Truth-state rules:
94
+
95
+ * Default `Artifact status` is `Not Produced`.
96
+ * States are downgrade-only, never upgrade.
97
+ * Planning a library never produces library files (`Runtime status: Not Run`, `Artifact status: Not Produced` unless verifying pre-existing external evidence).
98
+
99
+ ## Required laws
100
+ - `../../laws/evidence-before-done.md`
101
+ - `../../laws/non-blender-user-language.md`
102
+ - `../../laws/no-arbitrary-python-interface.md`
103
+ - `../../laws/official-runtime-only.md`
104
+
105
+ ## Official runtime boundary
106
+
107
+ Planning skill — never moves files, never configures git/LFS/DAM, never runs Blender, and never produces library files. Outputs a structure spec, migration steps, and review process only.
108
+
109
+ ## Operating procedure
110
+ 1. Read asset categories.
111
+ 2. Pin folder structure (see `references/folder-structure-rules.md`).
112
+ 3. Pin naming convention (see `references/naming-rules.md`).
113
+ 4. Pin metadata schema (see `references/metadata-schema.md`).
114
+ 5. Pin version control rules (LFS thresholds, branching).
115
+ 6. Pin license tracking (license file lives next to the asset; unlicensed old assets go to Quarantine for `asset-license-checker`).
116
+ 7. Recommend a review process for new asset additions.
117
+ 8. Emit library-init plan + migration steps.
118
+
119
+ ## Decision tree
120
+
121
+ ```txt
122
+ < 50 total assets?
123
+ → Simple flat structure may suffice
124
+ 50-500 assets?
125
+ → Categorical folders + subfolders
126
+ 500+ assets?
127
+ → DAM (Digital Asset Management) tool recommended
128
+ Mostly small files (< 50MB each)?
129
+ → Plain git OK
130
+ Mixed sizes including > 50MB?
131
+ → Git LFS or external storage
132
+ > 1GB total?
133
+ → External DAM strongly recommended
134
+ ```
135
+
136
+ ## Playbooks
137
+
138
+ ### Playbook A: Small repo (< 50 assets)
139
+
140
+ Flat folders by category: `assets/models/`, `assets/textures/`, `assets/hdris/`, `assets/fonts/`. Per-asset license file and metadata file live directly next to each asset file, plus one README per category folder.
141
+
142
+ ### Playbook B: Medium repo (50-500 assets)
143
+
144
+ Nested by category + sub-category: `assets/models/products/`, `assets/models/characters/`, `assets/textures/pbr/`, etc. Per-asset `LICENSE.txt` + `metadata.json` next to the asset.
145
+
146
+ ### Playbook C: Large repo (500+)
147
+
148
+ External DAM tool + git pointer files. Library plan focuses on folder taxonomy, naming convention, and per-asset metadata/license schema; binary storage is offloaded (operator configures DAM/VCS externally).
149
+
150
+ ## Mode handling
151
+
152
+ ### Text-only mode
153
+
154
+ Library structure plan, migration steps, and review process only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
155
+
156
+ ### Runtime-ready mode
157
+
158
+ Library plan + recommended directory creation and migration steps for the operator to run manually. This skill never creates directories, never moves files, never configures git/LFS/DAM, and never produces library files (`Runtime status: Not Run`, `Artifact status: Not Produced`).
159
+
160
+ ### Blocked runtime mode
161
+
162
+ Library plan only (`Runtime status: Not Run`, `Artifact status: Not Produced`).
163
+
164
+ ## Validation checklist
165
+ - [ ] Folder structure pinned
166
+ - [ ] Naming convention pinned
167
+ - [ ] Metadata schema pinned
168
+ - [ ] Version control rules pinned
169
+ - [ ] License tracking strategy pinned
170
+ - [ ] Review process for new assets
171
+ - [ ] Migration steps (if existing library)
172
+
173
+ ## Pass / Warn / Fail rubric
174
+
175
+ | Verdict | Criteria |
176
+ |---|---|
177
+ | Pass | All sections pinned + migration plan if needed + review process. |
178
+ | Warn | One section soft (e.g. metadata schema partial). |
179
+ | Fail | "Just dump in a folder" advice; no naming convention; no license tracking. |
180
+
181
+ ## Failure handling
182
+ - Existing library cannot be reorganized → plan a parallel new library + gradual migration.
183
+ - VCS not in place → recommend git or alternative before any asset commit.
184
+ - Team lacks process discipline → recommend lightweight review checklist (1-page).
185
+
186
+ ## Troubleshooting
187
+
188
+ | Problem | Response |
189
+ | --- | --- |
190
+ | Asset duplicates across folders | Plan a hash-check step in the migration plan so the operator can deduplicate before re-organizing (this skill does not move or delete files). |
191
+ | Lost license info on old assets | Plan a `Quarantine/` holding path; mark unlicensed old assets as Quarantine and hand off to `asset-license-checker` before any recipe uses them. |
192
+ | Naming inconsistency | Apply convention to new assets immediately; schedule batch renames of old assets in phased migration steps. |
193
+
194
+ ## Best practices
195
+ - One library, one source of truth.
196
+ - License lives next to the asset, always.
197
+ - Naming convention is unforgiving; enforce in code review.
198
+ - Avoid deeply-nested folders (> 4 levels gets confusing).
199
+
200
+ ## Good examples
201
+ - "assets/models/products/sneaker-v01-cc0.glb + assets/models/products/sneaker-v01-cc0.metadata.json + assets/models/products/sneaker-v01-cc0.LICENSE.txt"
202
+
203
+ ## Bad examples
204
+ - "Just use a Drive folder." — no version, no license tracking.
205
+
206
+ ## User-facing response template
207
+
208
+ ```txt
209
+ Library size estimate: <N assets>
210
+ VCS: <git / git+lfs / DAM>
211
+
212
+ Folder structure:
213
+ <tree>
214
+
215
+ Naming convention: <pattern + examples>
216
+
217
+ Metadata schema (per asset):
218
+ <fields>
219
+
220
+ Version control:
221
+ <rules>
222
+
223
+ License tracking: <per-asset license file next to asset + Quarantine rule for unlicensed legacy assets>
224
+
225
+ Review process: <1-page checklist>
226
+
227
+ Migration steps (if applicable): <list>
228
+
229
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
230
+ Artifact status: Not Produced | Produced | Verified | Failed
231
+ Evidence used: <links, paths, logs, or "none">
232
+ Limitations: <known gaps>
233
+ Next: operator implements structure; `asset-discovery` and `asset-fallback-strategy` use this library as their internal source
234
+ ```
235
+
236
+ ## Anti-patterns
237
+ - "Just a folder."
238
+ - No license file.
239
+ - Mutable "latest" pointers.
240
+ - Mixing assets and recipes in the same folders.
241
+
242
+ ## Cross-skill handoff
243
+ <!-- blendops:generated:start handoffs -->
244
+ - [upstream_reference] External asset sourcing into this library → `../asset-discovery/SKILL.md`
245
+ - [upstream_reference] License verification (license file next to asset; unlicensed old assets to Quarantine) → `../asset-license-checker/SKILL.md`
246
+ - [upstream_reference] Visual style consistency checks → `../asset-style-check/SKILL.md`
247
+ - [fallback] Consuming this library as fastest fallback source → `../asset-fallback-strategy/SKILL.md`
248
+ - [progression] File size and asset/polygon count pressure → `../mobile-glb-budget/SKILL.md`
249
+ <!-- blendops:generated:end handoffs -->
250
+
251
+ ## Non-goals
252
+
253
+ * Move, rename, or delete files.
254
+ * Configure git, Git LFS, Perforce, or DAM tools.
255
+ * Run Blender or execute Python.
256
+ * Buy or source external assets (use `asset-discovery`).
257
+ * Verify licenses, style consistency, or performance budgets (use `asset-license-checker`, `asset-style-check`, `mobile-glb-budget`).
258
+
259
+ ## References
260
+ - `references/folder-structure-rules.md`
261
+ - `references/naming-rules.md`
262
+ - `references/metadata-schema.md`
263
+ - `../../docs/skill-system.md`
@@ -0,0 +1,177 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "asset-library-plan",
4
+ "version": "1.0.0",
5
+ "category": "asset-and-sourcing",
6
+ "role": "local-asset-library-taxonomy-planner",
7
+ "purpose": "Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "organize the assets",
11
+ "asset library structure",
12
+ "where should assets go",
13
+ "name our assets"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "single-recipe repo with < 5 assets",
18
+ "delegateTo": "asset-discovery",
19
+ "reason": "Delegates out-of-scope requests to asset-discovery"
20
+ },
21
+ {
22
+ "condition": "pure planning before any asset categories or storage constraints are known",
23
+ "delegateTo": "asset-license-checker",
24
+ "reason": "Delegates out-of-scope requests to asset-license-checker"
25
+ },
26
+ {
27
+ "condition": "sourcing or acquiring external assets",
28
+ "delegateTo": "asset-discovery",
29
+ "reason": "use asset-discovery"
30
+ },
31
+ {
32
+ "condition": "verifying asset licenses",
33
+ "delegateTo": "asset-license-checker",
34
+ "reason": "use asset-license-checker"
35
+ },
36
+ {
37
+ "condition": "checking visual style consistency across assets",
38
+ "delegateTo": "asset-style-check",
39
+ "reason": "use asset-style-check"
40
+ },
41
+ {
42
+ "condition": "planning fallback substitutions when an asset is missing or fails",
43
+ "delegateTo": "asset-fallback-strategy",
44
+ "reason": "use asset-fallback-strategy"
45
+ },
46
+ {
47
+ "condition": "enforcing file size or polygon/asset count performance budgets",
48
+ "delegateTo": "mobile-glb-budget",
49
+ "reason": "use mobile-glb-budget"
50
+ }
51
+ ],
52
+ "inputs": {
53
+ "required": [
54
+ {
55
+ "name": "raw_asset_inventory",
56
+ "type": "array",
57
+ "description": "List of 3D models, PBR material sets, HDRIs, and license sidecar files to organize"
58
+ },
59
+ {
60
+ "name": "project_storage_scope",
61
+ "type": "string",
62
+ "description": "Whether the library is project-local or shared across multiple BlendOps packs"
63
+ }
64
+ ],
65
+ "optional": [
66
+ {
67
+ "name": "naming_prefix_convention",
68
+ "type": "string",
69
+ "description": "Optional studio or project naming prefix for datablocks and folders"
70
+ }
71
+ ]
72
+ },
73
+ "outputs": {
74
+ "primary": [
75
+ "directory_taxonomy_plan",
76
+ "datablock_naming_rules",
77
+ "quarantine_and_license_sidecar_policy"
78
+ ],
79
+ "truthStatePolicy": {
80
+ "runtimeDefault": "Not Run",
81
+ "artifactDefault": "Not Produced",
82
+ "mutationRule": "downgrade_only"
83
+ }
84
+ },
85
+ "handoffs": [
86
+ {
87
+ "target": "asset-discovery",
88
+ "type": "upstream_reference",
89
+ "label": "External asset sourcing into this library",
90
+ "when": {
91
+ "all": [
92
+ {
93
+ "field": "brief.locked",
94
+ "operator": "equals",
95
+ "value": true
96
+ },
97
+ {
98
+ "field": "assets.discoveryComplete",
99
+ "operator": "equals",
100
+ "value": false
101
+ }
102
+ ]
103
+ }
104
+ },
105
+ {
106
+ "target": "asset-license-checker",
107
+ "type": "upstream_reference",
108
+ "label": "License verification (license file next to asset; unlicensed old assets to Quarantine)",
109
+ "when": {
110
+ "all": [
111
+ {
112
+ "field": "assets.externalUsed",
113
+ "operator": "equals",
114
+ "value": true
115
+ },
116
+ {
117
+ "field": "assets.licenseCleared",
118
+ "operator": "equals",
119
+ "value": false
120
+ }
121
+ ]
122
+ }
123
+ },
124
+ {
125
+ "target": "asset-style-check",
126
+ "type": "upstream_reference",
127
+ "label": "Visual style consistency checks",
128
+ "when": {
129
+ "all": [
130
+ {
131
+ "field": "assets.licenseCleared",
132
+ "operator": "equals",
133
+ "value": true
134
+ },
135
+ {
136
+ "field": "stage.current",
137
+ "operator": "equals",
138
+ "value": "style_check"
139
+ }
140
+ ]
141
+ }
142
+ },
143
+ {
144
+ "target": "asset-fallback-strategy",
145
+ "type": "fallback",
146
+ "label": "Consuming this library as fastest fallback source",
147
+ "when": {
148
+ "all": [
149
+ {
150
+ "field": "assets.fallbackNeeded",
151
+ "operator": "equals",
152
+ "value": true
153
+ }
154
+ ]
155
+ }
156
+ },
157
+ {
158
+ "target": "mobile-glb-budget",
159
+ "type": "progression",
160
+ "label": "File size and asset/polygon count pressure",
161
+ "when": {
162
+ "all": [
163
+ {
164
+ "field": "artifact.type",
165
+ "operator": "equals",
166
+ "value": "glb"
167
+ },
168
+ {
169
+ "field": "budget.pinned",
170
+ "operator": "equals",
171
+ "value": false
172
+ }
173
+ ]
174
+ }
175
+ }
176
+ ]
177
+ }
@@ -0,0 +1,63 @@
1
+ # Folder structure rules
2
+
3
+ ## Top-level structure (recommended)
4
+
5
+ ```
6
+ assets/
7
+ models/
8
+ textures/
9
+ hdris/
10
+ fonts/
11
+ audio/
12
+ brushes/
13
+ presets/
14
+ ```
15
+
16
+ All kebab-case, all lowercase.
17
+
18
+ ## Per-category sub-structure
19
+
20
+ ### models/
21
+ - products/
22
+ - characters/
23
+ - environments/
24
+ - props/
25
+
26
+ ### textures/
27
+ - pbr/
28
+ - metals/
29
+ - woods/
30
+ - fabrics/
31
+ - gradients/
32
+ - alphas/
33
+
34
+ ### hdris/
35
+ - studio/
36
+ - outdoor/
37
+ - indoor/
38
+
39
+ ### fonts/
40
+ - (subfolders only if >50 fonts)
41
+
42
+ ## Rules
43
+
44
+ - Max nesting depth: 4 levels.
45
+ - Each folder has a README.md describing what belongs there.
46
+ - Each asset folder has a LICENSE.txt or LICENSE per asset.
47
+
48
+ ## Anti-patterns
49
+
50
+ - "misc/" or "other/" folders → vague; rejects organization discipline.
51
+ - Date-prefixed folder names ("2026-projects/") → mixes time-based and category-based; pick one.
52
+ - Per-recipe folders inside `assets/` → assets are reusable; recipes consume them.
53
+
54
+ ## Migration
55
+
56
+ When reorganizing existing assets:
57
+ 1. Inventory existing assets with paths.
58
+ 2. Map each to new location.
59
+ 3. Update references (Blender file paths, recipes).
60
+ 4. Re-test renders that used the assets.
61
+
62
+ ## Related skill
63
+ `../SKILL.md`
@@ -0,0 +1,62 @@
1
+ # Metadata schema
2
+
3
+ Each asset has a sidecar `<asset-name>.metadata.json` (or .yaml) with these fields.
4
+
5
+ ## Required fields
6
+
7
+ ```json
8
+ {
9
+ "name": "sneaker-hero",
10
+ "version": "v01",
11
+ "category": "models/products",
12
+ "license": "CC0 1.0",
13
+ "license_url": "https://creativecommons.org/publicdomain/zero/1.0/",
14
+ "source_url": "https://polyhaven.com/...",
15
+ "source_platform": "polyhaven",
16
+ "acquired_date": "2026-05-09",
17
+ "file_hash_sha256": "<hash>",
18
+ "file_size_bytes": 1234567,
19
+ "format": "glb"
20
+ }
21
+ ```
22
+
23
+ ## Optional fields
24
+
25
+ ```json
26
+ {
27
+ "author": "Original creator name",
28
+ "tags": ["sneaker", "footwear", "product-hero"],
29
+ "polycount": 24500,
30
+ "texture_resolutions": ["2048x2048", "1024x1024"],
31
+ "uv_layouts": 1,
32
+ "rigged": false,
33
+ "animated": false,
34
+ "preview_image": "preview.png",
35
+ "notes": "Free-form notes",
36
+ "supersedes": "sneaker-hero-old-v01-cc0.glb",
37
+ "review_status": "approved",
38
+ "reviewer": "alice"
39
+ }
40
+ ```
41
+
42
+ ## Why a sidecar file
43
+
44
+ - Survives version control (text diffs).
45
+ - Searchable by tools.
46
+ - Decoupled from binary file format.
47
+ - Re-readable without opening the asset.
48
+
49
+ ## Required fields rationale
50
+
51
+ - `license` + `license_url`: enables `asset-license-checker` lookups.
52
+ - `source_url`: provenance.
53
+ - `acquired_date`: license version pinning.
54
+ - `file_hash_sha256`: detect tampering / accidental changes.
55
+ - `file_size_bytes`: inform storage / VCS choice.
56
+
57
+ ## Generating metadata
58
+
59
+ Most fields can be auto-derived (size, hash, format, polycount). License + source require human input at acquisition time.
60
+
61
+ ## Related skill
62
+ `../SKILL.md`
@@ -0,0 +1,51 @@
1
+ # Naming rules
2
+
3
+ ## Pattern
4
+
5
+ ```
6
+ <asset-name>-<version>-<license-slug>.<ext>
7
+ ```
8
+
9
+ Examples:
10
+ - `sneaker-hero-v01-cc0.glb`
11
+ - `studio-hdri-v02-cc0.exr`
12
+ - `oak-wood-pbr-v01-cc-by.zip`
13
+ - `helvetica-neue-v01-proprietary.ttf`
14
+
15
+ ## Rules
16
+
17
+ - Kebab-case lowercase.
18
+ - No spaces.
19
+ - No special characters except hyphen and dot.
20
+ - Version always present (start at v01).
21
+ - License slug always present.
22
+
23
+ ## License slugs
24
+
25
+ | License | Slug |
26
+ |---|---|
27
+ | CC0 | cc0 |
28
+ | CC-BY 4.0 | cc-by |
29
+ | CC-BY-SA 4.0 | cc-by-sa |
30
+ | CC-BY-NC 4.0 | cc-by-nc |
31
+ | MIT | mit |
32
+ | Apache 2.0 | apache-2 |
33
+ | Proprietary / commercial | proprietary |
34
+ | Internal / confidential | internal |
35
+ | Unknown / quarantine | quarantine |
36
+
37
+ ## Versioning
38
+
39
+ - Bump version when the asset content changes meaningfully (re-modeled, re-textured, re-rendered HDRI).
40
+ - Do not bump version for metadata changes only.
41
+ - Keep prior versions in the library (do not delete) until referenced recipes are updated.
42
+
43
+ ## Forbidden in names
44
+
45
+ - Date stamps (use git history instead).
46
+ - "Final", "v2-final", "v3-real-final" (use proper version numbers).
47
+ - Author initials (use git author info).
48
+ - Project codenames (assets are reusable; not project-bound).
49
+
50
+ ## Related skill
51
+ `../SKILL.md`
@@ -0,0 +1,33 @@
1
+ # EVAL — asset-license-checker
2
+
3
+ ## Text-only eval prompt
4
+ Apply asset-license-checker on a 4-asset list (1 CC0 HDRI from polyhaven, 1 MIT model from sketchfab, 1 unknown texture, 1 paid commercial license model). Intended use: commercial brand campaign.
5
+
6
+ ## Expected behavior
7
+ - 4-row asset table with source / license / permissions / verdict
8
+ - attribution lines listed
9
+ - assets to remove flagged (the unknown one as Fail)
10
+ - top-line status
11
+ - "not legal advice" caveat
12
+
13
+ ## Pass / Warn / Fail criteria
14
+ - Pass: 4 rows + verdicts + attribution + caveat
15
+ - Warn: rows present but attribution incomplete
16
+ - Fail: marks "should be fine" verdicts, fabricates license terms
17
+
18
+ ## Common failure modes
19
+ - "Should be fine" verdicts
20
+ - skipping attribution plan
21
+ - inventing license terms
22
+ - treating "all rights reserved" as usable
23
+
24
+ ## Sample passing response outline
25
+ - Header: intended use + attribution policy
26
+ - 4 rows + verdicts
27
+ - Attribution list
28
+ - Assets to remove
29
+ - Top-line + caveat
30
+
31
+ ## Sample failing response outline
32
+ - "Looks OK to use"
33
+ - No license terms cited