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,247 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: lighting-quality-checker
|
|
3
|
+
description: Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# lighting-quality-checker
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run a focused pass/warn/fail check on the scene's lighting setup per light — covering intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance, and mood match — without expanding into material, composition, or lookdev planning concerns.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- enumerate every explicit light and HDRI in the scene plan or measured scene
|
|
13
|
+
- check intensity ranges per light
|
|
14
|
+
- check shadow softness consistency
|
|
15
|
+
- check color temperature consistency
|
|
16
|
+
- check HDRI presence + balance with explicit lights
|
|
17
|
+
- check mood match against the brief
|
|
18
|
+
- emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
|
|
19
|
+
|
|
20
|
+
## When to use
|
|
21
|
+
- before render
|
|
22
|
+
- after a lighting change request
|
|
23
|
+
- as a sub-check during full quality review
|
|
24
|
+
- when the rendered preview looks "off" but the issue is unclear
|
|
25
|
+
|
|
26
|
+
## When not to use
|
|
27
|
+
<!-- blendops:generated:start exclusions -->
|
|
28
|
+
- upstream lookdev and lighting planning → use `../lighting-material-plan/SKILL.md` (use lighting-material-plan)
|
|
29
|
+
- material validation → use `../material-quality-checker/SKILL.md` (use material-quality-checker)
|
|
30
|
+
- composition / camera validation → use `../composition-quality-checker/SKILL.md` (use composition-quality-checker)
|
|
31
|
+
- broad pass/warn/fail scene readiness → use `../scene-readiness/SKILL.md` (use scene-readiness)
|
|
32
|
+
- classifying render or export artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
|
|
33
|
+
- to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → use `../scene-readiness/SKILL.md` (this skill validates and gives remediation hints only; it never edits)
|
|
34
|
+
<!-- blendops:generated:end exclusions -->
|
|
35
|
+
|
|
36
|
+
## Trigger phrases
|
|
37
|
+
<!-- blendops:generated:start triggers -->
|
|
38
|
+
- "is the lighting okay"
|
|
39
|
+
- "check shadow softness"
|
|
40
|
+
- "lighting feels off"
|
|
41
|
+
- "is the HDRI balanced"
|
|
42
|
+
<!-- blendops:generated:end triggers -->
|
|
43
|
+
|
|
44
|
+
## Prerequisites / readiness
|
|
45
|
+
- light list known (from `lighting-material-plan` scene plan or measured scene snapshot)
|
|
46
|
+
- consumer target known (render or export target)
|
|
47
|
+
- mood / look brief known (from `intent-to-3d-brief-writer`)
|
|
48
|
+
|
|
49
|
+
## Input schema
|
|
50
|
+
|
|
51
|
+
### Required inputs
|
|
52
|
+
|
|
53
|
+
| Input | Why it is required |
|
|
54
|
+
|---|---|
|
|
55
|
+
| Light list (type, position, strength, color, soft size) | Scope of the check |
|
|
56
|
+
| Mood / look brief | Determines whether the lighting matches intent |
|
|
57
|
+
| Consumer target | Cycles vs Eevee vs glTF affects allowed light types |
|
|
58
|
+
|
|
59
|
+
### Optional inputs
|
|
60
|
+
|
|
61
|
+
| Input | Use |
|
|
62
|
+
|---|---|
|
|
63
|
+
| HDRI file path or name | Identifies environment lighting |
|
|
64
|
+
| Reference image | Allows intensity / mood cross-check |
|
|
65
|
+
|
|
66
|
+
### Assumptions to confirm
|
|
67
|
+
- Intensity units (Watts / Lumens / Sun strength) are consistent across the scene.
|
|
68
|
+
- Color temperature is in Kelvin where applicable; mixed Kelvin and RGB color modes need explicit annotation.
|
|
69
|
+
- HDRI is real-world calibrated (typical 0.5–2.0 strength), not arbitrarily boosted.
|
|
70
|
+
|
|
71
|
+
## Output schema
|
|
72
|
+
|
|
73
|
+
### Primary output
|
|
74
|
+
A per-light verdict table: name, type, intensity, color, shadow softness, verdict (`Pass / Warn / Fail`), and remediation hints (hints only, never direct edits or execution).
|
|
75
|
+
|
|
76
|
+
### Secondary output
|
|
77
|
+
- top-line status (`Pass / Warn / Fail`) computed from per-light rows
|
|
78
|
+
- mood / look match: `Yes / No / Unknown`
|
|
79
|
+
- worst-offender highlighting
|
|
80
|
+
|
|
81
|
+
### Evidence / caveat output
|
|
82
|
+
Validation verdicts (`Pass / Warn / Fail`) are separate from runtime and artifact truth states. Truth states are downgrade-only (never upgrade), and `Artifact status` defaults to `Not Produced` unless concrete output evidence exists (classified via `render-export-evidence`).
|
|
83
|
+
|
|
84
|
+
```txt
|
|
85
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
86
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
87
|
+
Evidence used: <links, paths, logs, or "none">
|
|
88
|
+
Limitations: <known gaps>
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Required laws
|
|
92
|
+
- `../../laws/evidence-before-done.md`
|
|
93
|
+
- `../../laws/non-blender-user-language.md`
|
|
94
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
95
|
+
- `../../laws/official-runtime-only.md`
|
|
96
|
+
|
|
97
|
+
## Official runtime boundary
|
|
98
|
+
|
|
99
|
+
This skill validates plans or measured scene snapshots only. It never modifies lights, runs Blender, or renders. Use measured scene description (plan output, runtime tool snapshot) — never invent values.
|
|
100
|
+
|
|
101
|
+
For runtime path attribution, see `../../docs/runtime-stack-strategy.md`.
|
|
102
|
+
|
|
103
|
+
## Operating procedure
|
|
104
|
+
1. Read the light list from the `lighting-material-plan` plan or measured scene snapshot.
|
|
105
|
+
2. For each light, evaluate intensity range (see `references/intensity-ranges.md`).
|
|
106
|
+
3. Evaluate shadow softness consistency (see `references/shadow-softness-rules.md`).
|
|
107
|
+
4. Evaluate color temperature consistency.
|
|
108
|
+
5. Evaluate HDRI strength + explicit-light balance (see `references/hdri-balance-rules.md`).
|
|
109
|
+
6. Cross-check overall setup with the mood brief from `intent-to-3d-brief-writer`.
|
|
110
|
+
7. Assign per-light verdict (`Pass / Warn / Fail`) and provide brief remediation hints only (never edit lights).
|
|
111
|
+
8. Compute top-line status, highlight worst offenders, and record downgrade-only truth states (`Artifact status: Not Produced` by default unless concrete output evidence exists).
|
|
112
|
+
9. Hand off to `scene-readiness` (broad review), `lighting-material-plan` (re-plan), `material-quality-checker` (materials), `composition-quality-checker` (framing), or `render-export-evidence` (artifact evidence classification).
|
|
113
|
+
|
|
114
|
+
## Decision tree
|
|
115
|
+
|
|
116
|
+
```txt
|
|
117
|
+
Scene has only HDRI, no explicit light when brief requires strong key separation?
|
|
118
|
+
→ Warn (HDRI/explicit-light balance flag; verify intent)
|
|
119
|
+
HDRI strength overpowers explicit lights?
|
|
120
|
+
→ Warn (balance issue); add remediation hint to rebalance HDRI vs key light
|
|
121
|
+
Multiple explicit lights stacked above target intensity range?
|
|
122
|
+
→ Warn or Fail depending on severity; add remediation hint to reduce intensities
|
|
123
|
+
Shadows hard when mood brief specifies soft lighting (or vice versa)?
|
|
124
|
+
→ Fail (shadow softness + mood mismatch)
|
|
125
|
+
Inconsistent or unannotated color temperatures across lights?
|
|
126
|
+
→ Warn (color temperature consistency flag)
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Playbooks
|
|
130
|
+
|
|
131
|
+
### Playbook A: Product hero with HDRI + 3-point lighting
|
|
132
|
+
HDRI ~0.7–1.2; key area light ~50–500W; fill ~10–20% of key; rim for separation. Verdicts per light + balance check.
|
|
133
|
+
|
|
134
|
+
### Playbook B: Cinematic moody scene
|
|
135
|
+
Single key + practical lights; HDRI ~0.2 (mostly ambient fill); shadows hard or soft per brief; verify mood match.
|
|
136
|
+
|
|
137
|
+
### Playbook C: Outdoor sunlight
|
|
138
|
+
Sun strength ~1–5; HDRI environment map for ambient; verify shadow direction matches sun direction; verify color temperature (~5500–6500K daylight).
|
|
139
|
+
|
|
140
|
+
## Mode handling
|
|
141
|
+
|
|
142
|
+
### Text-only mode
|
|
143
|
+
Verdicts (`Pass / Warn / Fail`) are based on the plan or spec only. Set `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
144
|
+
|
|
145
|
+
### Runtime-ready mode
|
|
146
|
+
Verdicts are based on a measured scene snapshot; cite the inspection source used. Truth states are downgrade-only — never upgrade `Runtime status` or `Artifact status` inside this skill, and leave `Artifact status: Not Produced` unless concrete output evidence already exists and is classified via `render-export-evidence`.
|
|
147
|
+
|
|
148
|
+
### Blocked runtime mode
|
|
149
|
+
Skip rows that depend on missing live measurement, mark limitations explicitly, and downgrade truth states (`Not Run` / `Not Produced` / `Failed` as applicable).
|
|
150
|
+
|
|
151
|
+
## Validation checklist
|
|
152
|
+
- [ ] Every light listed
|
|
153
|
+
- [ ] Intensity column filled
|
|
154
|
+
- [ ] Color column filled (Kelvin or RGB)
|
|
155
|
+
- [ ] Shadow softness column filled
|
|
156
|
+
- [ ] HDRI presence noted (or "none")
|
|
157
|
+
- [ ] Per-light verdict assigned
|
|
158
|
+
- [ ] Mood match assessed
|
|
159
|
+
- [ ] Top-line status derived from rows
|
|
160
|
+
- [ ] Honest evidence label
|
|
161
|
+
|
|
162
|
+
## Pass / Warn / Fail rubric
|
|
163
|
+
|
|
164
|
+
| Verdict | Criteria |
|
|
165
|
+
|---|---|
|
|
166
|
+
| Pass | All lights pass intensity / shadow / color sanity; HDRI balanced; mood match Yes. |
|
|
167
|
+
| Warn | Plausibility flags (HDRI alone, mixed color modes, intensity at edges of range) but no hard violations. |
|
|
168
|
+
| Fail | Mood mismatch (e.g. soft brief but hard shadows); unsupported light type for chosen export; intensity clearly off (factor of 10+); shadow direction inconsistent. |
|
|
169
|
+
|
|
170
|
+
## Failure handling
|
|
171
|
+
- Missing light data → Fail with note.
|
|
172
|
+
- Mood unclear → mark Mood match Unknown; do not Pass.
|
|
173
|
+
- User pushes for "Pass" without checks → restate requirement.
|
|
174
|
+
|
|
175
|
+
## Troubleshooting
|
|
176
|
+
|
|
177
|
+
| Problem | Remediation hint (lighting only) |
|
|
178
|
+
|---|---|
|
|
179
|
+
| Scene lighting too dark | Hint to recheck explicit light intensity ranges and HDRI balance in `lighting-material-plan` (route color/exposure questions to `color-management-decision`). |
|
|
180
|
+
| Scene lighting too bright | Hint to lower competing explicit light intensities or HDRI strength (route render clamping questions to `cycles-vs-eevee-decision`). |
|
|
181
|
+
| Shadows missing or harsh | Hint to check per-light shadow softness settings and key-to-fill intensity ratio. |
|
|
182
|
+
| Unintended color cast | Hint to check HDRI tint and color temperature consistency across key, fill, and rim lights. |
|
|
183
|
+
| Framing or surface response feels wrong | Out of scope — route framing/camera issues to `composition-quality-checker` and shader issues to `material-quality-checker`. |
|
|
184
|
+
|
|
185
|
+
## Best practices
|
|
186
|
+
- Pair every Fail with the rule that triggered it.
|
|
187
|
+
- Cross-check intensity sums against the scene's overall exposure target.
|
|
188
|
+
- Always evaluate HDRI + explicit lights as a system, not separately.
|
|
189
|
+
- Keep this skill narrow — do not creep into material or composition.
|
|
190
|
+
|
|
191
|
+
## Good examples
|
|
192
|
+
- "HDRI: studio.exr @ 1.0 (Pass); Key area light 250W, 5500K, 0.6m soft (Pass); Fill area 50W, 5500K, 0.8m soft (Pass); Rim area 80W, 5000K, 0.4m soft (Pass). Mood match: Yes (soft hero). Top-line: Pass. Runtime status: Not Run | Artifact status: Not Produced."
|
|
193
|
+
|
|
194
|
+
## Bad examples
|
|
195
|
+
- "Lighting looks fine." — missing per-light rows, mood match, and top-line status.
|
|
196
|
+
- Upgrading `Artifact status` to `Verified` or `Produced` inside a lighting check without concrete output evidence classified by `render-export-evidence`.
|
|
197
|
+
- Editing light power or running Blender scripts instead of giving remediation hints.
|
|
198
|
+
|
|
199
|
+
## User-facing response template
|
|
200
|
+
|
|
201
|
+
```txt
|
|
202
|
+
Consumer target: <target>
|
|
203
|
+
Mood / look: <one-line summary>
|
|
204
|
+
|
|
205
|
+
| Light | Type | Intensity | Color | Shadow softness | Verdict | Remediation hint |
|
|
206
|
+
|---|---|---|---|---|---|---|
|
|
207
|
+
| <name> | <type / HDRI> | <value> | <color temp / value> | <softness> | <Pass / Warn / Fail> | <hint only, no edits> |
|
|
208
|
+
|
|
209
|
+
HDRI balance: <name + strength + balance note, or "none">
|
|
210
|
+
Mood match: Yes / No / Unknown
|
|
211
|
+
Top-line: <Pass / Warn / Fail>
|
|
212
|
+
Worst offenders: <list or "none">
|
|
213
|
+
|
|
214
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
215
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
216
|
+
Evidence used: <links, paths, logs, or "none">
|
|
217
|
+
Limitations: <known gaps>
|
|
218
|
+
Next: scene-readiness | lighting-material-plan | material-quality-checker | composition-quality-checker | render-export-evidence
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
## Anti-patterns
|
|
222
|
+
- Editing lights or generating full lighting recipes inside this skill (use `lighting-material-plan`).
|
|
223
|
+
- Inventing light intensity, color, or softness values.
|
|
224
|
+
- Upgrading Runtime or Artifact truth states (truth states are downgrade-only; artifacts stay `Not Produced` unless concrete evidence exists).
|
|
225
|
+
- Mixing material checks (`material-quality-checker`), camera/framing checks (`composition-quality-checker`), or artifact evidence classification (`render-export-evidence`) into lighting validation.
|
|
226
|
+
|
|
227
|
+
## Cross-skill handoff
|
|
228
|
+
<!-- blendops:generated:start handoffs -->
|
|
229
|
+
- [progression] Broad readiness review → `../scene-readiness/SKILL.md`
|
|
230
|
+
- [upstream_reference] Material validation → `../material-quality-checker/SKILL.md`
|
|
231
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
232
|
+
- [retry] Lighting re-plan → `../lighting-material-plan/SKILL.md`
|
|
233
|
+
- [progression] Render evidence → `../render-export-evidence/SKILL.md`
|
|
234
|
+
<!-- blendops:generated:end handoffs -->
|
|
235
|
+
|
|
236
|
+
## Non-goals
|
|
237
|
+
- Edit lights.
|
|
238
|
+
- Generate light setup recipes.
|
|
239
|
+
- Replace `scene-readiness`.
|
|
240
|
+
- Run Blender.
|
|
241
|
+
|
|
242
|
+
## References
|
|
243
|
+
- `references/intensity-ranges.md`
|
|
244
|
+
- `references/shadow-softness-rules.md`
|
|
245
|
+
- `references/hdri-balance-rules.md`
|
|
246
|
+
- `../../laws/evidence-before-done.md`
|
|
247
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "lighting-quality-checker",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "quality-validators",
|
|
6
|
+
"role": "exposure-ratio-and-shadow-validator",
|
|
7
|
+
"purpose": "Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"is the lighting okay",
|
|
11
|
+
"check shadow softness",
|
|
12
|
+
"lighting feels off",
|
|
13
|
+
"is the HDRI balanced"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "upstream lookdev and lighting planning",
|
|
18
|
+
"delegateTo": "lighting-material-plan",
|
|
19
|
+
"reason": "use lighting-material-plan"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "material validation",
|
|
23
|
+
"delegateTo": "material-quality-checker",
|
|
24
|
+
"reason": "use material-quality-checker"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "composition / camera validation",
|
|
28
|
+
"delegateTo": "composition-quality-checker",
|
|
29
|
+
"reason": "use composition-quality-checker"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "broad pass/warn/fail scene readiness",
|
|
33
|
+
"delegateTo": "scene-readiness",
|
|
34
|
+
"reason": "use scene-readiness"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "classifying render or export artifact evidence",
|
|
38
|
+
"delegateTo": "render-export-evidence",
|
|
39
|
+
"reason": "use render-export-evidence"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "to fix or edit lights (this skill validates and gives remediation hints only; it never edits)",
|
|
43
|
+
"delegateTo": "scene-readiness",
|
|
44
|
+
"reason": "this skill validates and gives remediation hints only; it never edits"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "lighting_rig_specification",
|
|
51
|
+
"type": "object",
|
|
52
|
+
"description": "Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "color_management_pins",
|
|
56
|
+
"type": "object",
|
|
57
|
+
"description": "Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "render_or_preview_exposure_notes",
|
|
63
|
+
"type": "string",
|
|
64
|
+
"description": "Optional highlight clipping or shadow crush observations from preview output"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"lighting_quality_verdict_table",
|
|
71
|
+
"key_fill_rim_and_clipping_audit",
|
|
72
|
+
"lighting_remediation_instructions"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "scene-readiness",
|
|
83
|
+
"type": "progression",
|
|
84
|
+
"label": "Broad readiness review",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "quality.domain",
|
|
89
|
+
"operator": "equals",
|
|
90
|
+
"value": "holistic"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"field": "stage.current",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": "quality_validation"
|
|
96
|
+
}
|
|
97
|
+
]
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"target": "material-quality-checker",
|
|
102
|
+
"type": "upstream_reference",
|
|
103
|
+
"label": "Material validation",
|
|
104
|
+
"when": {
|
|
105
|
+
"all": [
|
|
106
|
+
{
|
|
107
|
+
"field": "quality.domain",
|
|
108
|
+
"operator": "equals",
|
|
109
|
+
"value": "material"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"field": "quality.verdict",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": "not_run"
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
}
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"target": "composition-quality-checker",
|
|
121
|
+
"type": "progression",
|
|
122
|
+
"label": "Composition validation",
|
|
123
|
+
"when": {
|
|
124
|
+
"all": [
|
|
125
|
+
{
|
|
126
|
+
"field": "quality.domain",
|
|
127
|
+
"operator": "equals",
|
|
128
|
+
"value": "composition"
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"field": "quality.verdict",
|
|
132
|
+
"operator": "equals",
|
|
133
|
+
"value": "not_run"
|
|
134
|
+
}
|
|
135
|
+
]
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
"target": "lighting-material-plan",
|
|
140
|
+
"type": "retry",
|
|
141
|
+
"label": "Lighting re-plan",
|
|
142
|
+
"when": {
|
|
143
|
+
"all": [
|
|
144
|
+
{
|
|
145
|
+
"field": "quality.domain",
|
|
146
|
+
"operator": "equals",
|
|
147
|
+
"value": "lighting"
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
"field": "quality.verdict",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": "Fail"
|
|
153
|
+
}
|
|
154
|
+
]
|
|
155
|
+
},
|
|
156
|
+
"retryPolicy": {
|
|
157
|
+
"maxAttempts": 2,
|
|
158
|
+
"exitCondition": {
|
|
159
|
+
"all": [
|
|
160
|
+
{
|
|
161
|
+
"field": "quality.verdict",
|
|
162
|
+
"operator": "in",
|
|
163
|
+
"value": [
|
|
164
|
+
"Pass",
|
|
165
|
+
"Warn"
|
|
166
|
+
]
|
|
167
|
+
}
|
|
168
|
+
]
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"target": "render-export-evidence",
|
|
174
|
+
"type": "progression",
|
|
175
|
+
"label": "Render evidence",
|
|
176
|
+
"when": {
|
|
177
|
+
"all": [
|
|
178
|
+
{
|
|
179
|
+
"field": "stage.current",
|
|
180
|
+
"operator": "equals",
|
|
181
|
+
"value": "post_execution_audit"
|
|
182
|
+
}
|
|
183
|
+
]
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
]
|
|
187
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# HDRI + explicit-light balance rules
|
|
2
|
+
|
|
3
|
+
HDRIs and explicit lights are not interchangeable. Use them as a system.
|
|
4
|
+
|
|
5
|
+
## HDRI alone
|
|
6
|
+
|
|
7
|
+
| Use case | Verdict |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Outdoor scene with sky HDRI | Pass |
|
|
10
|
+
| Quick lookdev / preview | Pass (rough check only) |
|
|
11
|
+
| Final product hero | Warn (HDRI alone often lacks key-light snap) |
|
|
12
|
+
| Cinematic narrative shot | Fail (no shaping) |
|
|
13
|
+
|
|
14
|
+
## HDRI + 3-point key/fill/rim
|
|
15
|
+
|
|
16
|
+
This is the **default for product hero**. HDRI provides ambient + ground reflection; explicit lights shape the subject.
|
|
17
|
+
|
|
18
|
+
Recommended balance:
|
|
19
|
+
- HDRI strength: 0.5–1.2 (subordinate)
|
|
20
|
+
- Key area light: ~50–500W (dominant on subject)
|
|
21
|
+
- Fill: 10–20% of key strength
|
|
22
|
+
- Rim: enough for separation against background (often 50–100% of key)
|
|
23
|
+
|
|
24
|
+
## Explicit lights only (no HDRI)
|
|
25
|
+
|
|
26
|
+
| Use case | Verdict |
|
|
27
|
+
|---|---|
|
|
28
|
+
| Studio product on solid color seamless | Pass (controlled) |
|
|
29
|
+
| Outdoor scene without sky | Fail (missing ambient) |
|
|
30
|
+
| Cinematic dark mood | Pass (HDRI optional) |
|
|
31
|
+
|
|
32
|
+
## Fail rules
|
|
33
|
+
|
|
34
|
+
- HDRI strength > 2.0 with explicit lights at studio levels → likely overpowering. Verify intent or Fail.
|
|
35
|
+
- HDRI tint conflicts with key Kelvin (e.g., warm HDRI + cool 7000K key) → Fail unless intentional split lighting.
|
|
36
|
+
- HDRI on but environment-only checkbox off → confusing setup; Warn.
|
|
37
|
+
|
|
38
|
+
## Common patterns
|
|
39
|
+
|
|
40
|
+
| Pattern | HDRI strength | Key W | Fill ratio | Rim |
|
|
41
|
+
|---|---|---|---|---|
|
|
42
|
+
| Soft hero | 1.0 | 250 | 0.15 | 100W rim |
|
|
43
|
+
| Hard dramatic | 0.3 | 500 | 0.05 | 100W rim |
|
|
44
|
+
| Outdoor daylight | 1.5 | 0 (sun separate) | — | — |
|
|
45
|
+
| Moody / noir | 0.2 | 400 | 0.0 | 50W rim only |
|
|
46
|
+
|
|
47
|
+
## Related skill
|
|
48
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Light intensity ranges (sanity reference)
|
|
2
|
+
|
|
3
|
+
These are typical Cycles/Eevee values for common scenarios. Use as plausibility ranges, not hard requirements.
|
|
4
|
+
|
|
5
|
+
## Sun light (directional)
|
|
6
|
+
|
|
7
|
+
| Scenario | Strength |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Outdoor daylight (overcast) | 1–2 |
|
|
10
|
+
| Outdoor daylight (clear sun) | 2–5 |
|
|
11
|
+
| Sunset / sunrise warm | 1–3 |
|
|
12
|
+
| Moonlight | 0.05–0.3 |
|
|
13
|
+
|
|
14
|
+
## Area light (W in Cycles, watts-equivalent)
|
|
15
|
+
|
|
16
|
+
| Scenario | Wattage |
|
|
17
|
+
|---|---|
|
|
18
|
+
| Practical (small bulb) | 5–25 W |
|
|
19
|
+
| Tabletop product key | 50–250 W |
|
|
20
|
+
| Studio key (medium soft) | 250–1000 W |
|
|
21
|
+
| Hero product key (large soft) | 500–2000 W |
|
|
22
|
+
| Architectural overhead bank | 1000–5000 W |
|
|
23
|
+
|
|
24
|
+
## Point light
|
|
25
|
+
|
|
26
|
+
| Scenario | Wattage |
|
|
27
|
+
|---|---|
|
|
28
|
+
| Practical (lamp bulb) | 5–60 W |
|
|
29
|
+
| Visible point glow | up to 200 W |
|
|
30
|
+
|
|
31
|
+
## Spot light
|
|
32
|
+
|
|
33
|
+
| Scenario | Wattage |
|
|
34
|
+
|---|---|
|
|
35
|
+
| Theater rim spot | 100–500 W |
|
|
36
|
+
| Architectural accent | 50–300 W |
|
|
37
|
+
|
|
38
|
+
## HDRI environment
|
|
39
|
+
|
|
40
|
+
| Scenario | Strength |
|
|
41
|
+
|---|---|
|
|
42
|
+
| Studio (soft fill) | 0.5–1.2 |
|
|
43
|
+
| Outdoor sun | 0.7–1.5 |
|
|
44
|
+
| Subtle ambient (mood scene) | 0.2–0.5 |
|
|
45
|
+
| Overpowering (likely error) | > 2.0 |
|
|
46
|
+
|
|
47
|
+
## View transform & color temperature pairing
|
|
48
|
+
|
|
49
|
+
Always judge lighting intensity under the intended target `view_transform`:
|
|
50
|
+
|
|
51
|
+
| View Transform | Best used for | Web / engine parity |
|
|
52
|
+
|---|---|---|
|
|
53
|
+
| **AgX** (Blender 4.0+ default) | Hero renders, high-contrast highlights, realistic rolloff | Pair with `ACESFilmic` / `AgX` tone mapping if targeting realistic web |
|
|
54
|
+
| **Khronos PBR Neutral** | E-commerce products, exact brand color & albedo parity | Direct 1:1 parity with Three.js `THREE.NeutralToneMapping` |
|
|
55
|
+
| **Standard** | 2D UI panels, flat graphic signage, pixel-exact color | No filmic highlight compression |
|
|
56
|
+
|
|
57
|
+
### Practical Kelvin pairings (contrast without mud)
|
|
58
|
+
|
|
59
|
+
| Contrast pair | Warm key / practical | Cool fill / rim |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| Studio product | `5200–5600 K` neutral key | `6500–7500 K` subtle cool rim |
|
|
62
|
+
| Moody / cozy interior | `2700–3200 K` practical lamp | `7500–10000 K` sky / window fill |
|
|
63
|
+
| Sci-fi / cyberpunk accent | Accent saturated rim (`cyan / magenta`) | Low-strength neutral fill (`20–35%` key) |
|
|
64
|
+
|
|
65
|
+
## Verdict guidance
|
|
66
|
+
|
|
67
|
+
- Outside the range → Warn
|
|
68
|
+
- 10× outside the range → Fail
|
|
69
|
+
- Range overlaps with a different scenario → check brief
|
|
70
|
+
- Judging PBR brand colors under extreme Filmic look instead of `Khronos PBR Neutral` or `AgX` → Warn
|
|
71
|
+
|
|
72
|
+
## Related skill
|
|
73
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Shadow softness rules
|
|
2
|
+
|
|
3
|
+
Shadow softness is a **system property**: it depends on light size, distance, and the shadowed surface — not just one parameter.
|
|
4
|
+
|
|
5
|
+
## Light size (area / disc) drives softness
|
|
6
|
+
|
|
7
|
+
- Small light (≤ 0.1m) at 2m distance → hard shadow.
|
|
8
|
+
- Medium light (0.5m) at 2m → softer.
|
|
9
|
+
- Large light (1.5m) at 2m → very soft.
|
|
10
|
+
- HDRI environment → very soft (entire dome contributes).
|
|
11
|
+
|
|
12
|
+
## Distance affects perceived softness
|
|
13
|
+
|
|
14
|
+
A small light far away looks like a point (hard shadow). A large light close looks soft.
|
|
15
|
+
|
|
16
|
+
## Mood matching
|
|
17
|
+
|
|
18
|
+
| Mood | Expected shadow style |
|
|
19
|
+
|---|---|
|
|
20
|
+
| Hard / dramatic | Single sharp light, small light size, no fill |
|
|
21
|
+
| Soft hero / studio | Large soft key + soft fill |
|
|
22
|
+
| Cinematic noir | Hard key + minimal fill |
|
|
23
|
+
| Outdoor daylight (clear) | Hard sun shadow + soft fill from sky HDRI |
|
|
24
|
+
| Outdoor daylight (overcast) | Very soft shadows, sky HDRI dominant |
|
|
25
|
+
|
|
26
|
+
## Fail rules
|
|
27
|
+
|
|
28
|
+
- Brief says "soft hero" but key light size ≤ 0.1m → Fail.
|
|
29
|
+
- Brief says "hard dramatic" but key light size ≥ 1m → Fail.
|
|
30
|
+
- Multiple key-strength lights with conflicting shadow directions → Fail (creates double shadows that read as error).
|
|
31
|
+
|
|
32
|
+
## Warn rules
|
|
33
|
+
|
|
34
|
+
- Light size exactly at the boundary of soft/hard categories → Warn.
|
|
35
|
+
- Shadow softness depends on contact-shadow vs ray-trace shadow distinction; flag when this is unclear.
|
|
36
|
+
|
|
37
|
+
## Related skill
|
|
38
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# EVAL — material-quality-checker
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use material-quality-checker on a glTF-mobile scene plan with 5 PBR materials and a 4 MP total texture budget.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- per-material rows (5) with name, type, albedo, normal, roughness/metallic, texture count + resolution, consumer compatibility, verdict, notes
|
|
8
|
+
- top-line status derived from rows
|
|
9
|
+
- worst-offender highlight
|
|
10
|
+
- consumer target stated explicitly
|
|
11
|
+
- evidence label honest (Not Run for text-only)
|
|
12
|
+
- handoff named
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: every row filled with explicit values; top-line correct; no fabricated row
|
|
16
|
+
- Warn: rows mostly filled but one column missing or one verdict ambiguous
|
|
17
|
+
- Fail: marks "Pass" without rule citations, fabricates values, performs material edits, or skips consumer-stack check
|
|
18
|
+
|
|
19
|
+
## Common failure modes
|
|
20
|
+
- broad summary without per-material rows
|
|
21
|
+
- claiming Verified without measurement
|
|
22
|
+
- mixing lighting / composition checks
|
|
23
|
+
- skipping consumer compatibility column
|
|
24
|
+
|
|
25
|
+
## Evidence expectations
|
|
26
|
+
- per-row PBR sanity verdicts cited from rules
|
|
27
|
+
- texture budget compared to pinned cap
|
|
28
|
+
- consumer target named
|
|
29
|
+
|
|
30
|
+
## Sample passing response outline
|
|
31
|
+
- Consumer target + texture budget cap header
|
|
32
|
+
- 5 material rows
|
|
33
|
+
- Top-line: derived from rows
|
|
34
|
+
- Worst offenders: 1-2 named
|
|
35
|
+
- Next: scene-readiness / render-export-evidence
|
|
36
|
+
|
|
37
|
+
## Sample failing response outline
|
|
38
|
+
- "Materials look good"
|
|
39
|
+
- No per-row analysis
|
|
40
|
+
- Verified label without measurement
|