blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/composition-quality-checker/SKILL.md and skills/composition-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# composition-quality-checker
|
|
3
|
+
|
|
4
|
+
Purpose: Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
|
|
5
|
+
|
|
6
|
+
Run a focused per-row Pass/Warn/Fail check on the camera and framing setup against composition rules (rule of thirds, subject placement, headroom/lead-room, negative space, visual hierarchy, depth cues, and lens/FOV plausibility) — emitting per-row verdicts, a top-line status, and remediation hints only, without expanding into camera planning, aspect-ratio locking, material validation, or lighting validation.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `framing-and-silhouette-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before render
|
|
12
|
+
- after a camera change request
|
|
13
|
+
- as a sub-check during full quality review
|
|
14
|
+
- when a render "feels off" but lighting and materials check out
|
|
15
|
+
- Trigger phrases: "is the framing okay", "check composition", "subject feels off-center", "too much negative space"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- planning or editing camera framing → use `camera-composition` (`references/skill-camera-composition.md`; use camera-composition)
|
|
19
|
+
- locking aspect ratio or resolution → use `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`; use resolution-aspect-decision)
|
|
20
|
+
- material validation → use `material-quality-checker` (`references/skill-material-quality-checker.md`; use material-quality-checker)
|
|
21
|
+
- lighting validation → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker)
|
|
22
|
+
- broad scene Pass/Warn/Fail readiness review → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
|
|
23
|
+
- classifying render or export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `camera_and_framing_spec` (`object`): Camera focal length, sensor, angle, and subject placement from camera-composition
|
|
27
|
+
- Required input `pinned_aspect_ratio_and_subject` (`object`): Locked aspect ratio and primary/secondary focal hierarchy from brief
|
|
28
|
+
- Optional input `viewport_or_render_preview_notes` (`string`): Optional framing observations from a viewport or preview capture
|
|
29
|
+
- Output contract: `composition_verdict_table`, `silhouette_and_headroom_assessment`, `camera_replan_remediation_hints` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. read camera lens / FOV, position, and target description
|
|
33
|
+
2. read framing intent and locked aspect ratio from the brief
|
|
34
|
+
3. check rule of thirds, subject placement, and headroom/lead-room
|
|
35
|
+
4. check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
|
|
36
|
+
5. emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
|
|
37
|
+
|
|
38
|
+
## Cross-skill handoffs
|
|
39
|
+
- [progression] Broad scene readiness review (consumes these rows) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
40
|
+
- [retry] Camera & framing re-plan → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
41
|
+
- [retry] Aspect ratio & resolution locks → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
42
|
+
- [progression] Artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
43
|
+
- [upstream_reference] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
44
|
+
- [upstream_reference] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
45
|
+
|
|
46
|
+
## Safety boundaries & non-goals
|
|
47
|
+
- Runtime boundary: This skill validates camera plans or measured scene snapshots only. It never moves the camera, never runs Blender, and never executes Python. Artifacts stay `Not Produced` unless concrete output evidence exists (classified by `render-export-evidence`), and truth states are strictly downgrade-only.
|
|
48
|
+
- Move or edit the camera (owned by `camera-composition`).
|
|
49
|
+
- Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
|
|
50
|
+
- Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
|
|
51
|
+
- Replace broad scene review (`scene-readiness`).
|
|
52
|
+
- Classify render or export artifact evidence (`render-export-evidence`).
|
|
53
|
+
- Run Blender or execute Python.
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cycles-vs-eevee-decision/SKILL.md and skills/cycles-vs-eevee-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# cycles-vs-eevee-decision
|
|
3
|
+
|
|
4
|
+
Purpose: Pick Cycles, Eevee, or Workbench for a render based on quality bar, time budget, and feature requirements (caustics, subsurface, etc.). Note: Eevee was named Eevee Next on Blender 4.2-4.x only.
|
|
5
|
+
|
|
6
|
+
Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `render-and-output-decisions` | Role `render-engine-tradeoff-selector` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before render
|
|
12
|
+
- when feature support drives engine choice
|
|
13
|
+
- when time vs quality tradeoff matters
|
|
14
|
+
- when previous render was wrong engine
|
|
15
|
+
- Trigger phrases: "Cycles or Eevee", "what render engine", "is Eevee enough", "render is too slow"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- for a known repeat render (engine already chosen) → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; engine already chosen)
|
|
19
|
+
- for non-render work (modeling / animation prep) → use `output-format-decision` (`references/skill-output-format-decision.md`; modeling / animation prep)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `deliverable_use_case` (`string`): Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source
|
|
23
|
+
- Required input `optical_feature_requirements` (`array`): Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)
|
|
24
|
+
- Required input `render_time_and_hardware_budget` (`string`): Per-frame render time ceiling and available GPU/CPU compute posture
|
|
25
|
+
- Optional input `blender_version_token` (`string`): Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming
|
|
26
|
+
- Output contract: `selected_render_engine_record`, `sample_and_denoiser_targets`, `engine_tradeoff_and_fallback_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. Name the use case (hero / preview / animation / lookdev / flat clay).
|
|
30
|
+
2. Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
|
|
31
|
+
3. Evaluate time budget per frame and available hardware.
|
|
32
|
+
4. Pick the engine: `Cycles`, `Eevee`, or `Workbench` (note: Eevee used the name Eevee Next and token `BLENDER_EEVEE_NEXT` on Blender 4.2–4.x only; it is `Eevee` with token `BLENDER_EEVEE` on 4.0–4.1 and 5.x).
|
|
33
|
+
5. Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] Lighting and material setup aligned with engine choice → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
37
|
+
- [upstream_reference] Color configuration decision → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
38
|
+
- [progression] Output container / codec decision → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
39
|
+
- [upstream_reference] Render resolution and aspect ratio decision → `resolution-aspect-decision` (`references/skill-resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
|
|
40
|
+
- [progression] Post-render output verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
41
|
+
|
|
42
|
+
## Safety boundaries & non-goals
|
|
43
|
+
- Runtime boundary: Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
44
|
+
- Never run Blender or execute a render or preview render.
|
|
45
|
+
- Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
|
|
46
|
+
- Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
|
|
47
|
+
- Never verify rendered files (`render-export-evidence`).
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/done-criteria/SKILL.md and skills/done-criteria/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# done-criteria
|
|
3
|
+
|
|
4
|
+
Purpose: Define explicit "done" conditions for a Blender recipe before starting work, so the agent stops at the right point instead of drifting into endless polish.
|
|
5
|
+
|
|
6
|
+
Pin a single, explicit stop condition for one recipe BEFORE work begins—consisting of one concrete sentence, an explicit out-of-scope list, and a handoff trigger—so the agent stops at the right point instead of drifting into endless polish. Firing the stop condition routes the deliverable to the next skill; it never upgrades any runtime or artifact truth state. Inspired by Anthropic Superpowers `/just-say-when-it's-done` analog.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `done-condition-and-iteration-cap-pinner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- BEFORE starting work on any non-trivial single Blender recipe
|
|
12
|
+
- after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
|
|
13
|
+
- when previous attempts drifted into endless polish or unclear completion boundaries
|
|
14
|
+
- Trigger phrases: "when are we done", "let's set the bar", "what does done look like"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- pure exploration or brainstorming → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming; goal is divergence)
|
|
18
|
+
- tiny single-shot requests → 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)
|
|
19
|
+
- splitting a broad multi-recipe request beforehand → use `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`; use blender-recipe-decomposer first)
|
|
20
|
+
- authoring measurable acceptance rows from scratch → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; use acceptance-criteria-builder first)
|
|
21
|
+
- enforcing per-stage checklist gates during execution → use `stage-gates` (`references/skill-stage-gates.md`; use stage-gates)
|
|
22
|
+
- after work has already started and scope is drifting mid-flight → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard)
|
|
23
|
+
- performing the final verification gate before delivery → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining deliverable intent
|
|
27
|
+
- Required input `acceptance_criteria_rows` (`array`): Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder
|
|
28
|
+
- Optional input `iteration_budget_preference` (`integer`): Maximum refinement passes before halting or escalating
|
|
29
|
+
- Output contract: `definition_of_done_checklist`, `max_iteration_caps_per_stage`, `halt_and_escalation_triggers` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. write one stop condition per recipe (one sentence, concrete)
|
|
33
|
+
2. write what is OUT OF SCOPE for "done"
|
|
34
|
+
3. write the handoff trigger (which skill receives the deliverable when stop condition fires)
|
|
35
|
+
4. enforce: do not polish past the stop condition; do not declare done before it
|
|
36
|
+
|
|
37
|
+
## Cross-skill handoffs
|
|
38
|
+
- [upstream_reference] Intent brief → `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 splitting beforehand → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
40
|
+
- [upstream_reference] Measurable acceptance rows → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
41
|
+
- [progression] Per-stage workflow gates → `stage-gates` (`references/skill-stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
|
|
42
|
+
- [progression] Mid-flight scope drift → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
43
|
+
- [progression] Artifact and render evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
44
|
+
- [progression] Final pre-handoff gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
45
|
+
|
|
46
|
+
## Safety boundaries & non-goals
|
|
47
|
+
- Runtime boundary: Process and discipline skill only—no Python code and no Blender execution. This skill writes the stop condition before work starts and routes handoff when the condition is met; it never executes runtime tasks or upgrades truth states.
|
|
48
|
+
- Run Blender or execute Python.
|
|
49
|
+
- Split multi-recipe scope (`blender-recipe-decomposer`).
|
|
50
|
+
- Author raw measurable acceptance rows (`acceptance-criteria-builder`).
|
|
51
|
+
- Enforce per-stage checklist gates (`stage-gates`).
|
|
52
|
+
- Police mid-flight scope drift (`scope-guard`).
|
|
53
|
+
- Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/environment-shot/SKILL.md and skills/environment-shot/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# environment-shot
|
|
3
|
+
|
|
4
|
+
Purpose: Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
|
|
5
|
+
|
|
6
|
+
Translate a wide place-establishing intent (locale, time of day, weather, atmosphere, foreground/midground/background depth layers, and focal subject or explicit "none") into a structured scene plan with an explicit assumptions register. Distinct from `character-portrait` (single subject), `product-hero-scene-planner` (manufactured products), and `interior-scene` (interior rooms/furniture/surfaces — an establishing shot of an interior room belongs there when furniture or surfaces dominate). Hands off asset rows 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 `environment-establishing-shot-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- intent is establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
|
|
12
|
+
- before any modeling, Geometry Nodes, or scene building
|
|
13
|
+
- when consumer is editorial, cinematic, or brand
|
|
14
|
+
- Trigger phrases: "establishing shot of", "wide shot of", "city / forest / desert / ocean scene", "set the scene"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- character portrait → use `character-portrait` (`references/skill-character-portrait.md`; use character-portrait)
|
|
18
|
+
- product hero → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
19
|
+
- interior arch viz with focus on furniture / surfaces → use `interior-scene` (`references/skill-interior-scene.md`; use interior-scene)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `locked_3d_brief` (`object`): Locked 3D brief specifying locale, mood, focal anchor, and delivery channel
|
|
23
|
+
- Required input `atmosphere_and_time_of_day` (`object`): Target time of day, weather condition, and atmospheric haze/fog parameters
|
|
24
|
+
- Optional input `asset_discovery_constraints` (`object`): Available environment kitbash or terrain assets from asset-discovery
|
|
25
|
+
- Output contract: `foreground_midground_background_layer_plan`, `sun_sky_atmosphere_specification`, `horizon_and_scale_anchor_plan` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
|
|
29
|
+
2. pin locale, time of day, weather, and atmosphere
|
|
30
|
+
3. pin foreground (FG), midground (MG), and background (BG) depth layers
|
|
31
|
+
4. pin focal subject (or explicitly declare `none`)
|
|
32
|
+
5. record an explicit assumptions register
|
|
33
|
+
6. flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [upstream_reference] 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]`
|
|
37
|
+
- [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
38
|
+
- [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
39
|
+
- [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
40
|
+
- [progression] Quality readiness → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
41
|
+
|
|
42
|
+
## Safety boundaries & non-goals
|
|
43
|
+
- Runtime boundary: Planning-only skill: no modeling, no Geometry Nodes, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief or locale scope is unclear, hand off to `intent-to-3d-brief-writer`.
|
|
44
|
+
- Model the environment.
|
|
45
|
+
- Generate Geometry Node setups.
|
|
46
|
+
- Render.
|
|
47
|
+
- Run Blender.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-animation-handoff/SKILL.md and skills/glb-animation-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# glb-animation-handoff
|
|
3
|
+
|
|
4
|
+
Purpose: Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.
|
|
5
|
+
|
|
6
|
+
When a GLB ships with animation, capture the exact playback contract the consumer needs (which clips exist, how to start them, what loops, what does not) so the web side does not guess.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `rig-and-animation-clip-handoff-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- the GLB has at least one animation clip
|
|
12
|
+
- before final glb-web-handoff
|
|
13
|
+
- when the consumer is a web app (Three.js / R3F / Babylon / model-viewer)
|
|
14
|
+
- when the user mentions "idle", "loop", "transition", "interactive trigger"
|
|
15
|
+
- Trigger phrases: "make it loop", "trigger animation on hover", "idle and active states", "smooth transition between"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- static GLBs with no animation → use `glb-web-handoff` (`references/skill-glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
|
|
19
|
+
- video pre-renders → use `output-format-decision` (`references/skill-output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
20
|
+
- platforms that re-author animation downstream (game engines re-rigging the asset) → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; game engines re-rigging the asset)
|
|
21
|
+
|
|
22
|
+
## Input & output contract
|
|
23
|
+
- Required input `animation_clip_inventory` (`array`): List of NLA/action clips with frame lengths, FPS, and skeletal/morph types
|
|
24
|
+
- Required input `interactive_playback_triggers` (`object`): Target loop/one-shot semantics, crossfade durations, root-motion policy, and consumer triggers
|
|
25
|
+
- Optional input `mobile_rig_budget_ceilings` (`object`): Bone count, morph target, and keyframe channel ceilings from mobile-glb-budget
|
|
26
|
+
- Output contract: `per_clip_animation_contract_table`, `root_motion_and_interpolation_pins`, `consumer_playback_verification_checklist` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
27
|
+
|
|
28
|
+
## Quick-start steps
|
|
29
|
+
1. enumerate every animation clip in the scene plan or exported GLB
|
|
30
|
+
2. mark the type of each clip (skeletal / morph / both)
|
|
31
|
+
3. pin FPS, loop semantics, transitions, root-motion treatment
|
|
32
|
+
4. flag web-playback caveats per clip (Three.js animationMixer, glTF spec quirks)
|
|
33
|
+
|
|
34
|
+
## Cross-skill handoffs
|
|
35
|
+
- [upstream_reference] Missing clip list / scene plan (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
36
|
+
- [upstream_reference] Missing clip list / scene plan (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
37
|
+
- [upstream_reference] Missing clip list / scene plan (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
38
|
+
- [upstream_reference] Missing clip list / scene plan (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
39
|
+
- [upstream_reference] Missing clip list / scene plan (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
40
|
+
- [upstream_reference] Channel, bone, and morph ceilings → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
41
|
+
- [upstream_reference] Export verification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
42
|
+
- [progression] Web delivery handoff → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
43
|
+
- [progression] React Three Fiber component shape → `r3f-component-plan` (`references/skill-r3f-component-plan.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "react_three_fiber"]`
|
|
44
|
+
- [progression] Final user-facing wording → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
45
|
+
|
|
46
|
+
## Safety boundaries & non-goals
|
|
47
|
+
- Runtime boundary: This skill is documentation-only. It never exports GLB, runs Blender, writes Python, or claims that a clip plays correctly without measured evidence (`render-export-evidence` for export proof plus manual viewer test for playback).
|
|
48
|
+
- Run Blender or export GLB files.
|
|
49
|
+
- Author, retarget, or modify animations.
|
|
50
|
+
- Generate Python or `bpy` snippets.
|
|
51
|
+
- Promise web-side playback smoothness or upgrade truth states.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/glb-web-handoff/SKILL.md and skills/glb-web-handoff/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# glb-web-handoff
|
|
3
|
+
|
|
4
|
+
Purpose: Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.
|
|
5
|
+
|
|
6
|
+
Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `evidence-and-handoff` | Role `web-glb-delivery-packager` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
|
|
12
|
+
- when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
|
|
13
|
+
- when preparing truthful next checks before passing final wording to `plain-language-response`
|
|
14
|
+
- Trigger phrases: "prepare web handoff", "is GLB ready", "summarize export status"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- to claim GLB or export success without concrete evidence → use `scene-readiness` (`references/skill-scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
|
|
18
|
+
- to replace runtime export verification → use `render-export-evidence` (`references/skill-render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
|
|
19
|
+
- to validate upstream scene readiness → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
|
|
20
|
+
- to classify raw render/export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
|
|
21
|
+
- to define mobile or file-size performance budgets → use `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`; use mobile-glb-budget)
|
|
22
|
+
- to define animation playback or rig contracts → use `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`; use glb-animation-handoff)
|
|
23
|
+
- to write the final user-facing response wording → use `plain-language-response` (`references/skill-plain-language-response.md`; use plain-language-response)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `verified_or_planned_glb_artifact` (`object`): GLB artifact evidence record (from render-export-evidence) or planned export specification
|
|
27
|
+
- Required input `target_web_viewer_stack` (`string`): Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)
|
|
28
|
+
- Optional input `animation_and_budget_contracts` (`object`): Optional linked contracts from glb-animation-handoff and mobile-glb-budget
|
|
29
|
+
- Output contract: `web_glb_delivery_handoff_packet`, `scale_orientation_and_compression_manifest`, `viewer_integration_caveats` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. confirm this skill fits your goal
|
|
33
|
+
2. provide required inputs first
|
|
34
|
+
3. keep runtime claims evidence-bound
|
|
35
|
+
4. follow suggested next-skill handoff
|
|
36
|
+
|
|
37
|
+
## Cross-skill handoffs
|
|
38
|
+
- [upstream_reference] Upstream scene readiness validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
39
|
+
- [upstream_reference] Upstream artifact evidence classification → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
40
|
+
- [upstream_reference] Mobile and file-size budget constraints → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
41
|
+
- [upstream_reference] Animation playback and rig handoff contracts → `glb-animation-handoff` (`references/skill-glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
|
|
42
|
+
- [progression] Final user-facing response wording → `plain-language-response` (`references/skill-plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Never claim GLB or export success without concrete evidence tied to the current run, and never replace runtime export verification. Keep runtime vocabulary strictly within the 2-path (Path 1 Official Blender Lab MCP 5.1+, Path 2 community `mcp-for-blender`) + CLI appendix model. This skill never runs Blender or Python and never upgrades Runtime or Artifact truth states (downgrade-only).
|
|
46
|
+
- Generating Python scripts or executing Blender exports
|
|
47
|
+
- Replacing runtime export verification
|
|
48
|
+
- Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
|
|
49
|
+
- Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
|
|
50
|
+
- Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
|
|
51
|
+
- Making unsupported web stack or loader compatibility guarantees
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/intent-to-3d-brief-writer/SKILL.md and skills/intent-to-3d-brief-writer/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# intent-to-3d-brief-writer
|
|
3
|
+
|
|
4
|
+
Purpose: Convert a non-Blender-user's natural-language request into a structured 3D brief (subject, mood, deliverables, constraints, evidence expectations). Use as first step before any planner.
|
|
5
|
+
|
|
6
|
+
Translate a confirmed user intent (from `blender-brainstorming` or a clear initial request) into a structured 3D brief that downstream planners and `acceptance-criteria-builder` can consume without re-asking. Inspired by the "Analysis phase" pattern in BMad-Method (PRD / project brief), adapted for 3D scene work and non-Blender users.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `canonical-8-slot-brief-author` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- right after `blender-brainstorming` confirms user intent
|
|
12
|
+
- when the user provides a structured request that just needs format normalization
|
|
13
|
+
- before any planner skill (`product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`)
|
|
14
|
+
- before `acceptance-criteria-builder` consumes brief rows to build criteria
|
|
15
|
+
- when multiple planners need to share the same source-of-truth brief
|
|
16
|
+
- Trigger phrases: "lock the brief", "write the brief from this conversation", "what's the formal scope?", "before planning, write the spec"
|
|
17
|
+
|
|
18
|
+
## When not to use (delegation boundaries)
|
|
19
|
+
- intent is still ambiguous (run blender-brainstorming first) → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; run blender-brainstorming first)
|
|
20
|
+
- the user is mid-execution and asks for a re-brief → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; route to blender-troubleshooting instead)
|
|
21
|
+
- the user pushes for immediate execution → use `runtime-readiness` (`references/skill-runtime-readiness.md`; route to runtime-readiness)
|
|
22
|
+
- the request is iteration on existing output ("make it darker") — that's a planner-level edit, not a new brief → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `raw_user_goal_and_context` (`string`): User request or brainstormed concept to lock into the canonical 8-slot 3D brief
|
|
26
|
+
- Required input `target_deliverable_surface` (`string`): Intended output format (hero still, product grid, portrait, environment, interior, or web GLB)
|
|
27
|
+
- Optional input `selected_recipe_or_pack` (`string`): Recipe or pack selected via recipe-fit-assessor
|
|
28
|
+
- Output contract: `canonical_8_slot_3d_brief`, `explicit_assumptions_register`, `scope_exclusions_and_next_skill` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. read confirmed intent from prior step (`blender-brainstorming` or original request)
|
|
32
|
+
2. fill the 8 brief slots (mark unconfirmed items as `Unknown`, never invent)
|
|
33
|
+
3. echo the brief to the user for confirmation
|
|
34
|
+
4. hand off to downstream planners (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder` once confirmed
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Preceding step → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
38
|
+
- [progression] Consuming skills (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
39
|
+
- [progression] Consuming skills (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
40
|
+
- [progression] Consuming skills (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] Consuming skills (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
42
|
+
- [conditional] If execution is requested → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
43
|
+
- [fallback] If mid-execution re-briefing occurs → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
44
|
+
|
|
45
|
+
## Safety boundaries & non-goals
|
|
46
|
+
- Runtime boundary: This skill does not install Blender, run Blender, configure MCP, or claim artifacts. Output is a structured text brief.
|
|
47
|
+
- making the plan (planner's job)
|
|
48
|
+
- running Blender
|
|
49
|
+
- setting up runtime
|
|
50
|
+
- writing the final user response (`plain-language-response`'s job)
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/interior-scene/SKILL.md and skills/interior-scene/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# interior-scene
|
|
3
|
+
|
|
4
|
+
Purpose: Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.
|
|
5
|
+
|
|
6
|
+
Translate an interior architectural visualization intent (room or interior space planned for catalog, brand, or showcase) into a complete, structured room plan with an assumptions register. Distinct from `environment-shot` (outdoor/wide places; an establishing shot of an interior room belongs HERE when furniture and surfaces dominate), `product-hero-scene-planner` (single manufactured product), and `character-portrait` (single subject).
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `interior-archviz-scene-architect` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
|
|
12
|
+
- architectural visualization, catalog, brand showcase, hospitality, or residential room planning
|
|
13
|
+
- before any modeling, furniture sourcing, or rendering
|
|
14
|
+
- Trigger phrases: "interior of", "living room scene", "office showcase", "hotel lobby", "kitchen showroom"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- outdoor establishing → use `environment-shot` (`references/skill-environment-shot.md`; use environment-shot)
|
|
18
|
+
- single hero product → use `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
19
|
+
- character portrait → use `character-portrait` (`references/skill-character-portrait.md`; use character-portrait)
|
|
20
|
+
|
|
21
|
+
## Input & output contract
|
|
22
|
+
- Required input `locked_3d_brief` (`object`): Locked 3D brief specifying room type, architectural style, focal zone, and daylight/artificial mood
|
|
23
|
+
- Required input `room_dimensions_and_openings` (`object`): Architectural envelope, window/door openings, and primary furniture anchor zones
|
|
24
|
+
- Optional input `sourced_furniture_and_finish_assets` (`array`): Available furniture and architectural material assets from asset-discovery
|
|
25
|
+
- Output contract: `interior_zone_and_circulation_plan`, `window_portal_and_fixture_lighting_plan`, `two_point_vertical_camera_constraints` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
26
|
+
|
|
27
|
+
## Quick-start steps
|
|
28
|
+
1. lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
|
|
29
|
+
2. pin architecture basics (walls, floor, ceiling, windows, doors)
|
|
30
|
+
3. pin furniture + props + material palette
|
|
31
|
+
4. pin lighting (natural + artificial mix) + mood + time of day
|
|
32
|
+
5. pin camera angle + lens
|
|
33
|
+
6. emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers
|
|
34
|
+
|
|
35
|
+
## Cross-skill handoffs
|
|
36
|
+
- [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]`
|
|
37
|
+
- [upstream_reference] Outdoor / wide establishing shot redirect → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
38
|
+
- [upstream_reference] Single hero product redirect → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
39
|
+
- [upstream_reference] Single character portrait redirect → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
40
|
+
- [upstream_reference] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
41
|
+
- [upstream_reference] Performance / polycount budget → `mobile-glb-budget` (`references/skill-mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
42
|
+
- [upstream_reference] Style consistency check → `asset-style-check` (`references/skill-asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
43
|
+
- [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
44
|
+
- [progression] Lighting validation → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
45
|
+
- [progression] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
46
|
+
- [progression] Scene quality validation → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
47
|
+
|
|
48
|
+
## Safety boundaries & non-goals
|
|
49
|
+
- Runtime boundary: Planning-only skill — does not model, source furniture, render, or execute Blender. Runtime status stays `Not Run` and artifact status stays `Not Produced` (downgrade-only, never upgrade). Hand off asset sourcing to `asset-discovery`, budget questions to `mobile-glb-budget`, style checks to `asset-style-check`, and validation to `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`.
|
|
50
|
+
- Model the room or geometry.
|
|
51
|
+
- Source furniture or download assets (belongs to `asset-discovery`).
|
|
52
|
+
- Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
|
|
53
|
+
- Audit cross-asset style consistency or validate composition, lighting, materials, or scene quality (belongs to `asset-style-check`, `composition-quality-checker`, `lighting-quality-checker`, `material-quality-checker`, and `scene-readiness`).
|
|
54
|
+
- Render or run Blender.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-material-plan/SKILL.md and skills/lighting-material-plan/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# lighting-material-plan
|
|
3
|
+
|
|
4
|
+
Purpose: Build detailed lighting and material direction with portability and caveat handling for Blender/web-3D outputs.
|
|
5
|
+
|
|
6
|
+
Create a high-quality, practical lighting/material plan that balances visual intent and web portability constraints.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `scene-planners` | Role `lighting-rig-and-lookdev-deep-planner` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- look-development strategy is needed
|
|
12
|
+
- lighting/material choices drive scene mood
|
|
13
|
+
- web/GLB portability caveats must be explicit
|
|
14
|
+
- Trigger phrases: "plan lighting and materials", "design cyberpunk lookdev", "define PBR and reflection strategy"
|
|
15
|
+
|
|
16
|
+
## When not to use (delegation boundaries)
|
|
17
|
+
- to claim final rendered quality or executed results → use `camera-composition` (`references/skill-camera-composition.md`; Delegates out-of-scope requests to camera-composition)
|
|
18
|
+
- to skip composition/camera context from camera-composition → use `camera-composition` (`references/skill-camera-composition.md`; Delegates out-of-scope requests to camera-composition)
|
|
19
|
+
- to validate existing lighting or materials → use `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`; use lighting-quality-checker and material-quality-checker)
|
|
20
|
+
- to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision) → use `color-management-decision` (`references/skill-color-management-decision.md`; output-format-decision)
|
|
21
|
+
- to execute Blender or generate Python scripts → use `color-management-decision` (`references/skill-color-management-decision.md`; Delegates out-of-scope requests to color-management-decision)
|
|
22
|
+
|
|
23
|
+
## Input & output contract
|
|
24
|
+
- Required input `domain_scene_plan` (`object`): Upstream scene layout and subject surface description
|
|
25
|
+
- Required input `camera_framing_plan` (`object`): Locked camera angles and hero silhouette requirements from camera-composition
|
|
26
|
+
- Optional input `target_render_engine_hint` (`string`): Preferred engine (Cycles, Eevee, or WebGL/GLB PBR export target)
|
|
27
|
+
- Output contract: `key_fill_rim_lighting_plan`, `pbr_material_and_roughness_spec`, `hdri_and_reflection_strategy` (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 (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
37
|
+
- [progression] Upstream input from (color-management-decision) → `color-management-decision` (`references/skill-color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
38
|
+
- [progression] Upstream input from (cycles-vs-eevee-decision) → `cycles-vs-eevee-decision` (`references/skill-cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
|
|
39
|
+
- [progression] Upstream input from (output-format-decision) → `output-format-decision` (`references/skill-output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
40
|
+
- [progression] Next validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
41
|
+
- [progression] Next validation (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
42
|
+
- [progression] Then scene check → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
43
|
+
- [progression] Then delivery → `glb-web-handoff` (`references/skill-glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
44
|
+
|
|
45
|
+
## Safety boundaries & non-goals
|
|
46
|
+
- Runtime boundary: This is a planning-only skill: no Blender execution, no Python, and no artifact generation. Runtime status always remains `Not Run` and artifact status always remains `Not Produced` (truth states are downgrade-only, never upgrade). If referencing Eevee engine tokens from upstream `cycles-vs-eevee-decision`, use `BLENDER_EEVEE` on Blender 4.0–4.1 and 5.x, and `BLENDER_EEVEE_NEXT` only for 4.2–4.x — never present Eevee Next as the current name.
|
|
47
|
+
- shader/runtime implementation code
|
|
48
|
+
- rendered quality claims without evidence
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/lighting-quality-checker/SKILL.md and skills/lighting-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# lighting-quality-checker
|
|
3
|
+
|
|
4
|
+
Purpose: Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
|
|
5
|
+
|
|
6
|
+
Run a focused pass/warn/fail check on the scene's lighting setup per light — covering intensity ranges, shadow softness, color temperature, HDRI / explicit-light balance, and mood match — without expanding into material, composition, or lookdev planning concerns.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `quality-validators` | Role `exposure-ratio-and-shadow-validator` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- before render
|
|
12
|
+
- after a lighting change request
|
|
13
|
+
- as a sub-check during full quality review
|
|
14
|
+
- when the rendered preview looks "off" but the issue is unclear
|
|
15
|
+
- Trigger phrases: "is the lighting okay", "check shadow softness", "lighting feels off", "is the HDRI balanced"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- upstream lookdev and lighting planning → use `lighting-material-plan` (`references/skill-lighting-material-plan.md`; use lighting-material-plan)
|
|
19
|
+
- material validation → use `material-quality-checker` (`references/skill-material-quality-checker.md`; use material-quality-checker)
|
|
20
|
+
- composition / camera validation → use `composition-quality-checker` (`references/skill-composition-quality-checker.md`; use composition-quality-checker)
|
|
21
|
+
- broad pass/warn/fail scene readiness → use `scene-readiness` (`references/skill-scene-readiness.md`; use scene-readiness)
|
|
22
|
+
- classifying render or export artifact evidence → use `render-export-evidence` (`references/skill-render-export-evidence.md`; use render-export-evidence)
|
|
23
|
+
- to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → use `scene-readiness` (`references/skill-scene-readiness.md`; this skill validates and gives remediation hints only; it never edits)
|
|
24
|
+
|
|
25
|
+
## Input & output contract
|
|
26
|
+
- Required input `lighting_rig_specification` (`object`): Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan
|
|
27
|
+
- Required input `color_management_pins` (`object`): Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision
|
|
28
|
+
- Optional input `render_or_preview_exposure_notes` (`string`): Optional highlight clipping or shadow crush observations from preview output
|
|
29
|
+
- Output contract: `lighting_quality_verdict_table`, `key_fill_rim_and_clipping_audit`, `lighting_remediation_instructions` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
30
|
+
|
|
31
|
+
## Quick-start steps
|
|
32
|
+
1. enumerate every explicit light and HDRI in the scene plan or measured scene
|
|
33
|
+
2. check intensity ranges per light
|
|
34
|
+
3. check shadow softness consistency
|
|
35
|
+
4. check color temperature consistency
|
|
36
|
+
5. check HDRI presence + balance with explicit lights
|
|
37
|
+
6. check mood match against the brief
|
|
38
|
+
7. emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
|
|
39
|
+
|
|
40
|
+
## Cross-skill handoffs
|
|
41
|
+
- [progression] Broad readiness review → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
42
|
+
- [upstream_reference] Material validation → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
43
|
+
- [progression] Composition validation → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
44
|
+
- [retry] Lighting re-plan → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
45
|
+
- [progression] Render evidence → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
46
|
+
|
|
47
|
+
## Safety boundaries & non-goals
|
|
48
|
+
- Runtime boundary: This skill validates plans or measured scene snapshots only. It never modifies lights, runs Blender, or renders. Use measured scene description (plan output, runtime tool snapshot) — never invent values.
|
|
49
|
+
- Edit lights.
|
|
50
|
+
- Generate light setup recipes.
|
|
51
|
+
- Replace `scene-readiness`.
|
|
52
|
+
- Run Blender.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Skill Map
|
|
2
|
+
|
|
3
|
+
Canonical BlendOps references inside this single upload-ready Skill package.
|
|
4
|
+
|
|
5
|
+
| Intent | Use reference |
|
|
6
|
+
|---|---|
|
|
7
|
+
| unclear next step | `skill-blendops-help.md` |
|
|
8
|
+
| vague creative request, intent exploration | `skill-blender-brainstorming.md` |
|
|
9
|
+
| convert intent → 8-slot 3D brief | `skill-intent-to-3d-brief-writer.md` |
|
|
10
|
+
| asset acquisition strategy | `skill-asset-discovery.md` |
|
|
11
|
+
| runtime setup prerequisites | `skill-runtime-setup.md` |
|
|
12
|
+
| runtime readiness | `skill-runtime-readiness.md` |
|
|
13
|
+
| MCP bridge conflicts (Path 1 + Path 2 + port 9876) | `skill-bridge-conflicts.md` |
|
|
14
|
+
| product hero scene plan | `skill-product-hero-scene-planner.md` |
|
|
15
|
+
| composition/camera | `skill-camera-composition.md` |
|
|
16
|
+
| lighting/material | `skill-lighting-material-plan.md` |
|
|
17
|
+
| scene quality gate | `skill-scene-readiness.md` |
|
|
18
|
+
| output looks wrong, root-cause analysis | `skill-blender-troubleshooting.md` |
|
|
19
|
+
| render/export evidence | `skill-render-export-evidence.md` |
|
|
20
|
+
| 7-point gate before any "ready" / `Verified` claim | `skill-pre-handoff-verification.md` |
|
|
21
|
+
| GLB/web handoff | `skill-glb-web-handoff.md` |
|
|
22
|
+
| plain-language final output | `skill-plain-language-response.md` |
|
|
23
|
+
| recipe / pack fit | `skill-recipe-fit-assessor.md` |
|
|
24
|
+
| pack pre-flight readiness | `skill-pack-prerequisite-checker.md` |
|
|
25
|
+
| resume / next skill routing | `skill-workflow-stage-router.md` |
|
|
26
|
+
| acceptance checklist authoring | `skill-acceptance-criteria-builder.md` |
|
|
27
|
+
| Path 1 vs Path 2 vs CLI decision | `skill-runtime-path-picker.md` |
|
|
28
|
+
| Path 1 Connector vs manual MCP | `skill-path-one-host-outline.md` |
|
|
29
|
+
| CLI appendix batch jobs | `skill-cli-appendix-job-outline.md` |
|
|
30
|
+
| runtime attempt provenance write-up | `skill-runtime-attempt-report.md` |
|
|
31
|
+
|
|
32
|
+
Apply law and evidence references before final output.
|