blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -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 +73 -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/README.md +276 -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 +103 -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 +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -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,237 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: environment-shot
|
|
3
|
+
description: Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# environment-shot
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Translate a wide place-establishing intent (locale, time of day, weather, atmosphere, foreground/midground/background depth layers, and focal subject or explicit "none") into a structured scene plan with an explicit assumptions register. Distinct from `character-portrait` (single subject), `product-hero-scene-planner` (manufactured products), and `interior-scene` (interior rooms/furniture/surfaces — an establishing shot of an interior room belongs there when furniture or surfaces dominate). Hands off asset rows to `asset-discovery` and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
|
|
13
|
+
- pin locale, time of day, weather, and atmosphere
|
|
14
|
+
- pin foreground (FG), midground (MG), and background (BG) depth layers
|
|
15
|
+
- pin focal subject (or explicitly declare `none`)
|
|
16
|
+
- record an explicit assumptions register
|
|
17
|
+
- flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
- intent is establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
|
|
21
|
+
- before any modeling, Geometry Nodes, or scene building
|
|
22
|
+
- when consumer is editorial, cinematic, or brand
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- character portrait → use `../character-portrait/SKILL.md` (use character-portrait)
|
|
27
|
+
- product hero → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
|
|
28
|
+
- interior arch viz with focus on furniture / surfaces → use `../interior-scene/SKILL.md` (use interior-scene)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "establishing shot of"
|
|
34
|
+
- "wide shot of"
|
|
35
|
+
- "city / forest / desert / ocean scene"
|
|
36
|
+
- "set the scene"
|
|
37
|
+
<!-- blendops:generated:end triggers -->
|
|
38
|
+
|
|
39
|
+
## Prerequisites / readiness
|
|
40
|
+
- brief from `intent-to-3d-brief-writer` is locked
|
|
41
|
+
- locale scope is realizable and bounded (never invented)
|
|
42
|
+
- target aspect ratio and use case are known
|
|
43
|
+
|
|
44
|
+
## Input schema
|
|
45
|
+
|
|
46
|
+
### Required inputs
|
|
47
|
+
|
|
48
|
+
| Input | Why it is required |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Realizable locale | Drives bounded asset and depth-layer scope without inventing unrequested worldbuilding |
|
|
51
|
+
| Time of day | Drives sunlight direction, sky tone, and lighting mood |
|
|
52
|
+
| Weather + atmosphere | Drives visibility, haze/fog, and surface condition |
|
|
53
|
+
| Focal subject intent | Identifies the visual anchor (or explicitly confirms `none`) |
|
|
54
|
+
|
|
55
|
+
### Optional inputs
|
|
56
|
+
|
|
57
|
+
| Input | Use |
|
|
58
|
+
|---|---|
|
|
59
|
+
| Reference images | Calibrate place scope, depth layers, and mood |
|
|
60
|
+
| Aspect ratio | Guides framing across FG / MG / BG layers |
|
|
61
|
+
| Era / period | Aligns asset discovery rows |
|
|
62
|
+
|
|
63
|
+
### Assumptions to confirm
|
|
64
|
+
- Single time-of-day snapshot (unless animation is explicitly requested upstream).
|
|
65
|
+
- Locale scope is realizable and bounded, not invented.
|
|
66
|
+
- Interior rooms dominated by furniture or surfaces are routed to `interior-scene`.
|
|
67
|
+
- Planning-only output: `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced`.
|
|
68
|
+
|
|
69
|
+
## Output schema
|
|
70
|
+
|
|
71
|
+
### Primary output
|
|
72
|
+
A structured place-establishing plan covering: Locale (bounded scope), Time of day, Weather, Atmosphere, Depth layers (FG / MG / BG), Focal subject (or explicit `none`), Mood / style, and an Assumptions register.
|
|
73
|
+
|
|
74
|
+
### Secondary output
|
|
75
|
+
- asset rows flagged for `asset-discovery`
|
|
76
|
+
- validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`
|
|
77
|
+
- explicit `Runtime status: Not Run` and `Artifact status: Not Produced` labels
|
|
78
|
+
|
|
79
|
+
### Evidence / caveat output
|
|
80
|
+
|
|
81
|
+
```txt
|
|
82
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
83
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
84
|
+
Evidence used: <links, paths, logs, or "none">
|
|
85
|
+
Limitations: <known gaps>
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## Required laws
|
|
89
|
+
- `../../laws/evidence-before-done.md`
|
|
90
|
+
- `../../laws/non-blender-user-language.md`
|
|
91
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
92
|
+
- `../../laws/official-runtime-only.md`
|
|
93
|
+
|
|
94
|
+
## Official runtime boundary
|
|
95
|
+
|
|
96
|
+
Planning-only skill: no modeling, no Geometry Nodes, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief or locale scope is unclear, hand off to `intent-to-3d-brief-writer`.
|
|
97
|
+
|
|
98
|
+
## Operating procedure
|
|
99
|
+
1. Read the brief from `intent-to-3d-brief-writer`; confirm wide place-establishing scope and ensure locale scope is realizable (not invented).
|
|
100
|
+
2. Route to `interior-scene` if the scene is an interior room where furniture or surfaces dominate.
|
|
101
|
+
3. Pin time of day, weather, and atmosphere (per `references/time-and-weather-rules.md`).
|
|
102
|
+
4. Define wide camera placement and framing intent (per `references/wide-shot-camera-rules.md`).
|
|
103
|
+
5. Plan foreground (FG), midground (MG), and background (BG) depth layers (per `references/depth-layering-rules.md`).
|
|
104
|
+
6. Identify the focal subject or explicitly document `none`.
|
|
105
|
+
7. Record all open assumptions in the assumptions register.
|
|
106
|
+
8. List required assets for `asset-discovery` and emit validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness` with `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
107
|
+
|
|
108
|
+
## Decision tree
|
|
109
|
+
|
|
110
|
+
```txt
|
|
111
|
+
Scene is an interior room where furniture or surfaces dominate?
|
|
112
|
+
→ Stop; route to interior-scene
|
|
113
|
+
Focus is a single character or a manufactured product?
|
|
114
|
+
→ Stop; route to character-portrait or product-hero-scene-planner
|
|
115
|
+
Locale scope is unbounded or unclear (would require inventing scope)?
|
|
116
|
+
→ Stop; hand off to intent-to-3d-brief-writer to bound locale scope
|
|
117
|
+
Locale + time-of-day combination implausible (e.g. "Antarctic noon" with deep dark mood)?
|
|
118
|
+
→ Warn; clarify intent
|
|
119
|
+
"City scene" + tight close-up framing?
|
|
120
|
+
→ Warn; this is not establishing — re-frame or use different planner
|
|
121
|
+
Weather conflicts with brief mood (sunny + noir)?
|
|
122
|
+
→ Fail; pick one
|
|
123
|
+
Focal subject not chosen but every asset has same visual weight?
|
|
124
|
+
→ Fail; eye has nowhere to land
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
## Playbooks
|
|
128
|
+
|
|
129
|
+
### Playbook A: City sunset establishing (16:9 cinematic)
|
|
130
|
+
35mm wide; camera elevated; warm sun direction; haze layer; subject = skyline silhouette; foreground rooftops; background sky gradient.
|
|
131
|
+
|
|
132
|
+
### Playbook B: Forest mid-day (1:1 brand campaign)
|
|
133
|
+
24mm wide; camera at human eye-line; key sun + dappled light; foreground branches; midground tree trunks; background distant haze.
|
|
134
|
+
|
|
135
|
+
### Playbook C: Stylized cyberpunk street (2.39:1 cinematic)
|
|
136
|
+
24–35mm; rain wet ground reflections; neon practicals; light haze + atmospheric fog; foreground silhouette; midground signage / cars; background distant towers.
|
|
137
|
+
|
|
138
|
+
## Mode handling
|
|
139
|
+
|
|
140
|
+
### Text-only mode
|
|
141
|
+
Produce the environment plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
142
|
+
|
|
143
|
+
### Runtime-ready mode
|
|
144
|
+
Planning-only even when runtime is available downstream: keep `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgrade), and hand off to `asset-discovery` and quality checkers.
|
|
145
|
+
|
|
146
|
+
### Blocked runtime mode
|
|
147
|
+
Produce the environment plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and log blockers under `Limitations`.
|
|
148
|
+
|
|
149
|
+
## Validation checklist
|
|
150
|
+
- [ ] Realizable, non-invented locale scope confirmed
|
|
151
|
+
- [ ] Time of day, weather, and atmosphere pinned
|
|
152
|
+
- [ ] Depth layers (FG / MG / BG) explicitly defined
|
|
153
|
+
- [ ] Focal subject (or explicit `none`) documented
|
|
154
|
+
- [ ] Assumptions register included
|
|
155
|
+
- [ ] Asset rows flagged for `asset-discovery`
|
|
156
|
+
- [ ] Validation handoffs named (`composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`)
|
|
157
|
+
- [ ] `Runtime status: Not Run` and `Artifact status: Not Produced` explicitly set
|
|
158
|
+
|
|
159
|
+
## Pass / Warn / Fail rubric
|
|
160
|
+
|
|
161
|
+
| Verdict | Criteria |
|
|
162
|
+
| --- | --- |
|
|
163
|
+
| Pass | Realizable locale scope; consistent time/weather/atmosphere; explicit FG/MG/BG depth layers; focal subject (or explicit `none`); assumptions register complete; truth states locked to `Not Run` / `Not Produced`; handoffs named. |
|
|
164
|
+
| Warn | Minor non-blocking assumption open in the assumptions register; asset list partial. |
|
|
165
|
+
| Fail | Invented or unbounded locale scope; interior room dominated by furniture/surfaces; contradictory time/weather/mood; missing FG/MG/BG layers; missing focal subject decision; truth states upgraded above `Not Run` / `Not Produced`. |
|
|
166
|
+
|
|
167
|
+
## Failure handling
|
|
168
|
+
- Locale scope too broad or unclear → hand off to `intent-to-3d-brief-writer` (never invent scope).
|
|
169
|
+
- Mood and weather contradict → stop and ask user to pick one consistent direction.
|
|
170
|
+
- Asset availability unknown → flag missing items for `asset-discovery`.
|
|
171
|
+
|
|
172
|
+
## Troubleshooting
|
|
173
|
+
|
|
174
|
+
| Problem | Response |
|
|
175
|
+
|---|---|
|
|
176
|
+
| Sun direction conflicts with shadows in reference | Verify time-of-day + sun azimuth; clarify reference. |
|
|
177
|
+
| Atmospheric haze hides focal subject | Reduce haze density or move subject closer. |
|
|
178
|
+
| Background too detailed | Simplify; use atmospheric perspective. |
|
|
179
|
+
|
|
180
|
+
## Best practices
|
|
181
|
+
- Lock time-of-day + weather + atmosphere together; they form a system.
|
|
182
|
+
- Always plan FG / MG / BG depth layers.
|
|
183
|
+
- Pair establishing shot with the next narrative step (often character portrait or product reveal).
|
|
184
|
+
|
|
185
|
+
## Good examples
|
|
186
|
+
- "Locale: cyberpunk city street, near-future. Time: night, neon lit. Weather: light rain. Atmosphere: haze 0.05 density, volumetric scattering. Sky: minimal (occluded by buildings). Camera: 24mm, eye-level, slight low-angle tilt. FG: silhouetted figure. MG: neon signage + parked cars. BG: distant towers + fog. Focal subject: figure silhouette right-third. Mood: gritty, atmospheric."
|
|
187
|
+
|
|
188
|
+
## Bad examples
|
|
189
|
+
- "Wide shot of a city." — no time, weather, lens, depth.
|
|
190
|
+
|
|
191
|
+
## User-facing response template
|
|
192
|
+
|
|
193
|
+
```txt
|
|
194
|
+
Locale (bounded scope): <where + realizable boundaries>
|
|
195
|
+
Time of day: <time / sun state>
|
|
196
|
+
Weather: <weather state>
|
|
197
|
+
Atmosphere: <haze / fog / visibility>
|
|
198
|
+
Camera & framing: <wide position / altitude / tilt>
|
|
199
|
+
Depth layers: FG: <…> | MG: <…> | BG: <…>
|
|
200
|
+
Focal subject: <subject + placement, or explicit "none">
|
|
201
|
+
Mood + style: <line>
|
|
202
|
+
Assumptions register: <explicit list of confirmed assumptions>
|
|
203
|
+
|
|
204
|
+
Assets to discover: <rows for asset-discovery>
|
|
205
|
+
Runtime status: Not Run
|
|
206
|
+
Artifact status: Not Produced
|
|
207
|
+
Evidence used: <links, paths, logs, or "none">
|
|
208
|
+
Limitations: <known gaps>
|
|
209
|
+
Next: asset-discovery | composition-quality-checker | lighting-quality-checker | scene-readiness
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
## Anti-patterns
|
|
213
|
+
- Mixing single-character portraits (`character-portrait`), manufactured product shots (`product-hero-scene-planner`), or furniture/surface-dominant interior rooms (`interior-scene`) into wide place planning.
|
|
214
|
+
- Inventing unbounded locale scope instead of handing off to `intent-to-3d-brief-writer`.
|
|
215
|
+
- Skipping FG / MG / BG depth layers or failing to declare a focal subject (or explicit `none`).
|
|
216
|
+
- Prescribing Geometry Nodes, modeling steps, or renders, or upgrading truth states above `Not Run` / `Not Produced`.
|
|
217
|
+
|
|
218
|
+
## Cross-skill handoff
|
|
219
|
+
<!-- blendops:generated:start handoffs -->
|
|
220
|
+
- [upstream_reference] Brief writer → `../intent-to-3d-brief-writer/SKILL.md`
|
|
221
|
+
- [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
|
|
222
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
223
|
+
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
224
|
+
- [progression] Quality readiness → `../scene-readiness/SKILL.md`
|
|
225
|
+
<!-- blendops:generated:end handoffs -->
|
|
226
|
+
|
|
227
|
+
## Non-goals
|
|
228
|
+
- Model the environment.
|
|
229
|
+
- Generate Geometry Node setups.
|
|
230
|
+
- Render.
|
|
231
|
+
- Run Blender.
|
|
232
|
+
|
|
233
|
+
## References
|
|
234
|
+
- `references/time-and-weather-rules.md`
|
|
235
|
+
- `references/wide-shot-camera-rules.md`
|
|
236
|
+
- `references/depth-layering-rules.md`
|
|
237
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "environment-shot",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "scene-planners",
|
|
6
|
+
"role": "environment-establishing-shot-architect",
|
|
7
|
+
"purpose": "Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"establishing shot of",
|
|
11
|
+
"wide shot of",
|
|
12
|
+
"city / forest / desert / ocean scene",
|
|
13
|
+
"set the scene"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "character portrait",
|
|
18
|
+
"delegateTo": "character-portrait",
|
|
19
|
+
"reason": "use character-portrait"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "product hero",
|
|
23
|
+
"delegateTo": "product-hero-scene-planner",
|
|
24
|
+
"reason": "use product-hero-scene-planner"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "interior arch viz with focus on furniture / surfaces",
|
|
28
|
+
"delegateTo": "interior-scene",
|
|
29
|
+
"reason": "use interior-scene"
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"inputs": {
|
|
33
|
+
"required": [
|
|
34
|
+
{
|
|
35
|
+
"name": "locked_3d_brief",
|
|
36
|
+
"type": "object",
|
|
37
|
+
"description": "Locked 3D brief specifying locale, mood, focal anchor, and delivery channel"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "atmosphere_and_time_of_day",
|
|
41
|
+
"type": "object",
|
|
42
|
+
"description": "Target time of day, weather condition, and atmospheric haze/fog parameters"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"optional": [
|
|
46
|
+
{
|
|
47
|
+
"name": "asset_discovery_constraints",
|
|
48
|
+
"type": "object",
|
|
49
|
+
"description": "Available environment kitbash or terrain assets from asset-discovery"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
"outputs": {
|
|
54
|
+
"primary": [
|
|
55
|
+
"foreground_midground_background_layer_plan",
|
|
56
|
+
"sun_sky_atmosphere_specification",
|
|
57
|
+
"horizon_and_scale_anchor_plan"
|
|
58
|
+
],
|
|
59
|
+
"truthStatePolicy": {
|
|
60
|
+
"runtimeDefault": "Not Run",
|
|
61
|
+
"artifactDefault": "Not Produced",
|
|
62
|
+
"mutationRule": "downgrade_only"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"handoffs": [
|
|
66
|
+
{
|
|
67
|
+
"target": "intent-to-3d-brief-writer",
|
|
68
|
+
"type": "upstream_reference",
|
|
69
|
+
"label": "Brief writer",
|
|
70
|
+
"when": {
|
|
71
|
+
"all": [
|
|
72
|
+
{
|
|
73
|
+
"field": "goal.clarity",
|
|
74
|
+
"operator": "equals",
|
|
75
|
+
"value": "clear"
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
"field": "brief.locked",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": false
|
|
81
|
+
}
|
|
82
|
+
]
|
|
83
|
+
}
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"target": "asset-discovery",
|
|
87
|
+
"type": "upstream_reference",
|
|
88
|
+
"label": "Asset discovery",
|
|
89
|
+
"when": {
|
|
90
|
+
"all": [
|
|
91
|
+
{
|
|
92
|
+
"field": "brief.locked",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": true
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"field": "assets.discoveryComplete",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": false
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
}
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"target": "composition-quality-checker",
|
|
106
|
+
"type": "progression",
|
|
107
|
+
"label": "Composition validation",
|
|
108
|
+
"when": {
|
|
109
|
+
"all": [
|
|
110
|
+
{
|
|
111
|
+
"field": "quality.domain",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": "composition"
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"field": "quality.verdict",
|
|
117
|
+
"operator": "equals",
|
|
118
|
+
"value": "not_run"
|
|
119
|
+
}
|
|
120
|
+
]
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"target": "lighting-quality-checker",
|
|
125
|
+
"type": "progression",
|
|
126
|
+
"label": "Lighting validation",
|
|
127
|
+
"when": {
|
|
128
|
+
"all": [
|
|
129
|
+
{
|
|
130
|
+
"field": "quality.domain",
|
|
131
|
+
"operator": "equals",
|
|
132
|
+
"value": "lighting"
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"field": "quality.verdict",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": "not_run"
|
|
138
|
+
}
|
|
139
|
+
]
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"target": "scene-readiness",
|
|
144
|
+
"type": "progression",
|
|
145
|
+
"label": "Quality readiness",
|
|
146
|
+
"when": {
|
|
147
|
+
"all": [
|
|
148
|
+
{
|
|
149
|
+
"field": "quality.domain",
|
|
150
|
+
"operator": "equals",
|
|
151
|
+
"value": "holistic"
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"field": "stage.current",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": "quality_validation"
|
|
157
|
+
}
|
|
158
|
+
]
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
]
|
|
162
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Depth layering rules
|
|
2
|
+
|
|
3
|
+
A wide establishing shot reads flat without distinct depth layers. Plan FG / MG / BG explicitly.
|
|
4
|
+
|
|
5
|
+
## Three-layer model
|
|
6
|
+
|
|
7
|
+
### Foreground (FG)
|
|
8
|
+
- Closest to camera; usually silhouettes or partial occluding elements.
|
|
9
|
+
- Provides scale + frame within frame.
|
|
10
|
+
- Examples: tree branches, rooftops, vehicles, characters in silhouette.
|
|
11
|
+
|
|
12
|
+
### Midground (MG)
|
|
13
|
+
- The subject area; carries focal subject if any.
|
|
14
|
+
- Most detailed; reads as primary visual layer.
|
|
15
|
+
- Examples: main building, focal vehicle, character group.
|
|
16
|
+
|
|
17
|
+
### Background (BG)
|
|
18
|
+
- Distant; provides context + atmospheric perspective.
|
|
19
|
+
- Less detailed; simplified by haze.
|
|
20
|
+
- Examples: distant skyline, mountains, sky.
|
|
21
|
+
|
|
22
|
+
## Atmospheric perspective rules
|
|
23
|
+
|
|
24
|
+
- BG is lighter / cooler / less saturated than MG.
|
|
25
|
+
- Haze density increases with distance.
|
|
26
|
+
- Sharpness decreases with distance.
|
|
27
|
+
- Color temperature shifts toward sky color in BG.
|
|
28
|
+
|
|
29
|
+
## Common failures
|
|
30
|
+
|
|
31
|
+
- All three layers same brightness → reads flat.
|
|
32
|
+
- Background more detailed than midground → eye reads BG first; subject lost.
|
|
33
|
+
- Foreground occlusion blocks focal subject.
|
|
34
|
+
- No FG → environment feels distant and unreachable.
|
|
35
|
+
- No BG → subject feels stage-set, isolated.
|
|
36
|
+
|
|
37
|
+
## Verdict guidance
|
|
38
|
+
|
|
39
|
+
- All 3 layers present + atmospheric perspective applied → Pass.
|
|
40
|
+
- 2 layers only → Warn (reduced depth).
|
|
41
|
+
- 1 layer only → Fail (no depth; not establishing).
|
|
42
|
+
- Layers present but BG dominates → Fail (hierarchy broken).
|
|
43
|
+
|
|
44
|
+
## Stylization caveat
|
|
45
|
+
|
|
46
|
+
For stylized / flat / abstract environments, depth layers may collapse intentionally. Verify against brief; if "flat 2D-style" is the brief, depth rules relax.
|
|
47
|
+
|
|
48
|
+
## Related skill
|
|
49
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Time of day + weather rules
|
|
2
|
+
|
|
3
|
+
## Time of day → light + sky
|
|
4
|
+
|
|
5
|
+
| Time | Sun azimuth | Sun strength | Sky tint | HDRI suggestion |
|
|
6
|
+
|---|---|---|---|---|
|
|
7
|
+
| Dawn | low east, ~10° | 0.5–1.0 | warm pink-orange | dawn HDRI |
|
|
8
|
+
| Mid-morning | ~30° | 1.5–2.5 | clear blue | sunny day |
|
|
9
|
+
| Noon | overhead, ~80° | 3–5 | bright blue | overcast or clear |
|
|
10
|
+
| Golden hour | low west, ~10° | 1–2 | deep orange-red | golden hour |
|
|
11
|
+
| Blue hour (post-sunset) | below horizon | 0 (no direct sun) | deep blue-purple | dusk |
|
|
12
|
+
| Night | below horizon | 0 | dark blue / black | night sky |
|
|
13
|
+
| Stylized "neon night" | below horizon | minor | mostly occluded | dark sky + practicals dominate |
|
|
14
|
+
|
|
15
|
+
## Weather → atmosphere + sky
|
|
16
|
+
|
|
17
|
+
| Weather | Sun visibility | Atmosphere density | Notes |
|
|
18
|
+
|---|---|---|---|
|
|
19
|
+
| Clear | direct | 0.0–0.02 | Sharp shadows |
|
|
20
|
+
| Partly cloudy | broken | 0.02–0.05 | Variable shadows |
|
|
21
|
+
| Overcast | diffuse | 0.05–0.1 | Soft shadows |
|
|
22
|
+
| Light rain | diffuse | 0.05–0.15 | Wet ground reflections |
|
|
23
|
+
| Heavy rain | diffuse / occluded | 0.1–0.3 | Reduced visibility |
|
|
24
|
+
| Fog | occluded | 0.3+ | Subject at distance lost |
|
|
25
|
+
| Snow | diffuse | varies | Ground albedo high |
|
|
26
|
+
|
|
27
|
+
## Common contradictions
|
|
28
|
+
|
|
29
|
+
- Sunny + noir mood → Fail; pick one.
|
|
30
|
+
- Heavy fog + sharp distant skyline → Fail (visibility contradicts).
|
|
31
|
+
- Dawn warm tint + cool blue mood → Warn unless intentional split.
|
|
32
|
+
- Stylized neon night + realistic sky HDRI → Fail; pick one paradigm.
|
|
33
|
+
|
|
34
|
+
## Related skill
|
|
35
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Wide-shot camera rules
|
|
2
|
+
|
|
3
|
+
## Lens choice
|
|
4
|
+
|
|
5
|
+
| Use case | Equivalent focal length |
|
|
6
|
+
|---|---|
|
|
7
|
+
| Cinematic ultrawide vista | 14–20mm |
|
|
8
|
+
| Standard wide establishing | 24–35mm |
|
|
9
|
+
| Compressed cityscape | 50–85mm (compresses depth) |
|
|
10
|
+
| Telephoto distant landscape | 100mm+ (very compressed) |
|
|
11
|
+
|
|
12
|
+
## Altitude
|
|
13
|
+
|
|
14
|
+
| Altitude | Effect |
|
|
15
|
+
|---|---|
|
|
16
|
+
| Ground / eye-level (1.6–1.8m) | Human perspective; relatable |
|
|
17
|
+
| Slightly elevated (3–10m) | Hero shot of subject in environment |
|
|
18
|
+
| Drone height (20–100m) | Aerial overview; reduces human scale |
|
|
19
|
+
| Top-down / orthographic | Map-like; abstract |
|
|
20
|
+
|
|
21
|
+
## Tilt
|
|
22
|
+
|
|
23
|
+
| Tilt | Effect |
|
|
24
|
+
|---|---|
|
|
25
|
+
| Level (no tilt) | Stable, neutral |
|
|
26
|
+
| Slight up (Dutch +5°) | Heroic, looking up |
|
|
27
|
+
| Slight down (Dutch −5°) | Authoritative, surveying |
|
|
28
|
+
| Strong tilt (>15°) | Disorienting; use rarely |
|
|
29
|
+
|
|
30
|
+
## Common wide-shot positions
|
|
31
|
+
|
|
32
|
+
- **Hero approach**: ground level, slight up tilt, subject silhouette dominates frame.
|
|
33
|
+
- **Establishing aerial**: 30m elevation, level, full landscape visible.
|
|
34
|
+
- **Worm's eye**: ground level, strong up tilt, subject looms.
|
|
35
|
+
- **Top-down**: orthographic, map view, abstract.
|
|
36
|
+
|
|
37
|
+
## Avoid
|
|
38
|
+
|
|
39
|
+
- Strong fisheye distortion on architectural establishing shots.
|
|
40
|
+
- Eye-level wide angle on small subject (subject reads as tiny dot).
|
|
41
|
+
- Extreme tilt without narrative justification.
|
|
42
|
+
|
|
43
|
+
## Aspect-specific notes
|
|
44
|
+
|
|
45
|
+
- 16:9 → standard establishing
|
|
46
|
+
- 2.39:1 → exaggerate horizontal scope; compress vertical
|
|
47
|
+
- 9:16 → portrait orientation; elevate subject placement; minimize sky if no clouds
|
|
48
|
+
- 1:1 → minimal negative space; tight crop required
|
|
49
|
+
|
|
50
|
+
## Related skill
|
|
51
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# EVAL — glb-animation-handoff
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use glb-animation-handoff to write the playback contract for a GLB with an "idle + hover" two-clip animation, target Three.js / R3F.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- both clips listed with type, length, FPS, loop, trigger, blend, root motion, interpolation
|
|
8
|
+
- consumer-stack-specific caveats listed (mixer time scale, animationActions, useAnimations hook caveats)
|
|
9
|
+
- animation channel + bone counts vs budget
|
|
10
|
+
- export evidence status `Not Run` (no measurement performed in text-only mode)
|
|
11
|
+
- handoff to glb-web-handoff named
|
|
12
|
+
|
|
13
|
+
## Pass / Warn / Fail criteria
|
|
14
|
+
- Pass: full clip rows + caveats + honest evidence labels + handoff named
|
|
15
|
+
- Warn: clip rows present but FPS / blend / trigger ambiguous
|
|
16
|
+
- Fail: claims smooth playback without measurement, conflicting root-motion treatment, or invents clip names not in the brief
|
|
17
|
+
|
|
18
|
+
## Common failure modes
|
|
19
|
+
- omitting FPS
|
|
20
|
+
- mixing baked + parented root motion
|
|
21
|
+
- forgetting to mark export evidence
|
|
22
|
+
- treating animation as a single uniform stream instead of distinct clips
|
|
23
|
+
|
|
24
|
+
## Evidence expectations
|
|
25
|
+
- per-clip rows
|
|
26
|
+
- explicit measurement-vs-planning distinction
|
|
27
|
+
- consumer-stack caveats per chosen stack
|
|
28
|
+
|
|
29
|
+
## Sample passing response outline
|
|
30
|
+
- Clip contract table
|
|
31
|
+
- Consumer stack: r3f
|
|
32
|
+
- Stack caveats: useAnimations hook returns actions; consumer must call .play() inside useEffect on mount; cleanup with .stop()
|
|
33
|
+
- Animation channels: 24 of 50 budget
|
|
34
|
+
- Compliance: Not Run
|
|
35
|
+
|
|
36
|
+
## Sample failing response outline
|
|
37
|
+
- "Animations work" without contract rows
|
|
38
|
+
- Single FPS unspecified
|
|
39
|
+
- "Will be smooth in three.js" with no measurement
|