blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
{
|
|
2
|
+
"bundle_name": "generic-project-local",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"status": "1.0.0 reference fixture",
|
|
5
|
+
"target": "generic-project",
|
|
6
|
+
"scope": "project-local",
|
|
7
|
+
"package_status": "local fixture / not published to marketplace",
|
|
8
|
+
"global_writes": false,
|
|
9
|
+
"runtime_status": "Not Run",
|
|
10
|
+
"artifact_status": "Not Produced",
|
|
11
|
+
"files": [
|
|
12
|
+
{
|
|
13
|
+
"path": "README.md",
|
|
14
|
+
"purpose": "Explains the fixture and safe manual use"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"path": "BLENDOPS.md",
|
|
18
|
+
"purpose": "Project-local instruction file to copy into a target project root"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"path": "ROLLBACK.md",
|
|
22
|
+
"purpose": "Rollback notes for project-local files"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"path": "INSTALL_REPORT_TEMPLATE.md",
|
|
26
|
+
"purpose": "Report template for manual or future scripted install attempts"
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"path": "manifest.json",
|
|
30
|
+
"purpose": "Machine-readable fixture metadata"
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"source_docs": [
|
|
34
|
+
"docs/ai-agent-install-flow.md",
|
|
35
|
+
"docs/install/generic-project.md",
|
|
36
|
+
"docs/install/installer-spec.md",
|
|
37
|
+
"docs/skill-system.md",
|
|
38
|
+
"docs/knowledge-and-recipe-catalog.md",
|
|
39
|
+
"docs/runtime-stack-strategy.md",
|
|
40
|
+
"registry/knowledge-sources.json",
|
|
41
|
+
"registry/knowledge-catalog.json",
|
|
42
|
+
"registry/recipe-catalog.json",
|
|
43
|
+
"registry/catalog-index.json",
|
|
44
|
+
"registry/runtime-operations.json",
|
|
45
|
+
"registry/runtime-capability-policy.json",
|
|
46
|
+
"schemas/scene-spec.schema.json",
|
|
47
|
+
"schemas/execution-plan.schema.json",
|
|
48
|
+
"schemas/runtime-session.schema.json",
|
|
49
|
+
"schemas/runtime-operations.schema.json",
|
|
50
|
+
"schemas/operation-execution-ledger.schema.json",
|
|
51
|
+
"skills/README.md",
|
|
52
|
+
"laws/README.md",
|
|
53
|
+
"packs/README.md",
|
|
54
|
+
"packs/product-hero-v0/PACK.md"
|
|
55
|
+
],
|
|
56
|
+
"non_actions": [
|
|
57
|
+
"does not install Blender",
|
|
58
|
+
"does not configure Claude Desktop Connector",
|
|
59
|
+
"does not configure official Blender MCP bridge/add-on",
|
|
60
|
+
"does not configure third-party runtime bridges",
|
|
61
|
+
"does not run Blender",
|
|
62
|
+
"does not run runtime eval",
|
|
63
|
+
"does not create preview/render/GLB artifacts",
|
|
64
|
+
"does not publish package/release/marketplace listing"
|
|
65
|
+
]
|
|
66
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# BlendOps skill package
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0 canonical portable skill package source
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
`bundles/skill-package/blendops/` is the canonical portable skill package source for BlendOps. It is the content-layer package that target-specific installers, manual import flows, and future adapter bundles should map into their own surfaces.
|
|
8
|
+
|
|
9
|
+
## Portable core content
|
|
10
|
+
|
|
11
|
+
The portable core is:
|
|
12
|
+
|
|
13
|
+
- `blendops/SKILL.md` — the package entrypoint.
|
|
14
|
+
- `blendops/references/` — flattened BlendOps skill, law, pack, runtime-boundary, and evidence-rule references.
|
|
15
|
+
- `blendops/LICENSE.txt` — license text for redistributed package form.
|
|
16
|
+
|
|
17
|
+
Those files are the target-neutral BlendOps skill content. They can be copied, referenced, or imported by compatible skill systems without implying a Blender runtime has been configured.
|
|
18
|
+
|
|
19
|
+
## Target-specific metadata
|
|
20
|
+
|
|
21
|
+
`blendops/agents/openai.yaml` is one consumer-specific metadata file for OpenAI/ChatGPT Skills UI upload compatibility. It is not the universal multi-agent adapter layer and does not configure Claude Desktop, Claude Code, OpenCode, Cursor, Codex, Gemini, Antigravity, GitHub Copilot, or the generic project-local fallback.
|
|
22
|
+
|
|
23
|
+
Other targets use separate install docs and adapter layers. Current guidance lives under `docs/install/`, `docs/multi-agent-install-strategy.md`, `docs/adapters/README.md`, and `docs/adapter-registry.md`; future adapter bundles may map this same core package into target-specific locations such as `.claude`, `.opencode`, `.cursor`, `.agents`, `.gemini`, `.agent`, or `.github` when those paths are verified.
|
|
24
|
+
|
|
25
|
+
## Non-actions
|
|
26
|
+
|
|
27
|
+
This package does not:
|
|
28
|
+
|
|
29
|
+
- install Blender,
|
|
30
|
+
- configure Claude Desktop Connector,
|
|
31
|
+
- configure the official Blender MCP bridge/add-on,
|
|
32
|
+
- configure third-party runtime bridges,
|
|
33
|
+
- run Blender,
|
|
34
|
+
- run runtime eval,
|
|
35
|
+
- produce preview/render/GLB artifacts,
|
|
36
|
+
- publish a package or marketplace listing.
|
|
37
|
+
|
|
38
|
+
Runtime status remains `Not Run` and artifact status remains `Not Produced` unless a separate eval record provides evidence.
|
|
39
|
+
|
|
40
|
+
## Deterministic skill reference summary generation
|
|
41
|
+
|
|
42
|
+
All 48 flattened per-skill summary files at `bundles/skill-package/blendops/references/skill-<skill-id>.md` (together with the 48 manual-bundle summaries at `bundles/claude-desktop-manual/references/skills/<skill-id>.md`) are deterministically generated from the canonical skill definitions:
|
|
43
|
+
|
|
44
|
+
- `skills/<skill-id>/SKILL.md`
|
|
45
|
+
- `skills/<skill-id>/contract.json`
|
|
46
|
+
|
|
47
|
+
Do not manually edit generated `blendops/references/skill-<skill-id>.md` files. Update the canonical skill sources under `skills/<skill-id>/` first, then run:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
npm run bundles:summaries:build
|
|
51
|
+
npm run bundles:summaries:check
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Note that `blendops/references/skill-map.md`, `blendops/references/runtime-stacks.md`, `blendops/references/evidence-rules.md`, `blendops/references/install-boundary.md`, `blendops/references/law-*.md`, and `blendops/references/pack-product-hero-v0.md` are preserved non-skill package references and are never overwritten by per-skill summary generation.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 BlendOps Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: blendops
|
|
3
|
+
description: Blender skills pack for non-Blender users. Use for scene planning, runtime readiness, render/export/GLB evidence, Claude Connect guidance, and plain-language handoff across multiple AI agents.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# BlendOps
|
|
7
|
+
|
|
8
|
+
Use this skill as the control plane for BlendOps workflow planning, runtime readiness, artifact evidence, and non-Blender-user explanations.
|
|
9
|
+
|
|
10
|
+
## Route by intent
|
|
11
|
+
|
|
12
|
+
Consult `references/skill-map.md` first, then load only the relevant flattened reference files:
|
|
13
|
+
|
|
14
|
+
- planning: product hero scene, composition/camera, lighting/material
|
|
15
|
+
- readiness: official runtime readiness and stack boundaries
|
|
16
|
+
- evidence: render/export/GLB truth labels
|
|
17
|
+
- handoff: GLB/web and plain-language summaries
|
|
18
|
+
- install/help: skill import, runtime boundary, and next safe action
|
|
19
|
+
|
|
20
|
+
## Non-negotiable truth rules
|
|
21
|
+
|
|
22
|
+
- Skill import is not runtime setup.
|
|
23
|
+
- Anthropic Blender Connector is not standalone — Anthropic's tutorial step 2 tells you to install the Blender Lab MCP add-on inside Blender. Path 1 always needs that Lab add-on (Blender 5.1+) regardless of host.
|
|
24
|
+
- Path 2 (community `mcp-for-blender` (formerly `blender-mcp`)) is mature third-party. Different add-on/server.
|
|
25
|
+
- CLI fallback (appendix) is direct Blender CLI; documented upstream as first-class Blender CLI, no in-repo evidence file yet.
|
|
26
|
+
- Run a read-only smoke test before any mutation, render, export, or runtime eval.
|
|
27
|
+
- Do not claim preview/render/GLB artifacts without evidence.
|
|
28
|
+
|
|
29
|
+
## Evidence states
|
|
30
|
+
|
|
31
|
+
Use: `Not Run`, `Attempted`, `Produced`, `Verified`, `Failed`.
|
|
32
|
+
|
|
33
|
+
Default after skill import:
|
|
34
|
+
|
|
35
|
+
- Runtime status: `Not Run`
|
|
36
|
+
- Artifact status: `Not Produced`
|
|
37
|
+
|
|
38
|
+
## Concise status block
|
|
39
|
+
|
|
40
|
+
```md
|
|
41
|
+
## BlendOps status
|
|
42
|
+
|
|
43
|
+
- Route:
|
|
44
|
+
- References used:
|
|
45
|
+
- Runtime status:
|
|
46
|
+
- Artifact status:
|
|
47
|
+
- Evidence:
|
|
48
|
+
- Caveats:
|
|
49
|
+
- Next safe action:
|
|
50
|
+
```
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# agents/ — Target-specific metadata
|
|
2
|
+
|
|
3
|
+
Status: 1.0.0
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
This folder contains target-specific metadata files for BlendOps skill package consumers. These files are not the universal multi-agent adapter layer; they are consumer-specific metadata for particular skill upload/import surfaces.
|
|
8
|
+
|
|
9
|
+
## Current files
|
|
10
|
+
|
|
11
|
+
### `openai.yaml`
|
|
12
|
+
|
|
13
|
+
OpenAI/ChatGPT Skills UI metadata only. This file provides display metadata (`display_name`, `short_description`) for OpenAI/ChatGPT skill upload compatibility.
|
|
14
|
+
|
|
15
|
+
**What it is:**
|
|
16
|
+
- OpenAI/ChatGPT-specific metadata for Skills UI upload.
|
|
17
|
+
|
|
18
|
+
**What it is not:**
|
|
19
|
+
- It does not configure Claude Desktop.
|
|
20
|
+
- It does not configure Claude Code.
|
|
21
|
+
- It does not configure OpenCode.
|
|
22
|
+
- It does not configure Cursor.
|
|
23
|
+
- It does not configure Codex.
|
|
24
|
+
- It does not configure Gemini.
|
|
25
|
+
- It does not configure Antigravity.
|
|
26
|
+
- It does not configure GitHub Copilot.
|
|
27
|
+
- It is not the universal multi-agent adapter layer.
|
|
28
|
+
|
|
29
|
+
## Multi-agent support
|
|
30
|
+
|
|
31
|
+
Multi-agent support comes from:
|
|
32
|
+
|
|
33
|
+
1. **Portable core content** — `SKILL.md` + `references/` are target-neutral and can be imported/copied by compatible skill systems.
|
|
34
|
+
2. **Install docs** — `docs/install/` provides per-target install guidance for Claude Desktop, Claude Code, OpenCode, Cursor, Codex, Gemini, Antigravity, GitHub Copilot, and generic project-local fallback.
|
|
35
|
+
3. **Adapter layers** — Future adapter bundles may map the same core package into target-specific locations (`.claude`, `.opencode`, `.cursor`, `.agents`, `.gemini`, `.agent`, `.github`, etc.) when those paths are verified.
|
|
36
|
+
|
|
37
|
+
See:
|
|
38
|
+
- `docs/multi-agent-install-strategy.md`
|
|
39
|
+
- `docs/adapters/README.md`
|
|
40
|
+
- `docs/adapter-registry.md`
|
|
41
|
+
- `docs/install/README.md`
|
|
42
|
+
|
|
43
|
+
## Adding target-specific metadata
|
|
44
|
+
|
|
45
|
+
If a new skill surface requires metadata beyond the portable core:
|
|
46
|
+
|
|
47
|
+
1. Add a new file in this folder (e.g., `claude-desktop.json`, `cursor.yaml`).
|
|
48
|
+
2. Document its purpose and scope in this README.
|
|
49
|
+
3. Clarify that it is target-specific metadata, not a universal adapter.
|
|
50
|
+
4. Update `docs/multi-agent-install-strategy.md` and `docs/adapter-registry.md` if the new surface changes the install model.
|
|
51
|
+
|
|
52
|
+
## Non-actions
|
|
53
|
+
|
|
54
|
+
Target-specific metadata files do not:
|
|
55
|
+
|
|
56
|
+
- install Blender,
|
|
57
|
+
- configure runtime bridges,
|
|
58
|
+
- run Blender or runtime eval,
|
|
59
|
+
- produce preview/render/GLB artifacts.
|
|
60
|
+
|
|
61
|
+
Runtime status remains `Not Run` and artifact status remains `Not Produced` unless a separate eval record provides evidence.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Evidence Rules
|
|
2
|
+
|
|
3
|
+
Evidence states:
|
|
4
|
+
|
|
5
|
+
- `Not Run`
|
|
6
|
+
- `Attempted`
|
|
7
|
+
- `Produced`
|
|
8
|
+
- `Verified`
|
|
9
|
+
- `Failed`
|
|
10
|
+
|
|
11
|
+
No preview/render/GLB claim is valid without output path or visible evidence plus validation notes.
|
|
12
|
+
|
|
13
|
+
A transcript alone is not enough for runtime success.
|
|
14
|
+
|
|
15
|
+
Default after import:
|
|
16
|
+
- Runtime status: `Not Run`
|
|
17
|
+
- Artifact status: `Not Produced`
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Install Boundary
|
|
2
|
+
|
|
3
|
+
Skill import is not runtime setup.
|
|
4
|
+
|
|
5
|
+
This upload-ready package does not:
|
|
6
|
+
- install Blender,
|
|
7
|
+
- configure Claude Desktop Connector,
|
|
8
|
+
- configure official Blender MCP bridge/add-on,
|
|
9
|
+
- run Blender,
|
|
10
|
+
- run runtime eval,
|
|
11
|
+
- produce preview/render/GLB artifacts.
|
|
12
|
+
|
|
13
|
+
Claude Desktop upload/import is a manual user action.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# evidence-before-done
|
|
2
|
+
|
|
3
|
+
Block readiness/success claims without evidence.
|
|
4
|
+
|
|
5
|
+
Must do:
|
|
6
|
+
- include runtime and artifact status,
|
|
7
|
+
- include verification outcomes,
|
|
8
|
+
- include caveats for unresolved checks.
|
|
9
|
+
|
|
10
|
+
Must not do:
|
|
11
|
+
- claim preview/render/GLB exists without evidence,
|
|
12
|
+
- mark Ready if evidence is missing.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# no-arbitrary-python-interface
|
|
2
|
+
|
|
3
|
+
Do not make arbitrary Python the final user-facing workflow.
|
|
4
|
+
|
|
5
|
+
Prefer constrained plans, readiness gates, evidence ledgers, and clear handoff notes.
|
|
6
|
+
|
|
7
|
+
Runtime execution should happen only after readiness is checked and user intent is explicit.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# non-blender-user-language
|
|
2
|
+
|
|
3
|
+
Explain outcomes for users who do not know Blender internals.
|
|
4
|
+
|
|
5
|
+
Use plain language, define technical caveats, and clearly separate:
|
|
6
|
+
- plan vs runtime execution,
|
|
7
|
+
- runtime readiness vs completed eval,
|
|
8
|
+
- intended artifacts vs produced evidence.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# official-runtime-only
|
|
2
|
+
|
|
3
|
+
Use documented Blender runtime paths only for release-facing BlendOps guidance:
|
|
4
|
+
|
|
5
|
+
1. **Path 1 — Official Blender Lab MCP.** Lab MCP add-on + Lab MCP server installed in Blender 5.1+, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually. Anthropic Connector is **not** standalone — Anthropic's tutorial step 2 tells you to install the Lab add-on inside Blender. The Blender 5.1+ floor applies to all of Path 1, regardless of host.
|
|
6
|
+
2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`).** Different add-on/server. Mature third-party, Blender 3.0+. Not endorsed by Anthropic or Blender Foundation, but treated as a supported path with extra caveats.
|
|
7
|
+
3. **CLI fallback (appendix).** Direct `blender --background --python`. No MCP. **Documented upstream** as a first-class Blender CLI surface; BlendOps has no in-repo evidence file yet.
|
|
8
|
+
|
|
9
|
+
Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance. Do not run Path 1 + Path 2 concurrently against the same Blender instance on `localhost:9876` (side-by-side on separate instances via per-instance `--port 9877` is supported upstream).
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# product-hero-v0 pack
|
|
2
|
+
|
|
3
|
+
1.0.0 workflow pack for product hero scene planning.
|
|
4
|
+
|
|
5
|
+
Included flow:
|
|
6
|
+
1. Help/routing
|
|
7
|
+
2. Scene planning
|
|
8
|
+
3. Composition/camera planning
|
|
9
|
+
4. Lighting/material planning
|
|
10
|
+
5. Quality gate
|
|
11
|
+
6. Runtime readiness
|
|
12
|
+
7. Render/export evidence
|
|
13
|
+
8. GLB/web handoff
|
|
14
|
+
9. Plain-language response
|
|
15
|
+
|
|
16
|
+
Evidence gates:
|
|
17
|
+
- Runtime remains `Not Run` until runtime evidence exists.
|
|
18
|
+
- Artifacts remain `Not Produced` until output evidence exists.
|
|
19
|
+
- No preview/render/GLB claim without validation notes.
|
|
20
|
+
|
|
21
|
+
Limitations: 1.0.0 workflow pack, not published to npm/marketplace, no runtime execution guarantee, no artifact guarantee.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Runtime Paths
|
|
4
|
+
|
|
5
|
+
BlendOps uses **two MCP execution paths** plus a **CLI fallback appendix** (replaces older 3-stack and 4-route labelings):
|
|
6
|
+
|
|
7
|
+
1. **Path 1 — Official Blender Lab MCP.** Lab add-on + Lab server installed in Blender, hosted from either (a) Anthropic Blender Connector in Claude Desktop, or (b) any other MCP client configured manually. Min Blender **5.1+** (Lab add-on manifest). Anthropic Connector is **not** standalone — Lab add-on inside Blender is required either way. Read-only smoke 2026-04-29 (likely Anthropic Connector host); mutation/render/export `Not Run`.
|
|
8
|
+
2. **Path 2 — Community `mcp-for-blender` (formerly `blender-mcp`).** Different `addon.py` + server via `uvx mcp-for-blender`. Mature third-party. Min Blender **3.0+**. User-reported verified; no formal evidence file yet.
|
|
9
|
+
3. **CLI fallback (appendix).** Direct `blender --background --python`. No MCP. Min Blender 4.2+ recommended. **Documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet.
|
|
10
|
+
|
|
11
|
+
Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance. Do not run Path 1 + Path 2 concurrently against the same Blender instance on `localhost:9876` (side-by-side on separate instances via per-instance `--port 9877` is supported upstream).
|
|
12
|
+
|
|
13
|
+
Runtime setup is separate from skill import.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/acceptance-criteria-builder/SKILL.md and skills/acceptance-criteria-builder/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# acceptance-criteria-builder
|
|
3
|
+
|
|
4
|
+
Purpose: Turn a locked 3D brief plus chosen recipe into a measurable acceptance checklist with evidence hooks.
|
|
5
|
+
|
|
6
|
+
Turn a locked 3D brief plus chosen recipe into a measurable acceptance checklist (`Criterion | Measurement | Evidence expected | Owner`) with evidence hooks, consumed by validators, `render-export-evidence`, and `pre-handoff-verification`. This skill is planning-only: it never executes Blender or Python, never produces artifacts, and never verifies files itself.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `measurable-acceptance-table-builder` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- after a brief is locked with `intent-to-3d-brief-writer` and a recipe is chosen, before expensive render or export stages
|
|
12
|
+
- when translating qualitative brief goals into measurable checklist rows with evidence hooks
|
|
13
|
+
- after `scope-guard` approves a brief or recipe delta that requires updated acceptance rows
|
|
14
|
+
- Trigger phrases: "acceptance criteria", "measurable checklist rows", "evidence hooks for brief", "sign-off checklist table"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- pure exploration without a locked deliverable → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming)
|
|
18
|
+
- writing or locking the brief itself → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; use intent-to-3d-brief-writer)
|
|
19
|
+
- pinning the stop or done condition → use `done-criteria` (`references/skill-done-criteria.md`; use done-criteria)
|
|
20
|
+
- enforcing per-stage workflow gates → use `stage-gates` (`references/skill-stage-gates.md`; use stage-gates)
|
|
21
|
+
- guarding or deciding scope boundaries → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard)
|
|
22
|
+
- legal or license-permission language → use `asset-license-checker` (`references/skill-asset-license-checker.md`; use asset-license-checker)
|
|
23
|
+
- classifying artifact evidence → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `locked_3d_brief` (`object`): Locked 8-slot 3D brief specifying subject, destination, deliverables, and constraints
|
|
27
|
+
- Required input `target_deliverable_channels` (`array`): Target delivery surfaces (hero still, catalog grid, turntable, or web GLB)
|
|
28
|
+
- Optional input `performance_budget_pins` (`object`): Optional triangle, texture, and file-size ceilings from mobile-glb-budget
|
|
29
|
+
- Output contract: `measurable_acceptance_criteria_table`, `pass_warn_fail_thresholds`, `evidence_hook_mappings` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. ingest brief slots + recipe expectations
|
|
33
|
+
2. expand using `skills/acceptance-criteria-builder/references/checklist-patterns.md`
|
|
34
|
+
3. attach evidence hooks per `skills/acceptance-criteria-builder/references/evidence-hook-rules.md`
|
|
35
|
+
4. format via `skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md`
|
|
36
|
+
|
|
37
|
+
## Cross-skill handoffs
|
|
38
|
+
- [upstream_reference] Brief source → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
39
|
+
- [progression] Done / stop condition → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
40
|
+
- [progression] Per-stage gate enforcement → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
|
|
41
|
+
- [progression] Scope boundary enforcement → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
42
|
+
- [progression] License permissions → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
|
|
43
|
+
- [progression] Artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
44
|
+
- [progression] Handoff gate verification → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
45
|
+
|
|
46
|
+
## Safety boundaries & non-goals
|
|
47
|
+
- Runtime boundary: This skill is strictly planning-only (no Python, no Blender execution). Checklists may define expected runtime evidence hooks, but must never execute tasks, verify files, or upgrade truth states beyond what upstream evidence skills report.
|
|
48
|
+
- Unlocking or rewriting the creative brief from scratch (use `intent-to-3d-brief-writer`).
|
|
49
|
+
- Executing Blender, generating Python scripts, or running automated file inspectors.
|
|
50
|
+
- Certifying that rendered images or exported GLB files actually meet the checklist (use `render-export-evidence` and `pre-handoff-verification`).
|
|
51
|
+
- Providing legal advice or asset license clearance (use `asset-license-checker`).
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-discovery/SKILL.md and skills/asset-discovery/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# asset-discovery
|
|
3
|
+
|
|
4
|
+
Purpose: Plan the asset acquisition strategy (procedural, library, generative, photogrammetry) for a Blender scene without installing or executing. Use after the brief, before scene planning.
|
|
5
|
+
|
|
6
|
+
Decide where the assets in a scene will come from before the scene planner commits to a layout. Asset acquisition decisions affect poly budget, web GLB size, licensing, and time-to-handoff. This skill produces a per-asset plan with explicit confidence labels and licensing notes — without installing tools, running Blender, or fetching anything.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `asset-strategy-and-source-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- after the 3D brief is locked, before any scene plan
|
|
12
|
+
- when scene assets aren't trivially given (e.g. user says "shoe" but doesn't supply a shoe model)
|
|
13
|
+
- when poly budget / GLB size / brand-licensing constraints exist
|
|
14
|
+
- when planner needs to know upfront whether assets are procedural or external
|
|
15
|
+
- Trigger phrases: "what assets do we need", "where do the models come from", "asset plan before scene planning", "do we generate or import", "surface asset license risks before planning"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- the user supplied all assets in the brief (skip; route directly to planner) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; skip; route directly to planner)
|
|
19
|
+
- runtime is already executing and assets are already in the scene → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; route to evidence skill)
|
|
20
|
+
- the request is iteration on an existing scene (assets are already chosen) → use `render-export-evidence` (`references/skill-render-export-evidence.md`; assets are already chosen)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `locked_3d_brief` (`object`): Structured 3D brief listing required hero subject, props, environment, and materials
|
|
24
|
+
- Required input `target_delivery_channel` (`string`): Target output surface driving geometry and texture fidelity requirements
|
|
25
|
+
- Optional input `existing_user_assets` (`array`): User-supplied CAD/FBX/OBJ/GLB files or brand texture sets
|
|
26
|
+
- Output contract: `asset_sourcing_matrix`, `procedural_vs_external_split`, `license_and_budget_risk_register` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. read the 8-slot brief from `intent-to-3d-brief-writer`
|
|
30
|
+
2. enumerate every asset class needed (subjects, props, environment, materials, HDRIs)
|
|
31
|
+
3. pick a strategy per asset class (procedural / library / generative / photogrammetry)
|
|
32
|
+
4. record license + confidence label per choice
|
|
33
|
+
5. hand off to scene planner
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] **Before this skill** → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
37
|
+
- [alternative] **Scene planners (primary handoff with brief + asset plan)** (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
38
|
+
- [alternative] **Scene planners (primary handoff with brief + asset plan)** (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
39
|
+
- [alternative] **Scene planners (primary handoff with brief + asset plan)** (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
40
|
+
- [alternative] **Scene planners (primary handoff with brief + asset plan)** (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
41
|
+
- [alternative] **Scene planners (primary handoff with brief + asset plan)** (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
42
|
+
- [progression] **License verdicts** → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
|
|
43
|
+
- [progression] **Style re-checks** → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
44
|
+
- [progression] **Budget reconciliation** (mobile-glb-budget) → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
45
|
+
- [progression] **Budget reconciliation** (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
46
|
+
- [upstream_reference] **Generative readiness** → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
47
|
+
- [fallback] **Fallback / constraint updates** (asset-fallback-strategy) → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
|
|
48
|
+
|
|
49
|
+
## Safety boundaries & non-goals
|
|
50
|
+
- Runtime boundary: This skill does not download, generate, fetch, or install any asset. It does not run Blender, configure any MCP path, or touch the network. It produces a plain-language plan in markdown.
|
|
51
|
+
- fetching / downloading / installing assets
|
|
52
|
+
- running Blender or generative tools
|
|
53
|
+
- making the scene plan
|
|
54
|
+
- license adjudication beyond surfacing risk
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-fallback-strategy/SKILL.md and skills/asset-fallback-strategy/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# asset-fallback-strategy
|
|
3
|
+
|
|
4
|
+
Purpose: Provide a fallback strategy when an asset is unavailable, over-budget, license-blocked, or style-incompatible — without halting the recipe.
|
|
5
|
+
|
|
6
|
+
When `asset-license-checker`, `asset-style-check`, or `mobile-glb-budget` blocks an asset (or an asset is unavailable), this skill plans 2-3 actionable fallback options (replace / re-source / procedural / generative / drop-with-caveat) ordered by speed so the recipe can proceed. Any chosen replacement must re-pass `asset-license-checker` and `asset-style-check` (plus `mobile-glb-budget` when budget applies).
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `blocked-asset-replacement-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- after a checker fails an asset
|
|
12
|
+
- when an asset cannot be acquired in time
|
|
13
|
+
- when budget excludes the originally-planned asset
|
|
14
|
+
- when license blocks an asset
|
|
15
|
+
- Trigger phrases: "what if we can't get this asset", "fallback for the model", "the license blocks us", "scaled-down asset"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- when no asset has failed (nothing to fall back to) → use `asset-license-checker` (`references/skill-asset-license-checker.md`; nothing to fall back to)
|
|
19
|
+
- pure exploration (no concrete asset list) → use `asset-discovery` (`references/skill-asset-discovery.md`; no concrete asset list)
|
|
20
|
+
- when the user wants to wait for the original asset → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `blocked_asset_entry` (`object`): Asset blocked by missing source, incompatible license, style mismatch, or budget breach
|
|
24
|
+
- Required input `blocking_reason` (`enum`): Primary block reason (license_rejected, source_unavailable, style_mismatch, budget_exceeded)
|
|
25
|
+
- Optional input `local_library_manifest` (`object`): Optional inventory of cleared local assets from asset-library-plan
|
|
26
|
+
- Output contract: `ranked_fallback_options`, `selected_replacement_plan`, `revalidation_routing_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. read the failed asset + blocking reason
|
|
30
|
+
2. propose 2-3 fallback options ordered by speed-to-implement (always including `drop-with-caveat`)
|
|
31
|
+
3. score each option on time, brief-match, and license
|
|
32
|
+
4. pick one only with explicit user agreement
|
|
33
|
+
5. update the asset list and route any replacement back through `asset-license-checker` and `asset-style-check` (and `mobile-glb-budget` if budget-constrained)
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] Re-source external asset → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
37
|
+
- [progression] Internal library lookup → `asset-library-plan` (`references/skill-asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
|
|
38
|
+
- [fallback] License re-check on replacement → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
|
|
39
|
+
- [fallback] Style re-check on replacement → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
40
|
+
- [progression] Budget re-check on replacement → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
41
|
+
- [fallback] Scope reduction when no viable fallback exists → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
42
|
+
- [fallback] Recipe split when no viable fallback exists → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Process and planning skill only — never acquires, generates, or edits assets itself. Outputs a fallback plan and routes execution or re-verification to dedicated skills.
|
|
46
|
+
- Acquire, generate, or edit assets itself.
|
|
47
|
+
- Run Blender or execute Python.
|
|
48
|
+
- Perform license, style, or performance budget checks itself.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-library-plan/SKILL.md and skills/asset-library-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# asset-library-plan
|
|
3
|
+
|
|
4
|
+
Purpose: Plan an internal asset library structure (folders, naming, metadata, license tracking, version control) so future recipes find and reuse assets reliably.
|
|
5
|
+
|
|
6
|
+
Plan a maintainable internal asset library structure (folder tree, naming convention, per-asset metadata schema, license-tracking strategy, version-control rules, migration steps, and review process) so future recipes can: - find existing assets quickly, - avoid re-licensing the same source, - reuse PBR materials and HDRIs, - track versions and revisions, - serve as the internal-library source for `asset-discovery` and `asset-fallback-strategy`.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `local-asset-library-taxonomy-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- starting a new BlendOps repo with multiple recipes
|
|
12
|
+
- existing library is disorganized; recipes can't find assets
|
|
13
|
+
- before scaling to 50+ assets
|
|
14
|
+
- Trigger phrases: "organize the assets", "asset library structure", "where should assets go", "name our assets"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- single-recipe repo with < 5 assets → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
|
|
18
|
+
- pure planning before any asset categories or storage constraints are known → use `asset-license-checker` (`references/skill-asset-license-checker.md`; Delegates out-of-scope requests to asset-license-checker)
|
|
19
|
+
- sourcing or acquiring external assets → use `asset-discovery` (`references/skill-asset-discovery.md`; use asset-discovery)
|
|
20
|
+
- verifying asset licenses → use `asset-license-checker` (`references/skill-asset-license-checker.md`; use asset-license-checker)
|
|
21
|
+
- checking visual style consistency across assets → use `asset-style-check` (`references/skill-asset-style-check.md`; use asset-style-check)
|
|
22
|
+
- planning fallback substitutions when an asset is missing or fails → use `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`; use asset-fallback-strategy)
|
|
23
|
+
- enforcing file size or polygon/asset count performance budgets → use `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`; use mobile-glb-budget)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `raw_asset_inventory` (`array`): List of 3D models, PBR material sets, HDRIs, and license sidecar files to organize
|
|
27
|
+
- Required input `project_storage_scope` (`string`): Whether the library is project-local or shared across multiple BlendOps packs
|
|
28
|
+
- Optional input `naming_prefix_convention` (`string`): Optional studio or project naming prefix for datablocks and folders
|
|
29
|
+
- Output contract: `directory_taxonomy_plan`, `datablock_naming_rules`, `quarantine_and_license_sidecar_policy` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. pin folder structure (kebab-case, by category)
|
|
33
|
+
2. pin naming convention (asset name + version + license slug)
|
|
34
|
+
3. pin metadata schema (license, source, date, version, hash)
|
|
35
|
+
4. pin version control rules (LFS for large binaries, plain text for metadata)
|
|
36
|
+
5. emit a library-init plan
|
|
37
|
+
|
|
38
|
+
## Cross-skill handoffs
|
|
39
|
+
- [upstream_reference] External asset sourcing into this library → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
40
|
+
- [upstream_reference] License verification (license file next to asset; unlicensed old assets to Quarantine) → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
|
|
41
|
+
- [upstream_reference] Visual style consistency checks → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
42
|
+
- [fallback] Consuming this library as fastest fallback source → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
|
|
43
|
+
- [progression] File size and asset/polygon count pressure → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
44
|
+
|
|
45
|
+
## Safety boundaries & non-goals
|
|
46
|
+
- Runtime boundary: Planning skill — never moves files, never configures git/LFS/DAM, never runs Blender, and never produces library files. Outputs a structure spec, migration steps, and review process only.
|
|
47
|
+
- Move, rename, or delete files.
|
|
48
|
+
- Configure git, Git LFS, Perforce, or DAM tools.
|
|
49
|
+
- Run Blender or execute Python.
|
|
50
|
+
- Buy or source external assets (use `asset-discovery`).
|
|
51
|
+
- Verify licenses, style consistency, or performance budgets (use `asset-license-checker`, `asset-style-check`, `mobile-glb-budget`).
|