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,296 @@
1
+ ---
2
+ # TEMPLATE — DO NOT UPLOAD AS-IS. Replace every <placeholder> before saving as a real skill.
3
+ # name: kebab-case lowercase letters/numbers/hyphens only, max 64 chars.
4
+ # description: max 200 chars (Claude.ai upload UI limit). No version/status/tags keys.
5
+ # Spec: https://support.anthropic.com/en/articles/12512198-creating-custom-skills
6
+ name: <skill-name>
7
+ description: <One sentence: what this skill does and the exact situations that should trigger it.>
8
+ ---
9
+
10
+ <!--
11
+ TEMPLATE FILE — DO NOT UPLOAD OR ZIP AS-IS.
12
+
13
+ Before using:
14
+ 1. Replace EVERY `<placeholder>` (name, description, headings, examples).
15
+ 2. Confirm `name` matches your folder slug exactly.
16
+ 3. Confirm `description` is ≤200 chars and triggers the right use cases.
17
+ 4. Delete this HTML comment block.
18
+
19
+ This file is excluded from `npm run skills:export` and from docs:check
20
+ frontmatter validation, so it can keep placeholder values safely in-repo.
21
+ -->
22
+
23
+ # <skill-name>
24
+
25
+ ## Purpose
26
+
27
+ State the skill's narrow job in one or two sentences. Keep it composable; do not make this skill own unrelated planning, runtime, evidence, and handoff work at the same time.
28
+
29
+ ## Quick start
30
+
31
+ 1. Confirm the user's goal and current evidence state.
32
+ 2. Select the correct runtime stack posture, if runtime is relevant.
33
+ 3. Follow the workflow below.
34
+ 4. Return the output contract with explicit evidence/caveat status.
35
+
36
+ ## When to use
37
+
38
+ Use this skill when:
39
+
40
+ - <trigger condition 1>
41
+ - <trigger condition 2>
42
+ - <trigger condition 3>
43
+
44
+ ## When not to use
45
+
46
+ Do not use this skill when:
47
+
48
+ - The request belongs to a narrower existing skill.
49
+ - The user asks for runtime execution but readiness has not been checked.
50
+ - The task would require claiming preview/render/GLB artifacts without evidence.
51
+ - The task would promote unofficial bridge setup as an official path.
52
+
53
+ ## Trigger phrases
54
+
55
+ - “<example trigger>”
56
+ - “<example trigger>”
57
+ - “<example trigger>”
58
+
59
+ ## Prerequisites / readiness
60
+
61
+ - Current BlendOps status is known: 1.0.0 unless a newer release-readiness doc says otherwise.
62
+ - Runtime state is one of: `Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`.
63
+ - If runtime is needed, identify the intended stack before execution.
64
+ - If artifacts are discussed, evidence source and output paths must be available or marked missing.
65
+
66
+ ## Input schema
67
+
68
+ ### Required inputs
69
+
70
+ | Input | Why it is required |
71
+ |---|---|
72
+ | User goal | Defines scope and prevents overwork. |
73
+ | Current runtime/artifact state | Prevents unsupported success claims. |
74
+ | Relevant target surface or workflow | Determines handoff and constraints. |
75
+
76
+ ### Optional inputs
77
+
78
+ | Input | Use |
79
+ |---|---|
80
+ | Runtime stack | Needed only when runtime work is in scope. |
81
+ | Output target | Helps shape render/export/evidence requirements. |
82
+ | Existing evidence links | Lets the skill verify rather than speculate. |
83
+
84
+ ### Assumptions to confirm
85
+
86
+ - Runtime install is separate from skill install.
87
+ - No Blender mutation/render/export occurs unless explicitly requested and readiness passes.
88
+ - Missing evidence means the output remains conservative.
89
+
90
+ ## Output schema
91
+
92
+ ### Primary output
93
+
94
+ - <main deliverable>
95
+
96
+ ### Secondary output
97
+
98
+ - next recommended skill/doc
99
+ - blockers or caveats
100
+ - user-facing status line
101
+
102
+ ### Evidence / caveat output
103
+
104
+ Always include:
105
+
106
+ ```txt
107
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
108
+ Artifact status: Not Produced | Produced | Verified | Failed
109
+ Evidence used: <links, paths, logs, or "none">
110
+ Limitations: <known gaps>
111
+ ```
112
+
113
+ ## Required laws
114
+
115
+ - `../../laws/official-runtime-only.md`
116
+ - `../../laws/evidence-before-done.md`
117
+ - `../../laws/non-blender-user-language.md`
118
+ - `../../laws/no-arbitrary-python-interface.md`
119
+
120
+ ## Official runtime boundary
121
+
122
+ BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix** (replaces older 3-stack and 4-route drafts — see `../../docs/runtime-stack-strategy.md` for the corrected attribution history):
123
+
124
+ 1. **Path 1 — Official Blender Lab MCP** (Lab add-on + Lab server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually). Anthropic Connector is **not** standalone — Anthropic's tutorial step 2 tells you to install the Lab add-on inside Blender.
125
+ 2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`)** (different `addon.py` + server via `uvx mcp-for-blender`, mature third-party, Blender 3.0+).
126
+ 3. **CLI fallback (appendix)** — direct `blender --background --python`, no MCP. **Documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet.
127
+
128
+ Blender 5.1+ floor applies to all of Path 1 (whichever host). Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance.
129
+
130
+ This skill must not install Blender, run Blender, configure a runtime bridge, mutate a scene, render, export GLB, or claim artifacts unless the user explicitly requested that work and evidence exists.
131
+
132
+ ## Runtime route requirements
133
+
134
+ | Path | Requirement before use |
135
+ |---|---|
136
+ | Path 1 (Blender-side, always required) | Blender 5.1+ + Lab MCP add-on installed in Blender + Lab MCP server (`.mcpb` bundle or source) reachable. |
137
+ | Path 1, host (a) Anthropic Connector | Connector enabled in Claude Desktop → Customize → Connectors; read-only request first. |
138
+ | Path 1, host (b) manual MCP client | Lab MCP server registered in client's `mcpServers` JSON or equivalent UI; read-only request first. |
139
+ | Path 2 (community `mcp-for-blender` (formerly `blender-mcp`)) | `uvx mcp-for-blender` registered in client config + `addon.py` installed/enabled in Blender 3.0+; read `../../docs/unofficial-runtime-bridges.md` first; explicit user opt-in for `execute_blender_code` (no sandbox). |
140
+ | CLI fallback (appendix) | Exact Blender executable/CLI command, input/script, output paths, logs, validation evidence; note that BlendOps has no in-repo evidence file yet (the CLI surface itself is upstream-documented). |
141
+
142
+ ## Operating procedure
143
+
144
+ 1. Identify user goal and current phase.
145
+ 2. Check whether this skill is the narrowest applicable skill.
146
+ 3. Confirm required inputs and assumptions.
147
+ 4. Apply relevant laws.
148
+ 5. Execute the workflow steps for this skill.
149
+ 6. Produce the output contract.
150
+ 7. Hand off to the next skill or doc when needed.
151
+
152
+ ## Decision tree
153
+
154
+ ```txt
155
+ Need help choosing next step?
156
+ → blendops-help
157
+ Need runtime readiness?
158
+ → runtime-readiness
159
+ Need scene plan?
160
+ → product-hero-scene-planner and domain planners
161
+ Need render/export proof?
162
+ → render-export-evidence
163
+ Need GLB/web handoff wording?
164
+ → glb-web-handoff
165
+ Need final non-Blender-user summary?
166
+ → plain-language-response
167
+ ```
168
+
169
+ ## Playbooks
170
+
171
+ ### Playbook A: Text-only mode
172
+
173
+ - Keep runtime status `Not Run`.
174
+ - Produce planning/checklist output only.
175
+ - State that preview/render/GLB artifacts are `Not Produced` unless evidence exists.
176
+
177
+ ### Playbook B: Runtime-ready mode
178
+
179
+ - Verify runtime stack and preflight evidence.
180
+ - Record exact actions, tools, inputs, output paths, and limitations.
181
+ - Do not upgrade status beyond the evidence.
182
+
183
+ ### Playbook C: Blocked mode
184
+
185
+ - Identify blocker.
186
+ - Keep runtime/artifact status conservative.
187
+ - Recommend the next safe readiness or planning step.
188
+
189
+ ## Mode handling
190
+
191
+ ### Text-only mode
192
+
193
+ Use when Blender is not available or not requested. Do not imply runtime execution.
194
+
195
+ ### Runtime-ready mode
196
+
197
+ Use only when the user explicitly requests runtime work and readiness is documented.
198
+
199
+ ### Blocked runtime mode
200
+
201
+ Use when requirements are missing. Report blockers and next safe action.
202
+
203
+ ## Validation checklist
204
+
205
+ - [ ] Skill scope fits the user request.
206
+ - [ ] Required laws were applied.
207
+ - [ ] Runtime stack status is explicit.
208
+ - [ ] Artifact evidence status is explicit.
209
+ - [ ] No unsupported runtime route is presented as supported.
210
+ - [ ] No preview/render/GLB claim appears without evidence.
211
+ - [ ] Handoff names the next skill/doc.
212
+
213
+ ## Pass / Warn / Fail rubric
214
+
215
+ | Verdict | Criteria |
216
+ |---|---|
217
+ | Pass | Output satisfies scope, evidence state is explicit, and no overclaim appears. |
218
+ | Warn | Output is useful but has missing inputs, partial evidence, or scoped uncertainty. |
219
+ | Fail | Output claims unsupported runtime/artifact success, ignores laws, or routes to an unsupported path. |
220
+
221
+ ## Failure handling
222
+
223
+ - If evidence is missing, downgrade status instead of guessing.
224
+ - If runtime readiness is unknown, hand off to readiness skill.
225
+ - If a user asks for unsupported direct official MCP usage, mark it future research/unverified.
226
+ - If an unofficial bridge appears, keep it optional/local and outside release evidence.
227
+
228
+ ## Troubleshooting
229
+
230
+ | Problem | Response |
231
+ |---|---|
232
+ | User wants “done” without evidence | Explain missing evidence and use `Not Run` / `Not Produced`. |
233
+ | User conflates skill install with runtime install | Separate skill install, runtime setup, and eval evidence. |
234
+ | User asks for marketplace/package claim | Keep as future until verified. |
235
+
236
+ ## Best practices
237
+
238
+ - Prefer operational checklists over essays.
239
+ - Keep examples short and evidence-bound.
240
+ - Link docs instead of copying large reference content.
241
+ - Use precise status words.
242
+ - Hand off instead of expanding scope.
243
+
244
+ ## Good examples
245
+
246
+ - “Runtime status: Not Run. Artifact status: Not Produced. Next safe action: run runtime readiness checklist for Path 1, host (a) Anthropic Blender Connector.”
247
+ - “Produced evidence exists at `<path>`, but validation is incomplete; status remains Produced, not Verified.”
248
+
249
+ ## Bad examples
250
+
251
+ - “Everything is ready” without evidence.
252
+ - “GLB produced” without file path and validation notes.
253
+ - “Use official direct MCP from Claude Code” as a supported route.
254
+
255
+ ## User-facing response template
256
+
257
+ ```txt
258
+ Status: <Pass/Warn/Fail or scoped status>
259
+ Runtime: <state>
260
+ Artifacts: <state>
261
+ Evidence: <paths/links/logs or none>
262
+ Next safe action: <skill/doc/action>
263
+ Limitations: <gaps>
264
+ ```
265
+
266
+ ## Anti-patterns
267
+
268
+ - Turning a planning skill into a runtime executor.
269
+ - Treating third-party bridge setup as official.
270
+ - Treating read-only connector access as full runtime eval.
271
+ - Treating install success as artifact success.
272
+
273
+ ## Cross-skill handoff
274
+
275
+ - Runtime readiness → `../runtime-readiness/SKILL.md`
276
+ - Scene planning → `../product-hero-scene-planner/SKILL.md`
277
+ - Render/export evidence → `../render-export-evidence/SKILL.md`
278
+ - GLB handoff → `../glb-web-handoff/SKILL.md`
279
+ - Final response → `../plain-language-response/SKILL.md`
280
+
281
+ ## Non-goals
282
+
283
+ - Install Blender.
284
+ - Run Blender.
285
+ - Configure connector/MCP/CLI runtime.
286
+ - Create scene data.
287
+ - Render or export GLB.
288
+ - Claim marketplace/package availability.
289
+
290
+ ## References
291
+
292
+ - `../../docs/skill-system.md`
293
+ - `../../docs/runtime-stack-strategy.md`
294
+ - `../../docs/evals/runtime-availability-checklist.md`
295
+ - `../../docs/evals/official-runtime-verification-criteria.md`
296
+ - `../../docs/distribution-strategy.md`
@@ -0,0 +1,25 @@
1
+ # EVAL — acceptance-criteria-builder
2
+
3
+ ## Text-only eval prompt
4
+
5
+ Brief: hero sneaker, cyberpunk neon, wet pavement reflection, deliver web GLB + hero PNG 2K. Build acceptance checklist.
6
+
7
+ ## Expected behavior
8
+
9
+ - Rows for silhouette readability, reflection intensity bounds, GLB size tier, PNG transparency need
10
+ - Evidence hooks → render-export-evidence + glb-web-handoff paths
11
+ - Subjective "cyberpunk feel" flagged subjective with stakeholder sign-off
12
+
13
+ ## Pass / Warn / Fail criteria
14
+
15
+ - Pass: P0 measurable + hooks
16
+ - Warn: too many subjective rows
17
+ - Fail: promises Verified without evidence path
18
+
19
+ ## Sample passing response outline
20
+
21
+ - Table + subjective flags
22
+
23
+ ## Sample failing response outline
24
+
25
+ - "Looks amazing" as only criterion
@@ -0,0 +1,257 @@
1
+ ---
2
+ name: acceptance-criteria-builder
3
+ description: Turn a locked 3D brief plus chosen recipe into a measurable acceptance checklist with evidence hooks.
4
+ ---
5
+
6
+ # acceptance-criteria-builder
7
+
8
+ ## Purpose
9
+
10
+ Turn a locked 3D brief plus chosen recipe into a measurable acceptance checklist (`Criterion | Measurement | Evidence expected | Owner`) with evidence hooks, consumed by validators, `render-export-evidence`, and `pre-handoff-verification`. This skill is planning-only: it never executes Blender or Python, never produces artifacts, and never verifies files itself.
11
+
12
+ ## Quick start
13
+
14
+ - ingest brief slots + recipe expectations
15
+ - expand using `references/checklist-patterns.md`
16
+ - attach evidence hooks per `references/evidence-hook-rules.md`
17
+ - format via `references/brief-to-criteria-mapper.md`
18
+
19
+ ## When to use
20
+
21
+ - after a brief is locked with `intent-to-3d-brief-writer` and a recipe is chosen, before expensive render or export stages
22
+ - when translating qualitative brief goals into measurable checklist rows with evidence hooks
23
+ - after `scope-guard` approves a brief or recipe delta that requires updated acceptance rows
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - pure exploration without a locked deliverable → use `../blender-brainstorming/SKILL.md` (use blender-brainstorming)
28
+ - writing or locking the brief itself → use `../intent-to-3d-brief-writer/SKILL.md` (use intent-to-3d-brief-writer)
29
+ - pinning the stop or done condition → use `../done-criteria/SKILL.md` (use done-criteria)
30
+ - enforcing per-stage workflow gates → use `../stage-gates/SKILL.md` (use stage-gates)
31
+ - guarding or deciding scope boundaries → use `../scope-guard/SKILL.md` (use scope-guard)
32
+ - legal or license-permission language → use `../asset-license-checker/SKILL.md` (use asset-license-checker)
33
+ - classifying artifact evidence → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
34
+ <!-- blendops:generated:end exclusions -->
35
+
36
+ ## Trigger phrases
37
+ <!-- blendops:generated:start triggers -->
38
+ - "acceptance criteria"
39
+ - "measurable checklist rows"
40
+ - "evidence hooks for brief"
41
+ - "sign-off checklist table"
42
+ <!-- blendops:generated:end triggers -->
43
+
44
+ ## Prerequisites / readiness
45
+
46
+ - brief considered locked enough for planners OR deltas explicitly listed
47
+ - recipe/pack anchor identified
48
+
49
+ ## Input schema
50
+
51
+ ### Required inputs
52
+
53
+ | Input | Why it is required |
54
+ |---|---|
55
+ | Locked brief summary | Source of target criteria (from `intent-to-3d-brief-writer`) |
56
+ | Chosen recipe | Anchors expected deliverables and stage checks |
57
+ | Priority outputs | Weights checklist rows (P0 vs secondary) |
58
+
59
+ ### Optional inputs
60
+
61
+ | Input | Use |
62
+ |---|---|
63
+ | Brand rubric | Adds objective rows |
64
+ | Platform constraints | Adds measurable thresholds |
65
+
66
+ ## Output schema
67
+
68
+ ### Primary output
69
+
70
+ - prioritized checklist table: `Criterion | Measurement | Evidence expected | Owner`
71
+
72
+ ### Evidence / caveat output
73
+
74
+ ```txt
75
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
76
+ Artifact status: Not Produced | Produced | Verified | Failed
77
+ Evidence used: <brief version ID + chosen recipe ID>
78
+ Limitations: <subjective rows flagged; planning-only — writing criteria never produces artifacts or verifies files>
79
+ ```
80
+
81
+ Rules for status reporting:
82
+
83
+ * Artifact status defaults to `Not Produced`; Runtime status defaults to `Not Run` when generating criteria.
84
+ * Truth states are downgrade-only, never upgrade.
85
+ * Never attach false `Verified` hooks or claim `Produced`/`Verified` status from criteria writing alone.
86
+
87
+ ## Required laws
88
+
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
+ This skill is strictly planning-only (no Python, no Blender execution). Checklists may define expected runtime evidence hooks, but must never execute tasks, verify files, or upgrade truth states beyond what upstream evidence skills report.
97
+
98
+ ## Operating procedure
99
+
100
+ 1. Ingest the locked brief and chosen recipe to map fields into criterion categories.
101
+ 2. Convert qualitative goals into measurable thresholds (`Criterion | Measurement | Evidence expected | Owner`) and explicitly flag any remaining subjective rows.
102
+ 3. Attach expected evidence hooks (without claiming `Produced` or `Verified` states) and route any license-permission items to `asset-license-checker`.
103
+ 4. Hand off the checklist to stage validators, `render-export-evidence` for artifact classification, and `pre-handoff-verification` for handoff gating.
104
+
105
+ ## Decision tree
106
+
107
+ ```txt
108
+ Is the 3D brief locked (or are approved deltas explicitly listed)?
109
+ No → stop and route to intent-to-3d-brief-writer (or blender-brainstorming if still exploratory)
110
+ Yes → continue
111
+ Is a target recipe or pack identified?
112
+ No → route to recipe-fit-assessor to anchor deliverable expectations
113
+ Yes → continue
114
+ Does the request ask to approve mid-stream scope additions?
115
+ Yes → route to scope-guard before updating acceptance rows
116
+ No → continue
117
+ Does a criterion involve asset licensing, redistribution, or attribution rules?
118
+ Yes → delegate license rows to asset-license-checker; keep technical/visual rows here
119
+ No → map brief slots to P0/P1/P2 rows with measurable thresholds and evidence hooks
120
+ Are any P0 rows inherently aesthetic or mood-driven (e.g., "cyberpunk atmosphere")?
121
+ Yes → pair with a proxy heuristic and mark as subjective requiring named stakeholder sign-off
122
+ No → attach objective validator and render-export-evidence ledger hooks
123
+ ```
124
+
125
+ ## Playbooks
126
+
127
+ ### Playbook A: Product hero still + web GLB acceptance table
128
+
129
+ - Map brief subject, framing, lighting contrast, output resolution (`resolution-aspect-decision`), file format (`output-format-decision`), and mobile/web GLB budget (`mobile-glb-budget`) into `Criterion | Measurement | Evidence expected | Owner` rows.
130
+ - Tag contractually required deliverables as `P0` and secondary polish items as `P1`/`P2`.
131
+ - Keep `Runtime status: Not Run` and `Artifact status: Not Produced` while authoring the table.
132
+
133
+ ### Playbook B: Subjective mood or brand aesthetic translation
134
+
135
+ - Decompose qualitative phrases (such as "warm luxury brass" or "wet neon street feel") into observable proxy measurements (key-to-fill contrast ratio notes, palette bounds, reflection roughness range) using `references/checklist-patterns.md`.
136
+ - Explicitly flag the remaining aesthetic judgment row as `[Subjective — requires stakeholder sign-off]` in the `Measurement` column per `references/evidence-hook-rules.md`.
137
+ - Forbid automatic `Verified` hooks on subjective rows without recorded human approval.
138
+
139
+ ### Playbook C: Post-delta criteria revision
140
+
141
+ - After `scope-guard` approves a brief or recipe change, update only the affected checklist rows and record the brief version ID in `Evidence used`.
142
+ - Preserve downgrade-only truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`) until `render-export-evidence` re-evaluates any affected outputs.
143
+
144
+ ## Mode handling
145
+
146
+ ### Text-only mode
147
+
148
+ Evidence hooks describe expected artifacts only. Set `Runtime status: Not Run` and `Artifact status: Not Produced`.
149
+
150
+ ### Runtime-ready mode
151
+
152
+ Add measurement rows with evidence hooks consumed by `render-export-evidence` and validators. Keep `Artifact status: Not Produced` until downstream evidence skills classify actual outputs.
153
+
154
+ ### Blocked runtime mode
155
+
156
+ Keep the measurable criteria table intact, record the blocker under `Limitations`, and use only valid downgrade-only truth states (`Runtime status: Not Run` or `Failed`; `Artifact status: Not Produced` or `Failed` — never invent a `Blocked` state).
157
+
158
+ ## Validation checklist
159
+
160
+ * [ ] Every P0 criterion is measurable or explicitly flagged as subjective
161
+ * [ ] Every P0 row includes `Criterion | Measurement | Evidence expected | Owner`
162
+ * [ ] No false `Verified` hooks or upgraded truth states (`Not Produced` default preserved)
163
+ * [ ] No license-permission language included (delegated to `asset-license-checker`)
164
+ * [ ] No role overlap with stop-condition, stage-gate, scope, or verification skills
165
+
166
+ ## Pass / Warn / Fail rubric
167
+
168
+ | Verdict | Criteria |
169
+ | --- | --- |
170
+ | Pass | P0 criteria measurable + evidence hooks attached + subjective rows flagged + default `Not Produced` preserved |
171
+ | Warn | Subjective-heavy list flagged for stakeholder sign-off |
172
+ | Fail | False `Verified` hooks, invalid or upgraded truth states (e.g., `Blocked`), license-permission rows written here, or claims of execution/verification |
173
+
174
+ ## Failure handling
175
+
176
+ - If the input brief is unlocked or missing core deliverable slots, do not invent criteria; return a blocked planning note with `Runtime status: Not Run` and `Artifact status: Not Produced` and route to `intent-to-3d-brief-writer`.
177
+ - If the user asks to mark rows `Verified` during criteria authoring, refuse the upgrade, explain that `acceptance-criteria-builder` is planning-only, and route actual output files to `render-export-evidence`.
178
+ - If the prompt mixes acceptance criteria with legal asset-permission checks, strip the legal language from this checklist and route those items to `asset-license-checker`.
179
+ - If an upstream gate has already failed, preserve downgrade-only truth states and route to `pre-handoff-verification`.
180
+
181
+ ## Troubleshooting
182
+
183
+ | Symptom | Cause | Safe resolution |
184
+ |---|---|---|
185
+ | Checklist explodes beyond 15+ rows | Every minor scene detail was promoted to `P0` | Apply `references/brief-to-criteria-mapper.md` (1–3 criteria per brief slot on first pass) and demote non-blocking polish to `P1`/`P2`. |
186
+ | Mood criterion has no testable threshold | Adjective copied verbatim from brief ("looks cinematic") | Pair with framing/lighting validator hooks (`composition-quality-checker`, `lighting-quality-checker`) and flag the residual aesthetic check for stakeholder sign-off. |
187
+ | Stakeholder treats checklist table as proof that files exist | Evidence hook column misread as completed verification | Restate `Runtime status: Not Run` and `Artifact status: Not Produced`, and clarify that `Evidence expected` describes future proof required by `render-export-evidence`. |
188
+
189
+ ## Best practices
190
+
191
+ - Keep `P0` rows concise, observable, and directly tied to a brief slot or recipe constraint (`references/brief-to-criteria-mapper.md`).
192
+ - Name the exact downstream validator or evidence skill in `Owner` / `Evidence expected` (for example, `polycount-budget-checker`, `mobile-glb-budget`, `render-export-evidence`).
193
+ - Separate objective technical thresholds from subjective creative sign-off rows so automated gates and human reviews never collide.
194
+ - Always emit `Runtime status: Not Run` and `Artifact status: Not Produced` when publishing or updating criteria tables.
195
+
196
+ ## Good examples
197
+
198
+ - "`P0 | Hero PNG resolution & alpha | 2048x2048 RGBA PNG with transparent background | Output path + image header check in render-export-evidence (target: Verified) | render-export-evidence`"
199
+ - "`P0 | Web GLB file size & triangle budget | <= 5 MB total file size, <= 50k triangles | GLB inspection ledger via polycount-budget-checker + mobile-glb-budget | render-export-evidence`"
200
+ - "`P1 | Cyberpunk neon mood read [Subjective] | Cyan/magenta rim contrast + wet ground specular read; requires human art-direction sign-off | Preview render + signed stakeholder note | Stakeholder + lighting-quality-checker`"
201
+
202
+ ## Bad examples
203
+
204
+ - "`P0 | Scene quality | Looks amazing and photorealistic | Engineer says it looks good | AI agent`" — untestable adjective with a forbidden self-attestation hook.
205
+ - "`P0 | Final GLB | Verified and ready for production | Artifact status: Verified | acceptance-criteria-builder`" — fabricates artifact verification inside a planning-only skill.
206
+ - "`P0 | Third-party sneaker logo license | Cleared for commercial resale | Checked by acceptance-criteria-builder | acceptance-criteria-builder`" — violates role boundary with `asset-license-checker`.
207
+
208
+ ## User-facing response template
209
+
210
+ ```txt
211
+ Brief & recipe anchor: <locked brief ID + chosen recipe/pack>
212
+
213
+ Acceptance criteria checklist:
214
+ | Priority | Criterion | Measurement | Evidence expected | Owner |
215
+ |---|---|---|---|---|
216
+ | P0 | <criterion> | <measurable threshold or [Subjective] flag> | <artifact type + validator + target truth state> | <skill or stakeholder> |
217
+ | P1 | <criterion> | <measurable threshold or [Subjective] flag> | <artifact type + validator + target truth state> | <skill or stakeholder> |
218
+
219
+ Subjective sign-off notes: <rows requiring human stakeholder approval, or none>
220
+ Runtime status: Not Run
221
+ Artifact status: Not Produced
222
+ Evidence used: <brief version ID + recipe path + reference docs consulted>
223
+ Limitations: <planning-only checklist; does not execute Blender or verify files>
224
+ Next skill: <stage-gates | render-export-evidence | pre-handoff-verification>
225
+ ```
226
+
227
+ ## Anti-patterns
228
+
229
+ - Marking any row or output block `Produced` or `Verified` merely because acceptance criteria were written.
230
+ - Writing `Artifact status: Not Run` instead of `Artifact status: Not Produced` (or inventing a `Blocked` truth state).
231
+ - Accepting vague adjectives ("clean", "pop", "realistic") as `P0` measurements without either a quantifiable proxy or an explicit `[Subjective]` stakeholder sign-off flag.
232
+ - Authoring legal copyright or license clearance criteria here instead of handing off to `asset-license-checker`.
233
+ - Replacing `done-criteria`, `stage-gates`, or `pre-handoff-verification` with ad-hoc gate logic.
234
+
235
+ ## Cross-skill handoff
236
+ <!-- blendops:generated:start handoffs -->
237
+ - [upstream_reference] Brief source → `../intent-to-3d-brief-writer/SKILL.md`
238
+ - [progression] Done / stop condition → `../done-criteria/SKILL.md`
239
+ - [progression] Per-stage gate enforcement → `../stage-gates/SKILL.md`
240
+ - [progression] Scope boundary enforcement → `../scope-guard/SKILL.md`
241
+ - [progression] License permissions → `../asset-license-checker/SKILL.md`
242
+ - [progression] Artifact evidence classification → `../render-export-evidence/SKILL.md`
243
+ - [progression] Handoff gate verification → `../pre-handoff-verification/SKILL.md`
244
+ <!-- blendops:generated:end handoffs -->
245
+
246
+ ## Non-goals
247
+
248
+ - Unlocking or rewriting the creative brief from scratch (use `intent-to-3d-brief-writer`).
249
+ - Executing Blender, generating Python scripts, or running automated file inspectors.
250
+ - Certifying that rendered images or exported GLB files actually meet the checklist (use `render-export-evidence` and `pre-handoff-verification`).
251
+ - Providing legal advice or asset license clearance (use `asset-license-checker`).
252
+
253
+ ## References
254
+
255
+ - `references/checklist-patterns.md`
256
+ - `references/evidence-hook-rules.md`
257
+ - `references/brief-to-criteria-mapper.md`