blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: composition-quality-checker
|
|
3
|
+
description: Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# composition-quality-checker
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run a focused per-row Pass/Warn/Fail check on the camera and framing setup against composition rules (rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility) — emitting per-row verdicts, a top-line status, and remediation hints only, without expanding into camera planning, aspect-ratio locking, material validation, or lighting validation.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- read camera lens / FOV, position, and target description
|
|
13
|
+
- read framing intent and locked aspect ratio from the brief
|
|
14
|
+
- check rule of thirds, subject placement, and headroom/lead-room
|
|
15
|
+
- check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
|
|
16
|
+
- emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
- before render
|
|
20
|
+
- after a camera change request
|
|
21
|
+
- as a sub-check during full quality review
|
|
22
|
+
- when a render "feels off" but lighting and materials check out
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- planning or editing camera framing → use `../camera-composition/SKILL.md` (use camera-composition)
|
|
27
|
+
- locking aspect ratio or resolution → use `../resolution-aspect-decision/SKILL.md` (use resolution-aspect-decision)
|
|
28
|
+
- material validation → use `../material-quality-checker/SKILL.md` (use material-quality-checker)
|
|
29
|
+
- lighting validation → use `../lighting-quality-checker/SKILL.md` (use lighting-quality-checker)
|
|
30
|
+
- broad scene Pass/Warn/Fail readiness review → use `../scene-readiness/SKILL.md` (use scene-readiness)
|
|
31
|
+
- classifying render or export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
|
|
32
|
+
<!-- blendops:generated:end exclusions -->
|
|
33
|
+
|
|
34
|
+
## Trigger phrases
|
|
35
|
+
<!-- blendops:generated:start triggers -->
|
|
36
|
+
- "is the framing okay"
|
|
37
|
+
- "check composition"
|
|
38
|
+
- "subject feels off-center"
|
|
39
|
+
- "too much negative space"
|
|
40
|
+
<!-- blendops:generated:end triggers -->
|
|
41
|
+
|
|
42
|
+
## Prerequisites / readiness
|
|
43
|
+
- camera setup known (FOV / focal length / position / target / lens)
|
|
44
|
+
- framing intent known (from brief)
|
|
45
|
+
- subject identified
|
|
46
|
+
|
|
47
|
+
## Input schema
|
|
48
|
+
|
|
49
|
+
### Required inputs
|
|
50
|
+
|
|
51
|
+
| Input | Why it is required |
|
|
52
|
+
|---|---|
|
|
53
|
+
| Camera setup | Anchors lens/FOV plausibility and framing checks |
|
|
54
|
+
| Framing intent | Determines applicable composition expectations (close-up vs hero card vs wide) |
|
|
55
|
+
| Subject identification | Determines what counts as the primary subject for placement and hierarchy rules |
|
|
56
|
+
| Aspect ratio lock | Provided upstream (via `resolution-aspect-decision`) to evaluate framing boundaries |
|
|
57
|
+
|
|
58
|
+
### Optional inputs
|
|
59
|
+
|
|
60
|
+
| Input | Use |
|
|
61
|
+
|---|---|
|
|
62
|
+
| Reference image or preview | Allows visual cross-check of framing and depth cues |
|
|
63
|
+
|
|
64
|
+
### Assumptions to confirm
|
|
65
|
+
- Render aspect ratio is known and stable.
|
|
66
|
+
- "Subject" is unambiguous in the brief.
|
|
67
|
+
- Camera is locked (or animated path is documented).
|
|
68
|
+
|
|
69
|
+
## Output schema
|
|
70
|
+
|
|
71
|
+
### Primary output
|
|
72
|
+
A composition verdict table covering: rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility — each with a `Pass | Warn | Fail` verdict and notes.
|
|
73
|
+
|
|
74
|
+
### Secondary output
|
|
75
|
+
- top-line validation status (`Pass | Warn | Fail`)
|
|
76
|
+
- worst-offender highlighting
|
|
77
|
+
- remediation hints only (never camera edits or execution commands)
|
|
78
|
+
|
|
79
|
+
### Evidence / caveat output
|
|
80
|
+
Validation verdicts (`Pass | Warn | Fail`) are separate from runtime and artifact truth states. Truth states are downgrade-only (never upgrade), and `Artifact status` defaults to `Not Produced` unless concrete output evidence exists (classified via `render-export-evidence`).
|
|
81
|
+
|
|
82
|
+
```txt
|
|
83
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
84
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
85
|
+
Evidence used: <links, paths, logs, or "none">
|
|
86
|
+
Limitations: <known gaps>
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Required laws
|
|
90
|
+
- `../../laws/evidence-before-done.md`
|
|
91
|
+
- `../../laws/non-blender-user-language.md`
|
|
92
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
93
|
+
- `../../laws/official-runtime-only.md`
|
|
94
|
+
|
|
95
|
+
## Official runtime boundary
|
|
96
|
+
|
|
97
|
+
This skill validates camera plans or measured scene snapshots only. It never moves the camera, never runs Blender, and never executes Python. Artifacts stay `Not Produced` unless concrete output evidence exists (classified by `render-export-evidence`), and truth states are strictly downgrade-only.
|
|
98
|
+
|
|
99
|
+
## Operating procedure
|
|
100
|
+
1. Read camera setup, framing intent, subject identification, and upstream aspect lock (from `resolution-aspect-decision`).
|
|
101
|
+
2. Check rule of thirds alignment against framing intent.
|
|
102
|
+
3. Check subject placement per intent.
|
|
103
|
+
4. Check headroom and lead-room balance.
|
|
104
|
+
5. Check negative space balance and visual hierarchy.
|
|
105
|
+
6. Check depth cues (foreground/midground/background separation).
|
|
106
|
+
7. Check lens / FOV plausibility for distortion or flattening against the brief.
|
|
107
|
+
8. Assign per-row `Pass | Warn | Fail` verdicts and remediation hints.
|
|
108
|
+
9. Compute top-line status and highlight worst offenders; record downgrade-only Runtime and Artifact truth states separately (defaulting Artifact status to `Not Produced`).
|
|
109
|
+
10. Hand off to `scene-readiness` (broad review), `camera-composition` (camera re-plan), `resolution-aspect-decision` (aspect/resolution changes), or `render-export-evidence` (artifact evidence classification).
|
|
110
|
+
|
|
111
|
+
## Decision tree
|
|
112
|
+
|
|
113
|
+
```txt
|
|
114
|
+
Subject dead-center in 16:9 hero card?
|
|
115
|
+
→ Pass for symmetric hero; Warn for documentary/editorial mood
|
|
116
|
+
Subject in dead corner?
|
|
117
|
+
→ Fail unless intentional asymmetry called out in brief
|
|
118
|
+
Headroom > 30% of frame for portrait?
|
|
119
|
+
→ Warn (too much empty space above)
|
|
120
|
+
Headroom 0% (subject's head touching top)?
|
|
121
|
+
→ Fail
|
|
122
|
+
Lead room missing for moving subject?
|
|
123
|
+
→ Fail (subject "pressed against" frame)
|
|
124
|
+
Negative space carrying intentional weight?
|
|
125
|
+
→ Pass; verify with brief
|
|
126
|
+
FOV < 18mm equivalent on a hero close-up?
|
|
127
|
+
→ Warn (likely distortion); verify intent
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## Playbooks
|
|
131
|
+
|
|
132
|
+
### Playbook A: Product hero card 16:9
|
|
133
|
+
Subject ~60% width, centered horizontally or on right third; clear negative space on the opposite side for headline / CTA; soft horizon line; FOV 50–85mm equivalent.
|
|
134
|
+
|
|
135
|
+
### Playbook B: Square 1:1 social
|
|
136
|
+
Subject centered; negative space minimal; tight crop OK if not cropping silhouette.
|
|
137
|
+
|
|
138
|
+
### Playbook C: Portrait 9:16 mobile
|
|
139
|
+
Subject in upper third; lower third reserved for text overlay; full silhouette visible.
|
|
140
|
+
|
|
141
|
+
### Playbook D: Cinematic 2.39:1
|
|
142
|
+
Wide negative space allowed; subject often off-center using rule of thirds; horizon at upper or lower third.
|
|
143
|
+
|
|
144
|
+
## Mode handling
|
|
145
|
+
|
|
146
|
+
### Text-only mode
|
|
147
|
+
Per-row `Pass | Warn | Fail` verdicts are based on the written camera plan/brief only. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced`.
|
|
148
|
+
|
|
149
|
+
### Runtime-ready mode
|
|
150
|
+
Per-row verdicts cross-check the measured scene snapshot or preview. Truth states remain separate from row verdicts, are downgrade-only, and require `render-export-evidence` before any artifact state above `Not Produced` is recorded.
|
|
151
|
+
|
|
152
|
+
### Blocked runtime mode
|
|
153
|
+
Skip preview-dependent verification, flag limitations explicitly, keep `Artifact status: Not Produced`, and downgrade truth states accordingly.
|
|
154
|
+
|
|
155
|
+
## Validation checklist
|
|
156
|
+
- [ ] Camera setup stated
|
|
157
|
+
- [ ] Framing intent stated
|
|
158
|
+
- [ ] Aspect ratio lock confirmed (from `resolution-aspect-decision`)
|
|
159
|
+
- [ ] Rule of thirds verdict
|
|
160
|
+
- [ ] Subject placement verdict
|
|
161
|
+
- [ ] Headroom / lead-room verdict
|
|
162
|
+
- [ ] Negative space verdict
|
|
163
|
+
- [ ] Visual hierarchy verdict
|
|
164
|
+
- [ ] Depth cues verdict
|
|
165
|
+
- [ ] Lens / FOV plausibility verdict
|
|
166
|
+
- [ ] Top-line status derived from rows (kept separate from Runtime/Artifact truth states)
|
|
167
|
+
|
|
168
|
+
## Pass / Warn / Fail rubric
|
|
169
|
+
|
|
170
|
+
| Verdict | Criteria |
|
|
171
|
+
|---|---|
|
|
172
|
+
| Pass | All rows pass; framing matches brief; aspect ratio coherent. |
|
|
173
|
+
| Warn | One or two plausibility flags (centered when off-center expected, FOV at boundary); no hard violations. |
|
|
174
|
+
| Fail | Subject dead corner without justification; 0 or excessive headroom; lead-room missing for moving subject; FOV severely wrong (e.g. 8mm on hero close-up). |
|
|
175
|
+
|
|
176
|
+
## Failure handling
|
|
177
|
+
- Camera path animated → flag every keyframe individually if possible, or mark as Warn for static-rule scope.
|
|
178
|
+
- "Negative space minimal" intent vs measured negative space wide → Fail, not Warn.
|
|
179
|
+
- Aspect ratio missing → Fail until provided.
|
|
180
|
+
|
|
181
|
+
## Troubleshooting
|
|
182
|
+
|
|
183
|
+
| Problem | Remediation hint (do not execute) |
|
|
184
|
+
|---|---|
|
|
185
|
+
| Subject feels off-center or unbalanced | Hint: verify rule-of-thirds vs centered intent; route to `camera-composition` if camera re-aiming is needed. |
|
|
186
|
+
| Excessive or cramped headroom | Hint: adjust framing tightness or subject framing height in `camera-composition`. |
|
|
187
|
+
| Unintended close-up perspective distortion | Hint: increase camera distance and use a longer focal length / narrower FOV in `camera-composition`. |
|
|
188
|
+
| Flat staging with weak depth cues | Hint: increase foreground/background separation or staging depth in `camera-composition`. |
|
|
189
|
+
| Aspect ratio mismatch with target delivery | Hint: route to `resolution-aspect-decision` to lock the proper aspect ratio before re-planning framing. |
|
|
190
|
+
|
|
191
|
+
## Best practices
|
|
192
|
+
- Confirm the upstream aspect-ratio lock from `resolution-aspect-decision` before judging framing margins.
|
|
193
|
+
- Apply composition checks relative to framing intent, not as rigid universal formulas.
|
|
194
|
+
- Treat negative space and depth cues as intentional design elements anchored to the brief.
|
|
195
|
+
- Provide remediation hints only — leave camera edits to `camera-composition` and broad scene sign-off to `scene-readiness`.
|
|
196
|
+
|
|
197
|
+
## Good examples
|
|
198
|
+
- "16:9 hero card; subject right-third 60% width; headroom 18%; lead room not applicable (static); negative space left for CTA; FOV 50mm equivalent. Verdict: Pass."
|
|
199
|
+
|
|
200
|
+
## Bad examples
|
|
201
|
+
- "Composition looks fine." — no per-row analysis.
|
|
202
|
+
- "Verified" without preview cross-check.
|
|
203
|
+
|
|
204
|
+
## User-facing response template
|
|
205
|
+
|
|
206
|
+
```txt
|
|
207
|
+
Aspect ratio lock: <from resolution-aspect-decision>
|
|
208
|
+
Framing intent: <hero card / portrait / wide / cinematic>
|
|
209
|
+
|
|
210
|
+
| Check | Verdict | Notes / Remediation Hint |
|
|
211
|
+
|---|---|---|
|
|
212
|
+
| Rule of thirds | Pass/Warn/Fail | |
|
|
213
|
+
| Subject placement | Pass/Warn/Fail | |
|
|
214
|
+
| Headroom / lead-room | Pass/Warn/Fail | |
|
|
215
|
+
| Negative space | Pass/Warn/Fail | |
|
|
216
|
+
| Visual hierarchy | Pass/Warn/Fail | |
|
|
217
|
+
| Depth cues | Pass/Warn/Fail | |
|
|
218
|
+
| Lens / FOV plausibility | Pass/Warn/Fail | |
|
|
219
|
+
|
|
220
|
+
Top-line verdict: <Pass / Warn / Fail>
|
|
221
|
+
Worst offenders: <list or "none">
|
|
222
|
+
Remediation hints: <hints only — no camera edits>
|
|
223
|
+
|
|
224
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
225
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
226
|
+
Evidence used: <links, paths, logs, or "none">
|
|
227
|
+
Limitations: <gaps>
|
|
228
|
+
Next: scene-readiness | camera-composition | resolution-aspect-decision | render-export-evidence
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
## Anti-patterns
|
|
232
|
+
- Editing the camera inside this skill.
|
|
233
|
+
- Inventing values.
|
|
234
|
+
- Marking Verified without preview.
|
|
235
|
+
- Mixing material / lighting checks here.
|
|
236
|
+
|
|
237
|
+
## Cross-skill handoff
|
|
238
|
+
<!-- blendops:generated:start handoffs -->
|
|
239
|
+
- [progression] Broad scene readiness review (consumes these rows) → `../scene-readiness/SKILL.md`
|
|
240
|
+
- [retry] Camera & framing re-plan → `../camera-composition/SKILL.md`
|
|
241
|
+
- [retry] Aspect ratio & resolution locks → `../resolution-aspect-decision/SKILL.md`
|
|
242
|
+
- [progression] Artifact evidence classification → `../render-export-evidence/SKILL.md`
|
|
243
|
+
- [upstream_reference] Material validation → `../material-quality-checker/SKILL.md`
|
|
244
|
+
- [upstream_reference] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
245
|
+
<!-- blendops:generated:end handoffs -->
|
|
246
|
+
|
|
247
|
+
## Non-goals
|
|
248
|
+
- Move or edit the camera (owned by `camera-composition`).
|
|
249
|
+
- Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
|
|
250
|
+
- Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
|
|
251
|
+
- Replace broad scene review (`scene-readiness`).
|
|
252
|
+
- Classify render or export artifact evidence (`render-export-evidence`).
|
|
253
|
+
- Run Blender or execute Python.
|
|
254
|
+
|
|
255
|
+
## References
|
|
256
|
+
- `references/composition-rules.md`
|
|
257
|
+
- `references/headroom-leadroom-rules.md`
|
|
258
|
+
- `references/aspect-ratio-rules.md`
|
|
259
|
+
- `../../laws/evidence-before-done.md`
|
|
260
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "composition-quality-checker",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "quality-validators",
|
|
6
|
+
"role": "framing-and-silhouette-validator",
|
|
7
|
+
"purpose": "Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"is the framing okay",
|
|
11
|
+
"check composition",
|
|
12
|
+
"subject feels off-center",
|
|
13
|
+
"too much negative space"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "planning or editing camera framing",
|
|
18
|
+
"delegateTo": "camera-composition",
|
|
19
|
+
"reason": "use camera-composition"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "locking aspect ratio or resolution",
|
|
23
|
+
"delegateTo": "resolution-aspect-decision",
|
|
24
|
+
"reason": "use resolution-aspect-decision"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "material validation",
|
|
28
|
+
"delegateTo": "material-quality-checker",
|
|
29
|
+
"reason": "use material-quality-checker"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "lighting validation",
|
|
33
|
+
"delegateTo": "lighting-quality-checker",
|
|
34
|
+
"reason": "use lighting-quality-checker"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "broad scene Pass/Warn/Fail readiness review",
|
|
38
|
+
"delegateTo": "scene-readiness",
|
|
39
|
+
"reason": "use scene-readiness"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "classifying render or export artifact evidence",
|
|
43
|
+
"delegateTo": "render-export-evidence",
|
|
44
|
+
"reason": "use render-export-evidence"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "camera_and_framing_spec",
|
|
51
|
+
"type": "object",
|
|
52
|
+
"description": "Camera focal length, sensor, angle, and subject placement from camera-composition"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "pinned_aspect_ratio_and_subject",
|
|
56
|
+
"type": "object",
|
|
57
|
+
"description": "Locked aspect ratio and primary/secondary focal hierarchy from brief"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "viewport_or_render_preview_notes",
|
|
63
|
+
"type": "string",
|
|
64
|
+
"description": "Optional framing observations from a viewport or preview capture"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"composition_verdict_table",
|
|
71
|
+
"silhouette_and_headroom_assessment",
|
|
72
|
+
"camera_replan_remediation_hints"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "scene-readiness",
|
|
83
|
+
"type": "progression",
|
|
84
|
+
"label": "Broad scene readiness review (consumes these rows)",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "quality.domain",
|
|
89
|
+
"operator": "equals",
|
|
90
|
+
"value": "holistic"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"field": "stage.current",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": "quality_validation"
|
|
96
|
+
}
|
|
97
|
+
]
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"target": "camera-composition",
|
|
102
|
+
"type": "retry",
|
|
103
|
+
"label": "Camera & framing re-plan",
|
|
104
|
+
"when": {
|
|
105
|
+
"all": [
|
|
106
|
+
{
|
|
107
|
+
"field": "quality.domain",
|
|
108
|
+
"operator": "equals",
|
|
109
|
+
"value": "composition"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"field": "quality.verdict",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": "Fail"
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
},
|
|
118
|
+
"retryPolicy": {
|
|
119
|
+
"maxAttempts": 2,
|
|
120
|
+
"exitCondition": {
|
|
121
|
+
"all": [
|
|
122
|
+
{
|
|
123
|
+
"field": "quality.verdict",
|
|
124
|
+
"operator": "in",
|
|
125
|
+
"value": [
|
|
126
|
+
"Pass",
|
|
127
|
+
"Warn"
|
|
128
|
+
]
|
|
129
|
+
}
|
|
130
|
+
]
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"target": "resolution-aspect-decision",
|
|
136
|
+
"type": "retry",
|
|
137
|
+
"label": "Aspect ratio & resolution locks",
|
|
138
|
+
"when": {
|
|
139
|
+
"all": [
|
|
140
|
+
{
|
|
141
|
+
"field": "quality.domain",
|
|
142
|
+
"operator": "equals",
|
|
143
|
+
"value": "composition"
|
|
144
|
+
},
|
|
145
|
+
{
|
|
146
|
+
"field": "quality.verdict",
|
|
147
|
+
"operator": "equals",
|
|
148
|
+
"value": "Fail"
|
|
149
|
+
}
|
|
150
|
+
]
|
|
151
|
+
},
|
|
152
|
+
"retryPolicy": {
|
|
153
|
+
"maxAttempts": 2,
|
|
154
|
+
"exitCondition": {
|
|
155
|
+
"all": [
|
|
156
|
+
{
|
|
157
|
+
"field": "quality.verdict",
|
|
158
|
+
"operator": "in",
|
|
159
|
+
"value": [
|
|
160
|
+
"Pass",
|
|
161
|
+
"Warn"
|
|
162
|
+
]
|
|
163
|
+
}
|
|
164
|
+
]
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
},
|
|
168
|
+
{
|
|
169
|
+
"target": "render-export-evidence",
|
|
170
|
+
"type": "progression",
|
|
171
|
+
"label": "Artifact evidence classification",
|
|
172
|
+
"when": {
|
|
173
|
+
"all": [
|
|
174
|
+
{
|
|
175
|
+
"field": "stage.current",
|
|
176
|
+
"operator": "equals",
|
|
177
|
+
"value": "post_execution_audit"
|
|
178
|
+
}
|
|
179
|
+
]
|
|
180
|
+
}
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
"target": "material-quality-checker",
|
|
184
|
+
"type": "upstream_reference",
|
|
185
|
+
"label": "Material validation",
|
|
186
|
+
"when": {
|
|
187
|
+
"all": [
|
|
188
|
+
{
|
|
189
|
+
"field": "quality.domain",
|
|
190
|
+
"operator": "equals",
|
|
191
|
+
"value": "material"
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
"field": "quality.verdict",
|
|
195
|
+
"operator": "equals",
|
|
196
|
+
"value": "not_run"
|
|
197
|
+
}
|
|
198
|
+
]
|
|
199
|
+
}
|
|
200
|
+
},
|
|
201
|
+
{
|
|
202
|
+
"target": "lighting-quality-checker",
|
|
203
|
+
"type": "upstream_reference",
|
|
204
|
+
"label": "Lighting validation",
|
|
205
|
+
"when": {
|
|
206
|
+
"all": [
|
|
207
|
+
{
|
|
208
|
+
"field": "quality.domain",
|
|
209
|
+
"operator": "equals",
|
|
210
|
+
"value": "lighting"
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
"field": "quality.verdict",
|
|
214
|
+
"operator": "equals",
|
|
215
|
+
"value": "not_run"
|
|
216
|
+
}
|
|
217
|
+
]
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
]
|
|
221
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Aspect ratio rules
|
|
2
|
+
|
|
3
|
+
The downstream consumer's required aspect ratio drives most composition decisions. Lock the aspect first; do not improvise.
|
|
4
|
+
|
|
5
|
+
## Common downstream aspects
|
|
6
|
+
|
|
7
|
+
| Use case | Aspect | Notes |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Web hero card | 16:9 (1920×1080) | Most common landing-page hero |
|
|
10
|
+
| Wide cinematic | 2.39:1 | Banner / billboard / cinematic |
|
|
11
|
+
| Square social | 1:1 | Instagram feed / catalog grid |
|
|
12
|
+
| Portrait social | 4:5 or 9:16 | Instagram portrait / TikTok / vertical mobile |
|
|
13
|
+
| App icon | 1:1 | Single subject only |
|
|
14
|
+
| Catalog grid | 4:3 or 1:1 | Often standardized |
|
|
15
|
+
|
|
16
|
+
## Render at the target aspect
|
|
17
|
+
|
|
18
|
+
Always render at the consumer's aspect ratio, **not** at a different ratio with the intent to crop. Cropping introduces bias and breaks composition.
|
|
19
|
+
|
|
20
|
+
## When the brief is silent
|
|
21
|
+
|
|
22
|
+
- Default to 16:9 for web hero.
|
|
23
|
+
- Default to 1:1 for social.
|
|
24
|
+
- Default to 9:16 for mobile-only contexts.
|
|
25
|
+
- Always confirm with user; do not assume.
|
|
26
|
+
|
|
27
|
+
## Aspect ratio mismatch verdicts
|
|
28
|
+
|
|
29
|
+
| Situation | Verdict |
|
|
30
|
+
|---|---|
|
|
31
|
+
| Render aspect matches brief | Pass |
|
|
32
|
+
| Render aspect close (e.g. 16:10 vs 16:9) | Warn |
|
|
33
|
+
| Render aspect wrong direction (square brief, wide render) | Fail |
|
|
34
|
+
| Aspect not specified in brief | Fail (brief incomplete) |
|
|
35
|
+
|
|
36
|
+
## Related skill
|
|
37
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Composition rules (rule of thirds, subject placement, hierarchy)
|
|
2
|
+
|
|
3
|
+
These are heuristics, not laws. Apply per framing intent.
|
|
4
|
+
|
|
5
|
+
## Rule of thirds
|
|
6
|
+
|
|
7
|
+
Divide the frame into 9 equal parts (3 × 3). Place primary subjects on the lines or intersection points (not center) for editorial / cinematic intent.
|
|
8
|
+
|
|
9
|
+
| Framing | Subject position |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Editorial portrait | Eye line on upper-third horizontal |
|
|
12
|
+
| Hero card with CTA | Subject on right-third (or left-third) vertical line |
|
|
13
|
+
| Cinematic landscape | Horizon on upper or lower third |
|
|
14
|
+
| Symmetric brand hero | Center is OK; rule of thirds optional |
|
|
15
|
+
|
|
16
|
+
## Subject placement
|
|
17
|
+
|
|
18
|
+
| Intent | Placement |
|
|
19
|
+
|---|---|
|
|
20
|
+
| Symmetric brand hero | Centered |
|
|
21
|
+
| Editorial / dynamic | Off-center on third |
|
|
22
|
+
| Catalog product (with negative space for text) | Right or left third |
|
|
23
|
+
| Documentary (off-camera focus) | Far edge with negative space toward viewer's gaze |
|
|
24
|
+
|
|
25
|
+
## Visual hierarchy
|
|
26
|
+
|
|
27
|
+
The eye reads:
|
|
28
|
+
1. Brightest spot first
|
|
29
|
+
2. Highest contrast next
|
|
30
|
+
3. Sharpest focus next
|
|
31
|
+
4. Largest object next
|
|
32
|
+
5. Most saturated color next
|
|
33
|
+
|
|
34
|
+
Hierarchy verdicts:
|
|
35
|
+
- Pass: subject claims at least 3 of these.
|
|
36
|
+
- Warn: subject claims 1–2.
|
|
37
|
+
- Fail: subject claims 0 (eye reads a non-subject as primary).
|
|
38
|
+
|
|
39
|
+
## Negative space
|
|
40
|
+
|
|
41
|
+
Negative space is **intentional**:
|
|
42
|
+
- "Soft hero" → wide negative space allowed for headline.
|
|
43
|
+
- "Editorial" → negative space carries mood.
|
|
44
|
+
- "Catalog" → negative space minimal; tight crop.
|
|
45
|
+
|
|
46
|
+
Verdict: match against intent. Wide negative space without brief justification → Warn or Fail.
|
|
47
|
+
|
|
48
|
+
## Depth cues
|
|
49
|
+
|
|
50
|
+
- Atmospheric perspective (haze) for outdoor depth.
|
|
51
|
+
- Overlap (foreground occluding mid/background).
|
|
52
|
+
- Size diminishment.
|
|
53
|
+
- Bokeh / depth of field.
|
|
54
|
+
|
|
55
|
+
A 3D scene without depth cues reads as flat. Hero close-up may intentionally minimize depth; verify intent.
|
|
56
|
+
|
|
57
|
+
## Related skill
|
|
58
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Headroom + lead room rules
|
|
2
|
+
|
|
3
|
+
## Headroom (space above subject)
|
|
4
|
+
|
|
5
|
+
| Subject | Recommended headroom (% of frame height) |
|
|
6
|
+
|---|---|
|
|
7
|
+
| Tight portrait close-up | 5–10% |
|
|
8
|
+
| Medium portrait shot | 10–18% |
|
|
9
|
+
| Wide / full body | 15–25% |
|
|
10
|
+
| Hero product (architectural) | 10–20% |
|
|
11
|
+
|
|
12
|
+
### Verdicts
|
|
13
|
+
|
|
14
|
+
- Pass: within recommended range.
|
|
15
|
+
- Warn: 0% (head touching top is uncomfortable for most uses) OR > 35% (excessive).
|
|
16
|
+
- Fail: head cropped (subject head extends above frame) when not stylistically justified.
|
|
17
|
+
|
|
18
|
+
## Lead room (space in direction of motion or gaze)
|
|
19
|
+
|
|
20
|
+
| Subject | Lead room |
|
|
21
|
+
|---|---|
|
|
22
|
+
| Subject looking left | More space on left of subject |
|
|
23
|
+
| Subject moving right | More space on right of subject |
|
|
24
|
+
| Static centered subject | Lead room not applicable |
|
|
25
|
+
|
|
26
|
+
### Verdicts
|
|
27
|
+
|
|
28
|
+
- Pass: lead room aligns with motion / gaze direction.
|
|
29
|
+
- Warn: lead room slightly off (within 10% of frame width).
|
|
30
|
+
- Fail: subject "pressed against" frame edge in motion / gaze direction → reads as trapped.
|
|
31
|
+
|
|
32
|
+
## Common mistakes
|
|
33
|
+
|
|
34
|
+
- Placing the subject's eyes at the dead vertical center (instead of upper third).
|
|
35
|
+
- Excessive headroom for tight close-ups.
|
|
36
|
+
- Lead room behind the subject (anti-motion direction).
|
|
37
|
+
- Treating "centered" as universally safe (it is not for editorial intent).
|
|
38
|
+
|
|
39
|
+
## Per-aspect adjustments
|
|
40
|
+
|
|
41
|
+
- 1:1 (square) → headroom can be slightly less; subject often centered.
|
|
42
|
+
- 9:16 (portrait mobile) → headroom and chinroom equally important; subject typically upper third.
|
|
43
|
+
- 2.39:1 (cinematic) → exaggerate horizontal lead room; verticals less critical.
|
|
44
|
+
|
|
45
|
+
## Related skill
|
|
46
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# EVAL — cycles-vs-eevee-decision
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Apply cycles-vs-eevee-decision for a hero product render with caustics + SSS, time budget 10 minutes per frame, OPTIX GPU available.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- engine: Cycles (caustics + SSS need it)
|
|
8
|
+
- samples: 256-512 with denoiser
|
|
9
|
+
- GPU device: OPTIX
|
|
10
|
+
- time budget realistic at chosen samples
|
|
11
|
+
- caveats listed
|
|
12
|
+
- handoff: render-export-evidence
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: engine + samples + GPU + caveats + handoff
|
|
16
|
+
- Warn: borderline samples for time budget
|
|
17
|
+
- Fail: Eevee for caustics, samples severely under-budget, no GPU device chosen
|
|
18
|
+
|
|
19
|
+
## Sample passing response outline
|
|
20
|
+
- Use case + features + time + machine header
|
|
21
|
+
- Engine config (5 lines)
|
|
22
|
+
- Caveats
|
|
23
|
+
|
|
24
|
+
## Sample failing response outline
|
|
25
|
+
- "Use Cycles"
|
|
26
|
+
- No samples / GPU / caveats
|