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,191 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "runtime-path-picker",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "runtime-and-execution",
|
|
6
|
+
"role": "execution-path-selector",
|
|
7
|
+
"purpose": "Choose Path 1 Lab MCP, Path 2 mcp-for-blender bridge, or CLI appendix from constraints; Connector hosts Path 1 only with Lab add-on inside Blender.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"which MCP should I use",
|
|
11
|
+
"Lab MCP or mcp-for-blender",
|
|
12
|
+
"Path 1 or Path 2",
|
|
13
|
+
"CLI vs MCP"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "prerequisite framing or install steps",
|
|
18
|
+
"delegateTo": "runtime-setup",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to runtime-setup"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "running the readiness matrix",
|
|
23
|
+
"delegateTo": "runtime-readiness",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to runtime-readiness"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "detailing Path 1 host (a) Connector vs (b) manual MCP client",
|
|
28
|
+
"delegateTo": "path-one-host-outline",
|
|
29
|
+
"reason": "Delegates out-of-scope requests to path-one-host-outline"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "outlining headless CLI jobs",
|
|
33
|
+
"delegateTo": "cli-appendix-job-outline",
|
|
34
|
+
"reason": "Delegates out-of-scope requests to cli-appendix-job-outline"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "resolving active bridge or port collisions",
|
|
38
|
+
"delegateTo": "bridge-conflicts",
|
|
39
|
+
"reason": "Delegates out-of-scope requests to bridge-conflicts"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "halting on contradictory constraints before handoff",
|
|
43
|
+
"delegateTo": "pre-handoff-verification",
|
|
44
|
+
"reason": "Delegates out-of-scope requests to pre-handoff-verification"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "blender_version_posture",
|
|
51
|
+
"type": "string",
|
|
52
|
+
"description": "Installed or available Blender version (e.g., 5.1+, 4.2 LTS, 3.6 LTS, or unknown)"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "host_environment_category",
|
|
56
|
+
"type": "string",
|
|
57
|
+
"description": "Available MCP client host (Claude Desktop Connector, manual MCP IDE client, or headless CI)"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "organizational_policy_constraints",
|
|
63
|
+
"type": "string",
|
|
64
|
+
"description": "Optional security or IT constraints restricting third-party add-ons or interactive GUI sessions"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"single_recommended_runtime_path",
|
|
71
|
+
"rejected_paths_comparison_table",
|
|
72
|
+
"path_specific_caveat_and_next_skill"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "runtime-setup",
|
|
83
|
+
"type": "progression",
|
|
84
|
+
"label": "Prerequisite framing",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "runtime.path",
|
|
89
|
+
"operator": "not_equals",
|
|
90
|
+
"value": "unselected"
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"field": "stage.current",
|
|
94
|
+
"operator": "equals",
|
|
95
|
+
"value": "runtime_setup"
|
|
96
|
+
}
|
|
97
|
+
]
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"target": "runtime-readiness",
|
|
102
|
+
"type": "progression",
|
|
103
|
+
"label": "Readiness matrix check",
|
|
104
|
+
"when": {
|
|
105
|
+
"all": [
|
|
106
|
+
{
|
|
107
|
+
"field": "runtime.path",
|
|
108
|
+
"operator": "not_equals",
|
|
109
|
+
"value": "unselected"
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
"field": "runtime.verifiedReady",
|
|
113
|
+
"operator": "equals",
|
|
114
|
+
"value": false
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
}
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"target": "path-one-host-outline",
|
|
121
|
+
"type": "progression",
|
|
122
|
+
"label": "Host (a)/(b) specifics for Path 1",
|
|
123
|
+
"when": {
|
|
124
|
+
"all": [
|
|
125
|
+
{
|
|
126
|
+
"field": "runtime.path",
|
|
127
|
+
"operator": "equals",
|
|
128
|
+
"value": "path_1"
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"field": "stage.current",
|
|
132
|
+
"operator": "equals",
|
|
133
|
+
"value": "runtime_setup"
|
|
134
|
+
}
|
|
135
|
+
]
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
"target": "cli-appendix-job-outline",
|
|
140
|
+
"type": "progression",
|
|
141
|
+
"label": "Headless CLI appendix job outline",
|
|
142
|
+
"when": {
|
|
143
|
+
"all": [
|
|
144
|
+
{
|
|
145
|
+
"field": "runtime.path",
|
|
146
|
+
"operator": "equals",
|
|
147
|
+
"value": "cli_appendix"
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
"field": "request.topic",
|
|
151
|
+
"operator": "equals",
|
|
152
|
+
"value": "cli_batch"
|
|
153
|
+
}
|
|
154
|
+
]
|
|
155
|
+
}
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
"target": "bridge-conflicts",
|
|
159
|
+
"type": "fallback",
|
|
160
|
+
"label": "Bridge or port 9876 conflicts",
|
|
161
|
+
"when": {
|
|
162
|
+
"all": [
|
|
163
|
+
{
|
|
164
|
+
"field": "runtime.conflictDetected",
|
|
165
|
+
"operator": "equals",
|
|
166
|
+
"value": true
|
|
167
|
+
}
|
|
168
|
+
]
|
|
169
|
+
}
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"target": "pre-handoff-verification",
|
|
173
|
+
"type": "fallback",
|
|
174
|
+
"label": "Contradictory constraints failure exit",
|
|
175
|
+
"when": {
|
|
176
|
+
"any": [
|
|
177
|
+
{
|
|
178
|
+
"field": "gate.status",
|
|
179
|
+
"operator": "equals",
|
|
180
|
+
"value": "failed"
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
"field": "runtime.mode",
|
|
184
|
+
"operator": "equals",
|
|
185
|
+
"value": "blocked"
|
|
186
|
+
}
|
|
187
|
+
]
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
]
|
|
191
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Anti-Patterns — Runtime Path Selection
|
|
2
|
+
|
|
3
|
+
Stop immediately and correct course if any of these appear in a plan or reply:
|
|
4
|
+
|
|
5
|
+
| Anti-pattern | Why it breaks | Required correction |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| **Standalone Connector myth** | Anthropic's official setup explicitly requires installing the Blender Lab MCP add-on inside Blender before the Connector works. | Present Connector strictly as Path 1 host option `(a)` alongside the Lab add-on prerequisite. |
|
|
8
|
+
| **Path 1 version bleed (`5.1+` everywhere)** | The `5.1.0` floor comes from the Lab add-on manifest only. Claiming Path 2 or `blender --background` needs 5.1+ misleads Blender 3.x/4.x users. | Scope `Blender 5.1+` strictly to Path 1; keep Path 2 at `3.0+` and CLI version-matched. |
|
|
9
|
+
| **Dual active bridges on one Blender instance** | Binding Path 1 Lab MCP and Path 2 `mcp-for-blender` (port `9876`) in the same session causes port conflicts and state drift. | Stop and route to `bridge-conflicts` before attempting any tool call. |
|
|
10
|
+
| **Dismissing CLI appendix as unsupported** | Upstream Blender documents `--background --python` as a first-class CLI surface; BlendOps simply has `Not Run` in-repo eval evidence for it today. | Frame CLI accurately as upstream-documented with `Not Run` in-repo evidence. |
|
|
11
|
+
| **Assuming IT/sandbox permission** | Choosing Path 1 or Path 2 does not guarantee local firewall, socket, or extension permissions succeed. | Keep `Runtime status: Not Run` until live probes return observed tool output. |
|
|
12
|
+
|
|
13
|
+
## Related skill
|
|
14
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Decision Tree — Choosing a Blender Execution Path
|
|
2
|
+
|
|
3
|
+
```txt
|
|
4
|
+
Need interactive, multi-step scene inspection or steering inside a live Blender session?
|
|
5
|
+
├─ NO (headless batch renders, deterministic CI export, scripted hygiene passes)
|
|
6
|
+
│ └─ Use CLI appendix (`cli-appendix-job-outline`) — documented upstream as a
|
|
7
|
+
│ first-class Blender CLI surface (no in-repo eval evidence file yet).
|
|
8
|
+
└─ YES (interactive MCP host session)
|
|
9
|
+
├─ Are TWO or more MCP bridges/add-ons enabled on port 9876 or the same instance?
|
|
10
|
+
│ └─ STOP immediately → route to `bridge-conflicts` (single-bridge law).
|
|
11
|
+
├─ Is Blender 5.1+ installed AND user ready to install Official Blender Lab MCP add-on?
|
|
12
|
+
│ ├─ YES → Choose Path 1 (`path-one-host-outline`):
|
|
13
|
+
│ │ (a) Anthropic Connector host (Claude Desktop) OR
|
|
14
|
+
│ │ (b) Manual MCP client (Claude Code, Cursor, Codex, OpenCode, Zed, etc.)
|
|
15
|
+
│ └─ NO (Blender 3.0–5.0 or Lab MCP unavailable)
|
|
16
|
+
│ └─ Consider Path 2 (`mcp-for-blender`) ONLY IF user explicitly accepts
|
|
17
|
+
│ community maintenance/support boundaries (`docs/unofficial-runtime-bridges.md`).
|
|
18
|
+
└─ Blender version unknown?
|
|
19
|
+
└─ WARN branch: emit conditional Path 1 (5.1+) vs Path 2 (3.0+) table;
|
|
20
|
+
request verbatim `blender --version` output before proceeding.
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Non-Negotiable Rules
|
|
24
|
+
- Anthropic Connector is a **Path 1 host option**, never a standalone runtime — the Blender Lab MCP add-on must be installed and enabled inside Blender 5.1+ first.
|
|
25
|
+
- Never apply the Blender 5.1+ floor to Path 2 (`3.0+`) or the CLI appendix.
|
|
26
|
+
- Selecting a path does **not** verify readiness or approve writes; pair with `runtime-readiness` and `runtime-attempt-report`.
|
|
27
|
+
|
|
28
|
+
## Related skill
|
|
29
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Path Constraints Comparison Matrix
|
|
2
|
+
|
|
3
|
+
| Dimension | Path 1 — Official Blender Lab MCP | Path 2 — Community `mcp-for-blender` | CLI Fallback Appendix (`blender --background`) |
|
|
4
|
+
|---|---|---|---|
|
|
5
|
+
| **Minimum Blender version** | **5.1+** (bound to Lab add-on `blender_version_min`) | **3.0+** (community bridge floor) | Matches target `.blend` / file operators (upstream manual) |
|
|
6
|
+
| **Host options** | (a) Anthropic Connector OR (b) manual MCP client (`stdio`/HTTP) | Manual MCP client configuration (`uvx mcp-for-blender` / local server) | Terminal, CI runner, shell scripts |
|
|
7
|
+
| **Blender-side prerequisite** | Blender Lab MCP add-on installed & enabled inside Blender | Community `addon.py` installed & enabled inside Blender | None (no MCP server or add-on required) |
|
|
8
|
+
| **Interactive iteration** | High (live tool inspection & staged updates) | High (community tool schemas vary by version) | Low (stateless batch execution per invocation) |
|
|
9
|
+
| **Deterministic batch / CI** | Heavyweight (requires open GUI + add-on socket) | Heavyweight & community-coupled | Ideal (headless reproducible job outline) |
|
|
10
|
+
| **Release gate policy** | Preferred official path when Blender 5.1+ available | **Never** ship as primary release recommendation; explicit caveat required | First-class upstream CLI surface (no in-repo evidence file yet) |
|
|
11
|
+
| **Single-bridge invariant** | Strictly **1 active MCP bridge** per Blender instance | Strictly **1 active MCP bridge** per Blender instance (watch port `9876` collisions) | Not applicable |
|
|
12
|
+
|
|
13
|
+
## Caveats & Links
|
|
14
|
+
- Review `../../../docs/runtime-stack-strategy.md` for full 2-path + CLI appendix boundaries.
|
|
15
|
+
- Review `../../../docs/unofficial-runtime-bridges.md` before accepting Path 2 caveats.
|
|
16
|
+
|
|
17
|
+
## Related skill
|
|
18
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — runtime-readiness
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use runtime-readiness to produce readiness matrix and final status (Ready/Partially Ready/Blocked/Unknown) without running Blender scene operations.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- readiness checks with evidence
|
|
8
|
+
- confidence label per check
|
|
9
|
+
- conservative final status
|
|
10
|
+
|
|
11
|
+
## Pass / Warn / Fail criteria
|
|
12
|
+
- Pass: matrix complete + evidence-aligned status
|
|
13
|
+
- Warn: partial evidence with explicit caveat
|
|
14
|
+
- Fail: readiness claim without evidence
|
|
15
|
+
|
|
16
|
+
## Common failure modes
|
|
17
|
+
- confusing readiness with execution success
|
|
18
|
+
- missing blocker details
|
|
19
|
+
|
|
20
|
+
## Evidence expectations
|
|
21
|
+
- check table with evidence lines
|
|
22
|
+
- final status rationale
|
|
23
|
+
- blocker list when not ready
|
|
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,218 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: runtime-readiness
|
|
3
|
+
description: Run evidence-bound Blender MCP readiness checks (version floor, add-on active, port collisions, handshake) -> Ready/Partially Ready/Not Ready/Unknown.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# runtime-readiness
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run the evidence-bound readiness matrix to evaluate check completeness (`Ready | Partially Ready | Blocked | Unknown`) before any runtime attempt.
|
|
10
|
+
|
|
11
|
+
Canonical role: `runtime-readiness` in the BlendOps skill system. Respect strict role boundaries:
|
|
12
|
+
- `runtime-setup` frames prerequisites and boundaries.
|
|
13
|
+
- `runtime-path-picker` chooses the runtime path.
|
|
14
|
+
- `path-one-host-outline` details Path 1 host (a) and host (b) setup.
|
|
15
|
+
- THIS skill (`runtime-readiness`) runs the readiness matrix only.
|
|
16
|
+
|
|
17
|
+
## Quick start
|
|
18
|
+
- confirm this skill fits your goal
|
|
19
|
+
- provide required inputs first
|
|
20
|
+
- keep runtime claims evidence-bound
|
|
21
|
+
- follow suggested next-skill handoff
|
|
22
|
+
|
|
23
|
+
## When to use
|
|
24
|
+
- to run the readiness matrix after prerequisites are framed (`runtime-setup`) and a target path is selected (`runtime-path-picker`)
|
|
25
|
+
- before any runtime manual evaluation or planning handoff
|
|
26
|
+
|
|
27
|
+
## When not to use
|
|
28
|
+
<!-- blendops:generated:start exclusions -->
|
|
29
|
+
- as proof that Blender ran or that runtime execution succeeded → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
|
|
30
|
+
- as a substitute for runtime truth states (Not Run | Attempted | Produced | Verified | Failed) or artifact status (default Not Produced) → use `../path-one-host-outline/SKILL.md` (default Not Produced)
|
|
31
|
+
- to choose a runtime path → use `../path-one-host-outline/SKILL.md` (use path-one-host-outline)
|
|
32
|
+
<!-- blendops:generated:end exclusions -->
|
|
33
|
+
|
|
34
|
+
## Trigger phrases
|
|
35
|
+
<!-- blendops:generated:start triggers -->
|
|
36
|
+
- "check runtime readiness"
|
|
37
|
+
- "is runtime available"
|
|
38
|
+
- "can we run this now"
|
|
39
|
+
- "run the readiness matrix for our chosen Blender path"
|
|
40
|
+
<!-- blendops:generated:end triggers -->
|
|
41
|
+
|
|
42
|
+
## Prerequisites / readiness
|
|
43
|
+
- non-destructive local environment access
|
|
44
|
+
- ability to read config/path signals
|
|
45
|
+
- clear distinction between readiness and execution
|
|
46
|
+
|
|
47
|
+
## Input schema
|
|
48
|
+
|
|
49
|
+
### Required inputs
|
|
50
|
+
- expected runtime path(s)
|
|
51
|
+
- target harness context
|
|
52
|
+
|
|
53
|
+
### Optional inputs
|
|
54
|
+
- known executable paths
|
|
55
|
+
- known config file locations
|
|
56
|
+
- prior blocker records
|
|
57
|
+
|
|
58
|
+
### Assumptions to confirm
|
|
59
|
+
- no Blender run required for readiness-only pass
|
|
60
|
+
- Path 2 used only with third-party caveats; CLI appendix never a peer path
|
|
61
|
+
|
|
62
|
+
## Output schema
|
|
63
|
+
|
|
64
|
+
### Primary output
|
|
65
|
+
- readiness matrix + final readiness status (`Ready | Partially Ready | Blocked | Unknown`, describing check completeness only)
|
|
66
|
+
- explicit runtime truth state reminder (runtime remains `Not Run`; artifacts remain `Not Produced`)
|
|
67
|
+
|
|
68
|
+
### Secondary output
|
|
69
|
+
- blocker list + next-skill handoff or retry steps
|
|
70
|
+
|
|
71
|
+
### Evidence / caveat output
|
|
72
|
+
- per-check evidence lines
|
|
73
|
+
- confidence label per check: `verified-read | linked-only | unknown | blocked`
|
|
74
|
+
|
|
75
|
+
## Required laws
|
|
76
|
+
- ../../laws/official-runtime-only.md
|
|
77
|
+
- ../../laws/evidence-before-done.md
|
|
78
|
+
- ../../laws/no-arbitrary-python-interface.md
|
|
79
|
+
- ../../laws/non-blender-user-language.md
|
|
80
|
+
|
|
81
|
+
## Official runtime boundary
|
|
82
|
+
- Readiness ≠ execution: `Ready` means readiness checks passed, never that Blender executed or artifacts exist.
|
|
83
|
+
- Readiness statuses (`Ready | Partially Ready | Blocked | Unknown`) describe check completeness only; never conflate them with runtime truth states (`Not Run | Attempted | Produced | Verified | Failed`, downgrade-only) or artifact state (default `Not Produced`).
|
|
84
|
+
- This skill can check local readiness signals.
|
|
85
|
+
- This skill must not claim runtime artifact production.
|
|
86
|
+
- This skill must not claim execution success without execution evidence.
|
|
87
|
+
- Path 1 Anthropic Connector is never standalone: it always requires the Official Blender Lab MCP add-on installed inside Blender 5.1+.
|
|
88
|
+
- Path 2 (`mcp-for-blender`) is third-party only, carries mandatory caveats, and is never release evidence.
|
|
89
|
+
- CLI fallback (`blender --background --python`) is appendix-only and never a peer path without an evaluation record.
|
|
90
|
+
|
|
91
|
+
## Operating procedure
|
|
92
|
+
1. Confirm chosen runtime path (Path 1 or Path 2 from `../../docs/runtime-stack-strategy.md`); for Path 1 also confirm host option (a Anthropic Connector, b manual MCP). CLI fallback is appendix only — documented upstream as a first-class Blender CLI surface but no in-repo evidence file yet; flag this if user picks it.
|
|
93
|
+
2. Check Blender executable availability (command/path evidence) AND record exact `blender --version` output for per-path minimum check:
|
|
94
|
+
- **Path 1 (either host)** → 5.1+ required (Lab install-link parameter + add-on manifest literal `blender_version_min=5.1.0`, re-verified 2026-10-13).
|
|
95
|
+
- Path 2 → 3.0+ required (per upstream).
|
|
96
|
+
- CLI fallback → 4.2+ recommended; documented upstream as a first-class Blender CLI surface; no in-repo evidence file yet.
|
|
97
|
+
3. Per chosen path + host, check the path-specific configuration:
|
|
98
|
+
- **Path 1 Blender-side (always required)**: Lab MCP add-on installed in Blender + MCP server (`.mcpb` bundle or source) reachable.
|
|
99
|
+
- Path 1 host (a): Anthropic Connector enabled in Claude Desktop → Customize → Connectors.
|
|
100
|
+
- Path 1 host (b): Lab MCP server registered in MCP client config (`mcpServers` JSON or equivalent).
|
|
101
|
+
- Path 2: `mcp-for-blender` (formerly `blender-mcp`) server registered (`uvx mcp-for-blender` or equivalent) + upstream `addon.py` installed + enabled in Blender.
|
|
102
|
+
- CLI fallback: Blender executable resolvable from agent shell.
|
|
103
|
+
4. Check single-bridge constraint: at most one MCP bridge session active per Blender instance on the default port (Path 1 + Path 2 must not both target the same Blender on `localhost:9876`; per-instance `--port 9877` is the supported multi-instance pattern; Path 1 host (a) + host (b) must not both target the same Blender).
|
|
104
|
+
5. Check operator sandbox hygiene: trusted environment, no secrets in scenes/logs, disposable ports/paths.
|
|
105
|
+
6. Check artifact/output location readiness for future run.
|
|
106
|
+
7. Assign confidence label to each check (`verified-read` / `linked-only` / `unknown` / `blocked`).
|
|
107
|
+
8. Populate readiness matrix table per path + host.
|
|
108
|
+
9. Derive final status (Ready / Partially Ready / Blocked / Unknown) while keeping runtime truth at `Not Run` and artifacts at `Not Produced`.
|
|
109
|
+
10. Produce blocker summary and next actions.
|
|
110
|
+
11. Route to planner or setup skill based on status.
|
|
111
|
+
|
|
112
|
+
## Decision tree
|
|
113
|
+
- Blender missing + no connector/MCP evidence → Blocked.
|
|
114
|
+
- Blender found but connector/MCP uncertain → Partially Ready or Unknown.
|
|
115
|
+
- Blender found + connector/MCP signals sufficient → Ready candidate (still no artifact claim).
|
|
116
|
+
|
|
117
|
+
## Playbooks
|
|
118
|
+
- Playbook A: text-only planning path
|
|
119
|
+
- Playbook B: runtime-ready path with evidence gating
|
|
120
|
+
- Playbook C: blocked runtime path with caveat-first reporting
|
|
121
|
+
|
|
122
|
+
## Mode handling
|
|
123
|
+
|
|
124
|
+
### Text-only mode
|
|
125
|
+
- evaluate readiness matrix from provided evidence only
|
|
126
|
+
- runtime truth state stays `Not Run`; artifacts stay `Not Produced`
|
|
127
|
+
|
|
128
|
+
### Runtime-ready mode
|
|
129
|
+
- status `Ready` or `Partially Ready` with explicit path caveats
|
|
130
|
+
- handoff to scene planning or host outline skills (never claim execution occurred)
|
|
131
|
+
|
|
132
|
+
### Blocked runtime mode
|
|
133
|
+
- status `Blocked` or `Unknown`
|
|
134
|
+
- list explicit blockers and handoff to setup or conflict-resolution skills
|
|
135
|
+
|
|
136
|
+
## Validation checklist
|
|
137
|
+
- [ ] Blender check recorded
|
|
138
|
+
- [ ] connector check recorded
|
|
139
|
+
- [ ] MCP check recorded
|
|
140
|
+
- [ ] artifact path readiness recorded
|
|
141
|
+
- [ ] confidence labels assigned
|
|
142
|
+
- [ ] final status assigned
|
|
143
|
+
- [ ] blocker list included
|
|
144
|
+
- [ ] no execution success claim
|
|
145
|
+
- [ ] runtime truth state kept at `Not Run`, artifacts at `Not Produced` (readiness is not execution)
|
|
146
|
+
- [ ] Path 2 references carry third-party caveats; CLI appendix never a peer path
|
|
147
|
+
- [ ] operator sandbox hygiene noted (trusted environment, no secrets in scenes/logs, disposable ports/paths)
|
|
148
|
+
- [ ] next actions clear
|
|
149
|
+
|
|
150
|
+
## Pass / Warn / Fail rubric
|
|
151
|
+
|
|
152
|
+
| Category | Pass | Warn | Fail |
|
|
153
|
+
|---|---|---|---|
|
|
154
|
+
| Blender availability | Verified with local evidence | Partial path evidence | Missing/not found |
|
|
155
|
+
| Path & host signals | Both in-Blender Lab add-on + host (a/b) verified for Path 1 (or caveated Path 2/CLI) | Incomplete signal downgraded to `Unknown`/`Partially Ready` | Standalone-Connector assumed or claimed without evidence |
|
|
156
|
+
| Sandbox hygiene & confidence | Sandbox hygiene noted; every check labeled (`verified-read`/`linked-only`/`unknown`/`blocked`) | Partial labels or hygiene caveats | Missing labels or hygiene ignored |
|
|
157
|
+
| Status vs truth separation | Matrix status matches evidence; runtime kept at `Not Run` and artifacts `Not Produced` | Minor ambiguity with conservative downgrade | Readiness conflated with execution or truth upgraded |
|
|
158
|
+
|
|
159
|
+
## Failure handling
|
|
160
|
+
- Unknown state: mark Unknown, not Ready.
|
|
161
|
+
- Missing config path: mark Blocked and provide exact next check.
|
|
162
|
+
- Conflicting signals: choose safer status with caveat.
|
|
163
|
+
|
|
164
|
+
## Troubleshooting
|
|
165
|
+
- Blender not on PATH: check absolute path.
|
|
166
|
+
- Config file exists but missing runtime entries: mark unknown/blocked.
|
|
167
|
+
- Existing artifacts found: treat as pre-existing unless run-specific evidence ties them to current eval.
|
|
168
|
+
|
|
169
|
+
## Best practices
|
|
170
|
+
- keep checks reproducible and non-destructive
|
|
171
|
+
- include exact evidence lines in report
|
|
172
|
+
- separate readiness from artifact claims
|
|
173
|
+
|
|
174
|
+
## Good examples
|
|
175
|
+
“Status: Blocked. Blender binary exists, but official connector/MCP runtime path is not confirmed in this environment.”
|
|
176
|
+
|
|
177
|
+
## Bad examples
|
|
178
|
+
“Looks good; runtime should work.” (no matrix, no evidence)
|
|
179
|
+
|
|
180
|
+
## User-facing response template
|
|
181
|
+
- Current runtime status
|
|
182
|
+
- Evidence observed
|
|
183
|
+
- Missing readiness signals
|
|
184
|
+
- Next setup action
|
|
185
|
+
|
|
186
|
+
## Anti-patterns
|
|
187
|
+
- skipping required laws or runtime boundary statements
|
|
188
|
+
- claiming runtime/artifact success without evidence
|
|
189
|
+
- conflating readiness status (`Ready`) with runtime truth states (`Produced | Verified`) or claiming artifacts exist
|
|
190
|
+
- treating the Path 1 Anthropic Connector as standalone without the Blender 5.1+ Lab MCP add-on
|
|
191
|
+
- using Path 2 (`mcp-for-blender`) without third-party caveats or as release evidence
|
|
192
|
+
- treating CLI fallback (`blender --background --python`) as a peer path without an eval record
|
|
193
|
+
- blurring roles with `runtime-setup`, `runtime-path-picker`, or `path-one-host-outline`
|
|
194
|
+
- producing jargon-heavy final output without explanation
|
|
195
|
+
|
|
196
|
+
## Cross-skill handoff
|
|
197
|
+
<!-- blendops:generated:start handoffs -->
|
|
198
|
+
- [upstream_reference] If runtime path is not yet chosen → `../runtime-path-picker/SKILL.md`
|
|
199
|
+
- [upstream_reference] If Path 1 host (a) or (b) outline is needed → `../path-one-host-outline/SKILL.md`
|
|
200
|
+
- [fallback] If prerequisites/boundaries are missing (Blocked / Unknown) → `../runtime-setup/SKILL.md`
|
|
201
|
+
- [fallback] If bridge contention is detected → `../bridge-conflicts/SKILL.md`
|
|
202
|
+
- [upstream_reference] If CLI appendix job structure is needed → `../cli-appendix-job-outline/SKILL.md`
|
|
203
|
+
- [alternative] If Ready / Partially Ready and moving to scene planning (product-hero-scene-planner) → `../product-hero-scene-planner/SKILL.md`
|
|
204
|
+
- [conditional] If Ready / Partially Ready and moving to scene planning (workflow-stage-router) → `../workflow-stage-router/SKILL.md`
|
|
205
|
+
<!-- blendops:generated:end handoffs -->
|
|
206
|
+
|
|
207
|
+
## Non-goals
|
|
208
|
+
- runtime execution
|
|
209
|
+
- artifact generation claims
|
|
210
|
+
- uncaveated Path 2 / peer-path CLI fallback
|
|
211
|
+
|
|
212
|
+
## References
|
|
213
|
+
- 2-path + CLI appendix runtime model: ../../docs/runtime-stack-strategy.md
|
|
214
|
+
- Per-path setup details: ../../docs/external-runtime-setup.md
|
|
215
|
+
- Path 1 host (a) source — Anthropic Connector: https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
216
|
+
- Path 1 Blender-side source — Lab MCP (required for both hosts): https://www.blender.org/lab/mcp-server/
|
|
217
|
+
- Path 2 source: https://github.com/ahujasid/mcp-for-blender
|
|
218
|
+
- CLI fallback source (documented upstream as first-class Blender CLI; no in-repo evidence file yet): https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|