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,256 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import fs from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { fileURLToPath } from 'node:url';
|
|
5
|
+
import Ajv2020 from 'ajv/dist/2020.js';
|
|
6
|
+
|
|
7
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
8
|
+
const __dirname = path.dirname(__filename);
|
|
9
|
+
const DEFAULT_SCHEMA_PATH = path.resolve(__dirname, '..', 'schemas', 'runtime-evidence-packet.schema.json');
|
|
10
|
+
|
|
11
|
+
const PATH_1_EXCLUSIVE_TOOLS = new Set([
|
|
12
|
+
'get_blendfile_summary_datablocks',
|
|
13
|
+
'get_objects_summary',
|
|
14
|
+
'get_object_Hierarchy_and_Transforms',
|
|
15
|
+
]);
|
|
16
|
+
|
|
17
|
+
const PATH_2_EXCLUSIVE_TOOLS = new Set([
|
|
18
|
+
'get_scene_info',
|
|
19
|
+
'get_object_info',
|
|
20
|
+
'execute_blender_code',
|
|
21
|
+
]);
|
|
22
|
+
|
|
23
|
+
let cachedSchemaValidator = null;
|
|
24
|
+
|
|
25
|
+
function getEvidenceSchemaValidator(schemaPath = DEFAULT_SCHEMA_PATH) {
|
|
26
|
+
if (cachedSchemaValidator && cachedSchemaValidator.schemaPath === schemaPath) {
|
|
27
|
+
return cachedSchemaValidator.validate;
|
|
28
|
+
}
|
|
29
|
+
const raw = fs.readFileSync(schemaPath, 'utf8');
|
|
30
|
+
const schema = JSON.parse(raw);
|
|
31
|
+
const ajv = new Ajv2020({ allErrors: true, strict: true });
|
|
32
|
+
const validate = ajv.compile(schema);
|
|
33
|
+
cachedSchemaValidator = { schemaPath, validate };
|
|
34
|
+
return validate;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export function parseSemverTuple(versionStr) {
|
|
38
|
+
if (typeof versionStr !== 'string') return null;
|
|
39
|
+
const m = versionStr.trim().match(/^(\d+)\.(\d+)\.(\d+)$/);
|
|
40
|
+
if (!m) return null;
|
|
41
|
+
return [Number(m[1]), Number(m[2]), Number(m[3])];
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
export function isVersionAtLeast(versionStr, minTuple) {
|
|
45
|
+
const parsed = parseSemverTuple(versionStr);
|
|
46
|
+
if (!parsed) return false;
|
|
47
|
+
for (let i = 0; i < 3; i += 1) {
|
|
48
|
+
if (parsed[i] > minTuple[i]) return true;
|
|
49
|
+
if (parsed[i] < minTuple[i]) return false;
|
|
50
|
+
}
|
|
51
|
+
return true;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export function validateEvidencePacket(packet, { catalogSkillSet = null, schemaPath = DEFAULT_SCHEMA_PATH } = {}) {
|
|
55
|
+
const errors = [];
|
|
56
|
+
|
|
57
|
+
if (!packet || typeof packet !== 'object' || Array.isArray(packet)) {
|
|
58
|
+
return {
|
|
59
|
+
valid: false,
|
|
60
|
+
errors: ['Evidence packet root must be a JSON object'],
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const validateSchema = getEvidenceSchemaValidator(schemaPath);
|
|
65
|
+
const schemaOk = validateSchema(packet);
|
|
66
|
+
if (!schemaOk) {
|
|
67
|
+
for (const err of validateSchema.errors || []) {
|
|
68
|
+
const loc = err.instancePath || '/';
|
|
69
|
+
const allowed = Array.isArray(err.params?.allowedValues)
|
|
70
|
+
? ` [${err.params.allowedValues.join(', ')}]`
|
|
71
|
+
: '';
|
|
72
|
+
errors.push(`schema(${loc}): ${err.message}${allowed}`);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
if (catalogSkillSet && typeof packet.skillId === 'string' && !catalogSkillSet.has(packet.skillId)) {
|
|
77
|
+
errors.push(`skillId '${packet.skillId}' does not exist in the 48-skill catalog`);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const rt = packet.runtimeEvidence;
|
|
81
|
+
const art = packet.artifactEvidence;
|
|
82
|
+
const checks = packet.validationChecks;
|
|
83
|
+
|
|
84
|
+
if (!rt || typeof rt !== 'object' || !art || typeof art !== 'object' || !checks || typeof checks !== 'object') {
|
|
85
|
+
return { valid: false, errors };
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// 1. Truth-state taxonomy separation guard
|
|
89
|
+
if (art.artifactStatus === 'Not Run') {
|
|
90
|
+
errors.push(
|
|
91
|
+
`Truth-state taxonomy violation: artifactEvidence.artifactStatus cannot be 'Not Run' (default artifact state is 'Not Produced')`,
|
|
92
|
+
);
|
|
93
|
+
}
|
|
94
|
+
if (rt.runtimeStatus === 'Not Produced') {
|
|
95
|
+
errors.push(
|
|
96
|
+
`Truth-state taxonomy violation: runtimeEvidence.runtimeStatus cannot be 'Not Produced' (default runtime state is 'Not Run')`,
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// 2. Runtime path === 'none' constraints
|
|
101
|
+
if (rt.runtimePath === 'none') {
|
|
102
|
+
if (rt.runtimeStatus !== 'Not Run') {
|
|
103
|
+
errors.push(
|
|
104
|
+
`When runtimeEvidence.runtimePath is 'none', runtimeStatus must be 'Not Run' (received '${rt.runtimeStatus}')`,
|
|
105
|
+
);
|
|
106
|
+
}
|
|
107
|
+
if (art.artifactStatus !== 'Not Produced') {
|
|
108
|
+
errors.push(
|
|
109
|
+
`When runtimeEvidence.runtimePath is 'none', artifactStatus must be 'Not Produced' (received '${art.artifactStatus}')`,
|
|
110
|
+
);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// 3. Path 1 (Official Blender Lab MCP) version floor (>= 5.1.0) & tool signature checks
|
|
115
|
+
const isActiveRuntime = ['Attempted', 'Produced', 'Verified'].includes(rt.runtimeStatus);
|
|
116
|
+
if (rt.runtimePath === 'path-1-host-a' || rt.runtimePath === 'path-1-host-b') {
|
|
117
|
+
if (isActiveRuntime) {
|
|
118
|
+
if (!rt.blenderVersion) {
|
|
119
|
+
errors.push(
|
|
120
|
+
`Path 1 (${rt.runtimePath}) active runtime state '${rt.runtimeStatus}' requires blenderVersion >= 5.1.0`,
|
|
121
|
+
);
|
|
122
|
+
} else if (!isVersionAtLeast(rt.blenderVersion, [5, 1, 0])) {
|
|
123
|
+
errors.push(
|
|
124
|
+
`Path 1 (${rt.runtimePath}) requires Blender >= 5.1.0 per Lab MCP add-on manifest (received '${rt.blenderVersion}')`,
|
|
125
|
+
);
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
for (const tool of rt.observedMcpTools || []) {
|
|
129
|
+
if (PATH_2_EXCLUSIVE_TOOLS.has(tool)) {
|
|
130
|
+
errors.push(
|
|
131
|
+
`Path 1 (${rt.runtimePath}) evidence packet lists Path 2 community MCP tool '${tool}' in observedMcpTools`,
|
|
132
|
+
);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
// 4. Path 2 (Community mcp-for-blender) version floor (>= 3.0.0) & tool signature checks
|
|
138
|
+
if (rt.runtimePath === 'path-2-community') {
|
|
139
|
+
if (isActiveRuntime) {
|
|
140
|
+
if (!rt.blenderVersion) {
|
|
141
|
+
errors.push(`Path 2 (path-2-community) active runtime state '${rt.runtimeStatus}' requires blenderVersion >= 3.0.0`);
|
|
142
|
+
} else if (!isVersionAtLeast(rt.blenderVersion, [3, 0, 0])) {
|
|
143
|
+
errors.push(`Path 2 (path-2-community) requires Blender >= 3.0.0 (received '${rt.blenderVersion}')`);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
for (const tool of rt.observedMcpTools || []) {
|
|
147
|
+
if (PATH_1_EXCLUSIVE_TOOLS.has(tool)) {
|
|
148
|
+
errors.push(
|
|
149
|
+
`Path 2 (path-2-community) evidence packet lists Path 1 Blender Lab MCP tool '${tool}' in observedMcpTools`,
|
|
150
|
+
);
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
// 5. Evidence-Before-Done: Produced / Verified artifact requirements
|
|
156
|
+
if (art.artifactStatus === 'Produced' || art.artifactStatus === 'Verified') {
|
|
157
|
+
if (rt.runtimeStatus !== 'Produced' && rt.runtimeStatus !== 'Verified') {
|
|
158
|
+
errors.push(
|
|
159
|
+
`Evidence-before-done violation: artifactStatus '${art.artifactStatus}' requires runtimeStatus to be 'Produced' or 'Verified' (received '${rt.runtimeStatus}')`,
|
|
160
|
+
);
|
|
161
|
+
}
|
|
162
|
+
if (art.artifactType === 'none') {
|
|
163
|
+
errors.push(
|
|
164
|
+
`Evidence-before-done violation: artifactStatus '${art.artifactStatus}' cannot have artifactType 'none'`,
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
if (typeof art.artifactPath !== 'string' || art.artifactPath.trim().length === 0) {
|
|
168
|
+
errors.push(
|
|
169
|
+
`Evidence-before-done violation: artifactStatus '${art.artifactStatus}' requires a non-empty artifactPath`,
|
|
170
|
+
);
|
|
171
|
+
}
|
|
172
|
+
if (!Number.isInteger(art.byteSize) || art.byteSize <= 0) {
|
|
173
|
+
errors.push(
|
|
174
|
+
`Evidence-before-done violation: artifactStatus '${art.artifactStatus}' requires positive integer byteSize (received ${JSON.stringify(art.byteSize)})`,
|
|
175
|
+
);
|
|
176
|
+
}
|
|
177
|
+
if (typeof art.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(art.sha256)) {
|
|
178
|
+
errors.push(
|
|
179
|
+
`Evidence-before-done violation: artifactStatus '${art.artifactStatus}' requires a 64-character hex sha256 digest`,
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
if (art.artifactType === 'glb') {
|
|
183
|
+
if (!art.glbInspection || art.glbInspection.valid !== true) {
|
|
184
|
+
errors.push(
|
|
185
|
+
`Evidence-before-done violation: GLB artifact with status '${art.artifactStatus}' requires glbInspection.valid === true`,
|
|
186
|
+
);
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
// 6. Verified gate: requires non-static fixture + runtimeStatus Verified + all applicable validationChecks Passed
|
|
192
|
+
if (rt.runtimeStatus === 'Verified' && packet.isStaticFixture === true) {
|
|
193
|
+
errors.push(
|
|
194
|
+
`Evidence-before-done violation: static fixture (isStaticFixture: true) cannot claim live runtimeStatus 'Verified'`,
|
|
195
|
+
);
|
|
196
|
+
}
|
|
197
|
+
if (art.artifactStatus === 'Verified') {
|
|
198
|
+
if (packet.isStaticFixture === true) {
|
|
199
|
+
errors.push(
|
|
200
|
+
`Evidence-before-done violation: static fixture (isStaticFixture: true) cannot claim live artifactStatus 'Verified'`,
|
|
201
|
+
);
|
|
202
|
+
}
|
|
203
|
+
if (rt.runtimeStatus !== 'Verified') {
|
|
204
|
+
errors.push(
|
|
205
|
+
`Evidence-before-done violation: artifactStatus 'Verified' requires runtimeStatus 'Verified' (received '${rt.runtimeStatus}')`,
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
const checkEntries = Object.entries(checks);
|
|
209
|
+
let passedCount = 0;
|
|
210
|
+
for (const [checkName, checkVal] of checkEntries) {
|
|
211
|
+
if (checkVal === 'Passed') {
|
|
212
|
+
passedCount += 1;
|
|
213
|
+
} else if (checkVal !== 'Not Applicable') {
|
|
214
|
+
errors.push(
|
|
215
|
+
`Evidence-before-done violation: artifactStatus 'Verified' requires validationChecks.${checkName} to be 'Passed' or 'Not Applicable' (received '${checkVal}')`,
|
|
216
|
+
);
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
if (passedCount === 0) {
|
|
220
|
+
errors.push(
|
|
221
|
+
`Evidence-before-done violation: artifactStatus 'Verified' requires at least one validationCheck to be 'Passed'`,
|
|
222
|
+
);
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
return {
|
|
227
|
+
valid: errors.length === 0,
|
|
228
|
+
errors,
|
|
229
|
+
};
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
function main() {
|
|
233
|
+
const args = process.argv.slice(2);
|
|
234
|
+
const positional = args.filter((a) => !a.startsWith('--'));
|
|
235
|
+
if (positional.length === 0) {
|
|
236
|
+
console.error('Usage: node scripts/validate-evidence-packet.mjs <packet.json>');
|
|
237
|
+
process.exit(1);
|
|
238
|
+
}
|
|
239
|
+
const targetPath = path.resolve(positional[0]);
|
|
240
|
+
if (!fs.existsSync(targetPath)) {
|
|
241
|
+
console.error(`Evidence packet file not found: ${positional[0]}`);
|
|
242
|
+
process.exit(1);
|
|
243
|
+
}
|
|
244
|
+
const parsed = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
|
|
245
|
+
const res = validateEvidencePacket(parsed);
|
|
246
|
+
if (!res.valid) {
|
|
247
|
+
console.error('Evidence packet validation failed:');
|
|
248
|
+
for (const err of res.errors) console.error(`- ${err}`);
|
|
249
|
+
process.exit(1);
|
|
250
|
+
}
|
|
251
|
+
console.log(`Evidence packet valid: ${parsed.packetId} (runtime=${parsed.runtimeEvidence.runtimeStatus}, artifact=${parsed.artifactEvidence.artifactStatus})`);
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
if (process.argv[1] && path.resolve(process.argv[1]) === __filename) {
|
|
255
|
+
main();
|
|
256
|
+
}
|
package/skills/README.md
ADDED
|
@@ -0,0 +1,315 @@
|
|
|
1
|
+
# BlendOps Skills Collection
|
|
2
|
+
|
|
3
|
+
> [!NOTE]
|
|
4
|
+
> Status: 1.0.0. These are portable AI-agent skill units for Blender workflow planning, runtime readiness, evidence truth, and user-facing handoff.
|
|
5
|
+
|
|
6
|
+
BlendOps skills are composable operating units. They load only when relevant, follow shared laws, preserve runtime boundaries, and hand off to the next narrow skill instead of becoming one monolithic Blender prompt.
|
|
7
|
+
|
|
8
|
+
Core guide: [docs/skill-system.md](../docs/skill-system.md)
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Skill philosophy
|
|
13
|
+
|
|
14
|
+
| Principle | Required behavior |
|
|
15
|
+
|---|---|
|
|
16
|
+
| Composable | Prefer narrow skills with explicit handoffs. |
|
|
17
|
+
| Evidence-bound | Runtime/artifact claims require recorded evidence. |
|
|
18
|
+
| Runtime-separated | Skill install does not install Blender or runtime bridges. |
|
|
19
|
+
| Evidence-safe | Keep `Not Run`, `Not Produced`, and truth-state caveats visible. |
|
|
20
|
+
| Portable | Keep core skill logic tool-agnostic; adapters map to target agents later. |
|
|
21
|
+
|
|
22
|
+
### 10-Second Routing Across the 8 `skills.sh.json` Groups
|
|
23
|
+
|
|
24
|
+
| Group | Entry skills | Inherited reference upgrades |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| **1. Workflow & Intake** | `blendops-help`, `blender-brainstorming`, `intent-to-3d-brief-writer` | Superpowers Iron Law / Anti-Rationalization tables + Reference silhouette slot |
|
|
27
|
+
| **2. Scene Planning** | `product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene` | Six-face & paired-component product anatomy completeness (`-Y/+Y/+Z/-Z/-X/+X`) |
|
|
28
|
+
| **3. Camera, Lighting & Materials** | `camera-composition`, `lighting-material-plan`, `*-quality-checker` | Principled BSDF IOR/Roughness/Albedo lookup, 5-layer wear stack, `AgX` vs `Khronos PBR Neutral` |
|
|
29
|
+
| **4. Assets & Budgets** | `asset-discovery`, `asset-license-checker`, `polycount-budget-checker`, `mobile-glb-budget` | 6-gate mesh/UV QA tolerances (`1e-4` weld, sharp-edge UV seams `>60°`, texel density) |
|
|
30
|
+
| **5. Render & Output** | `cycles-vs-eevee-decision`, `output-format-decision`, `render-export-evidence` | Simulation bake gate (`ALL` cache vs replay preview) & downgrade-only provenance |
|
|
31
|
+
| **6. Scene Verification** | `scene-readiness`, `pre-handoff-verification`, `blender-troubleshooting` | 7-point Iron Law & Red-Flags table + Reference-Image-Match silhouette loop |
|
|
32
|
+
| **7. Web 3D & GLB** | `glb-web-handoff`, `glb-animation-handoff`, `r3f-component-plan` | `EXT_meshopt_compression`/KTX2/WebP budgets + Godot/Unreal/Unity parity matrix |
|
|
33
|
+
| **8. Runtime & MCP** | `runtime-path-picker`, `runtime-setup`, `runtime-readiness`, `runtime-attempt-report` | Secure async MCP (`L0`–`L3`), SHA-256 contract pinning, & no-upgrade truth blocks |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Current skill inventory
|
|
38
|
+
|
|
39
|
+
### 🧭 Help and routing
|
|
40
|
+
|
|
41
|
+
| Skill | Purpose | Use when | Depth status | Gate review | Eval |
|
|
42
|
+
|---|---|---|---|---|---|
|
|
43
|
+
| `blendops-help` | Next-step routing across docs, skills, readiness, evidence, packaging, and release status | Goal/status is unclear or multiple skills could apply | Production 1.0.0 | Pass | [EVAL](./blendops-help/EVAL.md) |
|
|
44
|
+
|
|
45
|
+
### 🧭 Setup and readiness
|
|
46
|
+
|
|
47
|
+
| Skill | Purpose | Use when | Depth status | Gate review | Eval |
|
|
48
|
+
|---|---|---|---|---|---|
|
|
49
|
+
| `runtime-setup` | Runtime prerequisite guidance and confidence labels | Runtime setup path is unclear | Production 1.0.0 | Pass | [EVAL](./runtime-setup/EVAL.md) |
|
|
50
|
+
| `runtime-readiness` | Readiness matrix and blocker reporting; canonical role `runtime-readiness` | Before a runtime eval attempt | Production 1.0.0 | Pass | [EVAL](./runtime-readiness/EVAL.md) |
|
|
51
|
+
|
|
52
|
+
### 🎬 Planning
|
|
53
|
+
|
|
54
|
+
| Skill | Purpose | Use when | Depth status | Gate review | Eval |
|
|
55
|
+
|---|---|---|---|---|---|
|
|
56
|
+
| `product-hero-scene-planner` | Full product-hero scene plan schema; canonical role `scene-planning` for product-hero workflows | User asks for hero scene planning | Production 1.0.0 | Pass | [EVAL](./product-hero-scene-planner/EVAL.md) |
|
|
57
|
+
| `camera-composition` | Composition and camera strategy | Framing or camera decisions need depth | Production 1.0.0 | Pass | [EVAL](./camera-composition/EVAL.md) |
|
|
58
|
+
| `lighting-material-plan` | Lighting/material lookdev plan plus portability caveats | Lookdev strategy is required | Production 1.0.0 | Pass | [EVAL](./lighting-material-plan/EVAL.md) |
|
|
59
|
+
|
|
60
|
+
### ✅ Quality and eval
|
|
61
|
+
|
|
62
|
+
| Skill | Purpose | Use when | Depth status | Gate review | Eval |
|
|
63
|
+
|---|---|---|---|---|---|
|
|
64
|
+
| `scene-readiness` | Pass/warn/fail readiness and verdict | A readiness decision is needed | Production 1.0.0 | Pass | [EVAL](./scene-readiness/EVAL.md) |
|
|
65
|
+
| `render-export-evidence` | Preview/render/GLB evidence ledger and artifact truth labels | Artifact status must be proven or downgraded | Production 1.0.0 | Pass | [EVAL](./render-export-evidence/EVAL.md) |
|
|
66
|
+
|
|
67
|
+
### 📦 Handoff and communication
|
|
68
|
+
|
|
69
|
+
| Skill | Purpose | Use when | Depth status | Gate review | Eval |
|
|
70
|
+
|---|---|---|---|---|---|
|
|
71
|
+
| `glb-web-handoff` | GLB/web handoff status and caveats | Handoff clarity is required | Production 1.0.0 | Pass | [EVAL](./glb-web-handoff/EVAL.md) |
|
|
72
|
+
| `plain-language-response` | Plain-language final response | Stakeholder-facing summary is needed | Production 1.0.0 | Pass | [EVAL](./plain-language-response/EVAL.md) |
|
|
73
|
+
|
|
74
|
+
### 🌐 Web 3D handoff deep
|
|
75
|
+
|
|
76
|
+
Each ships with `SKILL.md` + `EVAL.md` + 3 `references/` files.
|
|
77
|
+
|
|
78
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
79
|
+
|---|---|---|---|---|---|
|
|
80
|
+
| `mobile-glb-budget` | Set explicit triangle / texture / draw-call / file-size / animation budgets per device tier before any export decision | User mentions "mobile" / "phone" / "low-end" / "for the web" | Production 1.0.0 | [EVAL](./mobile-glb-budget/EVAL.md) | budget-tiers / violation-rules / degradation-plan |
|
|
81
|
+
| `glb-animation-handoff` | Document GLB animation contract (skeletal / morph, FPS, looping, root motion, blend) with web-stack caveats | GLB ships with at least one animation clip and consumer is a web app | Production 1.0.0 | [EVAL](./glb-animation-handoff/EVAL.md) | animation-types / web-stack-caveats / transition-rules |
|
|
82
|
+
| `r3f-component-plan` | Plan the React Three Fiber component shape (props, refs, Suspense, useGLTF cache, animation hook) before delivering a GLB to the web team | Consumer is using R3F, before component code is written | Production 1.0.0 | [EVAL](./r3f-component-plan/EVAL.md) | component-shape-patterns / suspense-placement-rules / usegltf-caching-rules |
|
|
83
|
+
| `preview-report` | Generate the structured preview-report Markdown that glb-web-handoff and plain-language-response consume | After render-export-evidence produces measurements, before web/final handoff | Production 1.0.0 | [EVAL](./preview-report/EVAL.md) | report-schema / truth-label-rules / handoff-recipients |
|
|
84
|
+
|
|
85
|
+
### 🔍 Quality validation deep
|
|
86
|
+
|
|
87
|
+
Each ships with `SKILL.md` + `EVAL.md` + 3 `references/` files. These four narrow validators complement the broader `scene-readiness` — use them when you need a focused per-domain check (material / lighting / composition / polycount) instead of holistic readiness.
|
|
88
|
+
|
|
89
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
90
|
+
|---|---|---|---|---|---|
|
|
91
|
+
| `material-quality-checker` | Validate PBR material sanity, texture budgets, consumer-stack compatibility per material | Before render / GLB export, after a material change | Production 1.0.0 | [EVAL](./material-quality-checker/EVAL.md) | pbr-sanity-rules / texture-budget-rules / consumer-stack-rules |
|
|
92
|
+
| `lighting-quality-checker` | Validate intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance vs mood brief | Before render, after a lighting change, when render mood feels off | Production 1.0.0 | [EVAL](./lighting-quality-checker/EVAL.md) | intensity-ranges / shadow-softness-rules / hdri-balance-rules |
|
|
93
|
+
| `composition-quality-checker` | Validate framing, subject placement, headroom/lead-room, visual hierarchy vs framing intent | Before render, after a camera change | Production 1.0.0 | [EVAL](./composition-quality-checker/EVAL.md) | composition-rules / headroom-leadroom-rules / aspect-ratio-rules |
|
|
94
|
+
| `polycount-budget-checker` | Validate per-mesh + total-scene triangle counts vs pinned budget; flag worst offenders and topology hints without modeling | After scene plan, before GLB export, when `mobile-glb-budget` is pinned | Production 1.0.0 | [EVAL](./polycount-budget-checker/EVAL.md) | per-mesh-rules / topology-hints / instance-counting-rules |
|
|
95
|
+
|
|
96
|
+
### 🎬 Domain scene planners
|
|
97
|
+
|
|
98
|
+
Four narrowly-scoped scene planners that complement `product-hero-scene-planner` (the existing single-product hero planner).
|
|
99
|
+
|
|
100
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
101
|
+
|---|---|---|---|---|---|
|
|
102
|
+
| `character-portrait` | Plan a single-character portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) | Intent is a character / person / creature portrait | Production 1.0.0 | [EVAL](./character-portrait/EVAL.md) | portrait-framing-rules / portrait-lighting-patterns / style-consistency-rules |
|
|
103
|
+
| `environment-shot` | Plan a wide environment / establishing shot (locale, time, weather, atmosphere, depth layers, focal subject) | Intent is establishing a place (wide / outdoor / landscape / cityscape) | Production 1.0.0 | [EVAL](./environment-shot/EVAL.md) | time-and-weather-rules / wide-shot-camera-rules / depth-layering-rules |
|
|
104
|
+
| `interior-scene` | Plan an interior arch viz scene (room dims, style, furniture, materials, natural + artificial lighting, camera) | Intent is an interior room / venue / showroom | Production 1.0.0 | [EVAL](./interior-scene/EVAL.md) | interior-architecture-rules / furniture-layout-rules / interior-camera-rules |
|
|
105
|
+
| `product-grid-scene-planner` | Plan a multi-product grid scene with consistent lighting, camera, background, grid spacing | Intent is multi-product display (4+ products in same scene, e-commerce / catalog / comparison) | Production 1.0.0 | [EVAL](./product-grid-scene-planner/EVAL.md) | grid-layout-rules / grid-consistency-rules / grid-output-naming-rules |
|
|
106
|
+
|
|
107
|
+
### 🧰 Process discipline (Superpowers-inspired)
|
|
108
|
+
|
|
109
|
+
Four process / discipline skills that prevent scope drift, enforce gates, and pin "done":
|
|
110
|
+
|
|
111
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
112
|
+
|---|---|---|---|---|---|
|
|
113
|
+
| `stage-gates` | Enforce per-stage gates and acceptance checklists; work advances only when each previous gate `Pass` | Complex multi-stage recipe (4+ stages), or before runtime work | Production 1.0.0 | [EVAL](./stage-gates/EVAL.md) | gate-template / stage-decomposition-patterns / failed-gate-handling |
|
|
114
|
+
| `done-criteria` | Define one explicit "done" condition for a recipe before starting work, plus an out-of-scope list | Before any non-trivial recipe, when previous attempts drifted into endless polish | Production 1.0.0 | [EVAL](./done-criteria/EVAL.md) | stop-condition-templates / out-of-scope-patterns / done-vs-perfect |
|
|
115
|
+
| `scope-guard` | Detect mid-recipe scope creep and force decline / agree-to-new-scope / defer; prevents silent absorption | Mid-recipe when scope drift is detected ("can you also...") | Production 1.0.0 | [EVAL](./scope-guard/EVAL.md) | scope-addition-classification / options-language-template / recurring-creep-patterns |
|
|
116
|
+
| `blender-recipe-decomposer` | Break a complex / over-scoped intent into 2-5 smaller cohesive recipes with brief, stop condition, handoff | Intent has multiple distinct deliverables or crosses scene types | Production 1.0.0 | [EVAL](./blender-recipe-decomposer/EVAL.md) | recipe-grouping-rules / dependency-patterns / recipe-naming-rules |
|
|
117
|
+
|
|
118
|
+
### 🗂️ Asset / sourcing
|
|
119
|
+
|
|
120
|
+
Four asset-management skills covering license, style consistency, fallback, and library organization:
|
|
121
|
+
|
|
122
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
123
|
+
|---|---|---|---|---|---|
|
|
124
|
+
| `asset-license-checker` | Verify license compliance for downloaded 3D assets, textures, HDRIs, fonts before scene build / mutation / export | After asset-discovery produces asset list | Production 1.0.0 | [EVAL](./asset-license-checker/EVAL.md) | common-license-mapping / license-source-rules / attribution-rendering-patterns |
|
|
125
|
+
| `asset-style-check` | Verify chosen assets share visual style (realism / detail / color / surface) before scene build | Before scene build, when scene preview shows visible style mismatch | Production 1.0.0 | [EVAL](./asset-style-check/EVAL.md) | style-axes / drift-classification / intentional-mixed-style |
|
|
126
|
+
| `asset-fallback-strategy` | Provide 2-3 fallback options when asset is unavailable / blocked / over-budget — without halting the recipe | After a checker fails an asset | Production 1.0.0 | [EVAL](./asset-fallback-strategy/EVAL.md) | fallback-option-types / scoring-rubric / drop-with-caveat-rules |
|
|
127
|
+
| `asset-library-plan` | Plan internal asset library (folders, naming, metadata, license tracking, version control) for repeat reuse | Starting new repo with multiple recipes, or before scaling to 50+ assets | Production 1.0.0 | [EVAL](./asset-library-plan/EVAL.md) | folder-structure-rules / naming-rules / metadata-schema |
|
|
128
|
+
|
|
129
|
+
### 🎨 Color / format / output decisions
|
|
130
|
+
|
|
131
|
+
Four upfront render-config decisions that prevent the most common Blender output mistakes:
|
|
132
|
+
|
|
133
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
134
|
+
|---|---|---|---|---|---|
|
|
135
|
+
| `color-management-decision` | Pick color management config (sRGB / Filmic / Standard / AgX / ACEScg) per output context before render | Before render / lookdev pass when consumer color pipeline is known | Production 1.0.0 | [EVAL](./color-management-decision/EVAL.md) | pipeline-mapping / per-channel-rules / look-comparison |
|
|
136
|
+
| `output-format-decision` | Pick output file format (PNG / JPG / WebP / OpenEXR / TIFF) per use case based on bit depth, compression, transparency | Before render when consumer requires specific format | Production 1.0.0 | [EVAL](./output-format-decision/EVAL.md) | format-decision-matrix / bit-depth-rules / compression-tradeoffs |
|
|
137
|
+
| `resolution-aspect-decision` | Pick render resolution + aspect ratio per consumer use case; avoid render-then-crop and aspect mismatch | Before render when consumer requires specific aspect / resolution | Production 1.0.0 | [EVAL](./resolution-aspect-decision/EVAL.md) | aspect-defaults / resolution-defaults / print-vs-screen-rules |
|
|
138
|
+
| `cycles-vs-eevee-decision` | Pick Cycles / Eevee / Workbench based on quality bar, time budget, feature needs | Before render when engine choice drives feature support and time tradeoff | Production 1.0.0 | [EVAL](./cycles-vs-eevee-decision/EVAL.md) | engine-feature-matrix / samples-by-quality / gpu-device-rules |
|
|
139
|
+
|
|
140
|
+
### 📚 Recipe / pack operations
|
|
141
|
+
|
|
142
|
+
Four skills that keep pack workflows honest: fit, prerequisites, stage routing, and acceptance criteria.
|
|
143
|
+
|
|
144
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
145
|
+
|---|---|---|---|---|---|
|
|
146
|
+
| `recipe-fit-assessor` | Map goals to documented recipes/packs; flag scope gaps; recommend workflow entry | Choosing which recipe/pack fits before locking a brief | Production 1.0.0 | [EVAL](./recipe-fit-assessor/EVAL.md) | recipe-catalog / scope-gap-rules / workflow-recommendation-template |
|
|
147
|
+
| `pack-prerequisite-checker` | Pre-flight matrix: brief, assets, runtime posture, evidence habits, Single-bridge | Right before execution-heavy work for a chosen pack | Production 1.0.0 | [EVAL](./pack-prerequisite-checker/EVAL.md) | prerequisite-matrix / blocked-start-playbook / pack-readiness-template |
|
|
148
|
+
| `workflow-stage-router` | From current artifacts → next narrow skill + preconditions | Resume, de-bottleneck skill overload, mid-project status checks | Production 1.0.0 | [EVAL](./workflow-stage-router/EVAL.md) | milestone-model / routing-decision-tree / stage-handoff-template |
|
|
149
|
+
| `acceptance-criteria-builder` | Turn brief + recipe into measurable acceptance rows with evidence hooks | Stakeholder sign-off, definition-of-done, pre-render contract | Production 1.0.0 | [EVAL](./acceptance-criteria-builder/EVAL.md) | checklist-patterns / evidence-hook-rules / brief-to-criteria-mapper |
|
|
150
|
+
|
|
151
|
+
### 🧷 Runtime path discipline
|
|
152
|
+
|
|
153
|
+
Four skills that separate Path 1 hosting, Path 2 community bridge, and CLI appendix without false standalone Connector claims.
|
|
154
|
+
|
|
155
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
156
|
+
|---|---|---|---|---|---|
|
|
157
|
+
| `runtime-path-picker` | Choose Path 1 Lab MCP, Path 2 `mcp-for-blender`, or CLI appendix from constraints | User frozen between official Lab stack, community bridge, or headless batch | Production 1.0.0 | [EVAL](./runtime-path-picker/EVAL.md) | path-constraints-table / decision-tree / anti-patterns |
|
|
158
|
+
| `path-one-host-outline` | Connector vs manual MCP for Path 1; Lab add-on inside Blender 5.1+ always | Claude Desktop tutorial vs coding-agent MCP config explanations | Production 1.0.0 | [EVAL](./path-one-host-outline/EVAL.md) | connector-vs-manual-matrix / lab-addon-reminders / host-checklist-template |
|
|
159
|
+
| `cli-appendix-job-outline` | Phased headless job outline; upstream CLI manual is authority | CI / farm / policy-blocked MCP scenarios | Production 1.0.0 | [EVAL](./cli-appendix-job-outline/EVAL.md) | job-type-matrix / flag-order-reminders / stateless-limitations |
|
|
160
|
+
| `runtime-attempt-report` | Structured attempt report with truth labels for Path 1 / Path 2 / CLI | After connect tries; provenance for evals or stakeholders | Production 1.0.0 | [EVAL](./runtime-attempt-report/EVAL.md) | truth-label-blocks / attempt-record-template / triage-next-steps |
|
|
161
|
+
|
|
162
|
+
### 🧠 Process and discipline (Superpowers + BMad inspired)
|
|
163
|
+
|
|
164
|
+
Each ships with `SKILL.md` + `EVAL.md` + 3 `references/` files (templates / playbooks / patterns).
|
|
165
|
+
|
|
166
|
+
| Skill | Purpose | Use when | Depth status | Eval | References |
|
|
167
|
+
|---|---|---|---|---|---|
|
|
168
|
+
| `blender-brainstorming` | Socratic intent exploration before planning (Superpowers `/brainstorming` analog) | User request is vague or ambiguous | Production 1.0.0 | [EVAL](./blender-brainstorming/EVAL.md) | clarification-patterns / alternative-scoping-templates / intent-summary-style-guide |
|
|
169
|
+
| `blender-troubleshooting` | 4-phase root-cause analysis when output looks wrong (Superpowers `/systematic-debugging` analog) | Render / GLB / response diverges from intent | Production 1.0.0 | [EVAL](./blender-troubleshooting/EVAL.md) | four-phase-template / divergence-routing-table / common-symptom-playbooks |
|
|
170
|
+
| `pre-handoff-verification` | 7-point evidence gate before any "ready" / `Verified` claim (Superpowers `/verification-before-completion` analog) | Before any handoff, evidence file save, or release | Production 1.0.0 | [EVAL](./pre-handoff-verification/EVAL.md) | seven-point-checklist / downgrade-rules / text-only-mode-handling |
|
|
171
|
+
| `intent-to-3d-brief-writer` | Convert NL intent → 8-slot structured 3D brief (BMad analysis-phase analog) | First step before any planner | Production 1.0.0 | [EVAL](./intent-to-3d-brief-writer/EVAL.md) | eight-slot-template / acceptance-criteria-patterns / mixed-audience-handling |
|
|
172
|
+
| `asset-discovery` | Per-asset strategy (procedural / library / generative / photogrammetry) before scene plan | Brief is locked, scene plan needs asset commitment | Production 1.0.0 | [EVAL](./asset-discovery/EVAL.md) | asset-strategy-decision-tree / license-confidence-table / budget-reconciliation-patterns |
|
|
173
|
+
| `bridge-conflicts` | Diagnose Single-bridge constraint conflicts (Path 1 + Path 2 + port `9876`) | Readiness signals inconsistent or two bridges installed | Production 1.0.0 | [EVAL](./bridge-conflicts/EVAL.md) | bridge-state-matrix-template / conflict-playbooks / do-not-reminders |
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## Expected folder structure
|
|
178
|
+
|
|
179
|
+
```txt
|
|
180
|
+
skills/
|
|
181
|
+
├─ README.md
|
|
182
|
+
├─ _template/
|
|
183
|
+
│ └─ SKILL.md
|
|
184
|
+
├─ <skill-name>/
|
|
185
|
+
│ ├─ SKILL.md
|
|
186
|
+
│ ├─ references/ # optional, only when useful
|
|
187
|
+
│ ├─ evals/ # optional, only when useful
|
|
188
|
+
│ └─ assets/ # optional, only when useful
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
Do not create empty placeholder subfolders. Add references/assets/scripts only when they carry real reusable value.
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## SKILL.md contract
|
|
196
|
+
|
|
197
|
+
Every real root skill should include:
|
|
198
|
+
|
|
199
|
+
- YAML frontmatter: `name` (kebab-case, ≤64 chars) and `description` (≤200 chars to clear the Claude.ai upload UI limit). Upstream requires `name` + `description` and allows additional metadata; BlendOps packaging additionally forbids `version`, `status`, `tags`, `allowed-tools`, and other non-spec keys in any uploadable SKILL.md (Claude.ai upload contract), and the docs:check script enforces the BlendOps subset.
|
|
200
|
+
- `## Purpose`
|
|
201
|
+
- `## When to use`
|
|
202
|
+
- `## When not to use`
|
|
203
|
+
- `## Trigger phrases`
|
|
204
|
+
- `## Official runtime boundary`
|
|
205
|
+
- `## Mode handling`
|
|
206
|
+
- `## Validation checklist`
|
|
207
|
+
- `## Pass / Warn / Fail rubric`
|
|
208
|
+
- `## Cross-skill handoff`
|
|
209
|
+
- evidence/caveat output fields
|
|
210
|
+
- required law links
|
|
211
|
+
- references to runtime/eval docs when relevant
|
|
212
|
+
|
|
213
|
+
Start from [`_template/SKILL.md`](./_template/SKILL.md).
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
## Naming rules
|
|
218
|
+
|
|
219
|
+
| Rule | Example |
|
|
220
|
+
|---|---|
|
|
221
|
+
| Use kebab-case folder names | `render-export-evidence` |
|
|
222
|
+
| Match `name` to folder slug | `name: render-export-evidence` |
|
|
223
|
+
| Prefer domain/action names | `lighting-material-plan` |
|
|
224
|
+
| Avoid duplicate aliases unless packaging requires them | Use canonical role notes instead. |
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
228
|
+
## Trigger rules
|
|
229
|
+
|
|
230
|
+
- Use `blendops-help` when the next action is unclear.
|
|
231
|
+
- Use readiness skills before runtime mutation/render/export.
|
|
232
|
+
- Use planning skills before runtime execution.
|
|
233
|
+
- Use evidence skills before artifact claims.
|
|
234
|
+
- Use handoff skills after evidence state is known.
|
|
235
|
+
|
|
236
|
+
If multiple skills could apply, load the routing/help skill first or choose the narrowest skill that answers the current request.
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## Evidence-before-done rules
|
|
241
|
+
|
|
242
|
+
Every skill must preserve these states:
|
|
243
|
+
|
|
244
|
+
| State | Meaning |
|
|
245
|
+
|---|---|
|
|
246
|
+
| `Not Run` | No runtime attempt happened. |
|
|
247
|
+
| `Attempted` | Runtime was tried but evidence is incomplete or blocked. |
|
|
248
|
+
| `Produced` | A file/visible output exists but validation is incomplete. |
|
|
249
|
+
| `Verified` | Output exists and passed stated validation checks. |
|
|
250
|
+
| `Failed` | Attempt did not meet stated criteria. |
|
|
251
|
+
|
|
252
|
+
No preview/render/GLB claim is valid without output path or visible evidence plus validation notes.
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## Runtime boundary rules
|
|
257
|
+
|
|
258
|
+
- Skills do not install Blender.
|
|
259
|
+
- Skills do not run Blender unless the user explicitly requests runtime work and readiness is satisfied.
|
|
260
|
+
- Skill install is separate from runtime install.
|
|
261
|
+
- The 2-path + CLI appendix runtime model lives in [`docs/runtime-stack-strategy.md`](../docs/runtime-stack-strategy.md):
|
|
262
|
+
- **Path 1 — Official Blender Lab MCP** (Lab add-on + Lab 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.
|
|
263
|
+
- **Path 2 — Community `mcp-for-blender`** (different `addon.py` + server via `uvx mcp-for-blender`, mature third-party, Blender 3.0+).
|
|
264
|
+
- **CLI fallback (appendix)** — direct `blender --background --python`, no MCP. **Documented upstream** as a first-class Blender CLI surface; no in-repo evidence file yet.
|
|
265
|
+
- Skills must name the path explicitly (and Path 1 host option a/b when relevant) and must apply Blender 5.1+ to all of Path 1 (whichever host).
|
|
266
|
+
- Single-bridge constraint: Blender accepts one MCP bridge session per Blender instance. Skills must warn if Path 1 + Path 2 are both configured for the same Blender instance.
|
|
267
|
+
|
|
268
|
+
Runtime docs:
|
|
269
|
+
|
|
270
|
+
- [Runtime stack strategy](../docs/runtime-stack-strategy.md)
|
|
271
|
+
- [External runtime setup](../docs/external-runtime-setup.md)
|
|
272
|
+
- [Reference runtime](../docs/reference-runtime.md)
|
|
273
|
+
- [Unofficial runtime bridges](../docs/unofficial-runtime-bridges.md)
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
## How to add a new skill
|
|
278
|
+
|
|
279
|
+
1. Copy `skills/_template/SKILL.md` into `skills/<new-skill>/SKILL.md`.
|
|
280
|
+
2. Keep the skill narrow and composable.
|
|
281
|
+
3. Fill trigger/skip conditions with concrete phrases.
|
|
282
|
+
4. Define required inputs and output contract.
|
|
283
|
+
5. Add runtime/evidence status handling.
|
|
284
|
+
6. Link required laws and relevant docs.
|
|
285
|
+
7. Add to this README only when useful.
|
|
286
|
+
8. Add to a pack only when it belongs in that workflow.
|
|
287
|
+
9. Update `scripts/check-docs.mjs` if the skill becomes required.
|
|
288
|
+
10. Run `npm run docs:check`.
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## Packaging later
|
|
293
|
+
|
|
294
|
+
Future packaging should map this canonical source to target surfaces without duplicating skill logic.
|
|
295
|
+
|
|
296
|
+
| Target | Current stance |
|
|
297
|
+
|---|---|
|
|
298
|
+
| Claude Desktop | Future user-managed skill bundle; connector setup separate. |
|
|
299
|
+
| Claude Code | Project-local first; native path remains environment-scoped. |
|
|
300
|
+
| OpenCode | Research install options before claiming tool-native support. |
|
|
301
|
+
| Cursor | Project-local first (`.cursor/rules/*.mdc` or `AGENTS.md`, verified-read); native path remains environment-scoped. |
|
|
302
|
+
| Codex | `AGENTS.md` discovery verified; project-local instruction files. |
|
|
303
|
+
| Gemini | Future adapter; not researched enough for support claim. |
|
|
304
|
+
|
|
305
|
+
No packaged skill, plugin listing, marketplace listing, or release availability should be marked complete until verified.
|
|
306
|
+
|
|
307
|
+
---
|
|
308
|
+
|
|
309
|
+
## Review gate dependency
|
|
310
|
+
|
|
311
|
+
| Gate source | Applies to | Expected result |
|
|
312
|
+
|---|---|---|
|
|
313
|
+
| `skill-reviews/review-gates.md` | All promoted root skills | Pass before promotion, or record explicit warnings |
|
|
314
|
+
| Per-skill `EVAL.md` | Individual skill behavior | Text-only baseline checks pass |
|
|
315
|
+
| Pack manifest | Composed pack behavior | Laws, skill order, eval expectations stay aligned |
|