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,160 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "resolution-aspect-decision",
4
+ "version": "1.0.0",
5
+ "category": "render-and-output-decisions",
6
+ "role": "resolution-and-aspect-ratio-pinner",
7
+ "purpose": "Pick the right render resolution + aspect ratio for the consumer use case before render; avoid render-then-crop and aspect mismatch.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "what resolution",
11
+ "how big should the render be",
12
+ "16:9 or square"
13
+ ],
14
+ "exclusions": [
15
+ {
16
+ "condition": "after render is complete (no benefit)",
17
+ "delegateTo": "camera-composition",
18
+ "reason": "no benefit"
19
+ },
20
+ {
21
+ "condition": "pure modeling",
22
+ "delegateTo": "output-format-decision",
23
+ "reason": "Delegates out-of-scope requests to output-format-decision"
24
+ },
25
+ {
26
+ "condition": "internal preview-only renders (any reasonable size works)",
27
+ "delegateTo": "composition-quality-checker",
28
+ "reason": "any reasonable size works"
29
+ }
30
+ ],
31
+ "inputs": {
32
+ "required": [
33
+ {
34
+ "name": "target_delivery_surfaces",
35
+ "type": "array",
36
+ "description": "Target display placements (desktop hero banner, mobile portrait feed, 1:1 e-commerce card, 4K print)"
37
+ },
38
+ {
39
+ "name": "framing_and_crop_strategy",
40
+ "type": "string",
41
+ "description": "Whether deliverables use a single master aspect ratio with safe-zone crops or separate camera setups"
42
+ }
43
+ ],
44
+ "optional": [
45
+ {
46
+ "name": "render_time_constraints",
47
+ "type": "string",
48
+ "description": "Optional render time ceiling influencing pixel dimensions and percentage scale"
49
+ }
50
+ ]
51
+ },
52
+ "outputs": {
53
+ "primary": [
54
+ "pinned_pixel_dimensions_and_aspect_ratio",
55
+ "safe_frame_and_overscan_margins",
56
+ "camera_sensor_fit_alignment_notes"
57
+ ],
58
+ "truthStatePolicy": {
59
+ "runtimeDefault": "Not Run",
60
+ "artifactDefault": "Not Produced",
61
+ "mutationRule": "downgrade_only"
62
+ }
63
+ },
64
+ "handoffs": [
65
+ {
66
+ "target": "camera-composition",
67
+ "type": "upstream_reference",
68
+ "label": "Camera & composition planning (upstream framing setup)",
69
+ "when": {
70
+ "all": [
71
+ {
72
+ "field": "brief.locked",
73
+ "operator": "equals",
74
+ "value": true
75
+ },
76
+ {
77
+ "field": "stage.current",
78
+ "operator": "equals",
79
+ "value": "camera_planning"
80
+ }
81
+ ]
82
+ }
83
+ },
84
+ {
85
+ "target": "composition-quality-checker",
86
+ "type": "progression",
87
+ "label": "Composition framing validation against pinned aspect",
88
+ "when": {
89
+ "all": [
90
+ {
91
+ "field": "quality.domain",
92
+ "operator": "equals",
93
+ "value": "composition"
94
+ },
95
+ {
96
+ "field": "quality.verdict",
97
+ "operator": "equals",
98
+ "value": "not_run"
99
+ }
100
+ ]
101
+ }
102
+ },
103
+ {
104
+ "target": "color-management-decision",
105
+ "type": "upstream_reference",
106
+ "label": "Color configuration decision",
107
+ "when": {
108
+ "all": [
109
+ {
110
+ "field": "decision.colorLocked",
111
+ "operator": "equals",
112
+ "value": false
113
+ }
114
+ ]
115
+ }
116
+ },
117
+ {
118
+ "target": "output-format-decision",
119
+ "type": "progression",
120
+ "label": "Container / codec decision",
121
+ "when": {
122
+ "all": [
123
+ {
124
+ "field": "decision.formatLocked",
125
+ "operator": "equals",
126
+ "value": false
127
+ }
128
+ ]
129
+ }
130
+ },
131
+ {
132
+ "target": "cycles-vs-eevee-decision",
133
+ "type": "progression",
134
+ "label": "Render engine decision",
135
+ "when": {
136
+ "all": [
137
+ {
138
+ "field": "decision.engineLocked",
139
+ "operator": "equals",
140
+ "value": false
141
+ }
142
+ ]
143
+ }
144
+ },
145
+ {
146
+ "target": "render-export-evidence",
147
+ "type": "progression",
148
+ "label": "Post-render saved file verification",
149
+ "when": {
150
+ "all": [
151
+ {
152
+ "field": "stage.current",
153
+ "operator": "equals",
154
+ "value": "post_execution_audit"
155
+ }
156
+ ]
157
+ }
158
+ }
159
+ ]
160
+ }
@@ -0,0 +1,41 @@
1
+ # Aspect-ratio defaults per use case
2
+
3
+ | Use case | Aspect | Notes |
4
+ |---|---|---|
5
+ | Web hero card | 16:9 | Most common landing-page hero |
6
+ | Wide cinematic banner | 2.39:1 | Cinema bar / billboard |
7
+ | Square social (IG feed) | 1:1 | Old IG default |
8
+ | Portrait social (IG feed 4:5) | 4:5 | Modern IG portrait |
9
+ | Stories / Reels / TikTok | 9:16 | Vertical mobile |
10
+ | YouTube thumbnail | 16:9 | Same as hero |
11
+ | App icon | 1:1 | Single subject |
12
+ | Email header | 16:9 or 3:1 | Email banner |
13
+ | Print A4 portrait | 1:1.414 (~5:7) | A4 landscape: 1.414:1 |
14
+ | Print A3 | Same proportions | Larger version |
15
+ | Print US Letter | ~17:22 | Different from A4 |
16
+
17
+ ## Multi-format
18
+
19
+ When a single render must serve multiple aspects:
20
+
21
+ - Plan camera framing for the most-restrictive aspect first.
22
+ - Compose so subject reads in all required aspects.
23
+ - Re-frame or re-render for substantially different aspects (16:9 vs 9:16 → re-render usually).
24
+
25
+ ## Aspect mismatch verdicts
26
+
27
+ | Situation | Verdict |
28
+ |---|---|
29
+ | Rendered aspect = consumer aspect | Pass |
30
+ | Off by < 5% | Warn |
31
+ | Wrong direction (square brief, wide render) | Fail |
32
+ | No aspect specified | Fail (incomplete spec) |
33
+
34
+ ## Anti-patterns
35
+
36
+ - "Default 16:9, crop later" → loses pixels, breaks composition.
37
+ - One render serving square + portrait + wide → likely Fail; re-render per aspect.
38
+ - Aspect not in brief → block until clarified.
39
+
40
+ ## Related skill
41
+ `../SKILL.md`
@@ -0,0 +1,58 @@
1
+ # Print vs screen rules
2
+
3
+ Print and screen have different units, gamuts, and viewing conditions. Render correctly per target.
4
+
5
+ ## Units
6
+
7
+ - Screen: pixels (W × H).
8
+ - Print: physical size (cm/in) at DPI.
9
+ - Convert: pixels = physical_inches × DPI.
10
+
11
+ ## Standard DPI
12
+
13
+ - Print: 300 DPI for high-quality.
14
+ - Print (large format / billboard): 100-150 DPI is fine (viewed from distance).
15
+ - Screen: ~96-110 PPI is desktop default; 264 PPI for retina iPhones.
16
+
17
+ ## Color gamut
18
+
19
+ - Screen: sRGB (web), DCI-P3 (modern displays), Rec.2020 (HDR).
20
+ - Print: CMYK, often soft-proofed from sRGB.
21
+
22
+ ## Viewing conditions
23
+
24
+ - Screen: backlit, transmissive (lights add).
25
+ - Print: reflective, ambient-lit (lights subtract).
26
+
27
+ This is why print colors look "darker" than screen colors at the same hex code. Soft-proof in print prep tools.
28
+
29
+ ## Workflow per target
30
+
31
+ ### Screen-only (web hero)
32
+
33
+ - sRGB color space.
34
+ - 8-bit per channel.
35
+ - Render at delivery pixel resolution.
36
+ - Filmic tone-mapping for HDR scenes.
37
+
38
+ ### Print
39
+
40
+ - sRGB color space (then convert to CMYK in print prep).
41
+ - 16-bit per channel (preserves transition).
42
+ - Render at delivery_inches × 300 DPI.
43
+ - Standard or AgX tone-mapping.
44
+ - Soft-proof in print prep tool.
45
+
46
+ ### Print with metallic / specials
47
+
48
+ - Hand off to print prep specialist.
49
+ - Spot colors / Pantones are not represented in 3D render directly.
50
+
51
+ ## Common mistakes
52
+
53
+ - Render at 96 DPI then "scale up to print 300 DPI" → upscaling artifacts.
54
+ - Color matched on screen ≠ matched in print.
55
+ - Print-prep work skipped → final print has unexpected color shifts.
56
+
57
+ ## Related skill
58
+ `../SKILL.md`
@@ -0,0 +1,64 @@
1
+ # Resolution defaults per use case
2
+
3
+ ## Standard (no retina)
4
+
5
+ | Use case | Resolution | Notes |
6
+ |---|---|---|
7
+ | Web hero 16:9 | 1920×1080 | Default |
8
+ | Square social IG feed | 1080×1080 | Old IG |
9
+ | Portrait social 4:5 | 1080×1350 | Modern IG portrait |
10
+ | Stories / Reels 9:16 | 1080×1920 | Vertical mobile |
11
+ | Email header | 600×200 to 1200×400 | Per client requirement |
12
+ | App icon | 1024×1024 | Master; downscale to per-platform sizes |
13
+
14
+ ## Retina / 2x (high-DPI displays)
15
+
16
+ | Use case | Resolution |
17
+ |---|---|
18
+ | Web hero 16:9 retina | 2880×1620 |
19
+ | Square retina | 2160×2160 |
20
+ | Portrait retina | 2160×2700 |
21
+ | Stories retina | 2160×3840 |
22
+
23
+ Render at retina, downscale for standard. Upscaling never works.
24
+
25
+ ## Print
26
+
27
+ 300 DPI is the standard print resolution.
28
+
29
+ | Use case | Pixel resolution at 300 DPI |
30
+ |---|---|
31
+ | A4 portrait | 2480×3508 |
32
+ | A4 landscape | 3508×2480 |
33
+ | A3 portrait | 3508×4961 |
34
+ | US Letter | 2550×3300 |
35
+ | Tabloid (11×17) | 3300×5100 |
36
+ | Poster A2 | 4961×7016 |
37
+
38
+ ## Cinema / 4K / 8K
39
+
40
+ | Use case | Resolution |
41
+ |---|---|
42
+ | 1080p HD | 1920×1080 |
43
+ | 1440p QHD | 2560×1440 |
44
+ | 4K UHD | 3840×2160 |
45
+ | DCI 4K | 4096×2160 |
46
+ | 8K | 7680×4320 |
47
+ | DCI 8K | 8192×4320 |
48
+
49
+ ## Choosing resolution
50
+
51
+ - Render at the delivery resolution × 1.5 if downscale-quality matters; otherwise render at delivery exactly.
52
+ - Upscaling = bad. Downscaling = fine.
53
+ - Memory + time scale with pixel count; verify render machine can handle.
54
+
55
+ ## Resolution mismatch verdicts
56
+
57
+ | Situation | Verdict |
58
+ |---|---|
59
+ | Render res = delivery res or higher | Pass |
60
+ | Render res < delivery res | Fail (upscaling required) |
61
+ | Render res > 1.5× delivery res | Warn (wasted time / memory) |
62
+
63
+ ## Related skill
64
+ `../SKILL.md`
@@ -0,0 +1,26 @@
1
+ # EVAL — runtime-attempt-report
2
+
3
+ ## Text-only eval prompt
4
+
5
+ Path 2 attempt: server started, Blender addon enabled, first tool call timed out. Write report.
6
+
7
+ ## Expected behavior
8
+
9
+ - Runtime status likely Attempted or Failed depending on log certainty
10
+ - Artifact status Not Produced unless files linked
11
+ - Chronological actions + versions stub + next steps (firewall check, port Single-bridge check)
12
+ - Path 2 labeled community third-party
13
+
14
+ ## Pass / Warn / Fail criteria
15
+
16
+ - Pass: template filled + no false Verified
17
+ - Warn: vague timestamps
18
+ - Fail: blames BlendOps skills for upstream outage without evidence
19
+
20
+ ## Sample passing response outline
21
+
22
+ - Sections A–F complete
23
+
24
+ ## Sample failing response outline
25
+
26
+ - "Everything verified"
@@ -0,0 +1,268 @@
1
+ ---
2
+ name: runtime-attempt-report
3
+ description: Produce an evidence-bound runtime attempt report with truth labels and next steps; does not certify upstream stack success.
4
+ ---
5
+
6
+ # runtime-attempt-report
7
+
8
+ ## Purpose
9
+
10
+ Record a chronological, secret-free runtime attempt log—including version stamps, downgrade-only truth labels, and routed next steps—for Path 1, Path 2, or CLI appendix runs. A report produced by this skill can serve as an in-repo provenance record under `docs/evals/`, without certifying artifact quality or diagnosing runtime defects.
11
+
12
+ ## Quick start
13
+
14
+ - gather timestamps, commands/config surfaces touched (no secrets)
15
+ - choose blocks from `references/truth-label-blocks.md`
16
+ - fill `references/attempt-record-template.md`
17
+ - route improvements via `references/triage-next-steps.md`
18
+
19
+ ## When to use
20
+
21
+ - after any Blender connect attempt (success or failure)
22
+ - preparing notes for `docs/evals/` style provenance
23
+ - teaching non-technical stakeholders what actually occurred
24
+
25
+ ## When not to use
26
+ <!-- blendops:generated:start exclusions -->
27
+ - Classifying rendered or exported visual artifacts (render-export-evidence) → use `../render-export-evidence/SKILL.md` (render-export-evidence)
28
+ - Diagnosing systematic runtime or scene defects (blender-troubleshooting) → use `../blender-troubleshooting/SKILL.md` (blender-troubleshooting)
29
+ - Running pre-attempt environment checks (runtime-readiness) → use `../runtime-readiness/SKILL.md` (runtime-readiness)
30
+ - Selecting which runtime path to use before an attempt (runtime-path-picker) → use `../runtime-path-picker/SKILL.md` (runtime-path-picker)
31
+ - Performing final release or delivery gating (pre-handoff-verification) → use `../pre-handoff-verification/SKILL.md` (pre-handoff-verification)
32
+ <!-- blendops:generated:end exclusions -->
33
+
34
+ ## Trigger phrases
35
+ <!-- blendops:generated:start triggers -->
36
+ - "write up what we tried"
37
+ - "runtime attempt log"
38
+ - "postmortem blender connect"
39
+ - "evidence report template"
40
+ <!-- blendops:generated:end triggers -->
41
+
42
+ ## Prerequisites / readiness
43
+
44
+ - Pre-attempt path selection completed via `runtime-path-picker` and readiness checked via `runtime-readiness`
45
+ - Chronological list of actions attempted (even if partial or aborted)
46
+ - Exact version stamps for Blender, MCP host/client, and any bridge/add-on used
47
+
48
+ ## Input schema
49
+
50
+ ### Required inputs
51
+
52
+ | Input | Why it is required |
53
+ |---|---|
54
+ | Path & host attempted | Frames Path 1, Path 2, or CLI appendix boundaries and caveats |
55
+ | Chronological actions & symptom outcome | Establishes the factual timeline and governs downgrade-only truth labels |
56
+ | Versions | Stamps Blender, host/client, and bridge/add-on versions for provenance |
57
+
58
+ ### Optional inputs
59
+
60
+ | Input | Use |
61
+ |---|---|
62
+ | Redacted log excerpts | Supports chronological action records without upgrading truth states |
63
+ | Artifact pointers | Notes whether outputs exist so they can be routed to `render-export-evidence` |
64
+
65
+ ## Output schema
66
+
67
+ ### Primary output
68
+
69
+ - Structured Markdown attempt report (sections A–F) containing chronological actions, redacted config surfaces, version stamps, truth labels, and routed next steps (suitable for saving under `docs/evals/`).
70
+
71
+ ### Evidence / caveat output
72
+
73
+ - **Runtime truth state** (exact allowed values): `Not Run | Attempted | Produced | Verified | Failed`
74
+ - **Artifact truth state** (default `Not Produced`; exact allowed values): `Not Run | Not Produced | Produced | Verified | Failed`
75
+ - **Discipline**: Downgrade-only, never upgrade; defer all artifact verification and visual quality ledgering to `render-export-evidence`.
76
+ - Embedded template includes explicit Runtime + Artifact states.
77
+
78
+ ## Required laws
79
+
80
+ - `../../laws/evidence-before-done.md`
81
+ - `../../laws/non-blender-user-language.md`
82
+ - `../../laws/no-arbitrary-python-interface.md`
83
+ - `../../laws/official-runtime-only.md`
84
+
85
+ ## Official runtime boundary
86
+
87
+ Documentation skill only—never executes Blender or generates Python. Reports must strictly preserve upstream runtime distinctions:
88
+ - **Path 1**: Official Blender Lab MCP in Blender 5.1+, hosted from (a) Anthropic Connector or (b) manual MCP client. The Connector is NOT standalone.
89
+ - **Path 2**: Community `mcp-for-blender` (third-party, Blender 3.0+); document only with explicit caveats and never treat as release evidence.
90
+ - **CLI fallback**: Appendix only (`blender --background --python`); remains upstream-documented with no in-repo evidence file unless a report written by this skill becomes one under `docs/evals/`.
91
+
92
+ ## Operating procedure
93
+
94
+ 1. Stamp the attempted path, host mode, and exact versions (Blender, host/client, add-on/bridge).
95
+ 2. Record operator actions chronologically in plain language with all secrets, tokens, and private paths redacted.
96
+ 3. Assign Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (default `Not Produced`; allowed `Not Run | Not Produced | Produced | Verified | Failed`) truth states using strict downgrade-only discipline.
97
+ 4. Route next steps: send generated files to `render-export-evidence`, defect symptoms to `blender-troubleshooting` or `bridge-conflicts`, and delivery readiness to `pre-handoff-verification`.
98
+
99
+ ## Decision tree
100
+
101
+ ```txt
102
+ Did a real runtime connect or CLI execution attempt actually start?
103
+ No (environment blocked before start, or dry-run walkthrough) →
104
+ Set Runtime status: Not Run and Artifact status: Not Produced; record pre-attempt blocker and route to runtime-readiness
105
+ Yes → continue
106
+ Which runtime path was attempted (`references/attempt-record-template.md`)?
107
+ Path 1 (Official Blender Lab MCP in Blender 5.1+, Host (a) Connector or Host (b) manual MCP client) →
108
+ Stamp Blender 5.1+, Lab add-on, and host versions; note Connector is not standalone
109
+ Path 2 (Community `mcp-for-blender`, Blender 3.0+) →
110
+ Stamp versions, attach mandatory third-party / non-release-evidence caveat (`docs/unofficial-runtime-bridges.md`)
111
+ CLI appendix (`blender --background --python`) →
112
+ Stamp Blender version, redacted command flags, and stdout/stderr pointers
113
+ How did the attempt conclude (`references/truth-label-blocks.md`)?
114
+ Aborted mid-flight or timed out without conclusive outcome → Runtime status: Attempted
115
+ Terminated with explicit error / crash → Runtime status: Failed; route to blender-troubleshooting or bridge-conflicts
116
+ Completed with observable runtime signal → Runtime status: Produced (or Verified only if smoke checks are recorded)
117
+ Were any render/export files written to disk?
118
+ No → Artifact status: Not Produced
119
+ Yes → cap Artifact status at Produced (never Verified here) and route files to render-export-evidence
120
+ ```
121
+
122
+ ## Playbooks
123
+
124
+ ### Playbook A: Path 1 read-only or scene-mutation attempt log
125
+
126
+ - Populate Sections A–F of `references/attempt-record-template.md` with exact timestamps, **Blender 5.1+** version, Lab MCP add-on version, and Host **(a)** (Anthropic Connector) or Host **(b)** (manual MCP client) version stamps.
127
+ - Redact local user paths, tokens, and environment secrets before logging chronological actions.
128
+ - Assign downgrade-only truth states from `references/truth-label-blocks.md` and route any produced files to `../render-export-evidence/SKILL.md`.
129
+
130
+ ### Playbook B: Failed or timed-out MCP connection postmortem
131
+
132
+ - Record the exact chronological step where the connection dropped or port `9876` refused attachment (`references/triage-next-steps.md`).
133
+ - Set `Runtime status: Failed` (or `Attempted` if inconclusive) and `Artifact status: Not Produced` — never invent a `Blocked` truth state.
134
+ - Route port/bridge collisions to `../bridge-conflicts/SKILL.md`, runtime errors to `../blender-troubleshooting/SKILL.md`, and handoff gating to `../pre-handoff-verification/SKILL.md`.
135
+
136
+ ### Playbook C: Path 2 community bridge or CLI appendix provenance record
137
+
138
+ - For Path 2 (`mcp-for-blender`), stamp versions and include the explicit disclaimer that third-party bridge runs never count as official release evidence.
139
+ - For CLI appendix (`blender --background --python`), log the phased command invocation and stdout/stderr tail so the report can serve as an in-repo provenance candidate under `docs/evals/`.
140
+
141
+ ## Mode handling
142
+
143
+ ### Text-only mode
144
+
145
+ - Record hypothetical or dry-run walkthroughs with Runtime set to `Not Run` and Artifacts set to `Not Produced`. Never upgrade states without a real attempt.
146
+
147
+ ### Runtime-ready mode
148
+
149
+ - Log chronological steps and partial transcripts; cap Runtime at `Attempted` or `Produced` unless independently verified, and keep Artifacts at `Not Produced` or `Produced` pending `render-export-evidence`.
150
+
151
+ ### Blocked runtime mode
152
+
153
+ - Document the exact blocker chronologically, set Runtime to `Not Run` or `Failed` (downgrade-only), keep Artifacts at `Not Produced`, and route to `runtime-readiness` or `pre-handoff-verification`.
154
+
155
+ ## Validation checklist
156
+
157
+ - [ ] Runtime state uses only `Not Run | Attempted | Produced | Verified | Failed` and Artifact state defaults to `Not Produced` (`Not Run | Not Produced | Produced | Verified | Failed`)
158
+ - [ ] Truth labels follow downgrade-only discipline (no state upgrades, no Path 2 release evidence claims)
159
+ - [ ] Blender, host/client, and bridge/add-on version stamps are recorded
160
+ - [ ] Chronological actions contain no secrets, credentials, or upstream vendor blame language
161
+ - [ ] Operator sandbox hygiene recorded (trusted environment, no credentials in scenes/logs, disposable ports/paths)
162
+ - [ ] Artifact inspection is delegated to `render-export-evidence` and handoff gating is routed to `pre-handoff-verification`
163
+
164
+ ## Pass / Warn / Fail rubric
165
+
166
+ | Verdict | Criteria |
167
+ |---|---|
168
+ | Pass | Chronological template complete, versions stamped, secrets redacted, downgrade-only truth states accurate, and next steps routed |
169
+ | Warn | Minor timeline gaps while keeping conservative (downgraded) truth states and complete version stamps |
170
+ | Fail | Missing version stamps, unredacted secrets, upgraded truth states, Path 2 claimed as release evidence, or missing exit to `pre-handoff-verification` on failure |
171
+
172
+ ## Failure handling
173
+
174
+ - If an attempt aborts or crashes mid-run, record the chronological steps up to the failure point and set Runtime state to `Failed` and Artifact state to `Not Produced` (or `Failed` if corrupted).
175
+ - If version stamps or chronological steps cannot be confirmed from operator notes, downgrade the Runtime state to `Attempted` (or `Not Run`) and flag the gap explicitly.
176
+ - If a report is generated for a Path 2 (`mcp-for-blender`) run, attach the mandatory third-party caveat and block it from serving as release evidence.
177
+ - Route any failed or incomplete attempt report directly to `pre-handoff-verification` to block downstream delivery until resolved.
178
+
179
+ ## Troubleshooting
180
+
181
+ - **Missing version metadata**: Do not guess versions; mark the version field as unrecorded, downgrade truth claims accordingly, and route to `runtime-readiness` to capture environment facts.
182
+ - **Ambiguous connection drops**: Log the exact timestamp and symptom chronologically without speculating on root causes, then hand off diagnosis to `blender-troubleshooting` or `bridge-conflicts`.
183
+ - **Unverified output files present on disk**: Keep Artifact state at `Produced` (never `Verified`) and route the files to `render-export-evidence` for inspection.
184
+ - **Sensitive tokens in raw logs**: Strip all credentials, API keys, and personal file paths before writing the chronological record.
185
+
186
+ ## Best practices
187
+
188
+ - Stamp exact versions for Blender, the MCP host/client, and any bridge add-on at the top of every report.
189
+ - Write chronological entries in plain, factual language suitable for non-Blender stakeholders and `docs/evals/` provenance records.
190
+ - Default Artifact truth state to `Not Produced` and apply downgrade-only logic whenever logs or outcomes are partial.
191
+ - Clearly distinguish Path 1, Path 2, and CLI appendix runs in every report.
192
+
193
+ ## Good examples
194
+
195
+ - **Path 1 manual MCP client attempt**: Logs Blender 5.1+ and client version stamps, chronological connection steps, `Runtime status: Produced`, `Artifact status: Not Produced`, and routes next steps to `render-export-evidence`.
196
+ - **Blocked Path 1 Anthropic Connector attempt**: Notes that the Connector was invoked without a running Blender 5.1+ Lab add-on host (Connector is not standalone), stamps `Runtime status: Failed` and `Artifact status: Not Produced`, and routes to `runtime-readiness` and `pre-handoff-verification`.
197
+ - **Path 2 community exploration log**: Records a Blender 3.0+ `mcp-for-blender` run with explicit third-party caveats, caps truth labels against release use, and routes handoff gating to `pre-handoff-verification`.
198
+ - **CLI appendix record for `docs/evals/`**: Documents a `blender --background --python` run chronologically with redacted paths and version stamps to establish an in-repo evidence file.
199
+
200
+ ## Bad examples
201
+
202
+ - Claiming `Runtime status: Verified` and `Artifact status: Verified` from partial console logs or operator optimism without running `render-export-evidence`.
203
+ - Pasting raw MCP configuration files containing API keys, bearer tokens, or unredacted personal filesystem paths into Section C or Section E.
204
+ - Presenting a third-party Path 2 (`mcp-for-blender`) session transcript as official 1.0.0 release certification.
205
+
206
+ ## User-facing response template
207
+
208
+ ```txt
209
+ ## A. Summary
210
+ Path: <Path 1 Official Blender Lab MCP (5.1+) | Path 2 community mcp-for-blender (3.0+, non-release) | CLI fallback appendix>
211
+ Host: <Host (a) Anthropic Connector | Host (b) Manual MCP client | Headless shell>
212
+ Date/time (UTC): <timestamp>
213
+
214
+ ## B. Versions
215
+ Blender: <exact version or unrecorded>
216
+ Add-on / bridge package: <Lab MCP add-on version | mcp-for-blender version | N/A>
217
+ MCP host / client: <client name + version>
218
+
219
+ ## C. Actions chronology (secrets & private paths redacted)
220
+ 1. <timestamp — action taken>
221
+ 2. <timestamp — action taken>
222
+
223
+ ## D. Signals observed
224
+ - Expected: <observed expected signals>
225
+ - Unexpected: <timeouts, port 9876 conflicts, or errors>
226
+
227
+ ## E. Truth labels (downgrade-only)
228
+ Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
229
+ Artifact status: <Not Produced | Produced | Verified | Failed>
230
+ Evidence pointers: <redacted log/file paths or none>
231
+
232
+ ## F. Limitations, redactions & next routing
233
+ Secrets removed: Yes (trusted sandbox hygiene verified)
234
+ Limitations: <missing version stamps, third-party Path 2 caveat, or unverified outputs>
235
+ Next skill: <render-export-evidence | blender-troubleshooting | bridge-conflicts | pre-handoff-verification>
236
+ ```
237
+
238
+ ## Anti-patterns
239
+
240
+ - Upgrading Runtime or Artifact states to `Verified` based on partial console logs or operator optimism.
241
+ - Writing `Artifact status: Not Run` instead of `Artifact status: Not Produced` (or inventing a `Blocked` truth state).
242
+ - Treating a Path 2 (`mcp-for-blender`) attempt report as release certification or official runtime evidence.
243
+ - Blurring roles by inspecting render quality inside the attempt report instead of routing to `render-export-evidence`, or diagnosing defects instead of routing to `blender-troubleshooting`.
244
+ - Pasting raw config files containing API keys, tokens, or local user credentials into the report.
245
+
246
+ ## Cross-skill handoff
247
+ <!-- blendops:generated:start handoffs -->
248
+ - [upstream_reference] Pre-attempt readiness check → `../runtime-readiness/SKILL.md`
249
+ - [upstream_reference] Runtime path selection context → `../runtime-path-picker/SKILL.md`
250
+ - [fallback] Bridge / port / host conflicts → `../bridge-conflicts/SKILL.md`
251
+ - [fallback] Runtime or scene defect diagnosis → `../blender-troubleshooting/SKILL.md`
252
+ - [progression] Artifact evidence classification → `../render-export-evidence/SKILL.md`
253
+ - [fallback] Final handoff gate & failure exit → `../pre-handoff-verification/SKILL.md`
254
+ <!-- blendops:generated:end handoffs -->
255
+
256
+ ## Non-goals
257
+
258
+ - Executing Blender, running MCP commands, or writing Python scripts.
259
+ - Certifying visual artifact quality or export integrity (owned by `render-export-evidence`).
260
+ - Diagnosing runtime crashes, bridge conflicts, or scene errors (owned by `blender-troubleshooting` and `bridge-conflicts`).
261
+ - Approving final delivery packages without passing through `pre-handoff-verification`.
262
+
263
+ ## References
264
+
265
+ - `references/truth-label-blocks.md`
266
+ - `references/attempt-record-template.md`
267
+ - `references/triage-next-steps.md`
268
+ - `../../laws/evidence-before-done.md`