blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,251 @@
1
+ ---
2
+ name: polycount-budget-checker
3
+ description: Validate per-mesh and total-scene triangle counts against the pinned budget; flag worst offenders and topology hints without modeling.
4
+ ---
5
+
6
+ # polycount-budget-checker
7
+
8
+ ## Purpose
9
+ Run a focused pass/warn/fail check on per-mesh and total-scene triangle counts vs the pinned budget from `mobile-glb-budget` (or any other pinned budget). Surface worst offenders and basic topology hints without performing modeling.
10
+
11
+ ## Quick start
12
+ - read the pinned budget (per-mesh + total-scene)
13
+ - enumerate every mesh in the scene plan or measured scene
14
+ - compute per-mesh triangle counts vs per-mesh cap
15
+ - compute total-scene triangle count vs total cap
16
+ - flag worst offenders + give topology hints (no modeling)
17
+
18
+ ## When to use
19
+ - before render
20
+ - before GLB export
21
+ - after a mesh change request
22
+ - as a sub-check during full quality review
23
+ - when `mobile-glb-budget` is pinned
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - pinning or negotiating the performance budget itself → use `../mobile-glb-budget/SKILL.md` (use mobile-glb-budget)
28
+ - material validation → use `../material-quality-checker/SKILL.md` (use material-quality-checker)
29
+ - lighting validation → use `../lighting-quality-checker/SKILL.md` (use lighting-quality-checker)
30
+ - composition validation → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
31
+ - broad scene readiness review → use `../scene-readiness/SKILL.md` (use scene-readiness)
32
+ - classifying render or export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
33
+ - fixing topology, decimating, or retopologizing (this skill validates; it never edits or models) → use `../mobile-glb-budget/SKILL.md` (this skill validates; it never edits or models)
34
+ <!-- blendops:generated:end exclusions -->
35
+
36
+ ## Trigger phrases
37
+ <!-- blendops:generated:start triggers -->
38
+ - "is the polycount okay"
39
+ - "check triangle budget"
40
+ - "what's blowing the budget"
41
+ - "topology issue?"
42
+ <!-- blendops:generated:end triggers -->
43
+
44
+ ## Prerequisites / readiness
45
+ - pinned budget known (from `mobile-glb-budget` or explicit user)
46
+ - mesh list known (scene plan or measured scene)
47
+
48
+ ## Input schema
49
+
50
+ ### Required inputs
51
+
52
+ | Input | Why it is required |
53
+ |---|---|
54
+ | Pinned budget (per-mesh + total-scene caps) | Anchors the check (from `mobile-glb-budget`) |
55
+ | Mesh list (name + triangle count + count basis + instance count) | Defines scope, evaluated cost, and per-scene instance multiplier |
56
+
57
+ ### Optional inputs
58
+
59
+ | Input | Use |
60
+ |---|---|
61
+ | Scene scope context | Single product vs environment changes per-mesh expectations |
62
+ | Animation flags per mesh | Skinned meshes have stricter caps |
63
+ | Modifier / Scene Simplify notes | Flags Subdivision, Multiresolution, Solidify render levels or Scene Simplify reductions |
64
+
65
+ ### Assumptions to confirm
66
+ - The count that matters is the **evaluated render mesh** (base mesh + full modifier stack at render levels), not the viewport display.
67
+ - Every count states its basis (`base mesh` / `viewport` / `evaluated render mesh`); an unknown basis is marked `Not Run`, never guessed.
68
+ - Instances share geometry: count each unique mesh once against the per-mesh cap, and compute `base × N` callers for the total-scene cost.
69
+ - Counts include all visible meshes; hidden / collection-disabled meshes excluded.
70
+ - "Triangles" in glTF = primitive triangles after triangulation, not Blender face count.
71
+
72
+ ## Output schema
73
+
74
+ ### Primary output
75
+ A per-mesh row table: mesh name, triangle count, count basis (`base` / `viewport` / `evaluated render mesh` / `Not Run`), instance count (`N`), vs per-mesh cap, vs total budget contribution (`base × N`), validation verdict (`Pass` / `Warn` / `Fail` / `Not Run`), and advisory topology hint (no edit).
76
+
77
+ ### Secondary output
78
+ - top-line validation status (`Pass` / `Warn` / `Fail` / `Not Run`) computed from rows (separate from truth states)
79
+ - worst-offender list (top 1–3 meshes by evaluated contribution)
80
+ - general topology hints (advisory only, no modeling)
81
+
82
+ ### Evidence / caveat output
83
+
84
+ ```txt
85
+ Runtime status: Not Run | Attempted | Produced | Verified | Failed
86
+ Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
87
+ Evidence used: <links, paths, logs, or "none">
88
+ Limitations: <known gaps, viewport-only caveats, or Scene Simplify notes>
89
+ ```
90
+
91
+ Note: Truth states are downgrade-only (never upgrade). Validation verdicts (`Pass` / `Warn` / `Fail`) are separate from runtime and artifact truth states.
92
+
93
+ ## Required laws
94
+ - `../../laws/evidence-before-done.md`
95
+ - `../../laws/non-blender-user-language.md`
96
+ - `../../laws/no-arbitrary-python-interface.md`
97
+ - `../../laws/official-runtime-only.md`
98
+
99
+ ## Official runtime boundary
100
+
101
+ This skill validates plans or measured scene snapshots. It never decimates, retopologizes, or runs Blender. Hints are advisory.
102
+
103
+ ## Operating procedure
104
+ 1. Read the pinned budget from `mobile-glb-budget` output (or explicit user input).
105
+ 2. Read the mesh list, triangle counts, instance counts (`N`), and stated count basis (`base` / `viewport` / `evaluated render mesh`). If a mesh's count or basis is unknown, mark its row `Not Run` — never guess.
106
+ 3. Verify whether counts reflect the **evaluated render mesh** (base mesh + full modifier stack at render levels, accounting for Subdivision, Multiresolution, Solidify, and Scene Simplify). Flag viewport-only counts as undercounting risks.
107
+ 4. For each unique mesh, compare its evaluated triangle count once against the per-mesh cap (see `references/per-mesh-rules.md`).
108
+ 5. Compute total-scene triangle cost by summing `base × N` across all instances in the scene, then compare against the total-scene cap.
109
+ 6. Identify worst offenders (top 1–3 by evaluated count or scene contribution).
110
+ 7. Generate advisory topology hints per `references/topology-hints.md` (never model, decimate, or retopologize).
111
+ 8. Compute top-line validation status (`Pass` / `Warn` / `Fail`) separately from downgrade-only truth states.
112
+ 9. Hand off rows to `scene-readiness` (broad review), `mobile-glb-budget` (budget re-pinning), or `render-export-evidence` (artifact evidence classification).
113
+
114
+ ## Decision tree
115
+
116
+ ```txt
117
+ Count or count basis (base / viewport / evaluated render mesh) unknown?
118
+ → Mark row Not Run (never guess or fabricate)
119
+ Total evaluated triangle count (including base × N instances) > total cap?
120
+ → Fail (whole-scene)
121
+ Single mesh > 50% of total cap?
122
+ → Warn (one mesh dominates)
123
+ Single mesh > total cap by itself?
124
+ → Fail
125
+ Skinned mesh > per-mesh skinned cap?
126
+ → Fail (skinning cost is non-linear)
127
+ Hidden / disabled meshes consume budget by accident?
128
+ → Warn (verify exclusion before export)
129
+ Counts read at viewport levels while modifiers (Subdivision, Multiresolution, Solidify) render higher?
130
+ → Warn (viewport display undercounts cost; re-read evaluated render mesh)
131
+ Scene Simplify enabled at render time?
132
+ → Note in limitations; effective subdivision is lowered so rendered result may be cheaper than modeled
133
+ ```
134
+
135
+ ## Playbooks
136
+
137
+ ### Playbook A: Single-product hero
138
+ Use the pinned total and per-mesh caps from `mobile-glb-budget`. Verify every count states `evaluated render mesh` basis (accounting for Subdivision, Multiresolution, and Solidify at render levels). Fail any mesh exceeding the pinned per-mesh cap.
139
+
140
+ ### Playbook B: Multi-variant configurator
141
+ Use the pinned caps from `mobile-glb-budget`. Verify shared base meshes are counted once per active variant combination, while variant-specific overrides are evaluated per active configuration.
142
+
143
+ ### Playbook C: Instanced environment scene
144
+ Use the pinned caps from `mobile-glb-budget`. Instances (such as trees or fence posts) share geometry: validate the unique mesh once against the per-mesh cap, but compute `base × N` callers for the total-scene triangle cost.
145
+
146
+ ## Mode handling
147
+
148
+ ### Text-only mode
149
+ Read planned counts and stated basis from the scene plan; set `Runtime status: Not Run` and `Artifact status: Not Produced` (default). Mark any mesh with an unstated basis as `Not Run`.
150
+
151
+ ### Runtime-ready mode
152
+ Read evaluated render mesh counts from the measured scene snapshot and cite the source. Keep validation verdicts (`Pass` / `Warn` / `Fail`) separate from truth states. Truth states are strictly downgrade-only — never upgrade a truth state here; hand off artifact evidence classification to `render-export-evidence`.
153
+
154
+ ### Blocked runtime mode
155
+ Do not guess missing or unmeasured evaluated counts; mark affected rows `Not Run` and record the blocker under `Limitations`.
156
+
157
+ ## Validation checklist
158
+ - [ ] Pinned budget recorded from `mobile-glb-budget`
159
+ - [ ] Every mesh listed with triangle count and instance count (`N`)
160
+ - [ ] Count basis stated for every row (`base` / `viewport` / `evaluated render mesh`); unknown basis marked `Not Run`
161
+ - [ ] Modifiers with separate viewport/render levels (Subdivision, Multiresolution, Solidify) and Scene Simplify accounted for
162
+ - [ ] Instances counted once against per-mesh cap and `base × N` toward total-scene cost
163
+ - [ ] Per-mesh `%` of total budget and `Pass` / `Warn` / `Fail` / `Not Run` verdicts assigned
164
+ - [ ] Worst offenders highlighted and topology hints kept strictly advisory (no modeling)
165
+ - [ ] Truth states kept separate from validation verdicts and strictly downgrade-only (default artifact status `Not Produced`)
166
+
167
+ ## Pass / Warn / Fail rubric
168
+
169
+ | Verdict | Criteria |
170
+ |---|---|
171
+ | Pass | Evaluated render mesh basis stated; all unique meshes under per-mesh cap; total scene cost (including `base × N` instances) under total cap with 20% headroom; no single mesh dominates. |
172
+ | Warn | Total scene cost within 80–100% of cap; one mesh dominates (`> 50%` of total); skinned mesh near per-mesh cap; counts read at viewport basis when Subdivision, Multiresolution, or Solidify may evaluate higher at render. |
173
+ | Fail | Total scene cost over cap; single mesh over total or per-mesh cap; skinned mesh over per-mesh cap; missing pinned budget. |
174
+ | Not Run | Triangle count or count basis (`base` / `viewport` / `evaluated render mesh`) is missing or unknown (never guess). |
175
+
176
+ ## Failure handling
177
+ - Missing pinned budget → refuse validation; redirect to `mobile-glb-budget`.
178
+ - Mesh count or count basis missing/unknown → mark `Not Run` for that row; never guess or fabricate.
179
+ - User pushes for "Pass" without evaluated counts or basis → restate count-basis requirement and keep `Not Run` / `Warn`.
180
+ - User requests upgrading Runtime or Artifact truth state to `Verified` → refuse; truth states are downgrade-only (hand off evidence classification to `render-export-evidence`).
181
+
182
+ ## Troubleshooting
183
+
184
+ | Problem | Response |
185
+ |---|---|
186
+ | Total over cap | Identify worst offenders (including high `base × N` instance callers); recommend decimation or normal/texture detail trade (advisory only). |
187
+ | One mesh over per-mesh cap | Recommend splitting primitives or adding LODs (advisory only). |
188
+ | Skinned mesh expensive | Recommend reducing bone influences per vertex (clamp `≤ 4`) or bone count (advisory only). |
189
+ | Hidden meshes counted | Verify export settings exclude hidden or collection-disabled objects. |
190
+ | Viewport says under budget but render/export is heavy | Re-read the **evaluated render mesh**; modifiers with separate viewport/render levels (Subdivision, Multiresolution, Solidify) increase real cost, while Scene Simplify may temporarily lower effective subdivision in renders. |
191
+
192
+ ## Best practices
193
+ - Always pair total-scene and per-mesh caps from `mobile-glb-budget`; either alone is misleading.
194
+ - Reserve 20% headroom against absolute caps.
195
+ - Handle instances accurately: instances share geometry (count the unique mesh once against the per-mesh cap), but still compute `base × N` callers for the total-scene cost.
196
+ - Always validate the **evaluated render mesh** (base mesh + full modifier stack at render levels), never the viewport display, and state the basis on every count.
197
+ - Keep validation verdicts (`Pass` / `Warn` / `Fail`) separate from downgrade-only truth states.
198
+
199
+ ## Good examples
200
+ - "Basis: evaluated render mesh (Subdivision at render level 2). Total: 38K of 50K cap (76%). Per-mesh worst: `shoe-upper` at 18K (36% of total cap, under 40K per-mesh cap). Instances: `lace-eyelet` 500 tris × 12 = 6K scene cost. Verdict: Pass."
201
+
202
+ ## Bad examples
203
+ - "Polycount looks fine." — no numbers.
204
+ - "Verified" without measurement.
205
+
206
+ ## User-facing response template
207
+
208
+ ```txt
209
+ Pinned budget: <total triangles cap> | <per-mesh cap> (from mobile-glb-budget)
210
+
211
+ | Mesh | Tri count | Basis (base / viewport / evaluated render mesh / Not Run) | Instances (N) | Scene cost (base × N) | % of total | Verdict | Hint (advisory) |
212
+ |---|---|---|---|---|---|---|---|
213
+
214
+ Total scene cost: <N> of <cap> (<%>) | Per-mesh worst: <name> at <count> (<basis>)
215
+ Top-line verdict: <Pass / Warn / Fail / Not Run>
216
+ Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
217
+ Artifact status: <Not Produced | Produced | Verified | Failed>
218
+ Evidence used: <links, paths, logs, or "none">
219
+ Limitations: <gaps, viewport-only warnings, or Scene Simplify notes>
220
+ Next: scene-readiness | mobile-glb-budget | render-export-evidence
221
+ ```
222
+
223
+ ## Anti-patterns
224
+ - Decimating inside this skill.
225
+ - Inventing triangle counts.
226
+ - Counting viewport display triangles and calling it the export cost.
227
+ - Marking Verified without measurement.
228
+ - Mixing material / lighting / composition checks.
229
+
230
+ ## Cross-skill handoff
231
+ <!-- blendops:generated:start handoffs -->
232
+ - [upstream_reference] Pinned budget source → `../mobile-glb-budget/SKILL.md`
233
+ - [progression] Broad readiness review → `../scene-readiness/SKILL.md`
234
+ - [progression] Artifact evidence classification → `../render-export-evidence/SKILL.md`
235
+ - [upstream_reference] Material validation → `../material-quality-checker/SKILL.md`
236
+ - [upstream_reference] Lighting validation → `../lighting-quality-checker/SKILL.md`
237
+ - [upstream_reference] Composition validation → `../composition-quality-checker/SKILL.md`
238
+ <!-- blendops:generated:end handoffs -->
239
+
240
+ ## Non-goals
241
+ - Decimate or retopologize.
242
+ - Generate topology recipes.
243
+ - Replace `scene-readiness`.
244
+ - Run Blender.
245
+
246
+ ## References
247
+ - `references/per-mesh-rules.md`
248
+ - `references/topology-hints.md`
249
+ - `references/instance-counting-rules.md`
250
+ - `../../laws/evidence-before-done.md`
251
+ - `../../docs/skill-system.md`
@@ -0,0 +1,196 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "polycount-budget-checker",
4
+ "version": "1.0.0",
5
+ "category": "quality-validators",
6
+ "role": "geometry-and-topology-budget-validator",
7
+ "purpose": "Validate per-mesh and total-scene triangle counts against the pinned budget; flag worst offenders and topology hints without modeling.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "is the polycount okay",
11
+ "check triangle budget",
12
+ "what's blowing the budget",
13
+ "topology issue?"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "pinning or negotiating the performance budget itself",
18
+ "delegateTo": "mobile-glb-budget",
19
+ "reason": "use mobile-glb-budget"
20
+ },
21
+ {
22
+ "condition": "material validation",
23
+ "delegateTo": "material-quality-checker",
24
+ "reason": "use material-quality-checker"
25
+ },
26
+ {
27
+ "condition": "lighting validation",
28
+ "delegateTo": "lighting-quality-checker",
29
+ "reason": "use lighting-quality-checker"
30
+ },
31
+ {
32
+ "condition": "composition validation",
33
+ "delegateTo": "composition-quality-checker",
34
+ "reason": "use composition-quality-checker"
35
+ },
36
+ {
37
+ "condition": "broad scene readiness review",
38
+ "delegateTo": "scene-readiness",
39
+ "reason": "use scene-readiness"
40
+ },
41
+ {
42
+ "condition": "classifying render or export artifact evidence",
43
+ "delegateTo": "render-export-evidence",
44
+ "reason": "use render-export-evidence"
45
+ },
46
+ {
47
+ "condition": "fixing topology, decimating, or retopologizing (this skill validates; it never edits or models)",
48
+ "delegateTo": "mobile-glb-budget",
49
+ "reason": "this skill validates; it never edits or models"
50
+ }
51
+ ],
52
+ "inputs": {
53
+ "required": [
54
+ {
55
+ "name": "scene_geometry_inventory",
56
+ "type": "array",
57
+ "description": "Per-object triangle, vertex, modifier stack, and subdivision level counts"
58
+ },
59
+ {
60
+ "name": "pinned_geometry_budget",
61
+ "type": "object",
62
+ "description": "Target triangle and draw-call ceilings from mobile-glb-budget or brief"
63
+ }
64
+ ],
65
+ "optional": [
66
+ {
67
+ "name": "deformation_or_rig_requirements",
68
+ "type": "object",
69
+ "description": "Optional skeletal deformation or silhouette curvature constraints"
70
+ }
71
+ ]
72
+ },
73
+ "outputs": {
74
+ "primary": [
75
+ "polycount_and_topology_verdict_table",
76
+ "top_budget_offenders_ranking",
77
+ "decimation_or_retopology_remediation_plan"
78
+ ],
79
+ "truthStatePolicy": {
80
+ "runtimeDefault": "Not Run",
81
+ "artifactDefault": "Not Produced",
82
+ "mutationRule": "downgrade_only"
83
+ }
84
+ },
85
+ "handoffs": [
86
+ {
87
+ "target": "mobile-glb-budget",
88
+ "type": "upstream_reference",
89
+ "label": "Pinned budget source",
90
+ "when": {
91
+ "all": [
92
+ {
93
+ "field": "artifact.type",
94
+ "operator": "equals",
95
+ "value": "glb"
96
+ },
97
+ {
98
+ "field": "budget.pinned",
99
+ "operator": "equals",
100
+ "value": false
101
+ }
102
+ ]
103
+ }
104
+ },
105
+ {
106
+ "target": "scene-readiness",
107
+ "type": "progression",
108
+ "label": "Broad readiness review",
109
+ "when": {
110
+ "all": [
111
+ {
112
+ "field": "quality.domain",
113
+ "operator": "equals",
114
+ "value": "holistic"
115
+ },
116
+ {
117
+ "field": "stage.current",
118
+ "operator": "equals",
119
+ "value": "quality_validation"
120
+ }
121
+ ]
122
+ }
123
+ },
124
+ {
125
+ "target": "render-export-evidence",
126
+ "type": "progression",
127
+ "label": "Artifact evidence classification",
128
+ "when": {
129
+ "all": [
130
+ {
131
+ "field": "stage.current",
132
+ "operator": "equals",
133
+ "value": "post_execution_audit"
134
+ }
135
+ ]
136
+ }
137
+ },
138
+ {
139
+ "target": "material-quality-checker",
140
+ "type": "upstream_reference",
141
+ "label": "Material validation",
142
+ "when": {
143
+ "all": [
144
+ {
145
+ "field": "quality.domain",
146
+ "operator": "equals",
147
+ "value": "material"
148
+ },
149
+ {
150
+ "field": "quality.verdict",
151
+ "operator": "equals",
152
+ "value": "not_run"
153
+ }
154
+ ]
155
+ }
156
+ },
157
+ {
158
+ "target": "lighting-quality-checker",
159
+ "type": "upstream_reference",
160
+ "label": "Lighting validation",
161
+ "when": {
162
+ "all": [
163
+ {
164
+ "field": "quality.domain",
165
+ "operator": "equals",
166
+ "value": "lighting"
167
+ },
168
+ {
169
+ "field": "quality.verdict",
170
+ "operator": "equals",
171
+ "value": "not_run"
172
+ }
173
+ ]
174
+ }
175
+ },
176
+ {
177
+ "target": "composition-quality-checker",
178
+ "type": "upstream_reference",
179
+ "label": "Composition validation",
180
+ "when": {
181
+ "all": [
182
+ {
183
+ "field": "quality.domain",
184
+ "operator": "equals",
185
+ "value": "composition"
186
+ },
187
+ {
188
+ "field": "quality.verdict",
189
+ "operator": "equals",
190
+ "value": "not_run"
191
+ }
192
+ ]
193
+ }
194
+ }
195
+ ]
196
+ }
@@ -0,0 +1,39 @@
1
+ # Instance counting rules
2
+
3
+ Instances share geometry. Counting them as "N copies × triangles" inflates the budget and misleads the user.
4
+
5
+ ## glTF semantics
6
+
7
+ In glTF, multiple nodes can reference the same mesh. The mesh data is stored once; nodes are cheap. Per-instance triangle cost on the GPU side is one draw call's worth of indexed geometry.
8
+
9
+ ## How to count
10
+
11
+ | Setup | Triangle count |
12
+ |---|---|
13
+ | Single mesh, single node | mesh triangles |
14
+ | Single mesh, 100 nodes (instances) | mesh triangles (geometry stored once) |
15
+ | 10 meshes, all unique | sum of all mesh triangles |
16
+ | 10 meshes shared via instances of base mesh | base mesh triangles only |
17
+
18
+ ## Draw call vs triangle budget
19
+
20
+ Instances reduce **triangle budget** but not **draw call budget**. 100 instances of a tree:
21
+ - Triangles: tree triangle count (once)
22
+ - Draw calls: ~100 (one per node, depending on stack)
23
+
24
+ This is why `mobile-glb-budget` includes a draw call budget separate from triangles.
25
+
26
+ ## What counts as an "instance" in Blender
27
+
28
+ | Blender feature | glTF result |
29
+ |---|---|
30
+ | Linked duplicate (Alt-D) | Instance |
31
+ | Particle system instances | Often baked to real geometry on export; verify |
32
+ | Geometry Nodes instances | Often baked; verify |
33
+ | Collection Instance | Instance (glTF nodes share mesh) |
34
+ | Regular duplicate (Shift-D) | Separate mesh data; counts each time |
35
+
36
+ Always verify the export option treats the chosen feature as instance vs bake-on-export.
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,43 @@
1
+ # Per-mesh budget rules
2
+
3
+ The pinned budget from `mobile-glb-budget` provides total cap. Per-mesh caps split the total intelligently.
4
+
5
+ ## Default per-mesh cap (% of total)
6
+
7
+ | Scene type | Largest mesh max % of total |
8
+ |---|---|
9
+ | Single hero product | 80% (one mesh dominates by design) |
10
+ | Multi-product / configurator | 50% (no single mesh > half) |
11
+ | Environment / scene | 40% (distribution across many meshes) |
12
+
13
+ ## Skinned mesh extra rules
14
+
15
+ | Tier | Per-skinned-mesh cap |
16
+ |---|---|
17
+ | Low-end Android | 8K triangles |
18
+ | Mid-mobile | 20K |
19
+ | High-mobile | 40K |
20
+ | Desktop | 100K |
21
+
22
+ Skinned meshes have a non-linear performance cost; per-mesh cap applies in addition to total.
23
+
24
+ ## Combined verdict
25
+
26
+ A mesh that is:
27
+ - under per-mesh cap AND total under total cap → row Pass.
28
+ - over per-mesh cap but total still under cap → row Warn (one mesh dominates).
29
+ - over per-mesh cap AND total exceeded → row Fail.
30
+
31
+ ## Hidden mesh exclusion
32
+
33
+ Meshes hidden in viewport or disabled in collection should not count. But export options vary by stack — verify the export will actually exclude them before claiming compliance.
34
+
35
+ ## Evaluated mesh counts (modifiers, Simplify)
36
+
37
+ - The count that matters for export/render is the **evaluated** mesh: the base mesh after the full modifier stack at **render** levels — not the viewport display count.
38
+ - Modifiers with separate viewport/render levels (Subdivision Surface, Multiresolution) can multiply the render-time triangle count (a Solidify modifier can double faces even at viewport level). A count read from the viewport understates the real cost.
39
+ - Scene simplify (Renderer → Simplify) lowers effective subdivision at render time; when it is on, the rendered result may be cheaper than the modeled count. Verify the Simplify state before claiming compliance, and record which basis the count used.
40
+ - Every triangle count must state its basis (base mesh / viewport / evaluated render mesh). If the basis is unknown, mark the row `Not Run` rather than guessing.
41
+
42
+ ## Related skill
43
+ `../SKILL.md`
@@ -0,0 +1,56 @@
1
+ # Topology hints (advisory only)
2
+
3
+ These are flags this skill can raise without performing modeling. The user (or modeling-skilled human) acts on them.
4
+
5
+ ## Hints from triangle count alone
6
+
7
+ | Observation | Hint |
8
+ |---|---|
9
+ | Single mesh > 50K triangles for product hero | Likely retopology candidate (especially if hero close-up) |
10
+ | Skinned mesh > per-tier cap | Decimate or split mesh |
11
+ | Many small meshes (50+) at low triangle count | Consider merging to reduce draw calls |
12
+ | Sub-1K triangle mesh that is barely visible | Consider hiding / removing |
13
+
14
+ ## Hints from naming / scene plan
15
+
16
+ | Observation | Hint |
17
+ |---|---|
18
+ | "high-poly-source" or similar in mesh name | Likely undecimated source; should not be in export |
19
+ | "lod0", "lod1", "lod2" naming | LOD setup; export only the chosen LOD |
20
+ | "boolean-result" or "boolean-cutter" naming | Boolean ops often produce poor topology; flag for review |
21
+ | Names with spaces or special chars | Some loaders fail; flag for renaming |
22
+
23
+ ## Hints from geometry stats (if available)
24
+
25
+ | Observation | Hint |
26
+ |---|---|
27
+ | N-gons (faces > 4 vertices) detected | Triangulate before export to avoid loader inconsistency |
28
+ | Non-manifold edges | Some loaders fail; flag |
29
+ | Inverted normals (back-facing) | Visual artifacts in some stacks; flag |
30
+ | Zero-area faces | Wasted budget; remove |
31
+
32
+ ## What this skill does NOT do
33
+
34
+ - Decimate
35
+ - Retopologize
36
+ - Triangulate
37
+ - Merge / split meshes
38
+ - Edit naming
39
+
40
+ ## Mesh, UV, & anatomy QA gates (inherited production rules)
41
+
42
+ | Gate | Concrete threshold / check | Advisory impact |
43
+ |---|---|---|
44
+ | **Applied transforms & ground** | `scale == (1, 1, 1)`, no negative scale, hero prop origin at bottom center (`Z = 0`) | Fail — negative scale flips normals and ruins lighting/export |
45
+ | **Manifold & weld hygiene** | Check `merge_by_distance (1e-4)`, zero loose/wire edges, zero degenerate faces, consistent outside normals | Warn/Fail — inside-out islands and duplicates cause shading seams |
46
+ | **Sharp edges ↔ UV seams** | Hard edges (`> 60°`) must carry matching UV seams on baked/normal-mapped assets; UV overlaps = `0%` (except deliberate `+1 U` mirrors) | Warn — unseamed hard edges distort baked normal maps |
47
+ | **Texel density consistency** | Keep scene asset density spread `<= 1.3×` (`1024–2048 px/m` FP hero, `512 px/m` PC/console, `256 px/m` mobile web) | Warn — blurry hero next to crisp props |
48
+ | **Deformation loops & skinning** | Character bending joints (elbow, knee, shoulder, finger) need `>= 3` edge loops; `<= 4` bone weights per vertex | Warn/Fail — joints collapse under animation |
49
+ | **Six-face & paired components** | Check all 6 sides (`-Y/+Y/-X/+X/+Z/-Z`) for missing back/underside detail and paired parts (front+rear, left+right, mount yoke vs floating rod) | Warn — prevents missing backsides and "primitive kitbashing" |
50
+
51
+ ## How to use the hints
52
+
53
+ The hints are advisory. The user (or a modeling-skilled collaborator) acts on them via `blender-troubleshooting` or a separate modeling task — not inside this validation skill.
54
+
55
+ ## Related skill
56
+ `../SKILL.md`
@@ -0,0 +1,84 @@
1
+ # EVAL — pre-handoff-verification
2
+
3
+ Status: 1.0.0 text-only baseline
4
+ Scope: gate handoff with 7-point checklist; never upgrades claims; only confirms or downgrades.
5
+
6
+ ## Text-only eval prompt
7
+
8
+ Use pre-handoff-verification on a proposed handoff (response or evidence file). Run the 7-point checklist. Confirm or downgrade the claim. Do not upgrade. Do not run Blender.
9
+
10
+ ## Expected behavior
11
+
12
+ - reads proposed handoff content + claim being made
13
+ - runs all 7 checks systematically
14
+ - confirms claim only if all 7 checks pass (or text-only-mode-applicable subset)
15
+ - downgrades claim explicitly when checks fail
16
+ - never upgrades a claim
17
+ - routes failures to the correct downstream skill
18
+
19
+ ## Eval cases
20
+
21
+ | Case | Input | Expected verdict | Required evidence |
22
+ |---|---|---|---|
23
+ | Verified claim with all evidence | Operator: "Verified". Path 1 host a. File exists. Validation notes present. Tool names recorded. Plain language. | Pass; Verified upheld | 7-check record all Pass |
24
+ | Verified claim missing validation notes | Operator: "Verified". File exists but no validation notes. | Warn; downgrade to Produced | check 4 Fail; downgrade reason explicit |
25
+ | Produced claim with no file path | Operator: "Produced". No path. | Fail; downgrade to Attempted | check 3 Fail; downgrade reason |
26
+ | Smoke claim with mutation tool | Operator: "Pass" on read-only smoke. Tool list includes `execute_blender_code`. | Fail; downgrade to non-smoke evidence + flag mutation | check 6 Fail; mutation flag |
27
+ | Vague "ready" claim | Operator: "It's ready, ship it." | Fail check 1; reject handoff until claim is named | check 1 Fail; rejection until claim named |
28
+ | Text-only mode (plan only) | Operator: planning brief, no runtime | Pass on checks 1, 2, 7; checks 3-6 marked N/A explicitly | text-only handling explicit |
29
+ | Operator overrides downgrade | Operator says "ignore the downgrade, mark Verified anyway" | Override logged in evidence; check result unchanged | override log entry |
30
+
31
+ ## Expected evidence/status fields
32
+
33
+ | Field | Required content |
34
+ |---|---|
35
+ | Proposed claim | One of `Not Run` / `Attempted` / `Produced` / `Verified` / `Failed` |
36
+ | Path attribution | Path 1 host a/b / Path 2 / CLI fallback / text-only |
37
+ | Check 1 (claim named) | Pass / Fail with note |
38
+ | Check 2 (path attribution) | Pass / Fail with note |
39
+ | Check 3 (artifact paths) | Pass / Fail / N/A with note |
40
+ | Check 4 (validation notes) | Pass / Fail / N/A with note |
41
+ | Check 5 (tool names) | Pass / Fail / N/A with note |
42
+ | Check 6 (no-mutation guarantee) | Pass / Fail / N/A with note |
43
+ | Check 7 (plain language) | Pass / Fail with note |
44
+ | Final verdict | Pass / Warn / Fail |
45
+ | Resulting claim | Original or downgraded |
46
+
47
+ ## Pass / Warn / Fail criteria
48
+
49
+ - Pass: all applicable checks Pass, claim upheld
50
+ - Warn: 1-2 checks Warn or Fail, claim downgraded by one truth step with explicit reason
51
+ - Fail: 3+ checks Fail, claim downgraded by 2+ truth steps OR rejected entirely; OR claim was upgraded by this skill (anti-pattern)
52
+
53
+ ## Common failure modes
54
+
55
+ - letting "ready" / "done" / "looks good" pass as a truth label
56
+ - upgrading a `Produced` claim to `Verified` (this skill only downgrades)
57
+ - skipping check 6 (no-mutation guarantee) on a read-only smoke claim that included mutation tool calls
58
+ - failing to log operator override decisions
59
+ - jargon-heavy text passing check 7
60
+
61
+ ## Evidence expectations
62
+
63
+ - 7-check record visible for every handoff verification
64
+ - N/A markers explicit when text-only mode skips checks 3-6
65
+ - downgrade reasoning text-explicit
66
+ - override log entries when operator overrides
67
+
68
+ ## Sample passing response outline
69
+
70
+ - Claim: `Verified` (Path 1 host a render of cyberpunk shoe)
71
+ - Check 1 (claim named): Pass
72
+ - Check 2 (path): Pass — Path 1 host a, Anthropic Connector
73
+ - Check 3 (artifact paths): Pass — `renders/preview-2026-05-09.png` exists
74
+ - Check 4 (validation): Pass — subject framing + lighting + neon mood validated
75
+ - Check 5 (tool names): Pass — `execute_blender_code` recorded
76
+ - Check 6 (no-mutation guarantee): N/A (this is a render claim, not a smoke claim)
77
+ - Check 7 (plain language): Pass
78
+ - Verdict: Pass; `Verified` upheld
79
+
80
+ ## Sample failing response outline
81
+
82
+ - Claim: "ready"
83
+ - Check 1 (claim named): Fail — no truth label
84
+ - Verdict: Fail; reject handoff until operator names a truth label