blendops 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -0
- package/LICENSE +21 -0
- package/README.md +208 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +73 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/README.md +276 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +103 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5443 -0
- package/scripts/runtime-orchestrator.mjs +7713 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,69 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Document GLB animation contract (skeletal vs morph, FPS, looping, root motion, blend transitions) with truthful caveats for web playback.
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/glb-animation-handoff/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/glb-animation-handoff/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `evidence-and-handoff` / `rig-and-animation-clip-handoff-planner`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- the GLB has at least one animation clip
|
|
18
|
+
- before final glb-web-handoff
|
|
19
|
+
- when the consumer is a web app (Three.js / R3F / Babylon / model-viewer)
|
|
20
|
+
- when the user mentions "idle", "loop", "transition", "interactive trigger"
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "make it loop"
|
|
24
|
+
- "trigger animation on hover"
|
|
25
|
+
- "idle and active states"
|
|
26
|
+
- "smooth transition between"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- static GLBs with no animation → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; Delegates out-of-scope requests to glb-web-handoff)
|
|
30
|
+
- video pre-renders → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
31
|
+
- platforms that re-author animation downstream (game engines re-rigging the asset) → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; game engines re-rigging the asset)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `animation_clip_inventory` (`array`): List of NLA/action clips with frame lengths, FPS, and skeletal/morph types
|
|
36
|
+
- `interactive_playback_triggers` (`object`): Target loop/one-shot semantics, crossfade durations, root-motion policy, and consumer triggers
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `mobile_rig_budget_ceilings` (`object`): Bone count, morph target, and keyframe channel ceilings from mobile-glb-budget
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `per_clip_animation_contract_table`
|
|
43
|
+
- `root_motion_and_interpolation_pins`
|
|
44
|
+
- `consumer_playback_verification_checklist`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. enumerate every animation clip in the scene plan or exported GLB
|
|
48
|
+
2. mark the type of each clip (skeletal / morph / both)
|
|
49
|
+
3. pin FPS, loop semantics, transitions, root-motion treatment
|
|
50
|
+
4. flag web-playback caveats per clip (Three.js animationMixer, glTF spec quirks)
|
|
51
|
+
|
|
52
|
+
## Handoff notes
|
|
53
|
+
- **[upstream_reference]** Missing clip list / scene plan (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
54
|
+
- **[upstream_reference]** Missing clip list / scene plan (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
55
|
+
- **[upstream_reference]** Missing clip list / scene plan (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
56
|
+
- **[upstream_reference]** Missing clip list / scene plan (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
57
|
+
- **[upstream_reference]** Missing clip list / scene plan (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
58
|
+
- **[upstream_reference]** Channel, bone, and morph ceilings → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
59
|
+
- **[upstream_reference]** Export verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
60
|
+
- **[progression]** Web delivery handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
61
|
+
- **[progression]** React Three Fiber component shape → `r3f-component-plan` (`references/skills/r3f-component-plan.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "react_three_fiber"]`
|
|
62
|
+
- **[progression]** Final user-facing wording → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
63
|
+
|
|
64
|
+
## Safety boundaries & non-goals
|
|
65
|
+
- **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).
|
|
66
|
+
- Run Blender or export GLB files.
|
|
67
|
+
- Author, retarget, or modify animations.
|
|
68
|
+
- Generate Python or `bpy` snippets.
|
|
69
|
+
- Promise web-side playback smoothness or upgrade truth states.
|
|
@@ -0,0 +1,68 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Prepare truthful GLB/web handoff output with explicit artifact status, assumptions, and caveats.
|
|
6
|
+
|
|
7
|
+
Define reliable handoff language and checks for GLB/web scenarios without overclaiming.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/glb-web-handoff/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/glb-web-handoff/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `evidence-and-handoff` / `web-glb-delivery-packager`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- when writing the GLB/web handoff summary after upstream validation from `scene-readiness` and evidence classification from `render-export-evidence`
|
|
18
|
+
- when summarizing per-artifact export statuses and web compatibility assumptions/caveats (transform/scale/origin, material/texture portability, loader/extensions, stack, performance)
|
|
19
|
+
- when preparing truthful next checks before passing final wording to `plain-language-response`
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "prepare web handoff"
|
|
23
|
+
- "is GLB ready"
|
|
24
|
+
- "summarize export status"
|
|
25
|
+
|
|
26
|
+
## When not to use
|
|
27
|
+
- to claim GLB or export success without concrete evidence → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; Delegates out-of-scope requests to scene-readiness)
|
|
28
|
+
- to replace runtime export verification → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; Delegates out-of-scope requests to render-export-evidence)
|
|
29
|
+
- to validate upstream scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
|
|
30
|
+
- to classify raw render/export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
|
|
31
|
+
- to define mobile or file-size performance budgets → delegate to `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`; use mobile-glb-budget)
|
|
32
|
+
- to define animation playback or rig contracts → delegate to `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`; use glb-animation-handoff)
|
|
33
|
+
- to write the final user-facing response wording → delegate to `plain-language-response` (`references/skills/plain-language-response.md`; use plain-language-response)
|
|
34
|
+
|
|
35
|
+
## Inputs & output/evidence contract
|
|
36
|
+
### Required inputs
|
|
37
|
+
- `verified_or_planned_glb_artifact` (`object`): GLB artifact evidence record (from render-export-evidence) or planned export specification
|
|
38
|
+
- `target_web_viewer_stack` (`string`): Target web runtime (Three.js, React Three Fiber, <model-viewer>, Babylon.js)
|
|
39
|
+
|
|
40
|
+
### Optional inputs
|
|
41
|
+
- `animation_and_budget_contracts` (`object`): Optional linked contracts from glb-animation-handoff and mobile-glb-budget
|
|
42
|
+
|
|
43
|
+
### Primary outputs
|
|
44
|
+
- `web_glb_delivery_handoff_packet`
|
|
45
|
+
- `scale_orientation_and_compression_manifest`
|
|
46
|
+
- `viewer_integration_caveats`
|
|
47
|
+
|
|
48
|
+
## Quick-start procedure
|
|
49
|
+
1. confirm this skill fits your goal
|
|
50
|
+
2. provide required inputs first
|
|
51
|
+
3. keep runtime claims evidence-bound
|
|
52
|
+
4. follow suggested next-skill handoff
|
|
53
|
+
|
|
54
|
+
## Handoff notes
|
|
55
|
+
- **[upstream_reference]** Upstream scene readiness validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
56
|
+
- **[upstream_reference]** Upstream artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
57
|
+
- **[upstream_reference]** Mobile and file-size budget constraints → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
58
|
+
- **[upstream_reference]** Animation playback and rig handoff contracts → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
|
|
59
|
+
- **[progression]** Final user-facing response wording → `plain-language-response` (`references/skills/plain-language-response.md`) — `when.all: [stage.current equals "final_communication"]`
|
|
60
|
+
|
|
61
|
+
## Safety boundaries & non-goals
|
|
62
|
+
- **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).
|
|
63
|
+
- Generating Python scripts or executing Blender exports
|
|
64
|
+
- Replacing runtime export verification
|
|
65
|
+
- Upgrading Runtime or Artifact truth states or accepting pre-existing files without current-run provenance
|
|
66
|
+
- Classifying raw render/export evidence (`render-export-evidence`) or validating upstream scene quality (`scene-readiness`)
|
|
67
|
+
- Defining size budgets (`mobile-glb-budget`), animation contracts (`glb-animation-handoff`), or final user-facing wording (`plain-language-response`)
|
|
68
|
+
- Making unsupported web stack or loader compatibility guarantees
|
|
@@ -0,0 +1,68 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/intent-to-3d-brief-writer/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/intent-to-3d-brief-writer/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `process-discipline` / `canonical-8-slot-brief-author`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- right after `blender-brainstorming` confirms user intent
|
|
18
|
+
- when the user provides a structured request that just needs format normalization
|
|
19
|
+
- before any planner skill (`product-hero-scene-planner`, `camera-composition`, `lighting-material-plan`)
|
|
20
|
+
- before `acceptance-criteria-builder` consumes brief rows to build criteria
|
|
21
|
+
- when multiple planners need to share the same source-of-truth brief
|
|
22
|
+
|
|
23
|
+
## Trigger cues
|
|
24
|
+
- "lock the brief"
|
|
25
|
+
- "write the brief from this conversation"
|
|
26
|
+
- "what's the formal scope?"
|
|
27
|
+
- "before planning, write the spec"
|
|
28
|
+
|
|
29
|
+
## When not to use
|
|
30
|
+
- intent is still ambiguous (run blender-brainstorming first) → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; run blender-brainstorming first)
|
|
31
|
+
- the user is mid-execution and asks for a re-brief → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; route to blender-troubleshooting instead)
|
|
32
|
+
- the user pushes for immediate execution → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; route to runtime-readiness)
|
|
33
|
+
- the request is iteration on existing output ("make it darker") — that's a planner-level edit, not a new brief → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
|
|
34
|
+
|
|
35
|
+
## Inputs & output/evidence contract
|
|
36
|
+
### Required inputs
|
|
37
|
+
- `raw_user_goal_and_context` (`string`): User request or brainstormed concept to lock into the canonical 8-slot 3D brief
|
|
38
|
+
- `target_deliverable_surface` (`string`): Intended output format (hero still, product grid, portrait, environment, interior, or web GLB)
|
|
39
|
+
|
|
40
|
+
### Optional inputs
|
|
41
|
+
- `selected_recipe_or_pack` (`string`): Recipe or pack selected via recipe-fit-assessor
|
|
42
|
+
|
|
43
|
+
### Primary outputs
|
|
44
|
+
- `canonical_8_slot_3d_brief`
|
|
45
|
+
- `explicit_assumptions_register`
|
|
46
|
+
- `scope_exclusions_and_next_skill`
|
|
47
|
+
|
|
48
|
+
## Quick-start procedure
|
|
49
|
+
1. read confirmed intent from prior step (`blender-brainstorming` or original request)
|
|
50
|
+
2. fill the 8 brief slots (mark unconfirmed items as `Unknown`, never invent)
|
|
51
|
+
3. echo the brief to the user for confirmation
|
|
52
|
+
4. hand off to downstream planners (e.g., `product-hero-scene-planner`) and `acceptance-criteria-builder` once confirmed
|
|
53
|
+
|
|
54
|
+
## Handoff notes
|
|
55
|
+
- **[upstream_reference]** Preceding step → `blender-brainstorming` (`references/skills/blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
56
|
+
- **[progression]** Consuming skills (acceptance-criteria-builder) → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
57
|
+
- **[progression]** Consuming skills (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
58
|
+
- **[progression]** Consuming skills (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
59
|
+
- **[alternative]** Consuming skills (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
60
|
+
- **[conditional]** If execution is requested → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
61
|
+
- **[fallback]** If mid-execution re-briefing occurs → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
62
|
+
|
|
63
|
+
## Safety boundaries & non-goals
|
|
64
|
+
- **Runtime boundary:** This skill does not install Blender, run Blender, configure MCP, or claim artifacts. Output is a structured text brief.
|
|
65
|
+
- making the plan (planner's job)
|
|
66
|
+
- running Blender
|
|
67
|
+
- setting up runtime
|
|
68
|
+
- writing the final user response (`plain-language-response`'s job)
|
|
@@ -0,0 +1,73 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Plan an interior architectural visualization scene (room layout, furniture, materials, natural + artificial lighting) before any modeling or render attempt.
|
|
6
|
+
|
|
7
|
+
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).
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/interior-scene/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/interior-scene/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `scene-planners` / `interior-archviz-scene-architect`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- intent is an interior room, space, or venue where furniture and surfaces dominate (including interior establishing shots)
|
|
18
|
+
- architectural visualization, catalog, brand showcase, hospitality, or residential room planning
|
|
19
|
+
- before any modeling, furniture sourcing, or rendering
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "interior of"
|
|
23
|
+
- "living room scene"
|
|
24
|
+
- "office showcase"
|
|
25
|
+
- "hotel lobby"
|
|
26
|
+
- "kitchen showroom"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- outdoor establishing → delegate to `environment-shot` (`references/skills/environment-shot.md`; use environment-shot)
|
|
30
|
+
- single hero product → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
31
|
+
- character portrait → delegate to `character-portrait` (`references/skills/character-portrait.md`; use character-portrait)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `locked_3d_brief` (`object`): Locked 3D brief specifying room type, architectural style, focal zone, and daylight/artificial mood
|
|
36
|
+
- `room_dimensions_and_openings` (`object`): Architectural envelope, window/door openings, and primary furniture anchor zones
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `sourced_furniture_and_finish_assets` (`array`): Available furniture and architectural material assets from asset-discovery
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `interior_zone_and_circulation_plan`
|
|
43
|
+
- `window_portal_and_fixture_lighting_plan`
|
|
44
|
+
- `two_point_vertical_camera_constraints`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. lock style early and pin room type + plausible room dimensions (never invent dimensions; record any defaults in the assumptions register)
|
|
48
|
+
2. pin architecture basics (walls, floor, ceiling, windows, doors)
|
|
49
|
+
3. pin furniture + props + material palette
|
|
50
|
+
4. pin lighting (natural + artificial mix) + mood + time of day
|
|
51
|
+
5. pin camera angle + lens
|
|
52
|
+
6. emit a structured plan with an assumptions register + handoff to `asset-discovery`, `mobile-glb-budget`, `asset-style-check`, and quality checkers
|
|
53
|
+
|
|
54
|
+
## Handoff notes
|
|
55
|
+
- **[upstream_reference]** Upstream brief → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
56
|
+
- **[upstream_reference]** Outdoor / wide establishing shot redirect → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
57
|
+
- **[upstream_reference]** Single hero product redirect → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
58
|
+
- **[upstream_reference]** Single character portrait redirect → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
59
|
+
- **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
60
|
+
- **[upstream_reference]** Performance / polycount budget → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
61
|
+
- **[upstream_reference]** Style consistency check → `asset-style-check` (`references/skills/asset-style-check.md`) — `when.all: [assets.licenseCleared equals true; stage.current equals "style_check"]`
|
|
62
|
+
- **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
63
|
+
- **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
64
|
+
- **[progression]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
65
|
+
- **[progression]** Scene quality validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
66
|
+
|
|
67
|
+
## Safety boundaries & non-goals
|
|
68
|
+
- **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`.
|
|
69
|
+
- Model the room or geometry.
|
|
70
|
+
- Source furniture or download assets (belongs to `asset-discovery`).
|
|
71
|
+
- Decide performance or polycount budgets (belongs to `mobile-glb-budget`).
|
|
72
|
+
- 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`).
|
|
73
|
+
- Render or run Blender.
|
|
@@ -0,0 +1,65 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Build detailed lighting and material direction with portability and caveat handling for Blender/web-3D outputs.
|
|
6
|
+
|
|
7
|
+
Create a high-quality, practical lighting/material plan that balances visual intent and web portability constraints.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/lighting-material-plan/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/lighting-material-plan/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `scene-planners` / `lighting-rig-and-lookdev-deep-planner`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- look-development strategy is needed
|
|
18
|
+
- lighting/material choices drive scene mood
|
|
19
|
+
- web/GLB portability caveats must be explicit
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "plan lighting and materials"
|
|
23
|
+
- "design cyberpunk lookdev"
|
|
24
|
+
- "define PBR and reflection strategy"
|
|
25
|
+
|
|
26
|
+
## When not to use
|
|
27
|
+
- to claim final rendered quality or executed results → delegate to `camera-composition` (`references/skills/camera-composition.md`; Delegates out-of-scope requests to camera-composition)
|
|
28
|
+
- to skip composition/camera context from camera-composition → delegate to `camera-composition` (`references/skills/camera-composition.md`; Delegates out-of-scope requests to camera-composition)
|
|
29
|
+
- to validate existing lighting or materials → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker and material-quality-checker)
|
|
30
|
+
- to decide render engines (cycles-vs-eevee-decision), color management (color-management-decision), or file formats (output-format-decision) → delegate to `color-management-decision` (`references/skills/color-management-decision.md`; output-format-decision)
|
|
31
|
+
- to execute Blender or generate Python scripts → delegate to `color-management-decision` (`references/skills/color-management-decision.md`; Delegates out-of-scope requests to color-management-decision)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `domain_scene_plan` (`object`): Upstream scene layout and subject surface description
|
|
36
|
+
- `camera_framing_plan` (`object`): Locked camera angles and hero silhouette requirements from camera-composition
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `target_render_engine_hint` (`string`): Preferred engine (Cycles, Eevee, or WebGL/GLB PBR export target)
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `key_fill_rim_lighting_plan`
|
|
43
|
+
- `pbr_material_and_roughness_spec`
|
|
44
|
+
- `hdri_and_reflection_strategy`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. confirm this skill fits your goal
|
|
48
|
+
2. provide required inputs first
|
|
49
|
+
3. keep runtime claims evidence-bound
|
|
50
|
+
4. follow suggested next-skill handoff
|
|
51
|
+
|
|
52
|
+
## Handoff notes
|
|
53
|
+
- **[upstream_reference]** Upstream input from (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
54
|
+
- **[progression]** Upstream input from (color-management-decision) → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
55
|
+
- **[progression]** Upstream input from (cycles-vs-eevee-decision) → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
|
|
56
|
+
- **[progression]** Upstream input from (output-format-decision) → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
57
|
+
- **[progression]** Next validation (lighting-quality-checker) → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
58
|
+
- **[progression]** Next validation (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
59
|
+
- **[progression]** Then scene check → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
60
|
+
- **[progression]** Then delivery → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
61
|
+
|
|
62
|
+
## Safety boundaries & non-goals
|
|
63
|
+
- **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.
|
|
64
|
+
- shader/runtime implementation code
|
|
65
|
+
- rendered quality claims without evidence
|
|
@@ -0,0 +1,70 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Validate lighting intensity ranges, shadow softness, color temperature, and HDRI use against the scene brief before render.
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/lighting-quality-checker/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/lighting-quality-checker/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `quality-validators` / `exposure-ratio-and-shadow-validator`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- before render
|
|
18
|
+
- after a lighting change request
|
|
19
|
+
- as a sub-check during full quality review
|
|
20
|
+
- when the rendered preview looks "off" but the issue is unclear
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "is the lighting okay"
|
|
24
|
+
- "check shadow softness"
|
|
25
|
+
- "lighting feels off"
|
|
26
|
+
- "is the HDRI balanced"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- upstream lookdev and lighting planning → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
|
|
30
|
+
- material validation → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; use material-quality-checker)
|
|
31
|
+
- composition / camera validation → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
|
|
32
|
+
- broad pass/warn/fail scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
|
|
33
|
+
- classifying render or export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
|
|
34
|
+
- to fix or edit lights (this skill validates and gives remediation hints only; it never edits) → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; this skill validates and gives remediation hints only; it never edits)
|
|
35
|
+
|
|
36
|
+
## Inputs & output/evidence contract
|
|
37
|
+
### Required inputs
|
|
38
|
+
- `lighting_rig_specification` (`object`): Key-to-fill ratios, light placements, HDRI rotation, and shadow softness from lighting-material-plan
|
|
39
|
+
- `color_management_pins` (`object`): Pinned view transform (AgX/Filmic/Standard) and exposure target from color-management-decision
|
|
40
|
+
|
|
41
|
+
### Optional inputs
|
|
42
|
+
- `render_or_preview_exposure_notes` (`string`): Optional highlight clipping or shadow crush observations from preview output
|
|
43
|
+
|
|
44
|
+
### Primary outputs
|
|
45
|
+
- `lighting_quality_verdict_table`
|
|
46
|
+
- `key_fill_rim_and_clipping_audit`
|
|
47
|
+
- `lighting_remediation_instructions`
|
|
48
|
+
|
|
49
|
+
## Quick-start procedure
|
|
50
|
+
1. enumerate every explicit light and HDRI in the scene plan or measured scene
|
|
51
|
+
2. check intensity ranges per light
|
|
52
|
+
3. check shadow softness consistency
|
|
53
|
+
4. check color temperature consistency
|
|
54
|
+
5. check HDRI presence + balance with explicit lights
|
|
55
|
+
6. check mood match against the brief
|
|
56
|
+
7. emit per-light verdicts (`Pass / Warn / Fail`) with remediation hints only + a top-line status
|
|
57
|
+
|
|
58
|
+
## Handoff notes
|
|
59
|
+
- **[progression]** Broad readiness review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
60
|
+
- **[upstream_reference]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
61
|
+
- **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
62
|
+
- **[retry]** Lighting re-plan → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
63
|
+
- **[progression]** Render evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
64
|
+
|
|
65
|
+
## Safety boundaries & non-goals
|
|
66
|
+
- **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.
|
|
67
|
+
- Edit lights.
|
|
68
|
+
- Generate light setup recipes.
|
|
69
|
+
- Replace `scene-readiness`.
|
|
70
|
+
- Run Blender.
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/material-quality-checker/SKILL.md and skills/material-quality-checker/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# material-quality-checker (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Validate PBR material sanity, texture budgets, and web/runtime compatibility per material before render or export.
|
|
6
|
+
|
|
7
|
+
Run a focused pass/warn/fail check on each material in the scene against PBR sanity, texture budgets, and consumer-stack compatibility — without expanding into lighting or composition concerns.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/material-quality-checker/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/material-quality-checker/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `quality-validators` / `pbr-and-shader-portability-validator`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- before render
|
|
18
|
+
- before GLB export
|
|
19
|
+
- after a material change request
|
|
20
|
+
- as a sub-check during full quality review
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "are the materials okay"
|
|
24
|
+
- "check PBR sanity"
|
|
25
|
+
- "texture budget for materials"
|
|
26
|
+
- "will the materials work in Three.js"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- upstream lookdev and material planning → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
|
|
30
|
+
- lighting validation → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker)
|
|
31
|
+
- composition / camera validation → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
|
|
32
|
+
- broad pass/warn/fail scene readiness → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
|
|
33
|
+
- web integration and viewer handoff → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; use glb-web-handoff)
|
|
34
|
+
- to fix or edit materials (this skill validates and emits remediation hints only; it never edits) → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; this skill validates and emits remediation hints only; it never edits)
|
|
35
|
+
|
|
36
|
+
## Inputs & output/evidence contract
|
|
37
|
+
### Required inputs
|
|
38
|
+
- `material_and_shader_inventory` (`array`): Principled BSDF parameter ranges, texture maps, UV channels, and normal map conventions
|
|
39
|
+
- `target_consumption_surface` (`string`): Whether materials target offline Cycles/Eevee rendering or glTF 2.0 PBR web export
|
|
40
|
+
|
|
41
|
+
### Optional inputs
|
|
42
|
+
- `texture_memory_budget` (`object`): Maximum texture resolution and VRAM budget from mobile-glb-budget
|
|
43
|
+
|
|
44
|
+
### Primary outputs
|
|
45
|
+
- `pbr_material_verdict_table`
|
|
46
|
+
- `gltf_shader_portability_risks`
|
|
47
|
+
- `material_remediation_steps`
|
|
48
|
+
|
|
49
|
+
## Quick-start procedure
|
|
50
|
+
1. enumerate every material referenced in the scene plan or measured scene
|
|
51
|
+
2. check PBR sanity (albedo range, normal map sign, roughness/metallic plausibility)
|
|
52
|
+
3. check texture budget (resolution, count, format)
|
|
53
|
+
4. check consumer-stack compatibility (KHR extensions, unsupported features for chosen target)
|
|
54
|
+
5. emit per-material verdicts + a top-line status
|
|
55
|
+
|
|
56
|
+
## Handoff notes
|
|
57
|
+
- **[retry]** Upstream lookdev & material planning → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
58
|
+
- **[upstream_reference]** Mobile/web texture budget definition → `mobile-glb-budget` (`references/skills/mobile-glb-budget.md`) — `when.all: [artifact.type equals "glb"; budget.pinned equals false]`
|
|
59
|
+
- **[progression]** Broad readiness review → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
60
|
+
- **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
61
|
+
- **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
62
|
+
- **[progression]** Polycount budget → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
63
|
+
- **[progression]** Render / GLB export evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
64
|
+
- **[progression]** Web handoff → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
65
|
+
|
|
66
|
+
## Safety boundaries & non-goals
|
|
67
|
+
- **Runtime boundary:** This skill validates plans or measured scene snapshots. It never modifies materials, runs Blender, or exports a GLB. If actual material values are needed, rely on a measured scene description (plan output, runtime tool snapshot) — never invent values.
|
|
68
|
+
- Edit materials.
|
|
69
|
+
- Generate shader code.
|
|
70
|
+
- Replace `scene-readiness` (this skill is one of its inputs).
|
|
71
|
+
- Run Blender.
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/mobile-glb-budget/SKILL.md and skills/mobile-glb-budget/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# mobile-glb-budget (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Set explicit triangle / texture / draw-call / file-size / animation budgets for GLB targeted at mobile-web before any export decision.
|
|
6
|
+
|
|
7
|
+
Translate "make it work on mobile" intent into a concrete numeric planning ceiling table (triangles, vertices, GLB file size, texture pixels, materials, draw calls, animation channels, bones, morph targets) per device tier, scene scope, and target context. Pin this budget before scene mutation so downstream scene planners consume it, `polycount-budget-checker` and `material-quality-checker` validate counts and textures against it, `render-export-evidence` measures compliance, `glb-web-handoff` consumes it for web delivery, and `glb-animation-handoff` owns animation contracts.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/mobile-glb-budget/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/mobile-glb-budget/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `evidence-and-handoff` / `mobile-webgl-budget-validator`
|
|
13
|
+
- **Capability tier:** `L0`
|
|
14
|
+
- **Truth-state policy:** Runtime status defaults to `Not Run`; Artifact status defaults to `Not Produced`; mutation rule is `downgrade_only` (never upgrade without verified evidence).
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
- before scene plan is locked
|
|
18
|
+
- before any GLB export attempt
|
|
19
|
+
- when user says "for mobile" / "for the web" / "phone" / "low-end devices"
|
|
20
|
+
- when designing a scene that must run alongside other web content
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "what's a good polycount for mobile"
|
|
24
|
+
- "how big can the GLB be"
|
|
25
|
+
- "will this load on iPhone"
|
|
26
|
+
- "what should I aim for on a phone"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- desktop-only renders without web handoff → delegate to `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`; Delegates out-of-scope requests to polycount-budget-checker)
|
|
30
|
+
- offline pre-rendered video (no real-time budget needed) → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; no real-time budget needed)
|
|
31
|
+
- replacing engineering load testing (this skill sets a planning budget, not a real-world benchmark) → delegate to `glb-web-handoff` (`references/skills/glb-web-handoff.md`; this skill sets a planning budget, not a real-world benchmark)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `target_device_tier_and_network` (`string`): Target mobile/web hardware tier (iOS Safari, mid-range Android, desktop WebGL) and load budget
|
|
36
|
+
- `scene_deliverable_type` (`string`): Whether the GLB is a single hero product, multi-item configurator, or animated character
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `compression_pipeline_support` (`object`): Whether the host app supports Draco, Meshopt, or KTX2 BasisU transcoding
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `pinned_glb_performance_budget_table`
|
|
43
|
+
- `triangle_drawcall_and_texture_ceilings`
|
|
44
|
+
- `compression_and_lod_requirements`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. pick the device tier (low-end Android, mid-mobile, high-mobile, desktop-fallback)
|
|
48
|
+
2. read the budget row for that tier
|
|
49
|
+
3. pin the budget into the scene plan before mutation
|
|
50
|
+
4. treat any later violation as a blocker, not a warning
|
|
51
|
+
|
|
52
|
+
## Handoff notes
|
|
53
|
+
- **[progression]** Scene planning (consumes pinned budget) (camera-composition) → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
54
|
+
- **[progression]** Scene planning (consumes pinned budget) (lighting-material-plan) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
55
|
+
- **[alternative]** Scene planning (consumes pinned budget) (character-portrait) → `character-portrait` (`references/skills/character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
56
|
+
- **[alternative]** Scene planning (consumes pinned budget) (environment-shot) → `environment-shot` (`references/skills/environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
57
|
+
- **[alternative]** Scene planning (consumes pinned budget) (interior-scene) → `interior-scene` (`references/skills/interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
58
|
+
- **[alternative]** Scene planning (consumes pinned budget) (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skills/product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
59
|
+
- **[alternative]** Scene planning (consumes pinned budget) (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
60
|
+
- **[progression]** Count and texture budget validation (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
61
|
+
- **[progression]** Count and texture budget validation (material-quality-checker) → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
62
|
+
- **[progression]** Count and texture budget validation (polycount-budget-checker) → `polycount-budget-checker` (`references/skills/polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
63
|
+
- **[progression]** Measured export compliance → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
64
|
+
- **[progression]** Web delivery handoff (consumes pinned budget) → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
65
|
+
- **[progression]** Animation contracts (owns animation contract details within pinned channel/bone/morph ceilings) → `glb-animation-handoff` (`references/skills/glb-animation-handoff.md`) — `when.all: [artifact.hasAnimation equals true; stage.current equals "animation_handoff"]`
|
|
66
|
+
|
|
67
|
+
## Safety boundaries & non-goals
|
|
68
|
+
- **Runtime boundary:** BlendOps runtime guidance uses **2 MCP execution paths plus a CLI fallback appendix** (see `docs/runtime-stack-strategy.md`):
|
|
69
|
+
- Run a real-world benchmark.
|
|
70
|
+
- Install Blender.
|
|
71
|
+
- Run Blender.
|
|
72
|
+
- Choose a render engine.
|
|
73
|
+
- Write web-side optimization code.
|