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,251 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: path-one-host-outline
|
|
3
|
+
description: Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# path-one-host-outline
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
|
|
10
|
+
Outline **Path 1 host surfaces** — **(a)** Anthropic Connector in Claude Desktop vs **(b)** any manually configured MCP client — while making clear that both require the Lab MCP add-on inside **Blender 5.1+** and that the Connector is **never standalone**. This skill provides an outline only; it never configures hosts and never runs Blender.
|
|
11
|
+
|
|
12
|
+
## Quick start
|
|
13
|
+
|
|
14
|
+
- confirm Blender 5.1+ target
|
|
15
|
+
- choose host category using `references/connector-vs-manual-matrix.md`
|
|
16
|
+
- apply reminders from `references/lab-addon-reminders.md`
|
|
17
|
+
- emit checklist `references/host-checklist-template.md`
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
|
|
21
|
+
- user on Claude Desktop asking what the Anthropic Connector does vs the Blender-side add-on
|
|
22
|
+
- user or agent comparing Path 1 host surfaces: **(a)** Anthropic Connector in Claude Desktop vs **(b)** a manually configured MCP client
|
|
23
|
+
- outlining which components live on the host side vs inside Blender 5.1+ before setup begins
|
|
24
|
+
|
|
25
|
+
## When not to use
|
|
26
|
+
<!-- blendops:generated:start exclusions -->
|
|
27
|
+
- choosing between Path 1, Path 2, or CLI → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
|
|
28
|
+
- step-by-step host or add-on installation and configuration → use `../runtime-setup/SKILL.md` (Delegates out-of-scope requests to runtime-setup)
|
|
29
|
+
- probing live runtime readiness → use `../runtime-readiness/SKILL.md` (Delegates out-of-scope requests to runtime-readiness)
|
|
30
|
+
- resolving conflicts between official and unofficial bridges → use `../bridge-conflicts/SKILL.md` (Delegates out-of-scope requests to bridge-conflicts)
|
|
31
|
+
- Path 2 community bridge specifics → use `../runtime-path-picker/SKILL.md` (Delegates out-of-scope requests to runtime-path-picker)
|
|
32
|
+
- CLI appendix job outlining → use `../cli-appendix-job-outline/SKILL.md` (Delegates out-of-scope requests to cli-appendix-job-outline)
|
|
33
|
+
<!-- blendops:generated:end exclusions -->
|
|
34
|
+
|
|
35
|
+
## Trigger phrases
|
|
36
|
+
<!-- blendops:generated:start triggers -->
|
|
37
|
+
- "Connector vs Cursor MCP"
|
|
38
|
+
- "how do I host Lab MCP"
|
|
39
|
+
- "Claude Desktop Connector vs manual MCP client"
|
|
40
|
+
- "what hosts work with Path 1"
|
|
41
|
+
<!-- blendops:generated:end triggers -->
|
|
42
|
+
|
|
43
|
+
## Prerequisites / readiness
|
|
44
|
+
|
|
45
|
+
- target environment plans for **Blender 5.1+** with the Blender-side Lab MCP add-on required for both Host **(a)** and Host **(b)** (the Anthropic Connector is never standalone)
|
|
46
|
+
|
|
47
|
+
## Input schema
|
|
48
|
+
|
|
49
|
+
### Required inputs
|
|
50
|
+
|
|
51
|
+
| Input | Why it is required |
|
|
52
|
+
|---|---|
|
|
53
|
+
| Host product name | Select matrix row |
|
|
54
|
+
| Blender version plan | Confirms Path 1 viability |
|
|
55
|
+
|
|
56
|
+
### Optional inputs
|
|
57
|
+
|
|
58
|
+
| Input | Use |
|
|
59
|
+
|---|---|
|
|
60
|
+
| OS | Install nuance pointers |
|
|
61
|
+
|
|
62
|
+
## Output schema
|
|
63
|
+
|
|
64
|
+
### Primary output
|
|
65
|
+
|
|
66
|
+
- host-specific outline using **(a)** Anthropic Connector in Claude Desktop vs **(b)** manually configured MCP client framing (outline only — never configure hosts or dump executable setup scripts; hand off setup details to `runtime-setup`)
|
|
67
|
+
- explicit prerequisite line stating that both Host **(a)** and Host **(b)** require the Lab MCP add-on inside **Blender 5.1+**
|
|
68
|
+
- explicit statement that the Anthropic Connector is **never standalone** whenever Connector is discussed
|
|
69
|
+
|
|
70
|
+
### Evidence / caveat output
|
|
71
|
+
|
|
72
|
+
```txt
|
|
73
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
74
|
+
Artifact status: Not Produced | Produced | Verified | Failed (default: Not Produced)
|
|
75
|
+
Rule: Downgrade-only, never upgrade. Outlining hosts never configures hosts or runs Blender.
|
|
76
|
+
Blockers: <separate line>
|
|
77
|
+
Evidence used: <doc references>
|
|
78
|
+
Limitations: <unknown host version>
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Required laws
|
|
82
|
+
|
|
83
|
+
- `../../laws/evidence-before-done.md`
|
|
84
|
+
- `../../laws/non-blender-user-language.md`
|
|
85
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
86
|
+
- `../../laws/official-runtime-only.md`
|
|
87
|
+
|
|
88
|
+
## Official runtime boundary
|
|
89
|
+
|
|
90
|
+
Outline only; never configures hosts and never runs Blender. Path 1 requires the Lab MCP add-on inside **Blender 5.1+** plus a host surface: **(a)** Anthropic Connector in Claude Desktop or **(b)** any manually configured MCP client. The Connector is **never standalone**. Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`; see `docs/unofficial-runtime-bridges.md`) and CLI workflows (`cli-appendix-job-outline`) are out of scope here.
|
|
91
|
+
|
|
92
|
+
## Operating procedure
|
|
93
|
+
|
|
94
|
+
1. Verify the **Blender 5.1+** version floor for Path 1 (route path selection questions to `runtime-path-picker`).
|
|
95
|
+
2. Identify the target host surface as **(a)** Anthropic Connector in Claude Desktop or **(b)** a manually configured MCP client using `references/connector-vs-manual-matrix.md`.
|
|
96
|
+
3. State explicitly that the Lab MCP add-on inside Blender 5.1+ is required for both **(a)** and **(b)**, and reiterate that the Connector is **never standalone** (`references/lab-addon-reminders.md`).
|
|
97
|
+
4. Emit the conceptual checklist (`references/host-checklist-template.md`) with pointers to `docs/install/claude-desktop.md` or `runtime-setup` without performing host configuration.
|
|
98
|
+
|
|
99
|
+
## Decision tree
|
|
100
|
+
|
|
101
|
+
```txt
|
|
102
|
+
Is the user still deciding between Path 1 (Lab MCP), Path 2 (`mcp-for-blender`), or the CLI appendix?
|
|
103
|
+
Yes → stop and route to runtime-path-picker
|
|
104
|
+
No (Path 1 selected) → continue
|
|
105
|
+
Can the target environment run Blender 5.1+ (`blender_version_min = "5.1.0"`) with the Lab MCP add-on installed inside Blender?
|
|
106
|
+
No → Path 1 is not viable; route back to runtime-path-picker for Path 2 (`Blender 3.0+`) or CLI appendix evaluation
|
|
107
|
+
Yes → continue
|
|
108
|
+
Which Path 1 host surface is the user targeting (`references/connector-vs-manual-matrix.md`)?
|
|
109
|
+
Host (a) Claude Desktop with Anthropic Blender Connector →
|
|
110
|
+
1. Require Blender 5.1+ and Lab MCP add-on inside Blender first
|
|
111
|
+
2. State explicitly that the Anthropic Connector is NEVER standalone
|
|
112
|
+
3. Point to `docs/install/claude-desktop.md` and `runtime-setup`
|
|
113
|
+
Host (b) Manually configured MCP client (Cursor, Claude Code, Codex, OpenCode, Zed, Windsurf, etc.) →
|
|
114
|
+
1. Require Blender 5.1+ and Lab MCP add-on inside Blender first
|
|
115
|
+
2. Outline host MCP server entry pointing at the Blender Lab MCP server
|
|
116
|
+
3. Point to `docs/external-runtime-setup.md`, `docs/install/<target>.md`, and `runtime-setup`
|
|
117
|
+
Host unknown / comparing both →
|
|
118
|
+
Emit side-by-side Host (a) vs Host (b) outline sharing the mandatory Blender 5.1+ Lab add-on invariant
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## Playbooks
|
|
122
|
+
|
|
123
|
+
### Playbook A: Claude Desktop user asking how the Anthropic Connector works (`Host (a)`)
|
|
124
|
+
|
|
125
|
+
- Lead with the shared Path 1 invariant from `references/lab-addon-reminders.md`: **Blender 5.1+** (`blender_version_min = "5.1.0"`) and the **Official Blender Lab MCP add-on** inside Blender must be installed and enabled first.
|
|
126
|
+
- Explain that **Host (a)** (Anthropic Connector in Claude Desktop) is a host-side convenience layer that attaches to the Lab MCP add-on after Blender-side setup — the Connector is **never standalone**.
|
|
127
|
+
- Emit the 5-step outline from `references/host-checklist-template.md` and route step-by-step installation to `../runtime-setup/SKILL.md`.
|
|
128
|
+
|
|
129
|
+
### Playbook B: Coding agent user (Cursor, Claude Code, Codex, OpenCode) on Path 1 (`Host (b)`)
|
|
130
|
+
|
|
131
|
+
- Confirm the **Blender 5.1+** and Blender-side **Lab MCP add-on** prerequisite (`references/connector-vs-manual-matrix.md`).
|
|
132
|
+
- Outline **Host (b)**: the coding agent acts as a manually configured MCP client connecting to the Lab MCP server surface exposed by Blender 5.1+, with no Anthropic Connector involved.
|
|
133
|
+
- Remind the user of the single-bridge rule (do not attach Path 2 `mcp-for-blender` to the same Blender instance on port `9876`) and point to `../../docs/install/claude-desktop.md` or the target agent's install doc.
|
|
134
|
+
|
|
135
|
+
### Playbook C: Side-by-side comparison of Host (a) vs Host (b)
|
|
136
|
+
|
|
137
|
+
- Present the comparison table from `references/connector-vs-manual-matrix.md` showing what stays identical inside Blender 5.1+ (the Lab MCP add-on and single-bridge rule) vs what changes on the host (Connector UI linkage in Claude Desktop vs MCP client config in other agents).
|
|
138
|
+
- Keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
139
|
+
|
|
140
|
+
## Mode handling
|
|
141
|
+
|
|
142
|
+
### Text-only mode
|
|
143
|
+
|
|
144
|
+
References only; no credential paths.
|
|
145
|
+
|
|
146
|
+
### Runtime-ready mode
|
|
147
|
+
|
|
148
|
+
Suggest pairing with `runtime-readiness`.
|
|
149
|
+
|
|
150
|
+
### Blocked runtime mode
|
|
151
|
+
|
|
152
|
+
Still explain host conceptual split.
|
|
153
|
+
|
|
154
|
+
## Validation checklist
|
|
155
|
+
|
|
156
|
+
* [ ] Host **(a)** (Anthropic Connector in Claude Desktop) vs Host **(b)** (manually configured MCP client) framing is used
|
|
157
|
+
* [ ] Lab MCP add-on inside **Blender 5.1+** is stated as a prerequisite on the outline
|
|
158
|
+
* [ ] "Connector is never standalone" phrasing is present whenever the Connector is discussed
|
|
159
|
+
* [ ] No host configuration, Python, or Blender execution is performed
|
|
160
|
+
* [ ] Former Path 2 repo is cited as `ahujasid/blender-mcp` (never bare `blender-mcp`)
|
|
161
|
+
* [ ] Truth states use the full allowed enums with default `Not Produced` for artifacts and downgrade-only enforcement
|
|
162
|
+
|
|
163
|
+
## Pass / Warn / Fail rubric
|
|
164
|
+
|
|
165
|
+
| Verdict | Criteria |
|
|
166
|
+
|---|---|
|
|
167
|
+
| Pass | Uses Host (a)/(b) framing, requires Lab MCP add-on in Blender 5.1+, states Connector is never standalone, keeps strictly to outlining, and uses exact truth-state enums. |
|
|
168
|
+
| Warn | Host product or version is ambiguous, requiring a general (a) vs (b) comparison with documented limitations. |
|
|
169
|
+
| Fail | Implies Connector is standalone or installs Blender internals automatically, omits Blender 5.1+ Lab add-on prerequisite, uses bare `blender-mcp`, configures hosts/runs Blender, or upgrades truth states. |
|
|
170
|
+
|
|
171
|
+
## Failure handling
|
|
172
|
+
|
|
173
|
+
- If the user's environment is pinned below **Blender 5.1** (for example, Blender 4.2 LTS or 3.6 LTS), state clearly that Path 1 (both Host (a) and Host (b)) is unavailable because the Lab MCP add-on requires `blender_version_min = "5.1.0"`, and route to `../runtime-path-picker/SKILL.md`.
|
|
174
|
+
- If the user asks this skill to write live MCP client JSON configs, edit system credential files, or execute Blender, decline and route setup execution to `../runtime-setup/SKILL.md`.
|
|
175
|
+
- If both Path 1 Lab MCP and Path 2 `mcp-for-blender` (formerly `ahujasid/blender-mcp`) are active on the same Blender instance, route immediately to `../bridge-conflicts/SKILL.md`.
|
|
176
|
+
- Preserve downgrade-only truth states (`Runtime status: Not Run`, `Artifact status: Not Produced`).
|
|
177
|
+
|
|
178
|
+
## Troubleshooting
|
|
179
|
+
|
|
180
|
+
| Symptom | Cause | Safe resolution |
|
|
181
|
+
|---|---|---|
|
|
182
|
+
| User enabled Anthropic Connector in Claude Desktop but nothing connects | Lab MCP add-on was never installed/enabled inside Blender 5.1+ (Anthropic tutorial step 2 skipped) | Reiterate that the Anthropic Connector is **never standalone**; require installing and enabling the Lab MCP add-on inside Blender 5.1+ first, then route to `../runtime-setup/SKILL.md`. |
|
|
183
|
+
| User cites Anthropic tutorial prerequisite "Blender 4.2 or later" for Path 1 | Upstream tutorial text lags the Lab add-on manifest floor | Explain that the binding floor in the Lab MCP add-on manifest is `blender_version_min = "5.1.0"` (**Blender 5.1+**), which governs both Host (a) and Host (b). |
|
|
184
|
+
| User confuses Path 1 Host (b) with Path 2 `mcp-for-blender` | Both use manual MCP client configuration in coding agents | Clarify that Path 1 Host (b) connects to the official Blender Lab MCP add-on in Blender 5.1+, whereas Path 2 connects to the third-party `mcp-for-blender` (`ahujasid/blender-mcp`) add-on (`../../docs/unofficial-runtime-bridges.md`). |
|
|
185
|
+
|
|
186
|
+
## Best practices
|
|
187
|
+
|
|
188
|
+
- Always state the Blender-side prerequisite (**Blender 5.1+** + **Lab MCP add-on** inside Blender) **before** describing either Host (a) or Host (b).
|
|
189
|
+
- Include the explicit reminder that **the Anthropic Connector is never standalone** whenever Host (a) or Claude Desktop is mentioned.
|
|
190
|
+
- Cite the community Path 2 bridge as `mcp-for-blender` (formerly `ahujasid/blender-mcp`), never bare `blender-mcp`.
|
|
191
|
+
- Keep this skill strictly at the architectural outline level and hand off step-by-step installation to `../runtime-setup/SKILL.md` and live checks to `../runtime-readiness/SKILL.md`.
|
|
192
|
+
|
|
193
|
+
## Good examples
|
|
194
|
+
|
|
195
|
+
- "For Path 1 on Claude Desktop (**Host (a)**): 1) Install **Blender 5.1+** (`blender_version_min = \"5.1.0\"`). 2) Install and enable the **Official Blender Lab MCP add-on** inside Blender. 3) Connect the Anthropic Blender Connector in Claude Desktop — the Connector is **never standalone** and depends on the Lab add-on running inside Blender 5.1+. `Runtime status: Not Run`. `Artifact status: Not Produced`."
|
|
196
|
+
- "For Path 1 in Cursor or Claude Code (**Host (b)**): Both Host (a) and Host (b) require the **Lab MCP add-on inside Blender 5.1+**. On the host side, configure your agent's manual MCP client to point at the Lab MCP server and ensure no Path 2 (`mcp-for-blender`, formerly `ahujasid/blender-mcp`) bridge is attached to the same Blender instance. Hand off to `../runtime-setup/SKILL.md`."
|
|
197
|
+
|
|
198
|
+
## Bad examples
|
|
199
|
+
|
|
200
|
+
- "In Claude Desktop, just toggle on the Anthropic Blender Connector — no Blender add-on installation is needed." — false standalone Connector claim.
|
|
201
|
+
- "Use Host (b) manual MCP client to run Path 1 on Blender 4.2 LTS." — violates the binding Blender 5.1+ floor (`blender_version_min = "5.1.0"`) for Path 1.
|
|
202
|
+
- "Path 1 Host (b) uses `blender-mcp`." — confuses Path 1 with Path 2 and uses the ambiguous bare name `blender-mcp`.
|
|
203
|
+
|
|
204
|
+
## User-facing response template
|
|
205
|
+
|
|
206
|
+
```txt
|
|
207
|
+
Path 1 host outline: <Host (a) Anthropic Connector in Claude Desktop | Host (b) Manual MCP client | (a) vs (b) comparison>
|
|
208
|
+
Mandatory Path 1 prerequisite: Both Host (a) and Host (b) require Blender 5.1+ (`blender_version_min = "5.1.0"`) with the Official Blender Lab MCP add-on installed and enabled inside Blender. The Anthropic Connector is never standalone.
|
|
209
|
+
|
|
210
|
+
Component split:
|
|
211
|
+
1. Blender-side (shared by (a) and (b)): <Blender 5.1+ + Lab MCP add-on enabled + single-bridge check on port 9876>
|
|
212
|
+
2. Host-side wiring: <Host (a) Anthropic Connector linkage after step 1 | Host (b) manual MCP client server entry>
|
|
213
|
+
|
|
214
|
+
Blockers: <none or version/host constraints>
|
|
215
|
+
Runtime status: Not Run
|
|
216
|
+
Artifact status: Not Produced
|
|
217
|
+
Evidence used: <docs/runtime-stack-strategy.md, docs/install/claude-desktop.md, skill references>
|
|
218
|
+
Limitations: <outline only — does not configure hosts or run Blender>
|
|
219
|
+
Next skill: <runtime-setup | runtime-readiness | runtime-path-picker>
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
## Anti-patterns
|
|
223
|
+
|
|
224
|
+
- Describing the Anthropic Blender Connector as standalone or implying it works without installing the Lab MCP add-on inside Blender 5.1+.
|
|
225
|
+
- Claiming Path 1 Host (b) bypasses the **Blender 5.1+** floor (`blender_version_min = "5.1.0"`).
|
|
226
|
+
- Referring to the former Path 2 repository as bare `blender-mcp` instead of `mcp-for-blender` (`ahujasid/blender-mcp`).
|
|
227
|
+
- Writing `Artifact status: Not Run` or upgrading `Runtime status` / `Artifact status` from a host outline.
|
|
228
|
+
- Turning a conceptual host outline into live configuration execution or Python scripts.
|
|
229
|
+
|
|
230
|
+
## Cross-skill handoff
|
|
231
|
+
<!-- blendops:generated:start handoffs -->
|
|
232
|
+
- [upstream_reference] Path selection → `../runtime-path-picker/SKILL.md`
|
|
233
|
+
- [upstream_reference] Detailed setup and configuration → `../runtime-setup/SKILL.md`
|
|
234
|
+
- [progression] Readiness probing → `../runtime-readiness/SKILL.md`
|
|
235
|
+
- [fallback] Bridge conflicts → `../bridge-conflicts/SKILL.md`
|
|
236
|
+
- [progression] CLI appendix workflows → `../cli-appendix-job-outline/SKILL.md`
|
|
237
|
+
<!-- blendops:generated:end handoffs -->
|
|
238
|
+
|
|
239
|
+
## Non-goals
|
|
240
|
+
|
|
241
|
+
- Choosing between Path 1, Path 2, and the CLI appendix (owned by `../runtime-path-picker/SKILL.md`).
|
|
242
|
+
- Performing step-by-step installation or editing host MCP configuration files (owned by `../runtime-setup/SKILL.md`).
|
|
243
|
+
- Probing whether a live Blender MCP session is currently connected (owned by `../runtime-readiness/SKILL.md`).
|
|
244
|
+
- Documenting Path 2 community bridge internals or headless CLI batch scripts.
|
|
245
|
+
|
|
246
|
+
## References
|
|
247
|
+
|
|
248
|
+
- `references/connector-vs-manual-matrix.md`
|
|
249
|
+
- `references/lab-addon-reminders.md`
|
|
250
|
+
- `references/host-checklist-template.md`
|
|
251
|
+
- `../../docs/install/claude-desktop.md`
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "path-one-host-outline",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "runtime-and-execution",
|
|
6
|
+
"role": "lab-mcp-host-configuration-planner",
|
|
7
|
+
"purpose": "Outline Path 1 hosting options — Anthropic Blender Connector vs manual MCP client — both need Blender Lab MCP add-on in Blender 5.1+.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"Connector vs Cursor MCP",
|
|
11
|
+
"how do I host Lab MCP",
|
|
12
|
+
"Claude Desktop Connector vs manual MCP client",
|
|
13
|
+
"what hosts work with Path 1"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "choosing between Path 1, Path 2, or CLI",
|
|
18
|
+
"delegateTo": "runtime-path-picker",
|
|
19
|
+
"reason": "Delegates out-of-scope requests to runtime-path-picker"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "step-by-step host or add-on installation and configuration",
|
|
23
|
+
"delegateTo": "runtime-setup",
|
|
24
|
+
"reason": "Delegates out-of-scope requests to runtime-setup"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "probing live runtime readiness",
|
|
28
|
+
"delegateTo": "runtime-readiness",
|
|
29
|
+
"reason": "Delegates out-of-scope requests to runtime-readiness"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "resolving conflicts between official and unofficial bridges",
|
|
33
|
+
"delegateTo": "bridge-conflicts",
|
|
34
|
+
"reason": "Delegates out-of-scope requests to bridge-conflicts"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"condition": "Path 2 community bridge specifics",
|
|
38
|
+
"delegateTo": "runtime-path-picker",
|
|
39
|
+
"reason": "Delegates out-of-scope requests to runtime-path-picker"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"condition": "CLI appendix job outlining",
|
|
43
|
+
"delegateTo": "cli-appendix-job-outline",
|
|
44
|
+
"reason": "Delegates out-of-scope requests to cli-appendix-job-outline"
|
|
45
|
+
}
|
|
46
|
+
],
|
|
47
|
+
"inputs": {
|
|
48
|
+
"required": [
|
|
49
|
+
{
|
|
50
|
+
"name": "path_one_host_option",
|
|
51
|
+
"type": "string",
|
|
52
|
+
"description": "Selected Path 1 host mode: option (a) Anthropic Connector in Claude Desktop or option (b) manual MCP client"
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"name": "blender_5_1_addon_posture",
|
|
56
|
+
"type": "object",
|
|
57
|
+
"description": "Confirmation that Official Blender Lab MCP add-on in Blender 5.1+ is required by both host options"
|
|
58
|
+
}
|
|
59
|
+
],
|
|
60
|
+
"optional": [
|
|
61
|
+
{
|
|
62
|
+
"name": "mcp_client_name",
|
|
63
|
+
"type": "string",
|
|
64
|
+
"description": "Specific MCP client for host option (b) such as Cursor, Claude Code, or Zed"
|
|
65
|
+
}
|
|
66
|
+
]
|
|
67
|
+
},
|
|
68
|
+
"outputs": {
|
|
69
|
+
"primary": [
|
|
70
|
+
"path_one_host_architecture_outline",
|
|
71
|
+
"connector_not_standalone_boundary_check",
|
|
72
|
+
"host_to_readiness_handoff"
|
|
73
|
+
],
|
|
74
|
+
"truthStatePolicy": {
|
|
75
|
+
"runtimeDefault": "Not Run",
|
|
76
|
+
"artifactDefault": "Not Produced",
|
|
77
|
+
"mutationRule": "downgrade_only"
|
|
78
|
+
}
|
|
79
|
+
},
|
|
80
|
+
"handoffs": [
|
|
81
|
+
{
|
|
82
|
+
"target": "runtime-path-picker",
|
|
83
|
+
"type": "upstream_reference",
|
|
84
|
+
"label": "Path selection",
|
|
85
|
+
"when": {
|
|
86
|
+
"all": [
|
|
87
|
+
{
|
|
88
|
+
"field": "runtime.path",
|
|
89
|
+
"operator": "equals",
|
|
90
|
+
"value": "unselected"
|
|
91
|
+
}
|
|
92
|
+
]
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
"target": "runtime-setup",
|
|
97
|
+
"type": "upstream_reference",
|
|
98
|
+
"label": "Detailed setup and configuration",
|
|
99
|
+
"when": {
|
|
100
|
+
"all": [
|
|
101
|
+
{
|
|
102
|
+
"field": "runtime.path",
|
|
103
|
+
"operator": "not_equals",
|
|
104
|
+
"value": "unselected"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"field": "stage.current",
|
|
108
|
+
"operator": "equals",
|
|
109
|
+
"value": "runtime_setup"
|
|
110
|
+
}
|
|
111
|
+
]
|
|
112
|
+
}
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"target": "runtime-readiness",
|
|
116
|
+
"type": "progression",
|
|
117
|
+
"label": "Readiness probing",
|
|
118
|
+
"when": {
|
|
119
|
+
"all": [
|
|
120
|
+
{
|
|
121
|
+
"field": "runtime.path",
|
|
122
|
+
"operator": "not_equals",
|
|
123
|
+
"value": "unselected"
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
"field": "runtime.verifiedReady",
|
|
127
|
+
"operator": "equals",
|
|
128
|
+
"value": false
|
|
129
|
+
}
|
|
130
|
+
]
|
|
131
|
+
}
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"target": "bridge-conflicts",
|
|
135
|
+
"type": "fallback",
|
|
136
|
+
"label": "Bridge conflicts",
|
|
137
|
+
"when": {
|
|
138
|
+
"all": [
|
|
139
|
+
{
|
|
140
|
+
"field": "runtime.conflictDetected",
|
|
141
|
+
"operator": "equals",
|
|
142
|
+
"value": true
|
|
143
|
+
}
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"target": "cli-appendix-job-outline",
|
|
149
|
+
"type": "progression",
|
|
150
|
+
"label": "CLI appendix workflows",
|
|
151
|
+
"when": {
|
|
152
|
+
"all": [
|
|
153
|
+
{
|
|
154
|
+
"field": "runtime.path",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": "cli_appendix"
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"field": "request.topic",
|
|
160
|
+
"operator": "equals",
|
|
161
|
+
"value": "cli_batch"
|
|
162
|
+
}
|
|
163
|
+
]
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
]
|
|
167
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Path 1 Host Outline — Connector `(a)` vs Manual MCP `(b)`
|
|
2
|
+
|
|
3
|
+
Both Path 1 host options share the **exact same Blender-side engine**: Official Blender Lab MCP add-on running inside **Blender 5.1+**. Only the client-side wiring differs.
|
|
4
|
+
|
|
5
|
+
| Aspect | Host `(a)` — Anthropic Connector | Host `(b)` — Manual MCP Client |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| **Typical clients** | Claude Desktop / Anthropic UI Connector flow | Claude Code, Cursor, Codex, OpenCode, Windsurf, Cline, Zed, Continue |
|
|
8
|
+
| **Blender version floor** | Blender **5.1+** | Blender **5.1+** |
|
|
9
|
+
| **Blender-side add-on** | Install & enable Blender Lab MCP add-on inside Blender preferences | Install & enable Blender Lab MCP add-on inside Blender preferences |
|
|
10
|
+
| **Client transport wiring** | Linked via Connector extension UI per Anthropic tutorial | Configured in client MCP JSON/TOML/YAML (`mcpServers` pointing at Lab server) |
|
|
11
|
+
| **Trust boundary** | Standalone Connector **cannot** operate without Lab add-on enabled | Client executes only upstream Lab tool schemas; no BlendOps-owned bridge |
|
|
12
|
+
| **Safe initial check** | Read-only scene introspection (`tier0_read_only`) | Read-only scene introspection (`tier0_read_only`) before any write |
|
|
13
|
+
|
|
14
|
+
## Ordering Rule
|
|
15
|
+
1. Confirm Blender version is `5.1+`.
|
|
16
|
+
2. Confirm no competing Path 2 bridge add-on is enabled inside Blender (`bridge-conflicts`).
|
|
17
|
+
3. Enable Blender Lab MCP add-on inside Blender first.
|
|
18
|
+
4. Attach Host `(a)` OR Host `(b)` — never claim readiness before observed tool handshake.
|
|
19
|
+
|
|
20
|
+
## Related skill
|
|
21
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Path 1 Host Checklist Template
|
|
2
|
+
|
|
3
|
+
Use this step-by-step verification template when outlining **Path 1 (Official Blender Lab MCP)** for either host option **(a) Anthropic Blender Connector** or **(b) Manual MCP client** (Claude Code, Cursor, Codex, OpenCode, Cline, Continue, Zed, Windsurf, etc.). Remember the Blender **5.1+** floor applies specifically to the Lab add-on manifest.
|
|
4
|
+
|
|
5
|
+
```txt
|
|
6
|
+
Path 1 Host Outline — Official Blender Lab MCP
|
|
7
|
+
=============================================
|
|
8
|
+
1) Blender Executable Floor:
|
|
9
|
+
- Required for Path 1: Blender 5.1+ (Lab add-on manifest requirement)
|
|
10
|
+
- Detected / planned version: <e.g. Blender 5.2.3 LTS | Not checked yet>
|
|
11
|
+
|
|
12
|
+
2) Blender-Side Lab MCP Add-on (MANDATORY before host setup):
|
|
13
|
+
- Installed Blender Lab MCP add-on inside Blender Preferences? [Yes | Pending user step]
|
|
14
|
+
- Add-on enabled and local server started inside Blender session? [Yes | Pending user step]
|
|
15
|
+
- Note: Anthropic Blender Connector is NOT standalone — step 2 is required even for Host (a).
|
|
16
|
+
|
|
17
|
+
3) Host Wiring (choose exactly one active host):
|
|
18
|
+
- Host (a) Anthropic Blender Connector -> Follow Anthropic's official connector setup AFTER step 2
|
|
19
|
+
- Host (b) Manual MCP Client -> Follow `docs/install/<target>.md` and point client config to Lab MCP server
|
|
20
|
+
|
|
21
|
+
4) Single-Bridge Sanity Check:
|
|
22
|
+
- Confirm community `mcp-for-blender` (Path 2) is disabled/unloaded and port 9876 has no conflicting bridge.
|
|
23
|
+
- If dual-bridge suspected -> stop and invoke `bridge-conflicts`.
|
|
24
|
+
|
|
25
|
+
5) Initial Read-Only Verification:
|
|
26
|
+
- Run one non-mutating inspection check (`get_scene_info` / `blendops runtime doctor`) before creating or editing meshes.
|
|
27
|
+
|
|
28
|
+
Truth Status:
|
|
29
|
+
Runtime status: Not Run (until live tool output captured)
|
|
30
|
+
Artifact status: Not Produced
|
|
31
|
+
Source docs: docs/runtime-stack-strategy.md, docs/external-runtime-setup.md
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Related skill
|
|
35
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Lab Add-on Reminders — Path 1 Prerequisites
|
|
2
|
+
|
|
3
|
+
Keep these hard boundaries visible whenever guiding a non-Blender user through Path 1 setup:
|
|
4
|
+
|
|
5
|
+
1. **Blender 5.1+ applies to Path 1 ONLY**: The Lab MCP add-on manifest sets `blender_version_min = 5.1.0`. Translate in plain user language: *"This official connection needs Blender 5.1 or newer."* If the user cannot upgrade from 3.x/4.x, stop and route back to `runtime-path-picker` (Path 2 or CLI appendix).
|
|
6
|
+
2. **Blender-side add-on precedes client setup**: Never advise enabling Anthropic Connector or editing Cursor/Claude Code MCP config alone and expecting Blender control to work. The Lab MCP add-on inside Blender opens the endpoint.
|
|
7
|
+
3. **One bridge per instance**: Never leave a community `mcp-for-blender` add-on active alongside Lab MCP inside the same Blender preferences profile.
|
|
8
|
+
4. **Verify add-on checkbox & restart if stalled**: Users frequently install the `.zip` without ticking the add-on enable checkbox or saving preferences before restarting Blender.
|
|
9
|
+
5. **Conservative truth status**: Document setup steps cleanly, then require `runtime-readiness` checks (`Runtime status: Not Run` until handshake is observed).
|
|
10
|
+
|
|
11
|
+
## Related skill
|
|
12
|
+
- [SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# EVAL — plain-language-response
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use plain-language-response to transform technical findings into plain-language user output.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- clear summary
|
|
8
|
+
- verified/unverified split
|
|
9
|
+
- prioritized next action
|
|
10
|
+
|
|
11
|
+
## Pass / Warn / Fail criteria
|
|
12
|
+
- Pass: plain language + truthful caveats
|
|
13
|
+
- Warn: minor jargon remains but understandable
|
|
14
|
+
- Fail: overclaiming or jargon-heavy output
|
|
15
|
+
|
|
16
|
+
## Common failure modes
|
|
17
|
+
- hiding blockers
|
|
18
|
+
- unsupported certainty language
|
|
19
|
+
|
|
20
|
+
## Evidence expectations
|
|
21
|
+
- status aligned with evidence
|
|
22
|
+
- caveats included
|
|
23
|
+
- next action included
|
|
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
|