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,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-license-checker/SKILL.md and skills/asset-license-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# asset-license-checker
|
|
3
|
+
|
|
4
|
+
Purpose: Verify license compliance for downloaded 3D assets, textures, HDRIs, fonts before scene build or export.
|
|
5
|
+
|
|
6
|
+
Catch license risk before assets go into a scene that will be rendered, exported, or shipped. This is a planning / validation skill — does not modify assets, does not consult lawyers.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `asset-license-and-provenance-gate` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- Immediately after `asset-discovery` produces a candidate asset list.
|
|
12
|
+
- Before handing off to `asset-style-check`, `asset-library-plan`, or scene planners (`product-hero-scene-planner`, `character-portrait`, `environment-shot`, `interior-scene`, `product-grid-scene-planner`).
|
|
13
|
+
- Before `pre-handoff-verification`, `render-export-evidence`, `glb-web-handoff`, or `glb-animation-handoff`.
|
|
14
|
+
- Whenever a previously sourced asset's license or attribution requirement is unclear.
|
|
15
|
+
- Trigger phrases: "is this license OK", "can I use this commercially", "what's the license", "license check"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- Sourcing or searching for candidate assets → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
|
|
19
|
+
- Checking visual consistency, scale, or aesthetic fit across assets → use `asset-style-check` (`references/skill-asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
|
|
20
|
+
- Replacing or working around rejected/blocked assets → use `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`; Delegates out-of-scope requests to asset-fallback-strategy)
|
|
21
|
+
- Structuring folders, naming conventions, or catalog storage → use `asset-library-plan` (`references/skill-asset-library-plan.md`; Delegates out-of-scope requests to asset-library-plan)
|
|
22
|
+
- First-party assets authored entirely in-house with no external dependencies. → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
|
|
23
|
+
- Legal advice or binding legal interpretation (this skill flags risk only; escalate ambiguity to legal). → use `asset-style-check` (`references/skill-asset-style-check.md`; Delegates out-of-scope requests to asset-style-check)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `candidate_assets` (`array`): Candidate external 3D models, textures, and HDRIs with source URLs and license labels
|
|
27
|
+
- Required input `intended_distribution_use` (`string`): Target distribution context (commercial product marketing, web redistribution, internal preview)
|
|
28
|
+
- Optional input `attribution_delivery_surface` (`string`): Where attribution credits can be displayed if CC-BY-4.0 assets are used
|
|
29
|
+
- Output contract: `per_asset_license_verdict_table`, `attribution_obligations_list`, `quarantined_or_blocked_assets` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. Receive the sourced external asset list from `asset-discovery` (models, textures, HDRIs, fonts, sounds, brushes).
|
|
33
|
+
2. Record source URL, documented license name, and stated permissions per asset.
|
|
34
|
+
3. Flag risk per asset (`Pass` / `Warn` / `Fail`) and specify required attribution lines and attribution plan.
|
|
35
|
+
4. Gate progression: hand off to `asset-style-check`, `asset-library-plan`, or `workflow-stage-router` only if all rows are `Pass` or explicitly accepted `Warn`; route any `Fail` rows to `asset-fallback-strategy`.
|
|
36
|
+
|
|
37
|
+
## Cross-skill handoffs
|
|
38
|
+
- [upstream_reference] Upstream asset sourcing → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
39
|
+
- [progression] Visual style validation → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
40
|
+
- [fallback] Rejected/blocked asset handling → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
|
|
41
|
+
- [progression] Asset library organization → `asset-library-plan` (`references/skill-asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
|
|
42
|
+
- [progression] Stage routing & scene planning gate → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Validation skill — does not modify assets, does not run Blender. Verdicts are based on documented license terms, not legal interpretation. **Not legal advice**: when in doubt, recommend the user consult their legal team.
|
|
46
|
+
- Give legal advice or interpret complex contracts (escalate ambiguity to legal).
|
|
47
|
+
- Source or discover candidate assets (`asset-discovery`).
|
|
48
|
+
- Check visual style or aesthetic consistency (`asset-style-check`).
|
|
49
|
+
- Plan fallbacks or replacements for failed assets (`asset-fallback-strategy`).
|
|
50
|
+
- Organize asset libraries or folder structures (`asset-library-plan`).
|
|
51
|
+
- Modify asset files, write Python, or run Blender.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/asset-style-check/SKILL.md and skills/asset-style-check/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# asset-style-check
|
|
3
|
+
|
|
4
|
+
Purpose: Verify chosen assets share visual style (realism, detail, color treatment) before scene build; flag style drift between assets early.
|
|
5
|
+
|
|
6
|
+
Catch style mismatches between assets before they end up in the same scene where the inconsistency reads as compositing error.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `asset-and-sourcing` | Role `cross-asset-visual-coherence-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- after `asset-license-checker` clears the assets
|
|
12
|
+
- before scene build
|
|
13
|
+
- when a scene preview shows visible style mismatch
|
|
14
|
+
- when assets come from multiple sources
|
|
15
|
+
- Trigger phrases: "do these assets fit together", "style check the assets", "scene feels like a collage"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- single isolated asset where no multi-asset or scene-brief consistency check is requested → use `asset-discovery` (`references/skill-asset-discovery.md`; Delegates out-of-scope requests to asset-discovery)
|
|
19
|
+
- pure planning before candidate assets are picked → use `asset-discovery` (`references/skill-asset-discovery.md`; use asset-discovery)
|
|
20
|
+
- intentionally mixed-style art direction, ONLY when the locked brief explicitly specifies mixed styles → use `asset-license-checker` (`references/skill-asset-license-checker.md`; Delegates out-of-scope requests to asset-license-checker)
|
|
21
|
+
- checking asset licenses (asset-license-checker), polygon/performance budgets (polycount-budget-checker), topology, or planning materials/lighting (blender-light → use `asset-license-checker` (`references/skill-asset-license-checker.md`; lighting-material-plan)
|
|
22
|
+
|
|
23
|
+
## Input & output contract
|
|
24
|
+
- Required input `candidate_asset_list` (`array`): Sourced 3D models, materials, and props to evaluate for visual coherence
|
|
25
|
+
- Required input `brief_style_direction` (`string`): Pinned visual style, proportion language, texel density, and surface wear target from brief
|
|
26
|
+
- Optional input `hero_anchor_asset` (`string`): Primary hero asset used as the visual benchmark for secondary props
|
|
27
|
+
- Output contract: `style_coherence_matrix`, `mismatched_asset_flags`, `remediation_or_fallback_recommendations` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
28
|
+
|
|
29
|
+
## Quick-start steps
|
|
30
|
+
1. list every asset planned for the scene
|
|
31
|
+
2. evaluate each on style axes (realism / detail / color / surface)
|
|
32
|
+
3. flag drift between assets
|
|
33
|
+
4. recommend remediation (drop / restyle / replace)
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] Upstream discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
37
|
+
- [upstream_reference] Upstream license gate → `asset-license-checker` (`references/skill-asset-license-checker.md`) — `when.all: [assets.externalUsed equals true; assets.licenseCleared equals false]`
|
|
38
|
+
- [upstream_reference] Upstream brief lock → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
39
|
+
- [boundary_delegation] Scope enforcement → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
40
|
+
- [fallback] Rejected asset fallback → `asset-fallback-strategy` (`references/skill-asset-fallback-strategy.md`) — `when.all: [assets.fallbackNeeded equals true]`
|
|
41
|
+
- [progression] Approved asset organization → `asset-library-plan` (`references/skill-asset-library-plan.md`) — `when.all: [assets.discoveryComplete equals true; stage.current equals "library_organization"]`
|
|
42
|
+
- [progression] Broad scene review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
43
|
+
- [progression] Material & lookdev boundary (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
44
|
+
- [progression] Material & lookdev boundary (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
45
|
+
- [progression] Budget & topology boundary → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
46
|
+
|
|
47
|
+
## Safety boundaries & non-goals
|
|
48
|
+
- Runtime boundary: Validation-only skill — never modifies or re-styles assets, and never executes Blender or Python. Per-asset verdicts (`Pass | Warn | Fail`) and drift classifications (`None | Minor | Major`) are derived solely from documented asset previews and the locked style brief, and are tracked separately from runtime/artifact truth states (which default to `Not Produced` for artifacts and are downgrade-only).
|
|
49
|
+
- Never modify or re-style assets.
|
|
50
|
+
- Never check asset licenses (belongs to `asset-license-checker`).
|
|
51
|
+
- Never check polycount budgets or mesh topology (belongs to `polycount-budget-checker`).
|
|
52
|
+
- Never execute Blender or Python code.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-brainstorming/SKILL.md and skills/blender-brainstorming/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# blender-brainstorming
|
|
3
|
+
|
|
4
|
+
Purpose: Socratic exploration of a non-Blender-user's 3D intent before scene planning. Use when the request is vague, has multiple plausible interpretations, or needs creative scoping.
|
|
5
|
+
|
|
6
|
+
Run a structured Socratic brainstorming pass on a vague non-Blender-user 3D request before any scene planner, runtime readiness, or evidence skill is invoked. Surface the user's actual intent, missing constraints, and decision points so downstream skills do not waste effort on the wrong direction.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `pre-brief-ideation-and-clarification` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- the user request is short, ambiguous, or missing critical context (subject, mood, deliverable, evidence expectations)
|
|
12
|
+
- multiple plausible interpretations exist (e.g. "make me a cool product render" — what product, what mood, web or print, GLB or render?)
|
|
13
|
+
- the user is non-Blender-technical and may not realize what BlendOps must know to plan well
|
|
14
|
+
- before any planner skill (`product-hero-scene-planner`, `camera-composition`, …)
|
|
15
|
+
- Trigger phrases: "I want a 3D render of..." (vague)", "Make me something cool with...", "Help me plan a Blender scene" (no constraints given)", "I'm not sure what I want exactly...", "Brainstorm with me about..."
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- the user already provided a structured brief (route directly to intent-to-3d-brief-writer to lock the brief before any planner runs) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; route directly to intent-to-3d-brief-writer to lock the brief before any planner runs)
|
|
19
|
+
- the user explicitly asked to skip clarification (record explicit assumptions and route to intent-to-3d-brief-writer) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; record explicit assumptions and route to intent-to-3d-brief-writer)
|
|
20
|
+
- the user pushes for immediate execution rather than exploration → use `runtime-readiness` (`references/skill-runtime-readiness.md`; route to runtime-readiness)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `initial_user_idea` (`string`): Vague, exploratory, or open-ended 3D concept from the user
|
|
24
|
+
- Optional input `brand_or_mood_references` (`array`): Optional mood keywords, reference products, or target audience notes
|
|
25
|
+
- Output contract: `divergent_concept_options`, `clarifying_questions_shortlist`, `recommended_direction_for_brief` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. ask 3-5 minimum clarifying questions
|
|
29
|
+
2. propose 2-3 alternative scopings
|
|
30
|
+
3. end with a one-paragraph intent summary the user can confirm
|
|
31
|
+
4. hand off to `intent-to-3d-brief-writer` once intent is confirmed
|
|
32
|
+
|
|
33
|
+
## Cross-skill handoffs
|
|
34
|
+
- [progression] Lock the confirmed brief downstream → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
35
|
+
- [progression] User pushes for execution mid-brainstorm → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
36
|
+
- [progression] Explain blocked runtime status to user → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
37
|
+
|
|
38
|
+
## Safety boundaries & non-goals
|
|
39
|
+
- Runtime boundary: This skill does not install Blender, run Blender, or configure any MCP path. It is text-only conversation.
|
|
40
|
+
- runtime setup
|
|
41
|
+
- artifact production
|
|
42
|
+
- deciding the final scene plan (that's the planner's job)
|
|
43
|
+
- one-shot interpretation of vague requests
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-recipe-decomposer/SKILL.md and skills/blender-recipe-decomposer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# blender-recipe-decomposer
|
|
3
|
+
|
|
4
|
+
Purpose: Break over-scoped Blender intent into 2-5 cohesive recipes with brief seeds, stop conditions, order, dependencies, shared assets, and handoffs.
|
|
5
|
+
|
|
6
|
+
When user intent is too big for one recipe (multiple deliverables, mixed modes, conflicting briefs), split it into smaller recipes that each fit the BlendOps recipe shape (brief → plan → assets → runtime → handoff).
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `multi-deliverable-recipe-splitter` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- intent has multiple distinct deliverables (e.g., hero render + animation + GLB + variant grid)
|
|
12
|
+
- intent crosses multiple scene types (portrait + environment in one ask)
|
|
13
|
+
- previous attempts collapsed under their own scope
|
|
14
|
+
- before any planner runs
|
|
15
|
+
- Trigger phrases: "I want all of these", "this is a lot", "we'll need several outputs", "across these scenes"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- single deliverable that is already right-sized (hand off directly to intent-to-3d-brief-writer) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; hand off directly to intent-to-3d-brief-writer)
|
|
19
|
+
- pure exploration or open ideation → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming instead)
|
|
20
|
+
- after recipes are already split or running → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard for added scope or done-criteria to evaluate completion)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `multi_deliverable_request` (`string`): User request spanning multiple scenes, deliverables, or incompatible output channels
|
|
24
|
+
- Required input `candidate_recipes` (`array`): Candidate BlendOps recipes or packs identified by recipe-fit-assessor
|
|
25
|
+
- Optional input `delivery_priority_order` (`array`): Optional user preference on which deliverable to ship first
|
|
26
|
+
- Output contract: `ordered_sub_workflow_tracks`, `shared_asset_and_brief_dependencies`, `first_track_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. enumerate distinct deliverables in the user intent
|
|
30
|
+
2. group them into 2-5 cohesive recipes and plan shared assets early
|
|
31
|
+
3. give each recipe a name, one-line brief seed, one-line stop condition seed, explicit out-of-scope boundary, and handoff target
|
|
32
|
+
4. pin recipe start order (linear or parallel-OK) and dependencies
|
|
33
|
+
|
|
34
|
+
## Cross-skill handoffs
|
|
35
|
+
- [progression] Full brief authoring for each split recipe → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
36
|
+
- [progression] Pinning formal done conditions per recipe → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
37
|
+
- [progression] Workflow stage gates per recipe → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
|
|
38
|
+
- [progression] Handling scope added after splitting → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
39
|
+
- [upstream_reference] Pre-decomposition ideation when deliverables are unclear → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
40
|
+
|
|
41
|
+
## Safety boundaries & non-goals
|
|
42
|
+
- Runtime boundary: Process / discipline skill — does not run Blender. Splits intent into recipe specs only.
|
|
43
|
+
- Run Blender, write Python, or render/export any artifacts.
|
|
44
|
+
- Author full 3D briefs (belongs to `intent-to-3d-brief-writer`).
|
|
45
|
+
- Pin formal acceptance/stop gates (belongs to `done-criteria`).
|
|
46
|
+
- Run per-recipe checklist stage gates (belongs to `stage-gates`).
|
|
47
|
+
- Enforce scope creep after recipes are already split (belongs to `scope-guard`).
|
|
48
|
+
- Make or upgrade runtime or artifact truth claims.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blender-troubleshooting/SKILL.md and skills/blender-troubleshooting/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# blender-troubleshooting
|
|
3
|
+
|
|
4
|
+
Purpose: Structured 4-phase root-cause analysis when Blender output looks wrong. Use when render, export, scene, or handoff doesn't match intent and you need disciplined debug, not guesses.
|
|
5
|
+
|
|
6
|
+
Run a structured 4-phase root-cause analysis when a Blender output (render, export, GLB, preview, or final response) does not match the confirmed intent. Surface the actual cause before proposing any fix. Inspired by the `/systematic-debugging` skill in Anthropic Superpowers, adapted for Blender / non-Blender-user domain.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `scene-and-runtime-failure-diagnostician` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- a render came out black, blown out, missing assets, or just "wrong"
|
|
12
|
+
- a GLB export is empty, mis-scaled, or fails validation
|
|
13
|
+
- the non-Blender-user response sounds wrong (jargon-heavy, contradicted by evidence)
|
|
14
|
+
- the runtime smoke test passed but the recipe failed
|
|
15
|
+
- intent was clear but result diverges in a specific, reproducible way
|
|
16
|
+
- Trigger phrases: "the render looks wrong", "the GLB doesn't open / looks empty / is wrong scale", "the output doesn't match what I asked for", "why did it produce X instead of Y?", "debug this Blender output"
|
|
17
|
+
|
|
18
|
+
## When not to use (delegation boundaries)
|
|
19
|
+
- the user has not yet stated a clear expected outcome (run intent-to-3d-brief-writer first) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; run intent-to-3d-brief-writer first)
|
|
20
|
+
- runtime has never been attempted (run runtime-readiness first) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; run runtime-readiness first)
|
|
21
|
+
- the request is creative iteration ("can we make it more dramatic"), not debugging → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
|
|
22
|
+
- the user wants a one-shot fix without diagnostic discipline → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `observed_symptom_or_error` (`string`): Observed render defect, broken GLB export, scale mismatch, or MCP execution failure
|
|
26
|
+
- Required input `active_workflow_context` (`object`): Current scene plan, runtime path, and recent actions preceding the failure
|
|
27
|
+
- Optional input `runtime_attempt_notes` (`string`): Optional error output or attempt timeline from runtime-attempt-report
|
|
28
|
+
- Output contract: `root_cause_classification`, `minimal_remediation_plan`, `reverification_target_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. collect the symptom statement, expected outcome, and observed outcome
|
|
32
|
+
2. run the 4 phases: reproduce → narrow → identify root cause → propose fix
|
|
33
|
+
3. gate every conclusion on observable evidence
|
|
34
|
+
4. hand off the fix proposal to the relevant planner / readiness / evidence skill
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] If divergence at intent (blender-brainstorming) → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
38
|
+
- [upstream_reference] If divergence at intent (intent-to-3d-brief-writer) → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
39
|
+
- [conditional] If divergence at planning (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
40
|
+
- [conditional] If divergence at planning (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
41
|
+
- [alternative] If divergence at planning (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
42
|
+
- [alternative] If divergence at planning (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
43
|
+
- [alternative] If divergence at planning (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
44
|
+
- [alternative] If divergence at planning (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"]`
|
|
45
|
+
- [alternative] If divergence at planning (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"]`
|
|
46
|
+
- [upstream_reference] If divergence at execution (runtime-readiness) → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
47
|
+
- [fallback] If divergence at execution (bridge-conflicts) → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
48
|
+
- [upstream_reference] If divergence at execution (runtime-path-picker) → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
49
|
+
- [conditional] If divergence at output (glb-animation-handoff) → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
|
|
50
|
+
- [conditional] If divergence at output (glb-web-handoff) → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
51
|
+
- [conditional] If divergence at output (render-export-evidence) → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
52
|
+
- [conditional] If divergence at response → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
53
|
+
|
|
54
|
+
## Safety boundaries & non-goals
|
|
55
|
+
- Runtime boundary: This skill does not install Blender, run Blender, mutate scenes, render, export, or claim artifacts. It guides diagnosis. Any actual re-run goes through the relevant runtime skill (`runtime-readiness`, `render-export-evidence`).
|
|
56
|
+
- running Blender
|
|
57
|
+
- writing fix code
|
|
58
|
+
- guessing without evidence
|
|
59
|
+
- replacing the runtime evidence skill
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/blendops-help/SKILL.md and skills/blendops-help/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# blendops-help
|
|
3
|
+
|
|
4
|
+
Purpose: Route users to the right BlendOps skill, document, or next safe action without overclaiming runtime, artifact, or package readiness.
|
|
5
|
+
|
|
6
|
+
Help an agent or user decide the single safest next action in BlendOps when the goal is unclear, current status is unknown, or an entry point into skills, docs, runtime readiness, packaging, or release review is needed.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `ambiguous-intent-entry-router` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
Routing precedence: group `entry-and-stage-routing`, rank `1` | activationGate: `goalClarity="ambiguous_or_mixed"`, `recipeSelected=false`, `preflightPassed=false`, `hasStageOrArtifactInventory=false`
|
|
10
|
+
|
|
11
|
+
## When to use & trigger cues
|
|
12
|
+
- the user asks “what should I do next?” and the goal or current state is unclear
|
|
13
|
+
- the user is unsure how to enter the BlendOps skill catalog or documentation
|
|
14
|
+
- runtime, artifact, packaging, or release status is unknown and needs initial triage
|
|
15
|
+
- no workflow artifacts exist yet and the user needs a safe starting skill or doc
|
|
16
|
+
- an agent needs a concise entry-point recommendation before starting work
|
|
17
|
+
- Trigger phrases: "What should I do next?", "Which BlendOps skill should I use?", "Is this ready?", "Can I run the runtime eval?", "How do I package/install BlendOps?", "What is blocked?"
|
|
18
|
+
|
|
19
|
+
## When not to use (delegation boundaries)
|
|
20
|
+
- The goal is clear, preflight is passed, and stage or artifact inventory already exists → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; Selects the single immediate next skill from a locked precedence order and exits to pre-handoff-verification on any failed gate)
|
|
21
|
+
- The goal is clear and the user wants to select the right recipe or pack → use `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`; Scores candidate recipes/packs and detects multi-deliverable scope)
|
|
22
|
+
- A recipe or pack is already selected and needs preflight readiness verification → use `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`; Evaluates the preflight matrix across brief completeness, runtime posture, and asset readiness)
|
|
23
|
+
- The user explicitly asks to turn an idea into a structured 3D brief → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; Locks the canonical 8-slot 3D brief before scene planning)
|
|
24
|
+
- The user asks to plan a product-hero scene directly → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Handles domain-specific scene planning once brief and recipe are known)
|
|
25
|
+
- The user asks for render or export artifact verification → use `render-export-evidence` (`references/skill-render-export-evidence.md`; Classifies artifact truth states from on-disk paths and validation notes)
|
|
26
|
+
- The user asks for Blender MCP runtime preflight verification → use `runtime-readiness` (`references/skill-runtime-readiness.md`; Verifies Path 1 or Path 2 runtime readiness without claiming execution)
|
|
27
|
+
|
|
28
|
+
## Input & output contract
|
|
29
|
+
- Required input `user_request` (`string`): Ambiguous, mixed, or entry-level user question about BlendOps capabilities or next action
|
|
30
|
+
- Optional input `current_status_context` (`object`): Optional context about known files, docs, or blockers
|
|
31
|
+
- Output contract: `recommended_next_action`, `target_skill_or_doc`, `why_this_is_safe` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
32
|
+
|
|
33
|
+
## Quick-start steps
|
|
34
|
+
1. Ask for the current goal and status if missing.
|
|
35
|
+
2. If the goal is already clear and artifacts exist, hand off immediately to `workflow-stage-router`.
|
|
36
|
+
3. Otherwise, identify whether the entry need is brief/planning setup, runtime readiness, evidence verification, install/package docs, or release review.
|
|
37
|
+
4. Route to the single smallest safe skill or doc.
|
|
38
|
+
5. Preserve release, runtime, and artifact truth (downgrade-only, never upgrade).
|
|
39
|
+
|
|
40
|
+
## Cross-skill handoffs
|
|
41
|
+
- [progression] Recipe or pack selection when goal becomes clear → `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`) — `when.all: [goal.clarity equals "clear"; recipe.selected equals false]`
|
|
42
|
+
- [conditional] Pack preflight readiness check when recipe is already chosen → `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`) — `when.all: [recipe.selected equals true; preflight.passed equals false]`
|
|
43
|
+
- [conditional] In-flight workflow routing (clear goal + existing artifacts) → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [goal.clarity equals "clear"; preflight.passed equals true; inventory.exists equals true]`
|
|
44
|
+
- [progression] Initial 3D brief creation → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [brief.locked equals false]`
|
|
45
|
+
- [conditional] Runtime path selection → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [request.topic equals "runtime_selection"]`
|
|
46
|
+
- [conditional] Official runtime setup → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [request.topic equals "runtime_setup"]`
|
|
47
|
+
- [conditional] Runtime readiness preflight → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [request.topic equals "runtime_readiness"]`
|
|
48
|
+
- [fallback] MCP bridge port/session conflict → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
49
|
+
- [alternative] Scene planning → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.id equals "product-hero-v0"]`
|
|
50
|
+
- [conditional] Render/export evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [request.topic equals "artifact_evidence"]`
|
|
51
|
+
- [fallback] Failed workflow gate / pre-handoff check → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [gate.status equals "failed"]`
|
|
52
|
+
- [conditional] GLB handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [request.topic equals "glb_handoff"]`
|
|
53
|
+
- [progression] Final response → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
54
|
+
|
|
55
|
+
## Safety boundaries & non-goals
|
|
56
|
+
- Runtime boundary: Before runtime work, point to `docs/runtime-stack-strategy.md`, `runtime-path-picker`, and `runtime-readiness`.
|
|
57
|
+
- Replace or duplicate `workflow-stage-router` precedence logic once the goal is clear and artifacts exist.
|
|
58
|
+
- Install Blender or runtimes.
|
|
59
|
+
- Run Blender or execute Python.
|
|
60
|
+
- Create or mutate scene data.
|
|
61
|
+
- Render/export artifacts.
|
|
62
|
+
- Publish packages or marketplace listings.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/bridge-conflicts/SKILL.md and skills/bridge-conflicts/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# bridge-conflicts
|
|
3
|
+
|
|
4
|
+
Purpose: Diagnose MCP bridge conflicts (Path 1 Official Blender Lab MCP 5.1+ vs Path 2 mcp-for-blender, port 9876 collisions, host mismatch) and hand off to runtime-readiness.
|
|
5
|
+
|
|
6
|
+
Resolve the single-bridge constraint when more than one MCP runtime path is configured against the same Blender instance (or when ports collide). Blender accepts only one MCP bridge session per instance (default port 9876) — so running Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) concurrently, connecting two MCP clients to one Blender instance, colliding on port 9876, or enabling both Path 1 host (a) and host (b) on one session causes inconsistent signals.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `port-and-addon-conflict-resolver` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- `runtime-readiness` reports inconsistent signals (e.g. host reports connected but tool calls return the wrong tool surface)
|
|
12
|
+
- both Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) add-ons are enabled in the same Blender instance
|
|
13
|
+
- two MCP clients are pointing at the same Blender instance (e.g. Claude Desktop with Connector + Cursor with manual MCP)
|
|
14
|
+
- Path 1 host (a) and host (b) are both active on a single session
|
|
15
|
+
- log or port output shows a collision on default port `9876`
|
|
16
|
+
- Trigger phrases: "tool surface looks wrong", "smoke test passed yesterday but recipe fails today", "Lab MCP and ahujasid both installed", "Claude Desktop and Cursor both pointing at Blender", "port 9876 already in use", "single-bridge constraint violation"
|
|
17
|
+
|
|
18
|
+
## When not to use (delegation boundaries)
|
|
19
|
+
- no readiness signal yet (run runtime-readiness first) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; run runtime-readiness first)
|
|
20
|
+
- no runtime path has been chosen yet → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; route to runtime-path-picker)
|
|
21
|
+
- the user wants to switch or set up a path from scratch → use `runtime-setup` (`references/skill-runtime-setup.md`; route to runtime-setup)
|
|
22
|
+
- the bridge matrix is clean and only one path is active, but smoke tests still fail → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; route to blender-troubleshooting)
|
|
23
|
+
- the user explicitly wants both paths configured for separate Blender instances on different ports (requires explicit port isolation) → use `runtime-readiness` (`references/skill-runtime-readiness.md`; requires explicit port isolation)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `target_blender_instance` (`string`): Running Blender session identifier or binary path experiencing bridge or port collisions
|
|
27
|
+
- Required input `configured_mcp_hosts_and_addons` (`object`): Inventory of enabled Blender add-ons (Lab MCP vs mcp-for-blender) and active MCP client connections
|
|
28
|
+
- Optional input `port_9876_diagnostics` (`string`): Optional socket/port binding diagnostics around default port 9876
|
|
29
|
+
- Output contract: `bridge_conflict_diagnosis_matrix`, `single_bridge_isolation_steps`, `post_resolution_readiness_recheck_route` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. list every active / configured bridge for the target Blender session
|
|
33
|
+
2. check for port collision (commonly `localhost:9876`)
|
|
34
|
+
3. identify which path is intended; which is residual
|
|
35
|
+
4. propose the cheapest disable / port-isolation step
|
|
36
|
+
5. hand off to `runtime-readiness` to re-verify
|
|
37
|
+
|
|
38
|
+
## Cross-skill handoffs
|
|
39
|
+
- [upstream_reference] When runtime-readiness reports inconsistent signals → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
40
|
+
- [fallback] If the bridge matrix is clean but failures persist → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
41
|
+
- [upstream_reference] If the user wants to change paths or set up a path → `runtime-setup` (`references/skill-runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
|
|
42
|
+
- [upstream_reference] If the intended runtime path has not been chosen yet → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: This skill never disables add-ons, edits MCP client configs, changes ports, kills processes, or runs Blender. It only diagnoses the conflict, proposes the cheapest resolution for the operator to perform, and hands off to `runtime-readiness`.
|
|
46
|
+
- Disabling add-ons, editing MCP client configs, changing ports, killing processes, or running Blender
|
|
47
|
+
- Upgrading Runtime or Artifact truth states
|
|
48
|
+
- Replacing `runtime-readiness`, `runtime-path-picker`, `runtime-setup`, or `blender-troubleshooting`
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/camera-composition/SKILL.md and skills/camera-composition/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# camera-composition
|
|
3
|
+
|
|
4
|
+
Purpose: Provide detailed composition and camera planning for product hero outputs.
|
|
5
|
+
|
|
6
|
+
Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `camera-rig-and-composition-deep-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
|
|
12
|
+
- defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
|
|
13
|
+
- aligning hero framing and negative space with web/UI copy overlays
|
|
14
|
+
- Trigger phrases: "improve composition and camera", "choose hero framing", "set camera strategy for product hero"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- as proof of rendered output quality or to validate an existing framing → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
|
|
18
|
+
- to design lighting rigs or surface materials/lookdev → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; use lighting-material-plan)
|
|
19
|
+
- to lock final pixel resolution or output aspect specs → use `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`; use resolution-aspect-decision)
|
|
20
|
+
- to choose delivery file formats → use `output-format-decision` (`references/skill-output-format-decision.md`; use output-format-decision)
|
|
21
|
+
- when subject intent is undefined → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
|
|
22
|
+
|
|
23
|
+
## Input & output contract
|
|
24
|
+
- Required input `domain_scene_plan` (`object`): Upstream scene layout plan defining subject scale, staging, and depth layers
|
|
25
|
+
- Required input `framing_goal` (`string`): Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)
|
|
26
|
+
- Optional input `pinned_aspect_ratio` (`string`): Aspect ratio lock from resolution-aspect-decision
|
|
27
|
+
- Output contract: `camera_rig_specification`, `focal_length_and_dof_plan`, `composition_anchor_guidelines` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
28
|
+
|
|
29
|
+
## Quick-start steps
|
|
30
|
+
1. confirm this skill fits your goal
|
|
31
|
+
2. provide required inputs first
|
|
32
|
+
3. keep runtime claims evidence-bound
|
|
33
|
+
4. follow suggested next-skill handoff
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] Upstream input from → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
37
|
+
- [conditional] Lateral output specs (if needed) (output-format-decision) → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
38
|
+
- [conditional] Lateral output specs (if needed) (resolution-aspect-decision) → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
|
|
39
|
+
- [progression] Next (lookdev & lighting) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
40
|
+
- [progression] Then (validation) (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
41
|
+
- [progression] Then (validation) (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
42
|
+
|
|
43
|
+
## Safety boundaries & non-goals
|
|
44
|
+
- Runtime boundary: Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. Runtime status stays `Not Run` and artifacts stay `Not Produced` (truth states are downgrade-only, never upgraded without verified evidence).
|
|
45
|
+
- executing Blender commands, writing Python scripts, or generating scene/render artifacts
|
|
46
|
+
- designing lighting setups or materials (owned by `lighting-material-plan`)
|
|
47
|
+
- validating or scoring completed scene framing (owned by `composition-quality-checker`)
|
|
48
|
+
- locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/character-portrait/SKILL.md and skills/character-portrait/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# character-portrait
|
|
3
|
+
|
|
4
|
+
Purpose: Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
|
|
5
|
+
|
|
6
|
+
Translate a single-subject character-portrait intent (subject identity, pose, expression, wardrobe, framing, lighting, background) into a structured scene plan with an explicit assumptions register. Distinct from `product-hero-scene-planner` (manufactured products), `environment-shot` (places), and `interior-scene` (rooms). Multi-character ensembles are out of scope. Hands off framing deep-dives to `camera-composition`, lookdev deep-dives to `lighting-material-plan`, assets to `asset-discovery`, and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `character-portrait-and-turntable-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- intent is explicitly a character / person / creature portrait
|
|
12
|
+
- before any modeling or scene file is built
|
|
13
|
+
- when the consumer is editorial / brand / catalog / cinematic
|
|
14
|
+
- Trigger phrases: "portrait of", "character looking at the camera", "headshot", "hero shot of [person / mascot / creature]"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- product hero scenes → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
18
|
+
- environment establishing shots → use `environment-shot` (`references/skill-environment-shot.md`; use environment-shot)
|
|
19
|
+
- interior arch viz → use `interior-scene` (`references/skill-interior-scene.md`; use interior-scene)
|
|
20
|
+
- multi-character ensemble (this skill is single-subject) → use `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`; this skill is single-subject)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `locked_3d_brief` (`object`): Locked 3D brief specifying character subject, expression/pose, and framing intent
|
|
24
|
+
- Required input `character_asset_posture` (`object`): Available character model/rig status and material readiness from asset discovery
|
|
25
|
+
- Optional input `turntable_or_still_preference` (`string`): Whether the deliverable is a portrait still, bust turntable, or full-body pose
|
|
26
|
+
- Output contract: `character_staging_and_pose_plan`, `eyeline_and_portrait_camera_anchors`, `skin_hair_rim_lighting_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
|
|
30
|
+
2. confirm likeness rights before use if the subject is a real person
|
|
31
|
+
3. pin subject identity, pose, expression, wardrobe, framing, lighting, and background
|
|
32
|
+
4. record an explicit assumptions register
|
|
33
|
+
5. flag needed assets for `asset-discovery`
|
|
34
|
+
6. emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Upstream brief → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
38
|
+
- [progression] Framing deep-dive → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
39
|
+
- [progression] Lookdev deep-dive → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
40
|
+
- [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
41
|
+
- [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
42
|
+
- [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
43
|
+
- [progression] Scene quality validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
44
|
+
|
|
45
|
+
## Safety boundaries & non-goals
|
|
46
|
+
- Runtime boundary: Planning-only skill: no modeling, no animation, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief is unclear, hand off to `intent-to-3d-brief-writer`.
|
|
47
|
+
- Model the character.
|
|
48
|
+
- Animate the character.
|
|
49
|
+
- Render.
|
|
50
|
+
- Run Blender.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cli-appendix-job-outline/SKILL.md and skills/cli-appendix-job-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# cli-appendix-job-outline
|
|
3
|
+
|
|
4
|
+
Purpose: Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.
|
|
5
|
+
|
|
6
|
+
Structure **CLI fallback appendix** jobs (batch render, batch export, scripted scene setup) using Blender's documented command-line interface — without presenting arbitrary Python as the user-facing product surface.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `runtime-and-execution` | Role `headless-cli-batch-job-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- CI / render farm / repeatable exports
|
|
12
|
+
- MCP unavailable or disallowed by policy
|
|
13
|
+
- deterministic batch operations vs exploratory modeling
|
|
14
|
+
- Trigger phrases: "headless blender", "batch render CLI", "blender --background", "render farm outline"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- interactive viewport iteration primary goal → use `runtime-path-picker` (`references/skill-runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
|
|
18
|
+
- user expects Connector chat loop → use `path-one-host-outline` (`references/skill-path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
|
|
19
|
+
|
|
20
|
+
## Input & output contract
|
|
21
|
+
- Required input `target_blend_scene_and_outputs` (`object`): Source .blend file expectations and target render/export output deliverables
|
|
22
|
+
- Required input `execution_environment_constraints` (`string`): Headless CI, render node, or local batch constraints selected via runtime-path-picker
|
|
23
|
+
- Optional input `frame_range_or_batch_items` (`array`): Optional frame range or batch variant list for headless execution
|
|
24
|
+
- Output contract: `headless_cli_job_outline`, `appendix_governance_and_backup_gates`, `expected_output_evidence_hooks` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
25
|
+
|
|
26
|
+
## Quick-start steps
|
|
27
|
+
1. classify job type via `skills/cli-appendix-job-outline/references/job-type-matrix.md`
|
|
28
|
+
2. capture ordering cautions `skills/cli-appendix-job-outline/references/flag-order-reminders.md`
|
|
29
|
+
3. state limitations `skills/cli-appendix-job-outline/references/stateless-limitations.md`
|
|
30
|
+
4. point user to upstream CLI manual for exact flags
|
|
31
|
+
|
|
32
|
+
## Cross-skill handoffs
|
|
33
|
+
- [upstream_reference] Pick MCP vs CLI → `runtime-path-picker` (`references/skill-runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
34
|
+
- [upstream_reference] Interactive MCP host outline → `path-one-host-outline` (`references/skill-path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
|
|
35
|
+
- [progression] Export format choices → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
36
|
+
- [progression] Actual CLI output evidence recording → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
37
|
+
- [progression] Runtime attempt reporting → `runtime-attempt-report` (`references/skill-runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
|
|
38
|
+
|
|
39
|
+
## Safety boundaries & non-goals
|
|
40
|
+
- Runtime boundary: Planning outline only — BlendOps never executes Blender and never presents arbitrary Python as the product surface. This CLI workflow is an **appendix only**, never a peer path without an eval record, and BlendOps has **no in-repo CLI evidence file yet**. Point users to the upstream Blender manual for exact CLI flags.
|
|
41
|
+
- Generating or debugging user-facing Python (`bpy`) scripts.
|
|
42
|
+
- Executing `blender --background` jobs or inspecting output files directly.
|
|
43
|
+
- Selecting between MCP Path 1, Path 2, and CLI (owned by `runtime-path-picker`).
|
|
44
|
+
- Certifying rendered frames or exported GLBs (owned by `render-export-evidence`).
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/color-management-decision/SKILL.md and skills/color-management-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# color-management-decision
|
|
3
|
+
|
|
4
|
+
Purpose: Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.
|
|
5
|
+
|
|
6
|
+
Avoid the most common Blender color mistake: rendering with the wrong color space and then "fixing" it in post. Pick the color management strategy upfront based on the consumer's color pipeline.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `view-transform-and-colorspace-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before render / lookdev pass
|
|
12
|
+
- when consumer color pipeline is known
|
|
13
|
+
- when a previous render had unexpected color shifts
|
|
14
|
+
- Trigger phrases: "what color space", "Filmic vs Standard", "ACEScg for our pipeline", "colors look weird"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- Post-render color grading or soft-proofing (handled by compositor / DCC after render). → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
18
|
+
- Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker). → use `material-quality-checker` (`references/skill-material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
|
|
19
|
+
- Selecting file formats or bit depths (output-format-decision). → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
20
|
+
- Choosing the render engine (cycles-vs-eevee-decision). → use `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
21
|
+
- Monitor hardware calibration (out of scope). → use `material-quality-checker` (`references/skill-material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
|
|
22
|
+
- Raw modeling without lookdev (color management does not affect geometry accuracy). → use `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `target_delivery_pipeline` (`string`): Target display or compositing pipeline (web sRGB, product brand match, ACEScg VFX, HDR)
|
|
26
|
+
- Required input `blender_version_posture` (`string`): Target Blender version family (3.6 LTS Filmic, 4.0+ AgX, 5.1+ AgX/ACES)
|
|
27
|
+
- Optional input `brand_hex_swatch_constraints` (`array`): Optional strict brand hex colors requiring Standard vs tone-mapped tradeoffs
|
|
28
|
+
- Output contract: `pinned_view_transform_and_look`, `display_and_working_colorspace_spec`, `cross_engine_and_web_color_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. Identify the consumer pipeline (`web sRGB` / `film/VFX ACES linear` / `game engine` / `print` / `GLB-Three.js`).
|
|
32
|
+
2. Pin the 4-line render color config: `Display Device`, `View Transform`, `Look`, and `Sequencer`.
|
|
33
|
+
3. Define per-output color transforms if multiple outputs exist.
|
|
34
|
+
4. Emit the 4-line config record, caveats, truth states (`Not Run` / `Not Produced`), and handoff.
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [progression] Output format selection → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
38
|
+
- [progression] Material texture color spaces → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
39
|
+
- [progression] Render engine choice → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
|
|
40
|
+
- [progression] GLB Three.js delivery → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
41
|
+
- [progression] Render evidence verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
42
|
+
|
|
43
|
+
## Safety boundaries & non-goals
|
|
44
|
+
- Runtime boundary: Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
45
|
+
- Validate per-material texture color spaces (`material-quality-checker`).
|
|
46
|
+
- Choose output file formats or bit depths (`output-format-decision`).
|
|
47
|
+
- Choose the render engine (`cycles-vs-eevee-decision`).
|
|
48
|
+
- Perform post-render color grading (belongs to compositor / DCC).
|
|
49
|
+
- Calibrate a physical monitor (out of scope).
|
|
50
|
+
- Run Blender or execute renders.
|