blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "runtime-setup",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "runtime-and-execution",
|
|
6
|
+
"role": "path-1-and-2-setup-instructor",
|
|
7
|
+
"purpose": "Establish official runtime prerequisites and setup boundaries before any Blender execution claim.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"set up Blender runtime prerequisites",
|
|
11
|
+
"what are the Blender runtime setup boundaries",
|
|
12
|
+
"prepare Official Blender Lab MCP setup prerequisites",
|
|
13
|
+
"runtime prerequisites and version minimums"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "to install or configure a runtime automatically",
|
|
18
|
+
"delegateTo": "runtime-path-picker",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to runtime-path-picker"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "to claim runtime execution has already succeeded",
|
|
23
|
+
"delegateTo": "path-one-host-outline",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to path-one-host-outline"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "to choose a runtime path",
|
|
28
|
+
"delegateTo": "runtime-readiness",
|
|
29
|
+
"reason": "runtime-readiness"
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"inputs": {
|
|
33
|
+
"required": [
|
|
34
|
+
{
|
|
35
|
+
"name": "selected_runtime_path",
|
|
36
|
+
"type": "string",
|
|
37
|
+
"description": "Chosen execution path from runtime-path-picker (Path 1 Lab MCP, Path 2 mcp-for-blender, or CLI appendix)"
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "host_client_environment",
|
|
41
|
+
"type": "string",
|
|
42
|
+
"description": "User MCP host application (Claude Desktop Connector, Claude Code, Cursor, Windsurf, or manual client)"
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"optional": [
|
|
46
|
+
{
|
|
47
|
+
"name": "installed_blender_version",
|
|
48
|
+
"type": "string",
|
|
49
|
+
"description": "Installed Blender version used to check the Blender 5.1+ floor for Path 1 vs 3.0+ for Path 2"
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
"outputs": {
|
|
54
|
+
"primary": [
|
|
55
|
+
"step_by_step_setup_prerequisites",
|
|
56
|
+
"path_version_and_host_boundary_notes",
|
|
57
|
+
"readiness_verification_handoff"
|
|
58
|
+
],
|
|
59
|
+
"truthStatePolicy": {
|
|
60
|
+
"runtimeDefault": "Not Run",
|
|
61
|
+
"artifactDefault": "Not Produced",
|
|
62
|
+
"mutationRule": "downgrade_only"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"handoffs": [
|
|
66
|
+
{
|
|
67
|
+
"target": "runtime-path-picker",
|
|
68
|
+
"type": "upstream_reference",
|
|
69
|
+
"label": "Path selection",
|
|
70
|
+
"when": {
|
|
71
|
+
"all": [
|
|
72
|
+
{
|
|
73
|
+
"field": "runtime.path",
|
|
74
|
+
"operator": "equals",
|
|
75
|
+
"value": "unselected"
|
|
76
|
+
}
|
|
77
|
+
]
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"target": "path-one-host-outline",
|
|
82
|
+
"type": "progression",
|
|
83
|
+
"label": "Path 1 host (a)/(b) details",
|
|
84
|
+
"when": {
|
|
85
|
+
"all": [
|
|
86
|
+
{
|
|
87
|
+
"field": "runtime.path",
|
|
88
|
+
"operator": "equals",
|
|
89
|
+
"value": "path_1"
|
|
90
|
+
},
|
|
91
|
+
{
|
|
92
|
+
"field": "stage.current",
|
|
93
|
+
"operator": "equals",
|
|
94
|
+
"value": "runtime_setup"
|
|
95
|
+
}
|
|
96
|
+
]
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
"target": "cli-appendix-job-outline",
|
|
101
|
+
"type": "progression",
|
|
102
|
+
"label": "CLI appendix job structure",
|
|
103
|
+
"when": {
|
|
104
|
+
"all": [
|
|
105
|
+
{
|
|
106
|
+
"field": "runtime.path",
|
|
107
|
+
"operator": "equals",
|
|
108
|
+
"value": "cli_appendix"
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"field": "request.topic",
|
|
112
|
+
"operator": "equals",
|
|
113
|
+
"value": "cli_batch"
|
|
114
|
+
}
|
|
115
|
+
]
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
"target": "bridge-conflicts",
|
|
120
|
+
"type": "fallback",
|
|
121
|
+
"label": "Bridge conflict resolution",
|
|
122
|
+
"when": {
|
|
123
|
+
"all": [
|
|
124
|
+
{
|
|
125
|
+
"field": "runtime.conflictDetected",
|
|
126
|
+
"operator": "equals",
|
|
127
|
+
"value": true
|
|
128
|
+
}
|
|
129
|
+
]
|
|
130
|
+
}
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
"target": "runtime-readiness",
|
|
134
|
+
"type": "progression",
|
|
135
|
+
"label": "Readiness matrix check",
|
|
136
|
+
"when": {
|
|
137
|
+
"all": [
|
|
138
|
+
{
|
|
139
|
+
"field": "runtime.path",
|
|
140
|
+
"operator": "not_equals",
|
|
141
|
+
"value": "unselected"
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"field": "runtime.verifiedReady",
|
|
145
|
+
"operator": "equals",
|
|
146
|
+
"value": false
|
|
147
|
+
}
|
|
148
|
+
]
|
|
149
|
+
}
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"target": "product-hero-scene-planner",
|
|
153
|
+
"type": "alternative",
|
|
154
|
+
"label": "Scene planning after readiness",
|
|
155
|
+
"when": {
|
|
156
|
+
"all": [
|
|
157
|
+
{
|
|
158
|
+
"field": "brief.locked",
|
|
159
|
+
"operator": "equals",
|
|
160
|
+
"value": true
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"field": "recipe.domain",
|
|
164
|
+
"operator": "equals",
|
|
165
|
+
"value": "product_hero"
|
|
166
|
+
}
|
|
167
|
+
]
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
]
|
|
171
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Runtime Option Decision Tree
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Establish prerequisite boundaries and select the lowest-risk runtime posture before any execution claim.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
At the start of any task that may touch Blender — before claiming readiness, recommending a bridge, or scheduling writes.
|
|
8
|
+
|
|
9
|
+
## Decision tree
|
|
10
|
+
1. **Pure planning / brief / web-code handoff only?**
|
|
11
|
+
- Stay planning-only (`Runtime status: Not Run`, `Artifact status: Not Produced`). Do not invent runtime setup work the user did not ask for.
|
|
12
|
+
2. **Claude Desktop / Claude.ai UI with Path 1 Connector?**
|
|
13
|
+
- State Path 1 prerequisites explicitly: **Blender 5.1+ + Blender Lab MCP add-on inside Blender** PLUS Connector linkage (never describe Connector as standalone).
|
|
14
|
+
3. **IDE / CLI coding agent (Claude Code, Cursor, Codex, OpenCode, Windsurf, Cline, Zed, etc.)?**
|
|
15
|
+
- Recommend project-local BlendOps install + Path 1 host `(b)` manual MCP client (Blender 5.1+ Lab MCP) OR Path 2 `mcp-for-blender` (`3.0+`, community caveats) — never enable both simultaneously.
|
|
16
|
+
4. **Uncertain host support or unverified native config path?**
|
|
17
|
+
- Fall back cleanly to `generic-root` adapter guidance with honest `linked-only` confidence label (`docs/adapter-registry.md`).
|
|
18
|
+
5. **Runtime execution requested before probes ran?**
|
|
19
|
+
- Hand off to `runtime-path-picker` → `runtime-readiness` first; never assume readiness from installed config files alone.
|
|
20
|
+
|
|
21
|
+
## Good example
|
|
22
|
+
"Target client Cursor uses project-local install; Path 1 host `(b)` selected conditional on Blender 5.1+ + Lab MCP add-on enabled. Runtime readiness not verified yet (`Runtime status: Not Run`)."
|
|
23
|
+
|
|
24
|
+
## Bad example
|
|
25
|
+
"Installed Connector config, so Blender 5.1 runtime is ready to render." (Unverified premise + false readiness claim.)
|
|
26
|
+
|
|
27
|
+
## Related skill
|
|
28
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Setup Summary Template
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Standardize the final summary emitted by `runtime-setup` so non-Blender users see which path was chosen, what is verified on disk vs. linked-only, and one exact next step — without mixing up canonical truth states.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- At the conclusion of `runtime-setup` or whenever updating setup posture after checking a user's MCP host config.
|
|
8
|
+
|
|
9
|
+
## Canonical Output Template
|
|
10
|
+
```txt
|
|
11
|
+
Selected runtime path: <Path 1 (Lab MCP: Host a Connector / Host b Manual) | Path 2 (Community mcp-for-blender) | CLI Fallback (blender --background --python)>
|
|
12
|
+
Blender version floor: <5.1+ for Path 1 | 3.0+ for Path 2 | Upstream CLI surface>
|
|
13
|
+
Source confidence: <verified-read | linked-only | mixed>
|
|
14
|
+
|
|
15
|
+
What is verified locally (observed in this pass):
|
|
16
|
+
- <e.g. docs/install/cursor.md read; no conflicting Path 2 bridge found in workspace config>
|
|
17
|
+
|
|
18
|
+
What remains unverified / linked-only:
|
|
19
|
+
- <e.g. Blender executable version not yet checked on host; Lab MCP add-on toggle inside Blender UI pending user click>
|
|
20
|
+
|
|
21
|
+
Required single next step:
|
|
22
|
+
- <e.g. Install + enable Blender Lab MCP add-on inside Blender Preferences, then run a read-only connection check>
|
|
23
|
+
|
|
24
|
+
Runtime status: <Not Run | Attempted | Produced | Verified | Failed>
|
|
25
|
+
Artifact status: <Not Produced | Produced | Verified | Failed>
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Good vs. Bad Rules
|
|
29
|
+
- **Good**: Uses only the 5 canonical runtime truth states (`Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`) and marks `Artifact status: Not Produced` during setup.
|
|
30
|
+
- **Bad**: Claims `"Setup complete, Blender ready to render!"` when no Blender process or MCP handshake was actually observed.
|
|
31
|
+
|
|
32
|
+
## Related skill
|
|
33
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Source Confidence Labels
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Standardize provenance confidence labels whenever `runtime-setup` or install skills cite upstream Blender, Anthropic Connector, `mcp-for-blender`, or IDE skill-path documentation.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- Whenever citing external setup guides, MCP client configuration schemas, or target native skill paths (`docs/install/*.md`, `docs/adapter-registry.md`).
|
|
8
|
+
|
|
9
|
+
## Canonical Confidence Tiers
|
|
10
|
+
|
|
11
|
+
| Label | Exact Meaning | Allowed Action in BlendOps | Required Reason Format |
|
|
12
|
+
|---|---|---|---|
|
|
13
|
+
| `verified-read` | Source documentation or target config behavior was **directly inspected and verified** in this repository (`claude-code`, `generic-project`, Path 1 Lab MCP docs) | Safe to describe behavior directly; native fallback or verified target path allowed | Cite exact verified doc/path read (`verified-read: inspected docs/install/claude-code.md and verified CLAUDE.md + BLENDOPS.md behavior`) |
|
|
14
|
+
| `linked-only` | Official URL or community doc link is cataloged and reachable-by-reference, **but live target skill autoloader or client build was not empirically tested in this run** (`cursor`, `windsurf`, `zed`, etc.) | Default to safe project-local `BLENDOPS.md` unless user explicitly passes `--confirm-target-path` or `--with-skills-dir` | State URL + explicit unverified native caveat (`linked-only: official Cursor MCP docs cited; native .cursor/rules/ loader not empirically executed here`) |
|
|
15
|
+
| `mixed` | Base repo docs are `verified-read`, while a specific client plugin flag or OS binary version remains `linked-only` | Clearly split verified core steps from unverified host-specific steps | Bullet verified part separately from unverified host part |
|
|
16
|
+
| `unknown` | No authoritative doc, URL, or observed local command exists for the requested client or runtime bridge | **Fail closed** — stop setup instructions and ask user or point to `generic-project` fallback | State missing evidence explicitly (`unknown: no verified MCP config spec found for target X`) |
|
|
17
|
+
|
|
18
|
+
## Good vs. Bad Usage
|
|
19
|
+
- **Good**: `"linked-only: official Zed MCP context_servers URL cited in docs/install/zed.md; Zed native skill loader unverified, so BLENDOPS.md fallback is active."`
|
|
20
|
+
- **Bad**: `"Probably supported in all IDEs"` (omits confidence tier and blurs verified facts with assumptions).
|
|
21
|
+
|
|
22
|
+
## Related skill
|
|
23
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — scene-readiness
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use scene-readiness to score a planned hero scene with pass/warn/fail and final verdict.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- category rubric
|
|
8
|
+
- blockers/caveats
|
|
9
|
+
- verdict: Ready/Conditionally Ready/Not Ready/Not Run
|
|
10
|
+
|
|
11
|
+
## Pass / Warn / Fail criteria
|
|
12
|
+
- Pass: full rubric + evidence-aligned verdict
|
|
13
|
+
- Warn: partial rubric with explicit caveat
|
|
14
|
+
- Fail: verdict without rubric/evidence
|
|
15
|
+
|
|
16
|
+
## Common failure modes
|
|
17
|
+
- claiming Ready without artifacts
|
|
18
|
+
- missing blocker explanation
|
|
19
|
+
|
|
20
|
+
## Evidence expectations
|
|
21
|
+
- mode label
|
|
22
|
+
- artifact status language
|
|
23
|
+
- rationale for verdict
|
|
24
|
+
|
|
25
|
+
## Sample passing response outline
|
|
26
|
+
- Scope and mode stated clearly
|
|
27
|
+
- Evidence expectations listed
|
|
28
|
+
- Pass/warn/fail reasoning tied to checks
|
|
29
|
+
|
|
30
|
+
## Sample failing response outline
|
|
31
|
+
- Overclaims runtime/artifact success
|
|
32
|
+
- Missing caveats or blocker details
|
|
33
|
+
- No clear next action
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: scene-readiness
|
|
3
|
+
description: Run multi-category scene readiness gates (mesh, UVs, PBR, bake caches, camera, silhouette match) with PASS/WARN/FAIL verdicts before export.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# scene-readiness
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Evaluate scene/workflow readiness honestly and consistently before any success claim.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm this skill fits your goal
|
|
13
|
+
- provide required inputs first
|
|
14
|
+
- keep runtime claims evidence-bound
|
|
15
|
+
- follow suggested next-skill handoff
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- before readiness, export, or handoff claims to get a broad multi-category review
|
|
19
|
+
- after planning passes or after focused domain checkers have run
|
|
20
|
+
- during text-only or runtime evaluation reporting
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- as a replacement for evidence collection → use `../product-hero-scene-planner/SKILL.md` (Delegates out-of-scope requests to product-hero-scene-planner)
|
|
25
|
+
- to fabricate confidence in missing artifacts → use `../lighting-material-plan/SKILL.md` (Delegates out-of-scope requests to lighting-material-plan)
|
|
26
|
+
<!-- blendops:generated:end exclusions -->
|
|
27
|
+
|
|
28
|
+
## Trigger phrases
|
|
29
|
+
<!-- blendops:generated:start triggers -->
|
|
30
|
+
- "quality-check this scene"
|
|
31
|
+
- "is this ready"
|
|
32
|
+
- "evaluate pass warn fail"
|
|
33
|
+
<!-- blendops:generated:end triggers -->
|
|
34
|
+
|
|
35
|
+
## Prerequisites / readiness
|
|
36
|
+
- plan output and acceptance criteria set available (e.g., from `acceptance-criteria-builder`)
|
|
37
|
+
- runtime truth state known (`Not Run | Attempted | Produced | Verified | Failed`; stays `Not Run` unless a real attempt was recorded)
|
|
38
|
+
- artifact truth state known (`Not Run | Not Produced | Produced | Verified | Failed`; defaults to `Not Produced` unless concrete output evidence exists)
|
|
39
|
+
- optional outputs from focused checkers (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`) and `render-export-evidence`
|
|
40
|
+
|
|
41
|
+
## Input schema
|
|
42
|
+
|
|
43
|
+
### Required inputs
|
|
44
|
+
- scene plan summary
|
|
45
|
+
- intended output criteria
|
|
46
|
+
- current runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`)
|
|
47
|
+
- current artifact truth state ledger (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`)
|
|
48
|
+
|
|
49
|
+
### Optional inputs
|
|
50
|
+
- focused domain reports from `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `polycount-budget-checker`
|
|
51
|
+
- artifact evidence classification from `render-export-evidence`
|
|
52
|
+
- target quality threshold and destination-specific constraints
|
|
53
|
+
|
|
54
|
+
### Assumptions to confirm
|
|
55
|
+
- whether a real runtime attempt was recorded (otherwise runtime stays `Not Run`)
|
|
56
|
+
- whether artifacts have verified provenance to the current run vs. being pre-existing files
|
|
57
|
+
|
|
58
|
+
## Output schema
|
|
59
|
+
|
|
60
|
+
### Primary output
|
|
61
|
+
- category-level pass/warn/fail matrix
|
|
62
|
+
|
|
63
|
+
### Secondary output
|
|
64
|
+
- overall readiness verdict (`Ready | Conditionally Ready | Not Ready`, or `Not Run` when no runtime attempt happened) kept strictly separate from runtime/artifact truth states
|
|
65
|
+
- consolidated blockers and remediation steps traced from category scores
|
|
66
|
+
|
|
67
|
+
### Evidence / caveat output
|
|
68
|
+
- downgrade-only runtime and artifact truth-state ledger (with provenance noted for any pre-existing files)
|
|
69
|
+
- explicit caveats, unknowns, and plain-language user impact
|
|
70
|
+
|
|
71
|
+
## Required laws
|
|
72
|
+
- ../../laws/evidence-before-done.md
|
|
73
|
+
- ../../laws/non-blender-user-language.md
|
|
74
|
+
- ../../laws/official-runtime-only.md
|
|
75
|
+
- ../../laws/no-arbitrary-python-interface.md
|
|
76
|
+
|
|
77
|
+
## Official runtime boundary
|
|
78
|
+
Review-only skill: never executes Blender, never runs or emits Python, and never produces artifacts. Runtime truth state stays `Not Run` unless a real attempt was recorded; artifact truth state defaults to `Not Produced` unless concrete output evidence from the current run exists. Truth states are downgrade-only (never upgrade). Text-only and blocked modes must remain explicit.
|
|
79
|
+
|
|
80
|
+
## Operating procedure
|
|
81
|
+
1. Confirm run mode, runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`), and artifact truth state (`Not Run | Not Produced | Produced | Verified | Failed`), verifying provenance to the current run for any existing files.
|
|
82
|
+
2. Score **Subject clarity** against brief/plan intent.
|
|
83
|
+
3. Score **Composition/camera** readiness (consume `composition-quality-checker` output if available; do not redo deep domain validation).
|
|
84
|
+
4. Score **Lighting/material** readiness (consume `lighting-quality-checker` and `material-quality-checker` outputs if available; do not redo deep domain validation).
|
|
85
|
+
5. Score **Scale, transforms, and geometry budget** readiness (consume `polycount-budget-checker` output if available).
|
|
86
|
+
6. Score **Evidence and export readiness** (consume `render-export-evidence` classification if available; verify readiness for `pre-handoff-verification` and `glb-web-handoff` without taking over their roles).
|
|
87
|
+
7. Assign independent Pass / Warn / Fail scores per category and trace how each contributes to the final outcome.
|
|
88
|
+
8. Apply downgrade-only rules to truth states if gaps or missing provenance are found.
|
|
89
|
+
9. Produce the final readiness verdict (`Ready | Conditionally Ready | Not Ready`, or `Not Run` when no runtime attempt happened), keeping the verdict scale separate from runtime and artifact truth states.
|
|
90
|
+
|
|
91
|
+
## Decision tree
|
|
92
|
+
- If no runtime attempt happened → Runtime truth state stays `Not Run`, artifacts stay `Not Produced`, and readiness verdict is `Not Run` or `Conditionally Ready` (never `Ready`).
|
|
93
|
+
- If any critical category scores Fail or claims contradict evidence → Readiness verdict is `Not Ready`.
|
|
94
|
+
- If all critical categories Pass, runtime/artifact evidence is `Verified` for the current run, and no blockers remain → Readiness verdict is `Ready`.
|
|
95
|
+
- If critical categories Pass with minor warnings, or planning is complete while runtime/artifacts are unverified → Readiness verdict is `Conditionally Ready`.
|
|
96
|
+
|
|
97
|
+
## Playbooks
|
|
98
|
+
- Playbook A: text-only planning path
|
|
99
|
+
- Playbook B: runtime-ready path with evidence gating
|
|
100
|
+
- Playbook C: blocked runtime path with caveat-first reporting
|
|
101
|
+
|
|
102
|
+
## Mode handling
|
|
103
|
+
|
|
104
|
+
### Text-only mode
|
|
105
|
+
- evaluate planning quality across categories only
|
|
106
|
+
- keep runtime truth state at `Not Run` and artifact truth states at `Not Produced`
|
|
107
|
+
- cap readiness verdict at `Conditionally Ready` or `Not Run` (never `Ready`)
|
|
108
|
+
|
|
109
|
+
### Runtime-ready mode
|
|
110
|
+
- consume artifact classifications from `render-export-evidence` and domain checks from focused quality checkers
|
|
111
|
+
- require current-run provenance before accepting `Produced` or `Verified` artifact states
|
|
112
|
+
|
|
113
|
+
### Blocked runtime mode
|
|
114
|
+
- keep readiness verdict conservative (`Not Ready`, `Conditionally Ready`, or `Not Run`)
|
|
115
|
+
- preserve exact runtime/artifact truth states (downgrade-only) and list blockers and next actions
|
|
116
|
+
|
|
117
|
+
## Validation checklist
|
|
118
|
+
- [ ] run mode explicitly labeled
|
|
119
|
+
- [ ] runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`) and artifact truth state (`Not Run | Not Produced | Produced | Verified | Failed`) recorded separately from the readiness verdict
|
|
120
|
+
- [ ] truth states are downgrade-only (never upgraded) and pre-existing files require current-run provenance
|
|
121
|
+
- [ ] category rubric scored independently with clear traceability to the final verdict
|
|
122
|
+
- [ ] focused checker outputs consumed without redoing their domain work
|
|
123
|
+
- [ ] blocker list complete and caveats include plain-language user impact
|
|
124
|
+
- [ ] final readiness verdict (`Ready | Conditionally Ready | Not Ready | Not Run`) justified without unsupported success claims
|
|
125
|
+
- [ ] no uncaveated Path 2 guidance; CLI appendix never treated as a peer path
|
|
126
|
+
- [ ] plain-language summary and next-skill handoffs provided
|
|
127
|
+
|
|
128
|
+
## Pass / Warn / Fail rubric
|
|
129
|
+
|
|
130
|
+
| Category | Pass | Warn | Fail |
|
|
131
|
+
|---|---|---|---|
|
|
132
|
+
| Subject clarity | Clear focal hierarchy aligned with brief | Minor ambiguity in secondary elements | Unclear focal subject or intent mismatch |
|
|
133
|
+
| Composition/camera | Coherent framing; passes `composition-quality-checker` if run | Minor framing gaps; needs review | Framing fails user goal or missing camera plan |
|
|
134
|
+
| Lighting/material | Supports intent; passes `lighting-quality-checker` / `material-quality-checker` if run | Minor tuning needed or focused checks pending | Major lookdev mismatch or broken shading/lighting plan |
|
|
135
|
+
| Scale/geometry budget | Real-world scale, clean transforms, passes `polycount-budget-checker` if run | Unconfirmed transforms or near budget limit | Wrong scale, unapplied transforms, or over budget |
|
|
136
|
+
| Evidence & handoff readiness | Claims match `render-export-evidence` with current-run provenance | Partial evidence or pre-handoff checks pending | Claims contradict evidence, or pre-existing files claimed as new |
|
|
137
|
+
|
|
138
|
+
## Failure handling
|
|
139
|
+
- Missing runtime attempt or evidence: keep runtime truth state `Not Run`, keep artifact truth state `Not Produced` (downgrade-only, never upgrade), and cap readiness verdict at `Conditionally Ready` or `Not Run`.
|
|
140
|
+
- Critical category Fail: set readiness verdict to `Not Ready` with traced remediation steps.
|
|
141
|
+
- Unverified or pre-existing files without current-run provenance: refuse `Produced`/`Verified` attribution for this run and log a Warn/Fail caveat.
|
|
142
|
+
- Unknowns in domain specifics: log Warn with explicit caveat and recommend the appropriate focused checker (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, or `polycount-budget-checker`).
|
|
143
|
+
|
|
144
|
+
## Troubleshooting
|
|
145
|
+
- If all categories pass but no artifacts exist: ensure verdict is not Ready.
|
|
146
|
+
- If pre-existing files found: do not attribute to current run without linkage.
|
|
147
|
+
- If plan quality high but runtime blocked: use Conditionally Ready or Not Run.
|
|
148
|
+
|
|
149
|
+
## Best practices
|
|
150
|
+
- score categories independently before final verdict
|
|
151
|
+
- keep caveats visible in final summary
|
|
152
|
+
- preserve traceability from category score to verdict
|
|
153
|
+
|
|
154
|
+
## Good examples
|
|
155
|
+
"Readiness Verdict: Conditionally Ready. All planning categories pass, but Runtime Truth State is `Not Run` and Artifact Truth State is `Not Produced` for this pass."
|
|
156
|
+
|
|
157
|
+
## Bad examples
|
|
158
|
+
“Looks good overall, ship it.” (no rubric, no evidence mapping)
|
|
159
|
+
|
|
160
|
+
## User-facing response template
|
|
161
|
+
- Current status
|
|
162
|
+
- What passed
|
|
163
|
+
- What needs follow-up
|
|
164
|
+
- Next best action
|
|
165
|
+
|
|
166
|
+
## Anti-patterns
|
|
167
|
+
- conflating the readiness verdict scale (`Ready | Conditionally Ready | Not Ready | Not Run`) with runtime or artifact truth states
|
|
168
|
+
- upgrading runtime or artifact truth states, or attributing pre-existing files to the current run without provenance
|
|
169
|
+
- redoing deep per-domain validation instead of consuming `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, or `polycount-budget-checker`
|
|
170
|
+
- usurping artifact classification from `render-export-evidence`, gate ownership from `pre-handoff-verification`, or web packaging from `glb-web-handoff`
|
|
171
|
+
- skipping required laws, using Path 2 without caveats, treating CLI fallback as a peer path, or emitting jargon/Python
|
|
172
|
+
|
|
173
|
+
## Cross-skill handoff
|
|
174
|
+
<!-- blendops:generated:start handoffs -->
|
|
175
|
+
- [upstream_reference] Focused domain validation (if gaps found) (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
|
|
176
|
+
- [upstream_reference] Focused domain validation (if gaps found) (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
|
|
177
|
+
- [upstream_reference] Focused domain validation (if gaps found) (material-quality-checker) → `../material-quality-checker/SKILL.md`
|
|
178
|
+
- [upstream_reference] Focused domain validation (if gaps found) (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
|
|
179
|
+
- [progression] Evidence classification → `../render-export-evidence/SKILL.md`
|
|
180
|
+
- [progression] Handoff gate → `../pre-handoff-verification/SKILL.md`
|
|
181
|
+
- [conditional] Web delivery (when applicable) → `../glb-web-handoff/SKILL.md`
|
|
182
|
+
- [progression] Final communication → `../plain-language-response/SKILL.md`
|
|
183
|
+
<!-- blendops:generated:end handoffs -->
|
|
184
|
+
|
|
185
|
+
## Non-goals
|
|
186
|
+
- executing Blender or running/generating Python code
|
|
187
|
+
- producing or classifying raw render/export artifacts (owned by `render-export-evidence`)
|
|
188
|
+
- replacing focused domain validators (`material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`)
|
|
189
|
+
- owning final handoff gating (`pre-handoff-verification`) or web handoff packaging (`glb-web-handoff`)
|
|
190
|
+
- making evidence-free readiness claims
|
|
191
|
+
|
|
192
|
+
## References
|
|
193
|
+
- https://www.blender.org/lab/mcp-server/
|
|
194
|
+
- https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
195
|
+
- https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|