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,238 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: asset-style-check
|
|
3
|
+
description: Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# asset-style-check
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Catch style mismatches between assets before they end up in the same scene where the inconsistency reads as compositing error.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- list every asset planned for the scene
|
|
13
|
+
- evaluate each on style axes (realism / detail / color / surface)
|
|
14
|
+
- flag drift between assets
|
|
15
|
+
- recommend remediation (drop / restyle / replace)
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- after `asset-license-checker` clears the assets
|
|
19
|
+
- before scene build
|
|
20
|
+
- when a scene preview shows visible style mismatch
|
|
21
|
+
- when assets come from multiple sources
|
|
22
|
+
|
|
23
|
+
## When not to use
|
|
24
|
+
<!-- blendops:generated:start exclusions -->
|
|
25
|
+
- single isolated asset where no multi-asset or scene-brief consistency check is requested → use `../asset-discovery/SKILL.md` (Delegates out-of-scope requests to asset-discovery)
|
|
26
|
+
- pure planning before candidate assets are picked → use `../asset-discovery/SKILL.md` (use asset-discovery)
|
|
27
|
+
- intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles → use `../asset-license-checker/SKILL.md` (Delegates out-of-scope requests to asset-license-checker)
|
|
28
|
+
- checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light → use `../asset-license-checker/SKILL.md` (lighting-material-plan)
|
|
29
|
+
<!-- blendops:generated:end exclusions -->
|
|
30
|
+
|
|
31
|
+
## Trigger phrases
|
|
32
|
+
<!-- blendops:generated:start triggers -->
|
|
33
|
+
- "do these assets fit together"
|
|
34
|
+
- "style check the assets"
|
|
35
|
+
- "scene feels like a collage"
|
|
36
|
+
<!-- blendops:generated:end triggers -->
|
|
37
|
+
|
|
38
|
+
## Prerequisites / readiness
|
|
39
|
+
- candidate asset list with previews sourced via `asset-discovery`
|
|
40
|
+
- all candidate assets cleared by `asset-license-checker`
|
|
41
|
+
- scene brief visual style locked (via `intent-to-3d-brief-writer` if needed)
|
|
42
|
+
- target scene quality bar set
|
|
43
|
+
|
|
44
|
+
## Input schema
|
|
45
|
+
|
|
46
|
+
### Required inputs
|
|
47
|
+
|
|
48
|
+
| Input | Why it is required |
|
|
49
|
+
|---|---|
|
|
50
|
+
| Asset list with previews | Subject of the check |
|
|
51
|
+
| Brief style locked | Reference for consistency |
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
|
|
55
|
+
| Input | Use |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Reference image / mood board | Style baseline |
|
|
58
|
+
| Existing scene preview | Real-world consistency check |
|
|
59
|
+
|
|
60
|
+
### Assumptions to confirm
|
|
61
|
+
- Brief style is unambiguous.
|
|
62
|
+
- Asset previews are representative of final use.
|
|
63
|
+
|
|
64
|
+
## Output schema
|
|
65
|
+
|
|
66
|
+
### Primary output
|
|
67
|
+
A per-asset row table containing: asset name, realism axis, detail axis, color axis, surface axis, drift verdict (`None | Minor | Major`), validation verdict (`Pass | Warn | Fail`), and remediation hint (`none | drop | restyle | replace`).
|
|
68
|
+
|
|
69
|
+
### Secondary output
|
|
70
|
+
- top-line scene consistency verdict (`Pass | Warn | Fail`)
|
|
71
|
+
- summary list of assets to drop, restyle, or replace
|
|
72
|
+
- downstream handoff routing
|
|
73
|
+
- evidence and truth-state block (kept strictly separate from `Pass | Warn | Fail` validation verdicts)
|
|
74
|
+
|
|
75
|
+
### Evidence / caveat output
|
|
76
|
+
|
|
77
|
+
```txt
|
|
78
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
79
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
80
|
+
Evidence used: <links, paths, logs, or "none">
|
|
81
|
+
Limitations: <known gaps>
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Note: Truth states are downgrade-only (never upgrade without verified evidence) and remain strictly separate from per-asset `Pass | Warn | Fail` validation verdicts.
|
|
86
|
+
|
|
87
|
+
## Required laws
|
|
88
|
+
- `../../laws/evidence-before-done.md`
|
|
89
|
+
- `../../laws/non-blender-user-language.md`
|
|
90
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
91
|
+
- `../../laws/official-runtime-only.md`
|
|
92
|
+
|
|
93
|
+
## Official runtime boundary
|
|
94
|
+
|
|
95
|
+
Validation-only skill — never modifies or re-styles assets, and never executes Blender or Python. Per-asset verdicts (`Pass | Warn | Fail`) and drift classifications (`None | Minor | Major`) are derived solely from documented asset previews and the locked style brief, and are tracked separately from runtime/artifact truth states (which default to `Not Produced` for artifacts and are downgrade-only).
|
|
96
|
+
|
|
97
|
+
## Operating procedure
|
|
98
|
+
1. Confirm the asset list is sourced from `asset-discovery` and cleared by `asset-license-checker`.
|
|
99
|
+
2. Read the locked brief style baseline (if missing or ambiguous, hand off to `intent-to-3d-brief-writer`).
|
|
100
|
+
3. For each asset, evaluate all 4 style axes (`realism`, `detail`, `color`, `surface`) against the locked brief (see `references/style-axes.md`).
|
|
101
|
+
4. Assign a drift verdict (`None | Minor | Major`) and a validation verdict (`Pass | Warn | Fail`) per asset row.
|
|
102
|
+
5. Provide remediation hints only (`drop | restyle | replace`) for any asset with `Minor` or `Major` drift — never modify or re-style the asset here.
|
|
103
|
+
6. Route approved rows (`Pass`) to `asset-library-plan` for organization and `scene-readiness` for broad scene review; route rejected rows (`Fail`) to `asset-fallback-strategy` or back to `asset-discovery`.
|
|
104
|
+
|
|
105
|
+
## Decision tree
|
|
106
|
+
|
|
107
|
+
```txt
|
|
108
|
+
Brief explicitly locks mixed-style art direction?
|
|
109
|
+
→ Evaluate each asset against its assigned role in the brief; allowed contrast = None drift (Pass row)
|
|
110
|
+
Asset matches brief baseline across all 4 axes (realism / detail / color / surface)?
|
|
111
|
+
→ Drift: None | Verdict: Pass | Remediation: none
|
|
112
|
+
Asset off on 1 axis?
|
|
113
|
+
→ Drift: Minor | Verdict: Warn | Remediation: restyle or drop (verify intent)
|
|
114
|
+
Asset off on 2+ axes, or clashes severely with hero asset?
|
|
115
|
+
→ Drift: Major | Verdict: Fail | Remediation: replace or drop (hand off to asset-fallback-strategy)
|
|
116
|
+
Two or more assets in the same scene have Major drift between them without explicit mixed-style brief?
|
|
117
|
+
→ Top-line Verdict: Fail; cannot combine without breaking visual hierarchy
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Playbooks
|
|
121
|
+
|
|
122
|
+
### Playbook A: All-realistic product hero
|
|
123
|
+
All assets realistic; same detail density; PBR materials. One stylized prop → drop or restyle.
|
|
124
|
+
|
|
125
|
+
### Playbook B: Stylized character + flat background
|
|
126
|
+
Character is stylized; background must be equally simplified. Detailed background asset → drop.
|
|
127
|
+
|
|
128
|
+
### Playbook C: Mixed-style intentional (collage / editorial)
|
|
129
|
+
Brief explicitly mixed-style; verify with brief; drift becomes feature, not bug.
|
|
130
|
+
|
|
131
|
+
## Mode handling
|
|
132
|
+
|
|
133
|
+
### Text-only mode
|
|
134
|
+
|
|
135
|
+
Evaluate rows from documented previews and metadata. Set `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
136
|
+
|
|
137
|
+
### Runtime-ready mode
|
|
138
|
+
|
|
139
|
+
Evaluate rows using rendered scene preview snapshots alongside asset previews. Downgrade truth states if any preview is incomplete; never upgrade truth states beyond verified evidence.
|
|
140
|
+
|
|
141
|
+
### Blocked runtime mode
|
|
142
|
+
|
|
143
|
+
Skip rows that depend on a live rendered preview and mark limitations clearly. Keep `Runtime status: Not Run` (or `Failed` if attempted and blocked) and `Artifact status: Not Produced`.
|
|
144
|
+
|
|
145
|
+
## Validation checklist
|
|
146
|
+
- [ ] Every asset has a 4-axis row (`realism`, `detail`, `color`, `surface`) evaluated against the locked brief
|
|
147
|
+
- [ ] Every asset row includes both a drift verdict (`None / Minor / Major`) and a validation verdict (`Pass / Warn / Fail`)
|
|
148
|
+
- [ ] Top-line consistency verdict (`Pass / Warn / Fail`) is stated
|
|
149
|
+
- [ ] Remediation hints (`drop / restyle / replace`) are provided for any drift without modifying assets
|
|
150
|
+
- [ ] No license, polycount budget, or topology checks are mixed into the evaluation
|
|
151
|
+
- [ ] Runtime and artifact truth states (default `Not Produced`, downgrade-only) are reported separately from `Pass / Warn / Fail` verdicts
|
|
152
|
+
|
|
153
|
+
## Pass / Warn / Fail rubric
|
|
154
|
+
|
|
155
|
+
| Scope | Verdict | Criteria |
|
|
156
|
+
| --- | --- | --- |
|
|
157
|
+
| Per-asset row | Pass | Matches locked brief across all 4 axes (`realism`, `detail`, `color`, `surface`), or matches explicit mixed-style brief rule; drift is `None`. |
|
|
158
|
+
| Per-asset row | Warn | `Minor` drift on 1 axis against the locked brief; usable with a `restyle` or `drop` remediation hint. |
|
|
159
|
+
| Per-asset row | Fail | `Major` drift on 2+ axes against the locked brief; requires `replace` or `drop` via `asset-fallback-strategy`. |
|
|
160
|
+
| Top-line scene | Pass | All asset rows are `Pass` (or `Warn` with accepted remediation); locked brief style is respected. |
|
|
161
|
+
| Top-line scene | Warn | One or more assets show `Minor` drift (`Warn`), but no unresolved `Major` drift exists. |
|
|
162
|
+
| Top-line scene | Fail | Any asset has unresolved `Major` drift (`Fail`) or two+ assets clash, creating a visible collage error against the brief. |
|
|
163
|
+
|
|
164
|
+
Note: `Pass / Warn / Fail` validation verdicts measure style consistency only and must never be conflated with Runtime or Artifact truth states.
|
|
165
|
+
|
|
166
|
+
## Failure handling
|
|
167
|
+
- `Major` drift (`Fail` row) → recommend `replace` or `drop`; hand off rejected assets to `asset-fallback-strategy` or `asset-discovery`.
|
|
168
|
+
- Brief unclear or unlocked regarding visual style → stop evaluation and hand off to `intent-to-3d-brief-writer`.
|
|
169
|
+
- Claim that "mixed style is intentional" → accept ONLY if the locked brief explicitly specifies mixed styles; otherwise mark drift and hand off to `intent-to-3d-brief-writer` or `scope-guard`.
|
|
170
|
+
|
|
171
|
+
## Troubleshooting
|
|
172
|
+
|
|
173
|
+
| Problem | Response |
|
|
174
|
+
|---|---|
|
|
175
|
+
| Hard to tell style from preview | Request higher-quality preview; mark asset row `Warn` with limitation noted until clarified. |
|
|
176
|
+
| Style is on the boundary | Lock the style axis early against the brief; do not invite repeat boundary calls. |
|
|
177
|
+
| User changes style mid-scene | Treat as scope creep; hand off to `scope-guard`. |
|
|
178
|
+
|
|
179
|
+
## Best practices
|
|
180
|
+
- Lock style early; revisions are cheap pre-build.
|
|
181
|
+
- Always evaluate against the brief, not against vibe.
|
|
182
|
+
- Prefer 1 source for related assets to reduce drift risk.
|
|
183
|
+
- Keep this skill narrow — do not check license / budget / topology here.
|
|
184
|
+
|
|
185
|
+
## Good examples
|
|
186
|
+
- "`shoe-base.glb`: realism=realistic, detail=high, color=neutral, surface=PBR | Drift: `None` | Verdict: `Pass` | Remediation: `none`. `shoe-laces.glb`: realism=realistic, detail=high, color=neutral, surface=PBR | Drift: `None` | Verdict: `Pass` | Remediation: `none`. `shoe-environment-stylized.glb`: realism=stylized, detail=low, color=saturated, surface=flat | Drift: `Major` | Verdict: `Fail` | Remediation: `replace` via `asset-fallback-strategy`."
|
|
187
|
+
|
|
188
|
+
## Bad examples
|
|
189
|
+
- "Assets look like they go together." — no axis-by-axis verdict.
|
|
190
|
+
|
|
191
|
+
## User-facing response template
|
|
192
|
+
|
|
193
|
+
```txt
|
|
194
|
+
Brief style: <one line locked baseline>
|
|
195
|
+
|
|
196
|
+
| Asset | Realism | Detail | Color | Surface | Drift (None/Minor/Major) | Verdict (Pass/Warn/Fail) | Remediation (none/drop/restyle/replace) |
|
|
197
|
+
|---|---|---|---|---|---|---|---|
|
|
198
|
+
|
|
199
|
+
Top-line consistency: Pass / Warn / Fail
|
|
200
|
+
Assets to drop / restyle / replace: <list or "none">
|
|
201
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
202
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
203
|
+
Evidence used: <links, paths, logs, or "none">
|
|
204
|
+
Limitations: <known gaps>
|
|
205
|
+
Next: asset-library-plan & scene-readiness (Pass) / asset-fallback-strategy (Fail)
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
## Anti-patterns
|
|
209
|
+
- "Vibe match" verdicts.
|
|
210
|
+
- Skipping the brief reference.
|
|
211
|
+
- Mixing license / budget / topology checks here.
|
|
212
|
+
- Inventing axis values.
|
|
213
|
+
|
|
214
|
+
## Cross-skill handoff
|
|
215
|
+
<!-- blendops:generated:start handoffs -->
|
|
216
|
+
- [upstream_reference] Upstream discovery → `../asset-discovery/SKILL.md`
|
|
217
|
+
- [upstream_reference] Upstream license gate → `../asset-license-checker/SKILL.md`
|
|
218
|
+
- [upstream_reference] Upstream brief lock → `../intent-to-3d-brief-writer/SKILL.md`
|
|
219
|
+
- [boundary_delegation] Scope enforcement → `../scope-guard/SKILL.md`
|
|
220
|
+
- [fallback] Rejected asset fallback → `../asset-fallback-strategy/SKILL.md`
|
|
221
|
+
- [progression] Approved asset organization → `../asset-library-plan/SKILL.md`
|
|
222
|
+
- [progression] Broad scene review → `../scene-readiness/SKILL.md`
|
|
223
|
+
- [progression] Material & lookdev boundary (lighting-material-plan) → `../lighting-material-plan/SKILL.md`
|
|
224
|
+
- [progression] Material & lookdev boundary (material-quality-checker) → `../material-quality-checker/SKILL.md`
|
|
225
|
+
- [progression] Budget & topology boundary → `../polycount-budget-checker/SKILL.md`
|
|
226
|
+
<!-- blendops:generated:end handoffs -->
|
|
227
|
+
|
|
228
|
+
## Non-goals
|
|
229
|
+
- Never modify or re-style assets.
|
|
230
|
+
- Never check asset licenses (belongs to `asset-license-checker`).
|
|
231
|
+
- Never check polycount budgets or mesh topology (belongs to `polycount-budget-checker`).
|
|
232
|
+
- Never execute Blender or Python code.
|
|
233
|
+
|
|
234
|
+
## References
|
|
235
|
+
- `references/style-axes.md`
|
|
236
|
+
- `references/drift-classification.md`
|
|
237
|
+
- `references/intentional-mixed-style.md`
|
|
238
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "asset-style-check",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "asset-and-sourcing",
|
|
6
|
+
"role": "cross-asset-visual-coherence-validator",
|
|
7
|
+
"purpose": "Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"do these assets fit together",
|
|
11
|
+
"style check the assets",
|
|
12
|
+
"scene feels like a collage"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "single isolated asset where no multi-asset or scene-brief consistency check is requested",
|
|
17
|
+
"delegateTo": "asset-discovery",
|
|
18
|
+
"reason": "Delegates out-of-scope requests to asset-discovery"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "pure planning before candidate assets are picked",
|
|
22
|
+
"delegateTo": "asset-discovery",
|
|
23
|
+
"reason": "use asset-discovery"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles",
|
|
27
|
+
"delegateTo": "asset-license-checker",
|
|
28
|
+
"reason": "Delegates out-of-scope requests to asset-license-checker"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"condition": "checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light",
|
|
32
|
+
"delegateTo": "asset-license-checker",
|
|
33
|
+
"reason": "lighting-material-plan"
|
|
34
|
+
}
|
|
35
|
+
],
|
|
36
|
+
"inputs": {
|
|
37
|
+
"required": [
|
|
38
|
+
{
|
|
39
|
+
"name": "candidate_asset_list",
|
|
40
|
+
"type": "array",
|
|
41
|
+
"description": "Sourced 3D models, materials, and props to evaluate for visual coherence"
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"name": "brief_style_direction",
|
|
45
|
+
"type": "string",
|
|
46
|
+
"description": "Pinned visual style, proportion language, texel density, and surface wear target from brief"
|
|
47
|
+
}
|
|
48
|
+
],
|
|
49
|
+
"optional": [
|
|
50
|
+
{
|
|
51
|
+
"name": "hero_anchor_asset",
|
|
52
|
+
"type": "string",
|
|
53
|
+
"description": "Primary hero asset used as the visual benchmark for secondary props"
|
|
54
|
+
}
|
|
55
|
+
]
|
|
56
|
+
},
|
|
57
|
+
"outputs": {
|
|
58
|
+
"primary": [
|
|
59
|
+
"style_coherence_matrix",
|
|
60
|
+
"mismatched_asset_flags",
|
|
61
|
+
"remediation_or_fallback_recommendations"
|
|
62
|
+
],
|
|
63
|
+
"truthStatePolicy": {
|
|
64
|
+
"runtimeDefault": "Not Run",
|
|
65
|
+
"artifactDefault": "Not Produced",
|
|
66
|
+
"mutationRule": "downgrade_only"
|
|
67
|
+
}
|
|
68
|
+
},
|
|
69
|
+
"handoffs": [
|
|
70
|
+
{
|
|
71
|
+
"target": "asset-discovery",
|
|
72
|
+
"type": "upstream_reference",
|
|
73
|
+
"label": "Upstream discovery",
|
|
74
|
+
"when": {
|
|
75
|
+
"all": [
|
|
76
|
+
{
|
|
77
|
+
"field": "brief.locked",
|
|
78
|
+
"operator": "equals",
|
|
79
|
+
"value": true
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"field": "assets.discoveryComplete",
|
|
83
|
+
"operator": "equals",
|
|
84
|
+
"value": false
|
|
85
|
+
}
|
|
86
|
+
]
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"target": "asset-license-checker",
|
|
91
|
+
"type": "upstream_reference",
|
|
92
|
+
"label": "Upstream license gate",
|
|
93
|
+
"when": {
|
|
94
|
+
"all": [
|
|
95
|
+
{
|
|
96
|
+
"field": "assets.externalUsed",
|
|
97
|
+
"operator": "equals",
|
|
98
|
+
"value": true
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"field": "assets.licenseCleared",
|
|
102
|
+
"operator": "equals",
|
|
103
|
+
"value": false
|
|
104
|
+
}
|
|
105
|
+
]
|
|
106
|
+
}
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"target": "intent-to-3d-brief-writer",
|
|
110
|
+
"type": "upstream_reference",
|
|
111
|
+
"label": "Upstream brief lock",
|
|
112
|
+
"when": {
|
|
113
|
+
"all": [
|
|
114
|
+
{
|
|
115
|
+
"field": "goal.clarity",
|
|
116
|
+
"operator": "equals",
|
|
117
|
+
"value": "clear"
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"field": "brief.locked",
|
|
121
|
+
"operator": "equals",
|
|
122
|
+
"value": false
|
|
123
|
+
}
|
|
124
|
+
]
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
"target": "scope-guard",
|
|
129
|
+
"type": "boundary_delegation",
|
|
130
|
+
"label": "Scope enforcement",
|
|
131
|
+
"when": {
|
|
132
|
+
"all": [
|
|
133
|
+
{
|
|
134
|
+
"field": "scope.driftDetected",
|
|
135
|
+
"operator": "equals",
|
|
136
|
+
"value": true
|
|
137
|
+
}
|
|
138
|
+
]
|
|
139
|
+
}
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"target": "asset-fallback-strategy",
|
|
143
|
+
"type": "fallback",
|
|
144
|
+
"label": "Rejected asset fallback",
|
|
145
|
+
"when": {
|
|
146
|
+
"all": [
|
|
147
|
+
{
|
|
148
|
+
"field": "assets.fallbackNeeded",
|
|
149
|
+
"operator": "equals",
|
|
150
|
+
"value": true
|
|
151
|
+
}
|
|
152
|
+
]
|
|
153
|
+
}
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
"target": "asset-library-plan",
|
|
157
|
+
"type": "progression",
|
|
158
|
+
"label": "Approved asset organization",
|
|
159
|
+
"when": {
|
|
160
|
+
"all": [
|
|
161
|
+
{
|
|
162
|
+
"field": "assets.discoveryComplete",
|
|
163
|
+
"operator": "equals",
|
|
164
|
+
"value": true
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"field": "stage.current",
|
|
168
|
+
"operator": "equals",
|
|
169
|
+
"value": "library_organization"
|
|
170
|
+
}
|
|
171
|
+
]
|
|
172
|
+
}
|
|
173
|
+
},
|
|
174
|
+
{
|
|
175
|
+
"target": "scene-readiness",
|
|
176
|
+
"type": "progression",
|
|
177
|
+
"label": "Broad scene review",
|
|
178
|
+
"when": {
|
|
179
|
+
"all": [
|
|
180
|
+
{
|
|
181
|
+
"field": "quality.domain",
|
|
182
|
+
"operator": "equals",
|
|
183
|
+
"value": "holistic"
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
"field": "stage.current",
|
|
187
|
+
"operator": "equals",
|
|
188
|
+
"value": "quality_validation"
|
|
189
|
+
}
|
|
190
|
+
]
|
|
191
|
+
}
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
"target": "lighting-material-plan",
|
|
195
|
+
"type": "progression",
|
|
196
|
+
"label": "Material & lookdev boundary (lighting-material-plan)",
|
|
197
|
+
"when": {
|
|
198
|
+
"all": [
|
|
199
|
+
{
|
|
200
|
+
"field": "brief.locked",
|
|
201
|
+
"operator": "equals",
|
|
202
|
+
"value": true
|
|
203
|
+
},
|
|
204
|
+
{
|
|
205
|
+
"field": "stage.current",
|
|
206
|
+
"operator": "equals",
|
|
207
|
+
"value": "lookdev_planning"
|
|
208
|
+
}
|
|
209
|
+
]
|
|
210
|
+
}
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
"target": "material-quality-checker",
|
|
214
|
+
"type": "progression",
|
|
215
|
+
"label": "Material & lookdev boundary (material-quality-checker)",
|
|
216
|
+
"when": {
|
|
217
|
+
"all": [
|
|
218
|
+
{
|
|
219
|
+
"field": "quality.domain",
|
|
220
|
+
"operator": "equals",
|
|
221
|
+
"value": "material"
|
|
222
|
+
},
|
|
223
|
+
{
|
|
224
|
+
"field": "quality.verdict",
|
|
225
|
+
"operator": "equals",
|
|
226
|
+
"value": "not_run"
|
|
227
|
+
}
|
|
228
|
+
]
|
|
229
|
+
}
|
|
230
|
+
},
|
|
231
|
+
{
|
|
232
|
+
"target": "polycount-budget-checker",
|
|
233
|
+
"type": "progression",
|
|
234
|
+
"label": "Budget & topology boundary",
|
|
235
|
+
"when": {
|
|
236
|
+
"all": [
|
|
237
|
+
{
|
|
238
|
+
"field": "quality.domain",
|
|
239
|
+
"operator": "equals",
|
|
240
|
+
"value": "polycount"
|
|
241
|
+
},
|
|
242
|
+
{
|
|
243
|
+
"field": "budget.verdict",
|
|
244
|
+
"operator": "equals",
|
|
245
|
+
"value": "Not Run"
|
|
246
|
+
}
|
|
247
|
+
]
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
]
|
|
251
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Drift classification
|
|
2
|
+
|
|
3
|
+
## When drift is OK
|
|
4
|
+
|
|
5
|
+
- Brief explicitly calls for mixed style.
|
|
6
|
+
- Subject vs background intentional contrast (focus play).
|
|
7
|
+
- Editorial / collage aesthetic.
|
|
8
|
+
|
|
9
|
+
## When drift is NOT OK
|
|
10
|
+
|
|
11
|
+
- Default product hero / portrait / arch viz: drift breaks visual hierarchy.
|
|
12
|
+
- Multi-product grid: drift breaks catalog uniformity.
|
|
13
|
+
- Branded marketing: drift dilutes brand consistency.
|
|
14
|
+
|
|
15
|
+
## Severity scale
|
|
16
|
+
|
|
17
|
+
| Severity | What it looks like | Action |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| None | Assets share all 4 axes | Continue |
|
|
20
|
+
| Minor | One axis slightly off | Note; usually accept |
|
|
21
|
+
| Major | Two axes off | Replace or restyle |
|
|
22
|
+
| Severe | 3+ axes off | Block; cannot mix |
|
|
23
|
+
|
|
24
|
+
## Top-line aggregation
|
|
25
|
+
|
|
26
|
+
- All assets None → Pass.
|
|
27
|
+
- One Minor → Warn.
|
|
28
|
+
- Any Major or Severe → Fail.
|
|
29
|
+
|
|
30
|
+
## Remediation options
|
|
31
|
+
|
|
32
|
+
1. **Replace**: find a different asset that fits.
|
|
33
|
+
2. **Restyle**: reauthor the asset to match (modeling work).
|
|
34
|
+
3. **Drop**: remove the asset from the scene.
|
|
35
|
+
4. **Reframe brief**: explicit decision to accept mixed style.
|
|
36
|
+
|
|
37
|
+
Most often: replace is best (cheapest, cleanest).
|
|
38
|
+
|
|
39
|
+
## Related skill
|
|
40
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Intentional mixed-style
|
|
2
|
+
|
|
3
|
+
When the brief explicitly calls for mixed style, the consistency check inverts: drift becomes feature, uniformity becomes risk.
|
|
4
|
+
|
|
5
|
+
## Common intentional-mixed cases
|
|
6
|
+
|
|
7
|
+
### Editorial collage
|
|
8
|
+
Subject realistic, background flat 2D, props cartoon. Each chosen for narrative contrast.
|
|
9
|
+
|
|
10
|
+
### Hybrid 2D + 3D
|
|
11
|
+
3D subject composited over 2D illustrated background. Style boundary is the design.
|
|
12
|
+
|
|
13
|
+
### Style frame transitions
|
|
14
|
+
Multiple panels / shots showing the same character in different styles.
|
|
15
|
+
|
|
16
|
+
### Mood-driven contrast
|
|
17
|
+
Subject high-detail to draw eye, surroundings deliberately simplified.
|
|
18
|
+
|
|
19
|
+
## What to verify when mixed-style is intentional
|
|
20
|
+
|
|
21
|
+
- The brief explicitly states the mixed-style intent.
|
|
22
|
+
- Each "style island" is internally consistent (e.g., the stylized props all match each other even if they don't match the subject).
|
|
23
|
+
- Visual hierarchy still works (subject reads first).
|
|
24
|
+
- The mix is repeatable across the deliverable (not random).
|
|
25
|
+
|
|
26
|
+
## Common mistakes in "intentional mixed-style"
|
|
27
|
+
|
|
28
|
+
- "It's intentional" used as escape hatch for actually-broken assets.
|
|
29
|
+
- No internal consistency within style islands.
|
|
30
|
+
- Visual hierarchy lost (eye does not know where to land).
|
|
31
|
+
- Mix changes mid-deliverable (frame 1 has different mix than frame 2).
|
|
32
|
+
|
|
33
|
+
## Verdict in mixed-style case
|
|
34
|
+
|
|
35
|
+
- If brief is explicit + style islands consistent + hierarchy works → Pass even with axis-level drift.
|
|
36
|
+
- If brief is vague + drift is just there → Fail; not actually intentional.
|
|
37
|
+
|
|
38
|
+
## Related skill
|
|
39
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Style axes
|
|
2
|
+
|
|
3
|
+
## 4 axes
|
|
4
|
+
|
|
5
|
+
### 1. Realism
|
|
6
|
+
- Photorealistic ↔ stylized ↔ flat / cartoon
|
|
7
|
+
- Determine from materials, proportions, surface complexity.
|
|
8
|
+
|
|
9
|
+
### 2. Detail density
|
|
10
|
+
- High (PBR + micro-detail + small props)
|
|
11
|
+
- Medium (clear surfaces, fewer extras)
|
|
12
|
+
- Low (simplified shapes, large color blocks)
|
|
13
|
+
|
|
14
|
+
### 3. Color treatment
|
|
15
|
+
- Natural (real-world hues, daylight)
|
|
16
|
+
- Graded (cinematic / brand color grade applied)
|
|
17
|
+
- Stylized palette (limited / saturated)
|
|
18
|
+
|
|
19
|
+
### 4. Surface complexity
|
|
20
|
+
- Realistic (full PBR, accurate roughness / metallic / normal)
|
|
21
|
+
- Painterly (hand-feel; stylized brush strokes)
|
|
22
|
+
- Flat (uniform color blocks; minimal shading)
|
|
23
|
+
|
|
24
|
+
## Per-asset evaluation
|
|
25
|
+
|
|
26
|
+
For each asset, position it on each axis. Use ranges if uncertain (e.g., "medium-low detail").
|
|
27
|
+
|
|
28
|
+
## Brief baseline
|
|
29
|
+
|
|
30
|
+
Read the brief style. Position the brief on each axis. Each asset must fall within the brief's tolerance per axis.
|
|
31
|
+
|
|
32
|
+
## Drift severity
|
|
33
|
+
|
|
34
|
+
- 0 axes off → None
|
|
35
|
+
- 1 axis off → Minor
|
|
36
|
+
- 2 axes off → Major
|
|
37
|
+
- 3+ axes off → Severe (treat as Fail)
|
|
38
|
+
|
|
39
|
+
## Common mismatches
|
|
40
|
+
|
|
41
|
+
- Realistic subject + stylized prop → Major drift on realism + surface.
|
|
42
|
+
- High-detail subject + low-detail background → Major if subject is centered; Minor if intentional depth-of-field.
|
|
43
|
+
- Saturated palette asset in muted-palette scene → Minor or Major depending on how prominent.
|
|
44
|
+
|
|
45
|
+
## Related skill
|
|
46
|
+
`../SKILL.md`
|