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,196 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: camera-composition
|
|
3
|
+
description: Plan hero camera framing, 35-105mm focal lengths, composition hierarchy, and web copy-safe negative space before lighting or rendering.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# camera-composition
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm this skill fits your goal
|
|
13
|
+
- provide required inputs first
|
|
14
|
+
- keep runtime claims evidence-bound
|
|
15
|
+
- follow suggested next-skill handoff
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
|
|
19
|
+
- defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
|
|
20
|
+
- aligning hero framing and negative space with web/UI copy overlays
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- as proof of rendered output quality or to validate an existing framing → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
|
|
25
|
+
- to design lighting rigs or surface materials/lookdev → use `../lighting-material-plan/SKILL.md` (use lighting-material-plan)
|
|
26
|
+
- to lock final pixel resolution or output aspect specs → use `../resolution-aspect-decision/SKILL.md` (use resolution-aspect-decision)
|
|
27
|
+
- to choose delivery file formats → use `../output-format-decision/SKILL.md` (use output-format-decision)
|
|
28
|
+
- when subject intent is undefined → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "improve composition and camera"
|
|
34
|
+
- "choose hero framing"
|
|
35
|
+
- "set camera strategy for product hero"
|
|
36
|
+
<!-- blendops:generated:end triggers -->
|
|
37
|
+
|
|
38
|
+
## Prerequisites / readiness
|
|
39
|
+
- upstream scene concept from `product-hero-scene-planner` (or clear subject and destination context) available
|
|
40
|
+
- planning-only boundary accepted: runtime status remains `Not Run` and artifacts remain `Not Produced`
|
|
41
|
+
|
|
42
|
+
## Input schema
|
|
43
|
+
|
|
44
|
+
### Required inputs
|
|
45
|
+
- subject intent (from `product-hero-scene-planner` or user brief)
|
|
46
|
+
- target output context (web/app/game/render)
|
|
47
|
+
|
|
48
|
+
### Optional inputs
|
|
49
|
+
- target aspect ratio constraints (from `resolution-aspect-decision` if already locked)
|
|
50
|
+
- UI/copy overlay constraints
|
|
51
|
+
- cinematic vs neutral tone preference
|
|
52
|
+
|
|
53
|
+
### Assumptions to confirm
|
|
54
|
+
- need for negative space
|
|
55
|
+
- focal detail priority
|
|
56
|
+
- camera motion vs static hero shot intent
|
|
57
|
+
|
|
58
|
+
## Output schema
|
|
59
|
+
|
|
60
|
+
### Primary output
|
|
61
|
+
- composition-camera plan with plain-language rationale
|
|
62
|
+
|
|
63
|
+
### Secondary output
|
|
64
|
+
- fallback framing variant for uncertain constraints
|
|
65
|
+
|
|
66
|
+
### Evidence / caveat output
|
|
67
|
+
- unresolved visual assumptions
|
|
68
|
+
- explicit truth states: Runtime `Not Run`, Artifacts `Not Produced` (downgrade-only, never upgrade)
|
|
69
|
+
|
|
70
|
+
## Required laws
|
|
71
|
+
- ../../laws/non-blender-user-language.md
|
|
72
|
+
- ../../laws/evidence-before-done.md
|
|
73
|
+
- ../../laws/official-runtime-only.md
|
|
74
|
+
- ../../laws/no-arbitrary-python-interface.md
|
|
75
|
+
|
|
76
|
+
## Official runtime boundary
|
|
77
|
+
Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. Runtime status stays `Not Run` and artifacts stay `Not Produced` (truth states are downgrade-only, never upgraded without verified evidence).
|
|
78
|
+
|
|
79
|
+
## Operating procedure
|
|
80
|
+
1. Define focal hierarchy (primary/secondary/background).
|
|
81
|
+
2. Define hero-section objective and viewer attention path.
|
|
82
|
+
3. Select aspect ratio framing strategy (deferring final resolution/aspect locks to `resolution-aspect-decision`).
|
|
83
|
+
4. Reserve negative space for UI/text overlays if needed.
|
|
84
|
+
5. Choose camera angle preset family.
|
|
85
|
+
6. Set focal length guidance by mood (dramatic vs neutral).
|
|
86
|
+
7. Define depth layering (foreground/midground/background).
|
|
87
|
+
8. Define target silhouette/readability checks (for later validation by `composition-quality-checker`).
|
|
88
|
+
9. Produce fallback framing variant for uncertainty.
|
|
89
|
+
10. Translate plan into plain-language rationale.
|
|
90
|
+
|
|
91
|
+
## Decision tree
|
|
92
|
+
- If copy overlay required → prioritize negative space and silhouette.
|
|
93
|
+
- If product detail priority high → tighter framing and controlled depth.
|
|
94
|
+
- If uncertainty high → provide two options and ask preference.
|
|
95
|
+
|
|
96
|
+
## Playbooks
|
|
97
|
+
- Playbook A: Full brief path — expand upstream `product-hero-scene-planner` output into primary framing + fallback variant (`Runtime: Not Run`, `Artifacts: Not Produced`).
|
|
98
|
+
- Playbook B: Overlay-heavy path — prioritize negative space and silhouette separation for UI/copy constraints (`Runtime: Not Run`, `Artifacts: Not Produced`).
|
|
99
|
+
- Playbook C: High-uncertainty path — provide two distinct framing variants with trade-off rationale and explicit caveats (`Runtime: Not Run`, `Artifacts: Not Produced`).
|
|
100
|
+
|
|
101
|
+
## Mode handling
|
|
102
|
+
|
|
103
|
+
### Text-only mode
|
|
104
|
+
- provide primary composition/camera plan and fallback variant in plain language
|
|
105
|
+
- report `Runtime: Not Run` and `Artifacts: Not Produced`
|
|
106
|
+
|
|
107
|
+
### Runtime-ready mode
|
|
108
|
+
- provide the composition/camera plan plus explicit target criteria for `composition-quality-checker` to validate once a scene exists
|
|
109
|
+
- keep `Runtime: Not Run` and `Artifacts: Not Produced` during planning
|
|
110
|
+
|
|
111
|
+
### Blocked runtime mode
|
|
112
|
+
- deliver full composition/camera plan and fallback variant with explicit caveats
|
|
113
|
+
- keep `Runtime: Not Run` and `Artifacts: Not Produced`; make no visual success claims
|
|
114
|
+
|
|
115
|
+
## Validation checklist
|
|
116
|
+
- [ ] focal hierarchy explicit
|
|
117
|
+
- [ ] hero framing objective and attention path explicit
|
|
118
|
+
- [ ] aspect ratio framing strategy documented (without overriding `resolution-aspect-decision`)
|
|
119
|
+
- [ ] negative space policy documented
|
|
120
|
+
- [ ] camera angle preset rationale documented
|
|
121
|
+
- [ ] focal length guidance by mood documented
|
|
122
|
+
- [ ] depth layering (foreground/midground/background) documented
|
|
123
|
+
- [ ] target silhouette/readability checks documented for `composition-quality-checker`
|
|
124
|
+
- [ ] fallback framing variant documented
|
|
125
|
+
- [ ] plain-language rationale included throughout
|
|
126
|
+
- [ ] truth states explicitly set to `Runtime: Not Run` and `Artifacts: Not Produced`
|
|
127
|
+
|
|
128
|
+
## Pass / Warn / Fail rubric
|
|
129
|
+
|
|
130
|
+
| Category | Pass | Warn | Fail |
|
|
131
|
+
|---|---|---|---|
|
|
132
|
+
| Focal hierarchy | Clear primary/secondary/background priority | Partial hierarchy | Missing hierarchy |
|
|
133
|
+
| Framing strategy | Matches output context and includes fallback variant | Generic framing or weak fallback | Mismatched framing or missing fallback |
|
|
134
|
+
| Camera rationale | Specific plain-language angle, focal-length mood, and depth layering | Vague rationale or unexplained jargon | No rationale or includes Python/execution commands |
|
|
135
|
+
| Role & truth boundary | Stays in planning; reports `Runtime: Not Run` and `Artifacts: Not Produced` | Mild boundary overlap with lookdev/validation | Claims verified framing quality or upgrades truth states |
|
|
136
|
+
|
|
137
|
+
## Failure handling
|
|
138
|
+
- Conflicting goals: provide trade-off options.
|
|
139
|
+
- Missing constraints: ask targeted follow-up.
|
|
140
|
+
- Unknown destination: use conservative web-hero defaults + caveat.
|
|
141
|
+
|
|
142
|
+
## Troubleshooting
|
|
143
|
+
- Subject lost in frame: tighten framing focus, adjust camera angle preset, or increase spatial separation between foreground, midground, and background layers.
|
|
144
|
+
- No room for copy: widen negative space allowance and shift primary focal placement off-center.
|
|
145
|
+
- Flat spatial staging: adjust camera angle and focal-length perspective or increase depth-layer spacing (route lighting/material contrast issues to `lighting-material-plan`).
|
|
146
|
+
- Existing scene framing needs pass/fail grading: hand off to `composition-quality-checker`.
|
|
147
|
+
|
|
148
|
+
## Best practices
|
|
149
|
+
- optimize for clarity before stylization
|
|
150
|
+
- tie each camera choice to user outcome
|
|
151
|
+
- preserve fallback path for uncertain constraints
|
|
152
|
+
|
|
153
|
+
## Good examples
|
|
154
|
+
“Primary subject occupies center-right with left negative space for hero copy; camera 3/4 angle chosen for silhouette and depth readability.”
|
|
155
|
+
|
|
156
|
+
## Bad examples
|
|
157
|
+
“Use cinematic camera.” (no context, no criteria)
|
|
158
|
+
|
|
159
|
+
## User-facing response template
|
|
160
|
+
- Composition summary (focal hierarchy, attention path, negative space, depth layering, silhouette checks)
|
|
161
|
+
- Camera strategy summary (aspect strategy, angle preset, focal length by mood)
|
|
162
|
+
- Fallback framing variant
|
|
163
|
+
- Why this helps your goal (plain-language rationale)
|
|
164
|
+
- Truth states (`Runtime: Not Run`, `Artifacts: Not Produced`) and unverified assumptions
|
|
165
|
+
- Recommended next skill handoff
|
|
166
|
+
|
|
167
|
+
## Anti-patterns
|
|
168
|
+
- skipping required laws or runtime boundary statements
|
|
169
|
+
- claiming runtime/artifact success without evidence
|
|
170
|
+
- claiming runtime or artifact states above `Not Run` / `Not Produced` (violating downgrade-only truth rules)
|
|
171
|
+
- writing Python code or Blender camera execution commands
|
|
172
|
+
- designing lighting rigs or material lookdev instead of handing off to `lighting-material-plan`
|
|
173
|
+
- validating rendered/viewport composition instead of handing off to `composition-quality-checker`
|
|
174
|
+
- locking final export resolution/aspect (`resolution-aspect-decision`) or file formats (`output-format-decision`)
|
|
175
|
+
- producing jargon-heavy camera specs without plain-language rationale
|
|
176
|
+
|
|
177
|
+
## Cross-skill handoff
|
|
178
|
+
<!-- blendops:generated:start handoffs -->
|
|
179
|
+
- [upstream_reference] Upstream input from → `../product-hero-scene-planner/SKILL.md`
|
|
180
|
+
- [conditional] Lateral output specs (if needed) (output-format-decision) → `../output-format-decision/SKILL.md`
|
|
181
|
+
- [conditional] Lateral output specs (if needed) (resolution-aspect-decision) → `../resolution-aspect-decision/SKILL.md`
|
|
182
|
+
- [progression] Next (lookdev & lighting) → `../lighting-material-plan/SKILL.md`
|
|
183
|
+
- [progression] Then (validation) (scene-readiness) → `../scene-readiness/SKILL.md`
|
|
184
|
+
- [progression] Then (validation) (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
|
|
185
|
+
<!-- blendops:generated:end handoffs -->
|
|
186
|
+
|
|
187
|
+
## Non-goals
|
|
188
|
+
- executing Blender commands, writing Python scripts, or generating scene/render artifacts
|
|
189
|
+
- designing lighting setups or materials (owned by `lighting-material-plan`)
|
|
190
|
+
- validating or scoring completed scene framing (owned by `composition-quality-checker`)
|
|
191
|
+
- locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
|
|
192
|
+
|
|
193
|
+
## References
|
|
194
|
+
- https://www.blender.org/lab/mcp-server/
|
|
195
|
+
- https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
196
|
+
- https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "camera-composition",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "scene-planners",
|
|
6
|
+
"role": "camera-rig-and-composition-deep-planner",
|
|
7
|
+
"purpose": "Provide detailed composition and camera planning for product hero outputs.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"improve composition and camera",
|
|
11
|
+
"choose hero framing",
|
|
12
|
+
"set camera strategy for product hero"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "as proof of rendered output quality or to validate an existing framing",
|
|
17
|
+
"delegateTo": "composition-quality-checker",
|
|
18
|
+
"reason": "use composition-quality-checker"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "to design lighting rigs or surface materials/lookdev",
|
|
22
|
+
"delegateTo": "lighting-material-plan",
|
|
23
|
+
"reason": "use lighting-material-plan"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "to lock final pixel resolution or output aspect specs",
|
|
27
|
+
"delegateTo": "resolution-aspect-decision",
|
|
28
|
+
"reason": "use resolution-aspect-decision"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"condition": "to choose delivery file formats",
|
|
32
|
+
"delegateTo": "output-format-decision",
|
|
33
|
+
"reason": "use output-format-decision"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"condition": "when subject intent is undefined",
|
|
37
|
+
"delegateTo": "product-hero-scene-planner",
|
|
38
|
+
"reason": "Delegates out-of-scope requests to product-hero-scene-planner"
|
|
39
|
+
}
|
|
40
|
+
],
|
|
41
|
+
"inputs": {
|
|
42
|
+
"required": [
|
|
43
|
+
{
|
|
44
|
+
"name": "domain_scene_plan",
|
|
45
|
+
"type": "object",
|
|
46
|
+
"description": "Upstream scene layout plan defining subject scale, staging, and depth layers"
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"name": "framing_goal",
|
|
50
|
+
"type": "string",
|
|
51
|
+
"description": "Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)"
|
|
52
|
+
}
|
|
53
|
+
],
|
|
54
|
+
"optional": [
|
|
55
|
+
{
|
|
56
|
+
"name": "pinned_aspect_ratio",
|
|
57
|
+
"type": "string",
|
|
58
|
+
"description": "Aspect ratio lock from resolution-aspect-decision"
|
|
59
|
+
}
|
|
60
|
+
]
|
|
61
|
+
},
|
|
62
|
+
"outputs": {
|
|
63
|
+
"primary": [
|
|
64
|
+
"camera_rig_specification",
|
|
65
|
+
"focal_length_and_dof_plan",
|
|
66
|
+
"composition_anchor_guidelines"
|
|
67
|
+
],
|
|
68
|
+
"truthStatePolicy": {
|
|
69
|
+
"runtimeDefault": "Not Run",
|
|
70
|
+
"artifactDefault": "Not Produced",
|
|
71
|
+
"mutationRule": "downgrade_only"
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
"handoffs": [
|
|
75
|
+
{
|
|
76
|
+
"target": "product-hero-scene-planner",
|
|
77
|
+
"type": "upstream_reference",
|
|
78
|
+
"label": "Upstream input from",
|
|
79
|
+
"when": {
|
|
80
|
+
"all": [
|
|
81
|
+
{
|
|
82
|
+
"field": "brief.locked",
|
|
83
|
+
"operator": "equals",
|
|
84
|
+
"value": true
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
"field": "recipe.domain",
|
|
88
|
+
"operator": "equals",
|
|
89
|
+
"value": "product_hero"
|
|
90
|
+
}
|
|
91
|
+
]
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
"target": "output-format-decision",
|
|
96
|
+
"type": "conditional",
|
|
97
|
+
"label": "Lateral output specs (if needed) (output-format-decision)",
|
|
98
|
+
"when": {
|
|
99
|
+
"all": [
|
|
100
|
+
{
|
|
101
|
+
"field": "decision.formatLocked",
|
|
102
|
+
"operator": "equals",
|
|
103
|
+
"value": false
|
|
104
|
+
}
|
|
105
|
+
]
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"target": "resolution-aspect-decision",
|
|
110
|
+
"type": "conditional",
|
|
111
|
+
"label": "Lateral output specs (if needed) (resolution-aspect-decision)",
|
|
112
|
+
"when": {
|
|
113
|
+
"all": [
|
|
114
|
+
{
|
|
115
|
+
"field": "decision.aspectLocked",
|
|
116
|
+
"operator": "equals",
|
|
117
|
+
"value": false
|
|
118
|
+
}
|
|
119
|
+
]
|
|
120
|
+
}
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"target": "lighting-material-plan",
|
|
124
|
+
"type": "progression",
|
|
125
|
+
"label": "Next (lookdev & lighting)",
|
|
126
|
+
"when": {
|
|
127
|
+
"all": [
|
|
128
|
+
{
|
|
129
|
+
"field": "brief.locked",
|
|
130
|
+
"operator": "equals",
|
|
131
|
+
"value": true
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"field": "stage.current",
|
|
135
|
+
"operator": "equals",
|
|
136
|
+
"value": "lookdev_planning"
|
|
137
|
+
}
|
|
138
|
+
]
|
|
139
|
+
}
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"target": "scene-readiness",
|
|
143
|
+
"type": "progression",
|
|
144
|
+
"label": "Then (validation) (scene-readiness)",
|
|
145
|
+
"when": {
|
|
146
|
+
"all": [
|
|
147
|
+
{
|
|
148
|
+
"field": "quality.domain",
|
|
149
|
+
"operator": "equals",
|
|
150
|
+
"value": "holistic"
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
"field": "stage.current",
|
|
154
|
+
"operator": "equals",
|
|
155
|
+
"value": "quality_validation"
|
|
156
|
+
}
|
|
157
|
+
]
|
|
158
|
+
}
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
"target": "composition-quality-checker",
|
|
162
|
+
"type": "progression",
|
|
163
|
+
"label": "Then (validation) (composition-quality-checker)",
|
|
164
|
+
"when": {
|
|
165
|
+
"all": [
|
|
166
|
+
{
|
|
167
|
+
"field": "quality.domain",
|
|
168
|
+
"operator": "equals",
|
|
169
|
+
"value": "composition"
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"field": "quality.verdict",
|
|
173
|
+
"operator": "equals",
|
|
174
|
+
"value": "not_run"
|
|
175
|
+
}
|
|
176
|
+
]
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
]
|
|
180
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Camera Presets & Framing Calibration
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Define reproducible camera angle, focal length, sensor, and clip-plane presets for product hero and turntable planning outputs without bloated jargon.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
Whenever `camera-composition` translates a scene brief into camera orientation, focal perspective, and safe framing bounds.
|
|
8
|
+
|
|
9
|
+
## Preset Families
|
|
10
|
+
|
|
11
|
+
| Preset | Typical Focal Length (36mm Full Frame) | Camera Elevation / Pitch | Ideal Subject Occupancy | Primary Use Case |
|
|
12
|
+
|---|---|---|---|---|
|
|
13
|
+
| **3/4 Hero Orbit** | `50mm – 85mm` (natural-to-flattering compression) | `12° – 22°` above equator, `30° – 45°` azimuth | `55% – 70%` vertical/viewport span | Default flagship product render & interactive web GLB landing pose |
|
|
14
|
+
| **Front-Elevation Clean** | `75mm – 105mm` (minimizes perspective keystone) | `0° – 5°` eye level, centered orthogonal look-at | `60% – 72%` viewport span | E-commerce specs, silhouette comparison, grid symmetry |
|
|
15
|
+
| **Low-Angle Heroic** | `35mm – 50mm` (controlled dramatic foreshortening) | `-6° – +5°` looking slightly upward | `60% – 75%` frame height | Footwear, hardware, automotive, high-energy campaigns |
|
|
16
|
+
| **Macro Detail Crop** | `85mm – 120mm` + tight shallow DoF (`f/2.8 – f/4`) | Tightly angled onto texture seam / badge / bevel | Subject detail fills `70% – 85%` | Stitch, machined aluminum, anodized logo close-ups |
|
|
17
|
+
|
|
18
|
+
## Technical Sanity Rules
|
|
19
|
+
- **Avoid extreme wide angles (`< 28mm`)** on hard-surface products unless intentionally stylized — edge distortion stretches silhouette proportions.
|
|
20
|
+
- **Clip-plane hygiene**: Set `clip_start = 0.01m – 0.05m` (`0.001m` triggers viewport/shadow depth z-fighting) and tight `clip_end = 50m – 200m` for studio scenes.
|
|
21
|
+
- **Ground clearance**: Confirm object bottom sits cleanly at `Z = 0.0` (ground contact shadow visible) with `8% – 15%` breathing margin on all cropped edges.
|
|
22
|
+
|
|
23
|
+
## Good example
|
|
24
|
+
"Selected `65mm` 3/4 Hero Orbit at `16°` elevation, keeping shoe spanning `62%` of frame height with `10%` floor shadow margin and right-side negative space for hero typography."
|
|
25
|
+
|
|
26
|
+
## Bad example
|
|
27
|
+
"Put a camera in front of the product." (No focal length, elevation, occupancy, or edge clearance.)
|
|
28
|
+
|
|
29
|
+
## Related skill
|
|
30
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Camera Rubric
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Provide a structured 4-dimension scoring rubric for evaluating hero camera placement, framing, focal length, and layout compatibility prior to render or GLB export.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- During `composition-quality-checker` or `scene-readiness` review before approving a render/turntable.
|
|
8
|
+
- Whenever comparing candidate camera angles or validating hero framing against web overlay text zones.
|
|
9
|
+
|
|
10
|
+
## Rubric Dimensions & Grading Thresholds
|
|
11
|
+
|
|
12
|
+
| Dimension | Pass Criteria | Warn (Fixable Before Final) | Fail (Block Handoff) |
|
|
13
|
+
|---|---|---|---|
|
|
14
|
+
| **Focal Clarity** | Subject sharp and unobstructed; lens `50-85 mm` (`<= 35 mm` only for deliberate wide environments); `f/5.6-f/8` keeps full product crisp | Slight DOF blur near secondary edge or `35-45 mm` slight perspective exaggeration | Wide-angle barrel distortion (`< 28 mm`) warping product silhouette, or focal blur hiding hero details |
|
|
15
|
+
| **Framing Intent** | Hero fills `45%-70%` of frame; `10%+` safe margin around bounding box; vertical/horizontal horizon level (`roll = 0 deg` unless tilted hero) | Hero slightly tight (`70%-80%`) or loose (`30%-45%`); minor asymmetry unmotivated | Key product feature clipped off-edge, horizon accidentally crooked, or hero `< 25%` of frame |
|
|
16
|
+
| **Depth Layering** | Foreground/hero/background cleanly separated via distance falloff, floor reflection fade, or subtle haze/rim edge | Backdrop separates from hero in midtones only; shadows blend slightly into dark floor | Flat "sticker" cutout look or black product silhouette lost against black void |
|
|
17
|
+
| **Target Context Readability** | Negative space preserves UI headline/CTA zone (e.g., left-third hero leaves right 40% clean for hero copy) without occluding silhouette | Copy safe zone slightly tight (`< 25%` unobstructed margin) under responsive mobile crop | Hero overlaps web typography zone or mobile `9:16` / desktop `16:9` crop cuts off core product |
|
|
18
|
+
|
|
19
|
+
## Good vs. Bad Review Output
|
|
20
|
+
- **Good**: Score each of the 4 dimensions explicitly (`Pass / Warn / Fail`), state concrete evidence (`focal_length: 65mm`, `shift_x: 0.08`, `safe_margin: 12%`) or mark visual read `Not Run` if no render exists yet, and list one minimum camera adjustment per `Warn/Fail`.
|
|
21
|
+
- **Bad**: `"Camera looks 8/10, ready to export"` with zero per-dimension rationale or context fit check.
|
|
22
|
+
|
|
23
|
+
## Related skill
|
|
24
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Hero Composition Patterns
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Provide concrete, repeatable hero framing and camera setups matched to common product, e-commerce, and web-landing delivery goals.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- During `camera-composition` planning immediately after the hero subject footprint (`dimensions`, facing direction) is known.
|
|
8
|
+
|
|
9
|
+
## Core Hero Composition Patterns
|
|
10
|
+
|
|
11
|
+
| Pattern | Camera Geometry & Focal Range | Best For | Key Guardrail |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| **Center-Dominant Hero** | `65-85 mm`, `10-15 deg` slightly above eye-level (`Z + 0.15 m`), straight-on or `15 deg` yaw | Luxury packaging, sneaker side/3-4 profile, standalone hero turntable | Leave `15%+` top/bottom margin so shadow and badge badges never touch frame edge |
|
|
14
|
+
| **Rule-of-Thirds Split (Web Landing)** | `50-70 mm`, product placed on left or right vertical third (`shift_x` or aim offset), hero occupies `40%-55%` frame | SaaS/marketing hero banners with headline + CTA on the opposite side | Verify `40%+` opposite-side uncluttered background and test desktop `16:9` -> mobile `4:5` safe crop |
|
|
15
|
+
| **Three-Quarter Dynamic Diagonal** | `50-65 mm`, `35-45 deg` yaw + subtle `12-20 deg` low-to-high pitch (`+3-5 deg` subtle roll only if energetic tech/sport) | Footwear, hardware electronics, wearable gadgets needing depth + sole/back detail | Confirm diagonal leading lines point **into** the frame rather than exiting a corner |
|
|
16
|
+
| **Macro Craft Detail Crop** | `85-105 mm` telephoto, tight partial crop on stitching, chamfer, metallic bevel, or brushed anodizing (`f/4-f/5.6`) | Secondary gallery shots, material credibility cards, craftsmanship proof | Only pair with a wider establishing shot; never use macro as the sole hero shot |
|
|
17
|
+
| **Elevated Isometric / Orthographic Grid** | `85-135 mm` long lens (or true ortho `ortho_scale`), `30-35 deg` elevation, `45 deg` yaw | Product catalog consistency, multi-SKU comparisons, configurator thumbnails | Lock exact camera distance & focal preset across every SKU in the batch |
|
|
18
|
+
|
|
19
|
+
## Good vs. Bad Selection
|
|
20
|
+
- **Good**: `"Using Rule-of-Thirds Split (60mm, hero shifted right, left 45% dark matte gradient reserved for landing H1 + CTA), 12% margin above heel cap."`
|
|
21
|
+
- **Bad**: Picking a low-angle `24 mm` Dutch tilt for a clean minimalist skincare e-commerce thumbnail where straight verticals and multi-SKU consistency are required.
|
|
22
|
+
|
|
23
|
+
## Related skill
|
|
24
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Web Layout Negative Space & Viewport Safe Zones
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Guarantee hero renders and interactive GLB camera rigs leave clean unobstructed viewport area for web headings, pricing blocks, CTA buttons, and mobile reflows.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
Whenever outputs target hero sections, landing pages, split-screen showcases, or embedded React Three Fiber viewports.
|
|
8
|
+
|
|
9
|
+
## Quantitative Safe-Zone Checklist
|
|
10
|
+
|
|
11
|
+
| Check | Target Rule | Failure Risk |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| **Copy-safe negative space** | Reserve `35% – 45%` clean horizontal strip (left or right third) or upper band for UI copy; keep gradient backdrop calm behind text. | Headline sits across busy specular geometry and fails WCAG text contrast. |
|
|
14
|
+
| **Focal off-center target offset** | Aim `lookAt` / OrbitControls target toward `X = ±0.20..0.30` normalized viewport offset rather than translating the mesh away from world `(0,0,0)`. | Offsetting geometry breaks turntable pivot centers later in Three.js / R3F. |
|
|
15
|
+
| **Desktop (`16:9` / `1440×900`) vs Mobile (`9:16` / `390×844`)** | Confirm silhouette stays intact inside center-weighted crop or document explicit camera FOV / distance adaptation for portrait viewports. | Product toe/handle clips off horizontal screen edges on mobile screens. |
|
|
16
|
+
| **Shadow & reflection tail clearance** | Keep `≥ 10%` padding below contact shadow and rim fade-out inside the canvas frame. | Hard rectangular shadow crop at bottom canvas edge looks broken on page background. |
|
|
17
|
+
|
|
18
|
+
## Good example
|
|
19
|
+
"Target offset shifts sneaker cleanly to right 60% on desktop (`16:9`), preserving left 40% matte charcoal negative space (`#0F1117`) for H1 + CTA with zero silhouette overlap; mobile (`390×844`) resets target to centered `3/4` orbit."
|
|
20
|
+
|
|
21
|
+
## Bad example
|
|
22
|
+
"Centered shoe filling 92% width — landing page headline overlaps the laces and bright rim highlight."
|
|
23
|
+
|
|
24
|
+
## Related skill
|
|
25
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# EVAL — character-portrait
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use character-portrait on a hero close-up brief: stylized 30s tech founder, confident editorial mood, 16:9 web hero card.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- Subject section filled (identity / build / archetype / style)
|
|
8
|
+
- Pose / expression / gaze explicit
|
|
9
|
+
- Wardrobe + props listed
|
|
10
|
+
- Camera / framing / lens (50-85mm, eye-line upper third)
|
|
11
|
+
- Lighting plan (key / fill / rim + HDRI)
|
|
12
|
+
- Background + mood explicit
|
|
13
|
+
- Asset list flagged
|
|
14
|
+
- Handoff to discovery / composition / lighting / material / quality named
|
|
15
|
+
- Honest evidence label
|
|
16
|
+
|
|
17
|
+
## Pass / Warn / Fail criteria
|
|
18
|
+
- Pass: all sections + handoff + no "TBD"
|
|
19
|
+
- Warn: one section ambiguous
|
|
20
|
+
- Fail: framing impossible (e.g. 18mm tight close-up), missing lighting, no asset list
|
|
21
|
+
|
|
22
|
+
## Common failure modes
|
|
23
|
+
- inventing likeness without rights
|
|
24
|
+
- mixing multi-character scope
|
|
25
|
+
- skipping mood / style
|
|
26
|
+
- generating modeling instructions
|
|
27
|
+
|
|
28
|
+
## Evidence expectations
|
|
29
|
+
- explicit decisions per row
|
|
30
|
+
- asset list for discovery handoff
|
|
31
|
+
- evidence label honest (Not Run for text-only)
|
|
32
|
+
|
|
33
|
+
## Sample passing response outline
|
|
34
|
+
- Subject row + Pose row + Wardrobe row
|
|
35
|
+
- Camera / Lighting / Background / Mood rows
|
|
36
|
+
- Asset list
|
|
37
|
+
- Next: handoff named
|
|
38
|
+
|
|
39
|
+
## Sample failing response outline
|
|
40
|
+
- "Person looking at camera"
|
|
41
|
+
- No framing rules
|
|
42
|
+
- Verified without render
|