blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,245 @@
1
+ ---
2
+ name: character-portrait
3
+ description: Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
4
+ ---
5
+
6
+ # character-portrait
7
+
8
+ ## Purpose
9
+ Translate a single-subject character-portrait intent (subject identity, pose, expression, wardrobe, framing, lighting, background) into a structured scene plan with an explicit assumptions register. Distinct from `product-hero-scene-planner` (manufactured products), `environment-shot` (places), and `interior-scene` (rooms). Multi-character ensembles are out of scope. Hands off framing deep-dives to `camera-composition`, lookdev deep-dives to `lighting-material-plan`, assets to `asset-discovery`, and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
10
+
11
+ ## Quick start
12
+ - confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
13
+ - confirm likeness rights before use if the subject is a real person
14
+ - pin subject identity, pose, expression, wardrobe, framing, lighting, and background
15
+ - record an explicit assumptions register
16
+ - flag needed assets for `asset-discovery`
17
+ - emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
18
+
19
+ ## When to use
20
+ - intent is explicitly a character / person / creature portrait
21
+ - before any modeling or scene file is built
22
+ - when the consumer is editorial / brand / catalog / cinematic
23
+
24
+ ## When not to use
25
+ <!-- blendops:generated:start exclusions -->
26
+ - product hero scenes → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
27
+ - environment establishing shots → use `../environment-shot/SKILL.md` (use environment-shot)
28
+ - interior arch viz → use `../interior-scene/SKILL.md` (use interior-scene)
29
+ - multi-character ensemble (this skill is single-subject) → use `../intent-to-3d-brief-writer/SKILL.md` (this skill is single-subject)
30
+ <!-- blendops:generated:end exclusions -->
31
+
32
+ ## Trigger phrases
33
+ <!-- blendops:generated:start triggers -->
34
+ - "portrait of"
35
+ - "character looking at the camera"
36
+ - "headshot"
37
+ - "hero shot of [person / mascot / creature]"
38
+ <!-- blendops:generated:end triggers -->
39
+
40
+ ## Prerequisites / readiness
41
+ - brief from `intent-to-3d-brief-writer` is locked
42
+ - single-subject character identity and style are known
43
+ - likeness rights are confirmed before use if the subject depicts a real person
44
+ - target framing and use case are known
45
+
46
+ ## Input schema
47
+
48
+ ### Required inputs
49
+
50
+ | Input | Why it is required |
51
+ |---|---|
52
+ | Subject identity | Defines single-subject character traits and asset needs |
53
+ | Likeness rights confirmation (if real person) | Must be confirmed before use; blocks planning if unconfirmed |
54
+ | Pose + expression | Drives framing and lighting intent |
55
+ | Framing + background intent | Sets portrait boundaries before camera/lookdev deep-dives |
56
+
57
+ ### Optional inputs
58
+
59
+ | Input | Use |
60
+ |---|---|
61
+ | Reference images | Align style and character details (with rights confirmed) |
62
+ | Wardrobe / prop list | Populates asset rows for `asset-discovery` |
63
+ | Existing asset notes | Flags reuse candidates for discovery |
64
+
65
+ ### Assumptions to confirm
66
+ - Single subject only (multi-character ensembles are out of scope).
67
+ - Likeness rights are confirmed for any real person depicted.
68
+ - Style is consistent across subject, wardrobe, and background.
69
+ - Planning-only output: runtime stays `Not Run` and artifacts stay `Not Produced`.
70
+
71
+ ## Output schema
72
+
73
+ ### Primary output
74
+ A structured single-subject character portrait plan covering: Subject identity, Likeness rights status, Pose / expression, Wardrobe, Framing, Lighting, Background, and an Assumptions register.
75
+
76
+ ### Secondary output
77
+ - asset rows flagged for `asset-discovery`
78
+ - deep-dive handoffs to `camera-composition` (framing) and `lighting-material-plan` (lookdev)
79
+ - validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`
80
+ - explicit `Runtime status: Not Run` and `Artifact status: Not Produced` labels
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
87
+ Evidence used: <links, paths, logs, or "none">
88
+ Limitations: <known gaps>
89
+ ```
90
+
91
+ ## Required laws
92
+ - `../../laws/evidence-before-done.md`
93
+ - `../../laws/non-blender-user-language.md`
94
+ - `../../laws/no-arbitrary-python-interface.md`
95
+ - `../../laws/official-runtime-only.md`
96
+
97
+ ## Official runtime boundary
98
+
99
+ Planning-only skill: no modeling, no animation, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief is unclear, hand off to `intent-to-3d-brief-writer`.
100
+
101
+ ## Operating procedure
102
+ 1. Read the brief from `intent-to-3d-brief-writer` and verify single-subject portrait scope.
103
+ 2. Check if the subject is a real person; require confirmed likeness rights before proceeding.
104
+ 3. Fill subject identity, pose, expression, and wardrobe sections.
105
+ 4. Define portrait framing, lighting intent, and background intent without overclaiming rendered results.
106
+ 5. Record all open assumptions in the assumptions register.
107
+ 6. List required assets and hand off asset rows to `asset-discovery`.
108
+ 7. Hand off camera/framing deep-dives to `camera-composition` and lookdev deep-dives to `lighting-material-plan`.
109
+ 8. Emit validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness` with `Runtime status: Not Run` and `Artifact status: Not Produced`.
110
+
111
+ ## Decision tree
112
+
113
+ ```txt
114
+ More than one character, or focus is a product / place / room?
115
+ → Stop; route to product-hero-scene-planner, environment-shot, or interior-scene
116
+ Subject is a real person without confirmed likeness rights?
117
+ → Stop (Fail); require likeness rights confirmation before use
118
+ Subject is identifiable real person?
119
+ → Add Warn for likeness rights + reference image needed
120
+ Pose unclear?
121
+ → Hand off to intent-to-3d-brief-writer
122
+ Framing close-up but lens 18mm?
123
+ → Warn (likely distortion); propose 50–85mm
124
+ Background detailed but framing tight close-up?
125
+ → Warn (background mostly out of frame; simplify)
126
+ Need detailed camera/framing or lookdev execution plan?
127
+ → Hand off framing to camera-composition and lookdev to lighting-material-plan
128
+ ```
129
+
130
+ ## Playbooks
131
+
132
+ ### Playbook A: Hero close-up (16:9 web)
133
+ 50–85mm equivalent; eyes on upper third; key + soft fill; rim for separation; simple gradient or studio HDRI background.
134
+
135
+ ### Playbook B: Editorial 9:16 mobile
136
+ 24–35mm; subject head + upper body; environmental story background; mixed warm + cool lighting.
137
+
138
+ ### Playbook C: Stylized character mascot
139
+ Style-specific; flat or simplified background; key + bounce; consistent stylization across face + wardrobe.
140
+
141
+ ## Mode handling
142
+
143
+ ### Text-only mode
144
+ Produce the portrait plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
145
+
146
+ ### Runtime-ready mode
147
+ Planning-only even when runtime is available downstream: keep `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgrade), and hand off to downstream planners and checkers.
148
+
149
+ ### Blocked runtime mode
150
+ Produce the portrait plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and log blockers under `Limitations`.
151
+
152
+ ## Validation checklist
153
+ - [ ] Single-subject portrait scope confirmed
154
+ - [ ] Likeness rights confirmed before use (if real person)
155
+ - [ ] Subject identity, pose, expression, and wardrobe filled
156
+ - [ ] Framing, lighting, and background filled
157
+ - [ ] Assumptions register included
158
+ - [ ] Asset rows flagged for `asset-discovery`
159
+ - [ ] Deep-dive handoffs named (`camera-composition`, `lighting-material-plan`)
160
+ - [ ] Validation handoffs named (`composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`)
161
+ - [ ] `Runtime status: Not Run` and `Artifact status: Not Produced` explicitly set
162
+
163
+ ## Pass / Warn / Fail rubric
164
+
165
+ | Verdict | Criteria |
166
+ | --- | --- |
167
+ | Pass | All portrait sections and assumptions register complete; likeness rights confirmed (if applicable); truth states locked to `Not Run` / `Not Produced`; downstream handoffs named. |
168
+ | Warn | Minor non-blocking detail open in the assumptions register; asset list partial. |
169
+ | Fail | Multi-character or non-portrait scope; real person used without confirmed likeness rights; missing lighting/framing/assumptions sections; truth states upgraded above `Not Run` / `Not Produced`. |
170
+
171
+ ## Failure handling
172
+ - Brief unclear → hand off to `intent-to-3d-brief-writer`.
173
+ - Real person without confirmed likeness rights → block plan and require rights confirmation before use.
174
+ - Framing or lookdev underspecified → hand off deep-dives to `camera-composition` and `lighting-material-plan`.
175
+ - Style inconsistent → flag in assumptions register and require user confirmation.
176
+
177
+ ## Troubleshooting
178
+
179
+ | Problem | Response |
180
+ |---|---|
181
+ | Real person reference has no confirmed likeness rights | Stop immediately; require likeness rights confirmation before use. |
182
+ | Stylization clashes between character and wardrobe | Re-lock style in the plan and update rows for `asset-discovery`. |
183
+ | Lighting and background compete with the subject | Hand off lookdev adjustments to `lighting-material-plan`, then validate with `lighting-quality-checker`. |
184
+
185
+ ## Best practices
186
+ - Lock style early; revisions are cheap pre-modeling.
187
+ - Pair pose decisions with camera decisions in one row.
188
+ - Always flag assets for `asset-discovery` before committing modeling work.
189
+
190
+ ## Good examples
191
+ - "Subject: stylized founder character, single subject (fictional, no real-person likeness). Pose/expression: three-quarter turn, calm smile, direct gaze. Wardrobe: dark knit top. Framing: close-up head-and-shoulders portrait (deep-dive via `camera-composition`). Lighting: soft key, gentle fill, subtle rim for separation (lookdev via `lighting-material-plan`). Background: neutral studio gradient. Assumptions register: single static frame; fictional character; no existing rig. Runtime status: Not Run. Artifact status: Not Produced."
192
+
193
+ ## Bad examples
194
+ - "Person looking at camera." — no proportions, lighting, or framing.
195
+ - "Verified ready" — no rendered evidence.
196
+
197
+ ## User-facing response template
198
+
199
+ ```txt
200
+ Subject identity: <single-subject description>
201
+ Likeness rights: <confirmed | fictional N/A | unconfirmed — BLOCKED>
202
+ Pose / expression: <pose and expression>
203
+ Wardrobe: <wardrobe and props>
204
+ Framing: <portrait framing intent>
205
+ Lighting: <key / fill / rim intent>
206
+ Background: <background intent>
207
+ Assumptions register: <explicit list of assumptions>
208
+
209
+ Assets to discover: <rows for asset-discovery>
210
+ Runtime status: Not Run
211
+ Artifact status: Not Produced
212
+ Evidence used: <links, paths, logs, or "none">
213
+ Limitations: <known gaps>
214
+ Next: asset-discovery | camera-composition | lighting-material-plan | composition-quality-checker | lighting-quality-checker | scene-readiness
215
+ ```
216
+
217
+ ## Anti-patterns
218
+ - Performing modeling, animation, rendering, or Blender execution inside this skill.
219
+ - Proceeding with a real person's likeness without confirmed rights before use.
220
+ - Upgrading `Runtime status` above `Not Run` or `Artifact status` above `Not Produced`.
221
+ - Blurring boundaries with `product-hero-scene-planner`, `environment-shot`, `interior-scene`, or multi-character ensembles.
222
+ - Bypassing `camera-composition` (framing) or `lighting-material-plan` (lookdev).
223
+
224
+ ## Cross-skill handoff
225
+ <!-- blendops:generated:start handoffs -->
226
+ - [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
227
+ - [progression] Framing deep-dive → `../camera-composition/SKILL.md`
228
+ - [progression] Lookdev deep-dive → `../lighting-material-plan/SKILL.md`
229
+ - [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
230
+ - [progression] Composition validation → `../composition-quality-checker/SKILL.md`
231
+ - [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
232
+ - [progression] Scene quality validation → `../scene-readiness/SKILL.md`
233
+ <!-- blendops:generated:end handoffs -->
234
+
235
+ ## Non-goals
236
+ - Model the character.
237
+ - Animate the character.
238
+ - Render.
239
+ - Run Blender.
240
+
241
+ ## References
242
+ - `references/portrait-framing-rules.md`
243
+ - `references/portrait-lighting-patterns.md`
244
+ - `references/style-consistency-rules.md`
245
+ - `../../docs/skill-system.md`
@@ -0,0 +1,205 @@
1
+ {
2
+ "$schema": "../../schemas/skill-contract.schema.json",
3
+ "id": "character-portrait",
4
+ "version": "1.0.0",
5
+ "category": "scene-planners",
6
+ "role": "character-portrait-and-turntable-architect",
7
+ "purpose": "Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.",
8
+ "capabilityTier": "L0",
9
+ "triggers": [
10
+ "portrait of",
11
+ "character looking at the camera",
12
+ "headshot",
13
+ "hero shot of [person / mascot / creature]"
14
+ ],
15
+ "exclusions": [
16
+ {
17
+ "condition": "product hero scenes",
18
+ "delegateTo": "product-hero-scene-planner",
19
+ "reason": "use product-hero-scene-planner"
20
+ },
21
+ {
22
+ "condition": "environment establishing shots",
23
+ "delegateTo": "environment-shot",
24
+ "reason": "use environment-shot"
25
+ },
26
+ {
27
+ "condition": "interior arch viz",
28
+ "delegateTo": "interior-scene",
29
+ "reason": "use interior-scene"
30
+ },
31
+ {
32
+ "condition": "multi-character ensemble (this skill is single-subject)",
33
+ "delegateTo": "intent-to-3d-brief-writer",
34
+ "reason": "this skill is single-subject"
35
+ }
36
+ ],
37
+ "inputs": {
38
+ "required": [
39
+ {
40
+ "name": "locked_3d_brief",
41
+ "type": "object",
42
+ "description": "Locked 3D brief specifying character subject, expression/pose, and framing intent"
43
+ },
44
+ {
45
+ "name": "character_asset_posture",
46
+ "type": "object",
47
+ "description": "Available character model/rig status and material readiness from asset discovery"
48
+ }
49
+ ],
50
+ "optional": [
51
+ {
52
+ "name": "turntable_or_still_preference",
53
+ "type": "string",
54
+ "description": "Whether the deliverable is a portrait still, bust turntable, or full-body pose"
55
+ }
56
+ ]
57
+ },
58
+ "outputs": {
59
+ "primary": [
60
+ "character_staging_and_pose_plan",
61
+ "eyeline_and_portrait_camera_anchors",
62
+ "skin_hair_rim_lighting_hooks"
63
+ ],
64
+ "truthStatePolicy": {
65
+ "runtimeDefault": "Not Run",
66
+ "artifactDefault": "Not Produced",
67
+ "mutationRule": "downgrade_only"
68
+ }
69
+ },
70
+ "handoffs": [
71
+ {
72
+ "target": "intent-to-3d-brief-writer",
73
+ "type": "upstream_reference",
74
+ "label": "Upstream brief",
75
+ "when": {
76
+ "all": [
77
+ {
78
+ "field": "goal.clarity",
79
+ "operator": "equals",
80
+ "value": "clear"
81
+ },
82
+ {
83
+ "field": "brief.locked",
84
+ "operator": "equals",
85
+ "value": false
86
+ }
87
+ ]
88
+ }
89
+ },
90
+ {
91
+ "target": "camera-composition",
92
+ "type": "progression",
93
+ "label": "Framing deep-dive",
94
+ "when": {
95
+ "all": [
96
+ {
97
+ "field": "brief.locked",
98
+ "operator": "equals",
99
+ "value": true
100
+ },
101
+ {
102
+ "field": "stage.current",
103
+ "operator": "equals",
104
+ "value": "camera_planning"
105
+ }
106
+ ]
107
+ }
108
+ },
109
+ {
110
+ "target": "lighting-material-plan",
111
+ "type": "progression",
112
+ "label": "Lookdev deep-dive",
113
+ "when": {
114
+ "all": [
115
+ {
116
+ "field": "brief.locked",
117
+ "operator": "equals",
118
+ "value": true
119
+ },
120
+ {
121
+ "field": "stage.current",
122
+ "operator": "equals",
123
+ "value": "lookdev_planning"
124
+ }
125
+ ]
126
+ }
127
+ },
128
+ {
129
+ "target": "asset-discovery",
130
+ "type": "upstream_reference",
131
+ "label": "Asset discovery",
132
+ "when": {
133
+ "all": [
134
+ {
135
+ "field": "brief.locked",
136
+ "operator": "equals",
137
+ "value": true
138
+ },
139
+ {
140
+ "field": "assets.discoveryComplete",
141
+ "operator": "equals",
142
+ "value": false
143
+ }
144
+ ]
145
+ }
146
+ },
147
+ {
148
+ "target": "composition-quality-checker",
149
+ "type": "progression",
150
+ "label": "Composition validation",
151
+ "when": {
152
+ "all": [
153
+ {
154
+ "field": "quality.domain",
155
+ "operator": "equals",
156
+ "value": "composition"
157
+ },
158
+ {
159
+ "field": "quality.verdict",
160
+ "operator": "equals",
161
+ "value": "not_run"
162
+ }
163
+ ]
164
+ }
165
+ },
166
+ {
167
+ "target": "lighting-quality-checker",
168
+ "type": "progression",
169
+ "label": "Lighting validation",
170
+ "when": {
171
+ "all": [
172
+ {
173
+ "field": "quality.domain",
174
+ "operator": "equals",
175
+ "value": "lighting"
176
+ },
177
+ {
178
+ "field": "quality.verdict",
179
+ "operator": "equals",
180
+ "value": "not_run"
181
+ }
182
+ ]
183
+ }
184
+ },
185
+ {
186
+ "target": "scene-readiness",
187
+ "type": "progression",
188
+ "label": "Scene quality validation",
189
+ "when": {
190
+ "all": [
191
+ {
192
+ "field": "quality.domain",
193
+ "operator": "equals",
194
+ "value": "holistic"
195
+ },
196
+ {
197
+ "field": "stage.current",
198
+ "operator": "equals",
199
+ "value": "quality_validation"
200
+ }
201
+ ]
202
+ }
203
+ }
204
+ ]
205
+ }
@@ -0,0 +1,39 @@
1
+ # Portrait framing rules
2
+
3
+ ## Lens / focal length per framing
4
+
5
+ | Framing | Equivalent focal length | Distance |
6
+ |---|---|---|
7
+ | Tight close-up (face only) | 85–135mm | 1.5–2.5m |
8
+ | Close-up (head + shoulders) | 50–85mm | 1.5–2m |
9
+ | Medium (head to waist) | 35–50mm | 2–3m |
10
+ | Wide (full body) | 24–35mm | 3–5m |
11
+ | Environmental portrait (subject in space) | 18–35mm | 4m+ |
12
+
13
+ Wider lenses on close-ups distort facial proportions. Avoid 16–18mm for any tight portrait.
14
+
15
+ ## Eye-line placement
16
+
17
+ - Tight close-up: eyes upper third (rule of thirds top line)
18
+ - Close-up: eyes upper third
19
+ - Medium / wide: eyes upper third or upper half
20
+ - Environmental: eyes anywhere; subject placement matters more
21
+
22
+ ## Subject placement
23
+
24
+ | Mood | Placement |
25
+ |---|---|
26
+ | Confident hero (centered or right-third for negative space CTA) | Right-third |
27
+ | Editorial documentary | Off-center, gaze leads into negative space |
28
+ | Symmetric brand portrait | Centered |
29
+ | Cinematic narrative | Variable; depth cues drive placement |
30
+
31
+ ## Aspect-specific notes
32
+
33
+ - 16:9: room for headline / CTA on opposite side of subject; use right-third.
34
+ - 1:1: subject fills frame; minimal negative space.
35
+ - 9:16: subject upper third; lower third reserved for caption / CTA.
36
+ - 2.39:1: subject off-center; horizontal negative space tells story.
37
+
38
+ ## Related skill
39
+ `../SKILL.md`
@@ -0,0 +1,50 @@
1
+ # Portrait lighting patterns
2
+
3
+ ## Standard 3-point (default for hero / editorial)
4
+
5
+ - **Key**: 50–500W area light, 45° from camera, slightly above subject eye-line. Soft size 0.4–1.0m for soft hero; 0.1–0.3m for harder editorial.
6
+ - **Fill**: 10–20% of key strength, opposite side of subject, larger soft size.
7
+ - **Rim**: 50–100W spot or area, behind subject 135° from camera, separates subject from background.
8
+
9
+ ## Rembrandt (editorial / dramatic)
10
+
11
+ - Key at 45° creating triangle of light on shadow-side cheek.
12
+ - Minimal fill; shadow-side is darker.
13
+ - Rim optional.
14
+ - Mood: classic, painterly, contemplative.
15
+
16
+ ## Butterfly (beauty / glamour)
17
+
18
+ - Key directly in front of subject, slightly above; soft.
19
+ - Fill from below to lift shadows under chin.
20
+ - Rim optional.
21
+ - Mood: glamorous, polished.
22
+
23
+ ## Split (dramatic / mystery)
24
+
25
+ - Key 90° to one side; one half of face lit, other half in shadow.
26
+ - Minimal fill.
27
+ - Mood: noir, character study.
28
+
29
+ ## Loop (versatile portrait)
30
+
31
+ - Key just off-center, slightly above; small loop shadow from nose.
32
+ - Fill subordinate.
33
+ - Rim optional.
34
+ - Mood: friendly, accessible.
35
+
36
+ ## HDRI use in portraits
37
+
38
+ - Studio HDRI 0.5–1.0 for ambient + ground reflection.
39
+ - Outdoor HDRI 0.7–1.5 for environmental context.
40
+ - Avoid HDRI alone for hero portraits — explicit key light gives the snap that HDRI alone lacks.
41
+
42
+ ## Background
43
+
44
+ - Solid color seamless: cleanest hero look.
45
+ - Gradient: subtle depth.
46
+ - Studio backdrop with subtle texture: editorial.
47
+ - Environmental: storytelling but ensure subject still reads.
48
+
49
+ ## Related skill
50
+ `../SKILL.md`
@@ -0,0 +1,41 @@
1
+ # Style consistency rules
2
+
3
+ A character portrait reads as broken if the subject, wardrobe, props, and background do not share the same stylization. Lock style early.
4
+
5
+ ## Style axes
6
+
7
+ - **Realism**: photorealistic ↔ stylized ↔ flat / cartoon
8
+ - **Detail density**: high (PBR + micro-detail) ↔ medium ↔ low (stylized)
9
+ - **Color treatment**: natural ↔ graded ↔ stylized palette
10
+ - **Surface complexity**: realistic textures ↔ painterly ↔ flat color blocks
11
+
12
+ ## Per-axis decision
13
+
14
+ For each axis, lock one position and apply across:
15
+ 1. Subject skin / face
16
+ 2. Subject hair
17
+ 3. Wardrobe
18
+ 4. Props
19
+ 5. Background / environment
20
+
21
+ ## Common consistency failures
22
+
23
+ - Photoreal subject + stylized cartoon background → reads as compositing error.
24
+ - Stylized subject + PBR wardrobe with detailed materials → wardrobe upstages subject.
25
+ - Mix of realistic + flat-color props in the same hand → distracting.
26
+ - Background more detailed than subject → eye reads background first.
27
+
28
+ ## Color harmony
29
+
30
+ - Subject's primary palette → wardrobe accents → background ambient color → prop color.
31
+ - Use a 60-30-10 distribution (dominant / secondary / accent).
32
+ - Verify against `composition-quality-checker` hierarchy rules.
33
+
34
+ ## Verdicts
35
+
36
+ - Pass: all 5 elements share style axis position.
37
+ - Warn: one element drifts (e.g. wardrobe slightly more realistic than subject).
38
+ - Fail: clear mix of realism + stylized (subject photoreal, props flat color block).
39
+
40
+ ## Related skill
41
+ `../SKILL.md`
@@ -0,0 +1,26 @@
1
+ # EVAL — cli-appendix-job-outline
2
+
3
+ ## Text-only eval prompt
4
+
5
+ CI must nightly export GLBs from `.blend` files on Linux agents without MCP. Outline job.
6
+
7
+ ## Expected behavior
8
+
9
+ - CLI appendix framing + first-class upstream mention + no in-repo BlendOps evidence claim
10
+ - Phases: background startup, load file, export, verify output path logging
11
+ - Stateless limits noted
12
+ - Hand off to render-export-evidence for ledger expectations
13
+
14
+ ## Pass / Warn / Fail criteria
15
+
16
+ - Pass: phases + hook points + doc pointer
17
+ - Warn: GPU ambiguity
18
+ - Fail: drops evidence discipline
19
+
20
+ ## Sample passing response outline
21
+
22
+ - Numbered phases + caution banner
23
+
24
+ ## Sample failing response outline
25
+
26
+ - Paste 200-line script as "the solution"