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,68 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/bridge-conflicts/SKILL.md and skills/bridge-conflicts/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# bridge-conflicts (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Diagnose MCP bridge conflicts (Path 1 Official Blender Lab MCP 5.1+ vs Path 2 mcp-for-blender, port 9876 collisions, host mismatch) and hand off to runtime-readiness.
|
|
6
|
+
|
|
7
|
+
Resolve the single-bridge constraint when more than one MCP runtime path is configured against the same Blender instance (or when ports collide). Blender accepts only one MCP bridge session per instance (default port 9876) — so running Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) concurrently, connecting two MCP clients to one Blender instance, colliding on port 9876, or enabling both Path 1 host (a) and host (b) on one session causes inconsistent signals.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/bridge-conflicts/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/bridge-conflicts/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `runtime-and-execution` / `port-and-addon-conflict-resolver`
|
|
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
|
+
- `runtime-readiness` reports inconsistent signals (e.g. host reports connected but tool calls return the wrong tool surface)
|
|
18
|
+
- both Path 1 (Official Blender Lab MCP 5.1+) and Path 2 (community `mcp-for-blender`, renamed from `ahujasid/blender-mcp`) add-ons are enabled in the same Blender instance
|
|
19
|
+
- two MCP clients are pointing at the same Blender instance (e.g. Claude Desktop with Connector + Cursor with manual MCP)
|
|
20
|
+
- Path 1 host (a) and host (b) are both active on a single session
|
|
21
|
+
- log or port output shows a collision on default port `9876`
|
|
22
|
+
|
|
23
|
+
## Trigger cues
|
|
24
|
+
- "tool surface looks wrong"
|
|
25
|
+
- "smoke test passed yesterday but recipe fails today"
|
|
26
|
+
- "Lab MCP and ahujasid both installed"
|
|
27
|
+
- "Claude Desktop and Cursor both pointing at Blender"
|
|
28
|
+
- "port 9876 already in use"
|
|
29
|
+
- "single-bridge constraint violation"
|
|
30
|
+
|
|
31
|
+
## When not to use
|
|
32
|
+
- no readiness signal yet (run runtime-readiness first) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; run runtime-readiness first)
|
|
33
|
+
- no runtime path has been chosen yet → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; route to runtime-path-picker)
|
|
34
|
+
- the user wants to switch or set up a path from scratch → delegate to `runtime-setup` (`references/skills/runtime-setup.md`; route to runtime-setup)
|
|
35
|
+
- the bridge matrix is clean and only one path is active, but smoke tests still fail → delegate to `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`; route to blender-troubleshooting)
|
|
36
|
+
- the user explicitly wants both paths configured for separate Blender instances on different ports (requires explicit port isolation) → delegate to `runtime-readiness` (`references/skills/runtime-readiness.md`; requires explicit port isolation)
|
|
37
|
+
|
|
38
|
+
## Inputs & output/evidence contract
|
|
39
|
+
### Required inputs
|
|
40
|
+
- `target_blender_instance` (`string`): Running Blender session identifier or binary path experiencing bridge or port collisions
|
|
41
|
+
- `configured_mcp_hosts_and_addons` (`object`): Inventory of enabled Blender add-ons (Lab MCP vs mcp-for-blender) and active MCP client connections
|
|
42
|
+
|
|
43
|
+
### Optional inputs
|
|
44
|
+
- `port_9876_diagnostics` (`string`): Optional socket/port binding diagnostics around default port 9876
|
|
45
|
+
|
|
46
|
+
### Primary outputs
|
|
47
|
+
- `bridge_conflict_diagnosis_matrix`
|
|
48
|
+
- `single_bridge_isolation_steps`
|
|
49
|
+
- `post_resolution_readiness_recheck_route`
|
|
50
|
+
|
|
51
|
+
## Quick-start procedure
|
|
52
|
+
1. list every active / configured bridge for the target Blender session
|
|
53
|
+
2. check for port collision (commonly `localhost:9876`)
|
|
54
|
+
3. identify which path is intended; which is residual
|
|
55
|
+
4. propose the cheapest disable / port-isolation step
|
|
56
|
+
5. hand off to `runtime-readiness` to re-verify
|
|
57
|
+
|
|
58
|
+
## Handoff notes
|
|
59
|
+
- **[upstream_reference]** When runtime-readiness reports inconsistent signals → `runtime-readiness` (`references/skills/runtime-readiness.md`) — `when.all: [runtime.path not_equals "unselected"; runtime.verifiedReady equals false]`
|
|
60
|
+
- **[fallback]** If the bridge matrix is clean but failures persist → `blender-troubleshooting` (`references/skills/blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
61
|
+
- **[upstream_reference]** If the user wants to change paths or set up a path → `runtime-setup` (`references/skills/runtime-setup.md`) — `when.all: [runtime.path not_equals "unselected"; stage.current equals "runtime_setup"]`
|
|
62
|
+
- **[upstream_reference]** If the intended runtime path has not been chosen yet → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
63
|
+
|
|
64
|
+
## Safety boundaries & non-goals
|
|
65
|
+
- **Runtime boundary:** This skill never disables add-ons, edits MCP client configs, changes ports, kills processes, or runs Blender. It only diagnoses the conflict, proposes the cheapest resolution for the operator to perform, and hands off to `runtime-readiness`.
|
|
66
|
+
- Disabling add-ons, editing MCP client configs, changing ports, killing processes, or running Blender
|
|
67
|
+
- Upgrading Runtime or Artifact truth states
|
|
68
|
+
- Replacing `runtime-readiness`, `runtime-path-picker`, `runtime-setup`, or `blender-troubleshooting`
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/camera-composition/SKILL.md and skills/camera-composition/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# camera-composition (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Provide detailed composition and camera planning for product hero outputs.
|
|
6
|
+
|
|
7
|
+
Design high-quality composition/camera strategy for product hero scenes in plain, actionable language.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/camera-composition/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/camera-composition/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `scene-planners` / `camera-rig-and-composition-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
|
+
- expanding an upstream scene brief from `product-hero-scene-planner` into detailed framing and camera direction
|
|
18
|
+
- defining focal hierarchy, viewer attention path, camera angle, focal length mood, and depth layering before lookdev
|
|
19
|
+
- aligning hero framing and negative space with web/UI copy overlays
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "improve composition and camera"
|
|
23
|
+
- "choose hero framing"
|
|
24
|
+
- "set camera strategy for product hero"
|
|
25
|
+
|
|
26
|
+
## When not to use
|
|
27
|
+
- as proof of rendered output quality or to validate an existing framing → delegate to `composition-quality-checker` (`references/skills/composition-quality-checker.md`; use composition-quality-checker)
|
|
28
|
+
- to design lighting rigs or surface materials/lookdev → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; use lighting-material-plan)
|
|
29
|
+
- to lock final pixel resolution or output aspect specs → delegate to `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`; use resolution-aspect-decision)
|
|
30
|
+
- to choose delivery file formats → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; use output-format-decision)
|
|
31
|
+
- when subject intent is undefined → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; Delegates out-of-scope requests to product-hero-scene-planner)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `domain_scene_plan` (`object`): Upstream scene layout plan defining subject scale, staging, and depth layers
|
|
36
|
+
- `framing_goal` (`string`): Target shot type (hero three-quarter, orthographic catalog grid, portrait, wide establishing)
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `pinned_aspect_ratio` (`string`): Aspect ratio lock from resolution-aspect-decision
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `camera_rig_specification`
|
|
43
|
+
- `focal_length_and_dof_plan`
|
|
44
|
+
- `composition_anchor_guidelines`
|
|
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 → `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
54
|
+
- **[conditional]** Lateral output specs (if needed) (output-format-decision) → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
55
|
+
- **[conditional]** Lateral output specs (if needed) (resolution-aspect-decision) → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
|
|
56
|
+
- **[progression]** Next (lookdev & lighting) → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
57
|
+
- **[progression]** Then (validation) (scene-readiness) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
58
|
+
- **[progression]** Then (validation) (composition-quality-checker) → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
59
|
+
|
|
60
|
+
## Safety boundaries & non-goals
|
|
61
|
+
- **Runtime boundary:** Planning-only skill: no Blender execution, no Python scripts, and no artifact generation. Runtime status stays `Not Run` and artifacts stay `Not Produced` (truth states are downgrade-only, never upgraded without verified evidence).
|
|
62
|
+
- executing Blender commands, writing Python scripts, or generating scene/render artifacts
|
|
63
|
+
- designing lighting setups or materials (owned by `lighting-material-plan`)
|
|
64
|
+
- validating or scoring completed scene framing (owned by `composition-quality-checker`)
|
|
65
|
+
- locking output resolution/aspect standards (owned by `resolution-aspect-decision`) or file formats (owned by `output-format-decision`)
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/character-portrait/SKILL.md and skills/character-portrait/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# character-portrait (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
|
|
6
|
+
|
|
7
|
+
Translate a single-subject character-portrait intent (subject identity, pose, expression, wardrobe, framing, lighting, background) into a structured scene plan with an explicit assumptions register. Distinct from `product-hero-scene-planner` (manufactured products), `environment-shot` (places), and `interior-scene` (rooms). Multi-character ensembles are out of scope. Hands off framing deep-dives to `camera-composition`, lookdev deep-dives to `lighting-material-plan`, assets to `asset-discovery`, and validation to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/character-portrait/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/character-portrait/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `scene-planners` / `character-portrait-and-turntable-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 explicitly a character / person / creature portrait
|
|
18
|
+
- before any modeling or scene file is built
|
|
19
|
+
- when the consumer is editorial / brand / catalog / cinematic
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "portrait of"
|
|
23
|
+
- "character looking at the camera"
|
|
24
|
+
- "headshot"
|
|
25
|
+
- "hero shot of [person / mascot / creature]"
|
|
26
|
+
|
|
27
|
+
## When not to use
|
|
28
|
+
- product hero scenes → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
29
|
+
- environment establishing shots → delegate to `environment-shot` (`references/skills/environment-shot.md`; use environment-shot)
|
|
30
|
+
- interior arch viz → delegate to `interior-scene` (`references/skills/interior-scene.md`; use interior-scene)
|
|
31
|
+
- multi-character ensemble (this skill is single-subject) → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; this skill is single-subject)
|
|
32
|
+
|
|
33
|
+
## Inputs & output/evidence contract
|
|
34
|
+
### Required inputs
|
|
35
|
+
- `locked_3d_brief` (`object`): Locked 3D brief specifying character subject, expression/pose, and framing intent
|
|
36
|
+
- `character_asset_posture` (`object`): Available character model/rig status and material readiness from asset discovery
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `turntable_or_still_preference` (`string`): Whether the deliverable is a portrait still, bust turntable, or full-body pose
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `character_staging_and_pose_plan`
|
|
43
|
+
- `eyeline_and_portrait_camera_anchors`
|
|
44
|
+
- `skin_hair_rim_lighting_hooks`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
|
|
48
|
+
2. confirm likeness rights before use if the subject is a real person
|
|
49
|
+
3. pin subject identity, pose, expression, wardrobe, framing, lighting, and background
|
|
50
|
+
4. record an explicit assumptions register
|
|
51
|
+
5. flag needed assets for `asset-discovery`
|
|
52
|
+
6. emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
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
|
+
- **[progression]** Framing deep-dive → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
57
|
+
- **[progression]** Lookdev deep-dive → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
58
|
+
- **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
59
|
+
- **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
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]** Scene quality validation → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
62
|
+
|
|
63
|
+
## Safety boundaries & non-goals
|
|
64
|
+
- **Runtime boundary:** Planning-only skill: no modeling, no animation, no render, and no Blender execution. `Runtime status` stays `Not Run` and `Artifact status` stays `Not Produced` (downgrade-only, never upgrade). If the brief is unclear, hand off to `intent-to-3d-brief-writer`.
|
|
65
|
+
- Model the character.
|
|
66
|
+
- Animate the character.
|
|
67
|
+
- Render.
|
|
68
|
+
- Run Blender.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/cli-appendix-job-outline/SKILL.md and skills/cli-appendix-job-outline/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# cli-appendix-job-outline (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Plan headless blender --background export or render jobs when MCP chat control is a poor fit; cite upstream Blender CLI docs only.
|
|
6
|
+
|
|
7
|
+
Structure **CLI fallback appendix** jobs (batch render, batch export, scripted scene setup) using Blender's documented command-line interface — without presenting arbitrary Python as the user-facing product surface.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/cli-appendix-job-outline/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/cli-appendix-job-outline/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `runtime-and-execution` / `headless-cli-batch-job-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
|
+
- CI / render farm / repeatable exports
|
|
18
|
+
- MCP unavailable or disallowed by policy
|
|
19
|
+
- deterministic batch operations vs exploratory modeling
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "headless blender"
|
|
23
|
+
- "batch render CLI"
|
|
24
|
+
- "blender --background"
|
|
25
|
+
- "render farm outline"
|
|
26
|
+
|
|
27
|
+
## When not to use
|
|
28
|
+
- interactive viewport iteration primary goal → delegate to `runtime-path-picker` (`references/skills/runtime-path-picker.md`; Delegates out-of-scope requests to runtime-path-picker)
|
|
29
|
+
- user expects Connector chat loop → delegate to `path-one-host-outline` (`references/skills/path-one-host-outline.md`; Delegates out-of-scope requests to path-one-host-outline)
|
|
30
|
+
|
|
31
|
+
## Inputs & output/evidence contract
|
|
32
|
+
### Required inputs
|
|
33
|
+
- `target_blend_scene_and_outputs` (`object`): Source .blend file expectations and target render/export output deliverables
|
|
34
|
+
- `execution_environment_constraints` (`string`): Headless CI, render node, or local batch constraints selected via runtime-path-picker
|
|
35
|
+
|
|
36
|
+
### Optional inputs
|
|
37
|
+
- `frame_range_or_batch_items` (`array`): Optional frame range or batch variant list for headless execution
|
|
38
|
+
|
|
39
|
+
### Primary outputs
|
|
40
|
+
- `headless_cli_job_outline`
|
|
41
|
+
- `appendix_governance_and_backup_gates`
|
|
42
|
+
- `expected_output_evidence_hooks`
|
|
43
|
+
|
|
44
|
+
## Quick-start procedure
|
|
45
|
+
1. classify job type via `skills/cli-appendix-job-outline/references/job-type-matrix.md`
|
|
46
|
+
2. capture ordering cautions `skills/cli-appendix-job-outline/references/flag-order-reminders.md`
|
|
47
|
+
3. state limitations `skills/cli-appendix-job-outline/references/stateless-limitations.md`
|
|
48
|
+
4. point user to upstream CLI manual for exact flags
|
|
49
|
+
|
|
50
|
+
## Handoff notes
|
|
51
|
+
- **[upstream_reference]** Pick MCP vs CLI → `runtime-path-picker` (`references/skills/runtime-path-picker.md`) — `when.all: [runtime.path equals "unselected"]`
|
|
52
|
+
- **[upstream_reference]** Interactive MCP host outline → `path-one-host-outline` (`references/skills/path-one-host-outline.md`) — `when.all: [runtime.path equals "path_1"; stage.current equals "runtime_setup"]`
|
|
53
|
+
- **[progression]** Export format choices → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
54
|
+
- **[progression]** Actual CLI output evidence recording → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
55
|
+
- **[progression]** Runtime attempt reporting → `runtime-attempt-report` (`references/skills/runtime-attempt-report.md`) — `when.all: [runtime.status in ["Attempted","Produced","Verified","Failed"]; request.topic equals "attempt_report"]`
|
|
56
|
+
|
|
57
|
+
## Safety boundaries & non-goals
|
|
58
|
+
- **Runtime boundary:** Planning outline only — BlendOps never executes Blender and never presents arbitrary Python as the product surface. This CLI workflow is an **appendix only**, never a peer path without an eval record, and BlendOps has **no in-repo CLI evidence file yet**. Point users to the upstream Blender manual for exact CLI flags.
|
|
59
|
+
- Generating or debugging user-facing Python (`bpy`) scripts.
|
|
60
|
+
- Executing `blender --background` jobs or inspecting output files directly.
|
|
61
|
+
- Selecting between MCP Path 1, Path 2, and CLI (owned by `runtime-path-picker`).
|
|
62
|
+
- Certifying rendered frames or exported GLBs (owned by `render-export-evidence`).
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/color-management-decision/SKILL.md and skills/color-management-decision/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# color-management-decision (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Pin Display Device, View Transform, Look, and Sequencer per consumer pipeline (web sRGB, VFX ACES linear, game engine, print, GLB-Three.js) before render.
|
|
6
|
+
|
|
7
|
+
Avoid the most common Blender color mistake: rendering with the wrong color space and then "fixing" it in post. Pick the color management strategy upfront based on the consumer's color pipeline.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/color-management-decision/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/color-management-decision/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `render-and-output-decisions` / `view-transform-and-colorspace-selector`
|
|
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 / lookdev pass
|
|
18
|
+
- when consumer color pipeline is known
|
|
19
|
+
- when a previous render had unexpected color shifts
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "what color space"
|
|
23
|
+
- "Filmic vs Standard"
|
|
24
|
+
- "ACEScg for our pipeline"
|
|
25
|
+
- "colors look weird"
|
|
26
|
+
|
|
27
|
+
## When not to use
|
|
28
|
+
- Post-render color grading or soft-proofing (handled by compositor / DCC after render). → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
29
|
+
- Validating per-material texture color spaces such as sRGB vs Non-Color/Linear (material-quality-checker). → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
|
|
30
|
+
- Selecting file formats or bit depths (output-format-decision). → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; Delegates out-of-scope requests to output-format-decision)
|
|
31
|
+
- Choosing the render engine (cycles-vs-eevee-decision). → delegate to `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
32
|
+
- Monitor hardware calibration (out of scope). → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; Delegates out-of-scope requests to material-quality-checker)
|
|
33
|
+
- Raw modeling without lookdev (color management does not affect geometry accuracy). → delegate to `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`; Delegates out-of-scope requests to cycles-vs-eevee-decision)
|
|
34
|
+
|
|
35
|
+
## Inputs & output/evidence contract
|
|
36
|
+
### Required inputs
|
|
37
|
+
- `target_delivery_pipeline` (`string`): Target display or compositing pipeline (web sRGB, product brand match, ACEScg VFX, HDR)
|
|
38
|
+
- `blender_version_posture` (`string`): Target Blender version family (3.6 LTS Filmic, 4.0+ AgX, 5.1+ AgX/ACES)
|
|
39
|
+
|
|
40
|
+
### Optional inputs
|
|
41
|
+
- `brand_hex_swatch_constraints` (`array`): Optional strict brand hex colors requiring Standard vs tone-mapped tradeoffs
|
|
42
|
+
|
|
43
|
+
### Primary outputs
|
|
44
|
+
- `pinned_view_transform_and_look`
|
|
45
|
+
- `display_and_working_colorspace_spec`
|
|
46
|
+
- `cross_engine_and_web_color_caveats`
|
|
47
|
+
|
|
48
|
+
## Quick-start procedure
|
|
49
|
+
1. Identify the consumer pipeline (`web sRGB` / `film/VFX ACES linear` / `game engine` / `print` / `GLB-Three.js`).
|
|
50
|
+
2. Pin the 4-line render color config: `Display Device`, `View Transform`, `Look`, and `Sequencer`.
|
|
51
|
+
3. Define per-output color transforms if multiple outputs exist.
|
|
52
|
+
4. Emit the 4-line config record, caveats, truth states (`Not Run` / `Not Produced`), and handoff.
|
|
53
|
+
|
|
54
|
+
## Handoff notes
|
|
55
|
+
- **[progression]** Output format selection → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
56
|
+
- **[progression]** Material texture color spaces → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
57
|
+
- **[progression]** Render engine choice → `cycles-vs-eevee-decision` (`references/skills/cycles-vs-eevee-decision.md`) — `when.all: [decision.engineLocked equals false]`
|
|
58
|
+
- **[progression]** GLB Three.js delivery → `glb-web-handoff` (`references/skills/glb-web-handoff.md`) — `when.all: [artifact.type equals "glb"; handoff.consumerStack equals "web_glb"]`
|
|
59
|
+
- **[progression]** Render evidence verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
60
|
+
|
|
61
|
+
## Safety boundaries & non-goals
|
|
62
|
+
- **Runtime boundary:** Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
63
|
+
- Validate per-material texture color spaces (`material-quality-checker`).
|
|
64
|
+
- Choose output file formats or bit depths (`output-format-decision`).
|
|
65
|
+
- Choose the render engine (`cycles-vs-eevee-decision`).
|
|
66
|
+
- Perform post-render color grading (belongs to compositor / DCC).
|
|
67
|
+
- Calibrate a physical monitor (out of scope).
|
|
68
|
+
- Run Blender or execute renders.
|
|
@@ -0,0 +1,71 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Validate camera framing, subject placement, headroom/lead-room, and visual hierarchy against the scene brief before render.
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/composition-quality-checker/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/composition-quality-checker/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `quality-validators` / `framing-and-silhouette-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 camera change request
|
|
19
|
+
- as a sub-check during full quality review
|
|
20
|
+
- when a render "feels off" but lighting and materials check out
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "is the framing okay"
|
|
24
|
+
- "check composition"
|
|
25
|
+
- "subject feels off-center"
|
|
26
|
+
- "too much negative space"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- planning or editing camera framing → delegate to `camera-composition` (`references/skills/camera-composition.md`; use camera-composition)
|
|
30
|
+
- locking aspect ratio or resolution → delegate to `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`; use resolution-aspect-decision)
|
|
31
|
+
- material validation → delegate to `material-quality-checker` (`references/skills/material-quality-checker.md`; use material-quality-checker)
|
|
32
|
+
- lighting validation → delegate to `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`; use lighting-quality-checker)
|
|
33
|
+
- broad scene Pass/Warn/Fail readiness review → delegate to `scene-readiness` (`references/skills/scene-readiness.md`; use scene-readiness)
|
|
34
|
+
- classifying render or export artifact evidence → delegate to `render-export-evidence` (`references/skills/render-export-evidence.md`; use render-export-evidence)
|
|
35
|
+
|
|
36
|
+
## Inputs & output/evidence contract
|
|
37
|
+
### Required inputs
|
|
38
|
+
- `camera_and_framing_spec` (`object`): Camera focal length, sensor, angle, and subject placement from camera-composition
|
|
39
|
+
- `pinned_aspect_ratio_and_subject` (`object`): Locked aspect ratio and primary/secondary focal hierarchy from brief
|
|
40
|
+
|
|
41
|
+
### Optional inputs
|
|
42
|
+
- `viewport_or_render_preview_notes` (`string`): Optional framing observations from a viewport or preview capture
|
|
43
|
+
|
|
44
|
+
### Primary outputs
|
|
45
|
+
- `composition_verdict_table`
|
|
46
|
+
- `silhouette_and_headroom_assessment`
|
|
47
|
+
- `camera_replan_remediation_hints`
|
|
48
|
+
|
|
49
|
+
## Quick-start procedure
|
|
50
|
+
1. read camera lens / FOV, position, and target description
|
|
51
|
+
2. read framing intent and locked aspect ratio from the brief
|
|
52
|
+
3. check rule of thirds, subject placement, and headroom/lead-room
|
|
53
|
+
4. check negative space, visual hierarchy, depth cues, and lens/FOV plausibility
|
|
54
|
+
5. emit per-row Pass/Warn/Fail verdicts, top-line status, and remediation hints (keep truth states separate and downgrade-only)
|
|
55
|
+
|
|
56
|
+
## Handoff notes
|
|
57
|
+
- **[progression]** Broad scene readiness review (consumes these rows) → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
58
|
+
- **[retry]** Camera & framing re-plan → `camera-composition` (`references/skills/camera-composition.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
59
|
+
- **[retry]** Aspect ratio & resolution locks → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "Fail"]`; retryPolicy: `maxAttempts=2`, `exitCondition.all: [quality.verdict in ["Pass","Warn"]]`
|
|
60
|
+
- **[progression]** Artifact evidence classification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
61
|
+
- **[upstream_reference]** Material validation → `material-quality-checker` (`references/skills/material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
62
|
+
- **[upstream_reference]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
63
|
+
|
|
64
|
+
## Safety boundaries & non-goals
|
|
65
|
+
- **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.
|
|
66
|
+
- Move or edit the camera (owned by `camera-composition`).
|
|
67
|
+
- Lock aspect ratio or resolution (owned by `resolution-aspect-decision`).
|
|
68
|
+
- Validate materials (`material-quality-checker`) or lighting (`lighting-quality-checker`).
|
|
69
|
+
- Replace broad scene review (`scene-readiness`).
|
|
70
|
+
- Classify render or export artifact evidence (`render-export-evidence`).
|
|
71
|
+
- Run Blender or execute Python.
|
|
@@ -0,0 +1,65 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
Pick the render engine upfront based on quality + time tradeoff and feature requirements. Avoid the "use Cycles always" / "Eevee is faster" oversimplifications.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/cycles-vs-eevee-decision/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/cycles-vs-eevee-decision/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `render-and-output-decisions` / `render-engine-tradeoff-selector`
|
|
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
|
+
- when feature support drives engine choice
|
|
19
|
+
- when time vs quality tradeoff matters
|
|
20
|
+
- when previous render was wrong engine
|
|
21
|
+
|
|
22
|
+
## Trigger cues
|
|
23
|
+
- "Cycles or Eevee"
|
|
24
|
+
- "what render engine"
|
|
25
|
+
- "is Eevee enough"
|
|
26
|
+
- "render is too slow"
|
|
27
|
+
|
|
28
|
+
## When not to use
|
|
29
|
+
- for a known repeat render (engine already chosen) → delegate to `lighting-material-plan` (`references/skills/lighting-material-plan.md`; engine already chosen)
|
|
30
|
+
- for non-render work (modeling / animation prep) → delegate to `output-format-decision` (`references/skills/output-format-decision.md`; modeling / animation prep)
|
|
31
|
+
|
|
32
|
+
## Inputs & output/evidence contract
|
|
33
|
+
### Required inputs
|
|
34
|
+
- `deliverable_use_case` (`string`): Whether the output is a final hero still, lookdev preview, animation turntable, or baked GLB source
|
|
35
|
+
- `optical_feature_requirements` (`array`): Required optical features (refraction, caustics, Volumetrics, SSS, soft area shadows)
|
|
36
|
+
- `render_time_and_hardware_budget` (`string`): Per-frame render time ceiling and available GPU/CPU compute posture
|
|
37
|
+
|
|
38
|
+
### Optional inputs
|
|
39
|
+
- `blender_version_token` (`string`): Target Blender version governing BLENDER_EEVEE vs BLENDER_EEVEE_NEXT naming
|
|
40
|
+
|
|
41
|
+
### Primary outputs
|
|
42
|
+
- `selected_render_engine_record`
|
|
43
|
+
- `sample_and_denoiser_targets`
|
|
44
|
+
- `engine_tradeoff_and_fallback_caveats`
|
|
45
|
+
|
|
46
|
+
## Quick-start procedure
|
|
47
|
+
1. Name the use case (hero / preview / animation / lookdev / flat clay).
|
|
48
|
+
2. Evaluate required rendering features (caustics / subsurface scattering / volumetrics / global illumination accuracy).
|
|
49
|
+
3. Evaluate time budget per frame and available hardware.
|
|
50
|
+
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).
|
|
51
|
+
5. Pin the 4-item engine record: engine + samples + GPU device (if applicable) + caveats.
|
|
52
|
+
|
|
53
|
+
## Handoff notes
|
|
54
|
+
- **[upstream_reference]** Lighting and material setup aligned with engine choice → `lighting-material-plan` (`references/skills/lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
55
|
+
- **[upstream_reference]** Color configuration decision → `color-management-decision` (`references/skills/color-management-decision.md`) — `when.all: [decision.colorLocked equals false]`
|
|
56
|
+
- **[progression]** Output container / codec decision → `output-format-decision` (`references/skills/output-format-decision.md`) — `when.all: [decision.formatLocked equals false]`
|
|
57
|
+
- **[upstream_reference]** Render resolution and aspect ratio decision → `resolution-aspect-decision` (`references/skills/resolution-aspect-decision.md`) — `when.all: [decision.aspectLocked equals false]`
|
|
58
|
+
- **[progression]** Post-render output verification → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
59
|
+
|
|
60
|
+
## Safety boundaries & non-goals
|
|
61
|
+
- **Runtime boundary:** Decision skill — does not run Blender. Pins config; operator applies in scene render properties.
|
|
62
|
+
- Never run Blender or execute a render or preview render.
|
|
63
|
+
- Never configure denoiser specifics, tile sizes, light probe volumes, or render-setting optimizations beyond `engine + samples + GPU device + caveats`.
|
|
64
|
+
- Never decide color management (`color-management-decision`), container/codec (`output-format-decision`), or resolution/aspect (`resolution-aspect-decision`).
|
|
65
|
+
- Never verify rendered files (`render-export-evidence`).
|
|
@@ -0,0 +1,70 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
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.
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/done-criteria/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/done-criteria/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `process-discipline` / `done-condition-and-iteration-cap-pinner`
|
|
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 starting work on any non-trivial single Blender recipe
|
|
18
|
+
- after `blender-recipe-decomposer` has isolated a single recipe and `acceptance-criteria-builder` has provided measurable acceptance rows
|
|
19
|
+
- when previous attempts drifted into endless polish or unclear completion boundaries
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "when are we done"
|
|
23
|
+
- "let's set the bar"
|
|
24
|
+
- "what does done look like"
|
|
25
|
+
|
|
26
|
+
## When not to use
|
|
27
|
+
- pure exploration or brainstorming → delegate to `blender-brainstorming` (`references/skills/blender-brainstorming.md`; use blender-brainstorming; goal is divergence)
|
|
28
|
+
- tiny single-shot requests → delegate to `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`; Delegates out-of-scope requests to intent-to-3d-brief-writer)
|
|
29
|
+
- splitting a broad multi-recipe request beforehand → delegate to `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`; use blender-recipe-decomposer first)
|
|
30
|
+
- authoring measurable acceptance rows from scratch → delegate to `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`; use acceptance-criteria-builder first)
|
|
31
|
+
- enforcing per-stage checklist gates during execution → delegate to `stage-gates` (`references/skills/stage-gates.md`; use stage-gates)
|
|
32
|
+
- after work has already started and scope is drifting mid-flight → delegate to `scope-guard` (`references/skills/scope-guard.md`; use scope-guard)
|
|
33
|
+
- performing the final verification gate before delivery → delegate to `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`; use pre-handoff-verification)
|
|
34
|
+
|
|
35
|
+
## Inputs & output/evidence contract
|
|
36
|
+
### Required inputs
|
|
37
|
+
- `locked_3d_brief` (`object`): Locked 8-slot 3D brief defining deliverable intent
|
|
38
|
+
- `acceptance_criteria_rows` (`array`): Measurable Pass/Warn/Fail criteria from acceptance-criteria-builder
|
|
39
|
+
|
|
40
|
+
### Optional inputs
|
|
41
|
+
- `iteration_budget_preference` (`integer`): Maximum refinement passes before halting or escalating
|
|
42
|
+
|
|
43
|
+
### Primary outputs
|
|
44
|
+
- `definition_of_done_checklist`
|
|
45
|
+
- `max_iteration_caps_per_stage`
|
|
46
|
+
- `halt_and_escalation_triggers`
|
|
47
|
+
|
|
48
|
+
## Quick-start procedure
|
|
49
|
+
1. write one stop condition per recipe (one sentence, concrete)
|
|
50
|
+
2. write what is OUT OF SCOPE for "done"
|
|
51
|
+
3. write the handoff trigger (which skill receives the deliverable when stop condition fires)
|
|
52
|
+
4. enforce: do not polish past the stop condition; do not declare done before it
|
|
53
|
+
|
|
54
|
+
## Handoff notes
|
|
55
|
+
- **[upstream_reference]** Intent 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
|
+
- **[boundary_delegation]** Scope splitting beforehand → `blender-recipe-decomposer` (`references/skills/blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
57
|
+
- **[upstream_reference]** Measurable acceptance rows → `acceptance-criteria-builder` (`references/skills/acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
58
|
+
- **[progression]** Per-stage workflow gates → `stage-gates` (`references/skills/stage-gates.md`) — `when.all: [brief.locked equals true; stage.current equals "stage_gates"]`
|
|
59
|
+
- **[progression]** Mid-flight scope drift → `scope-guard` (`references/skills/scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
60
|
+
- **[progression]** Artifact and render evidence → `render-export-evidence` (`references/skills/render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
61
|
+
- **[progression]** Final pre-handoff gate → `pre-handoff-verification` (`references/skills/pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
62
|
+
|
|
63
|
+
## Safety boundaries & non-goals
|
|
64
|
+
- **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.
|
|
65
|
+
- Run Blender or execute Python.
|
|
66
|
+
- Split multi-recipe scope (`blender-recipe-decomposer`).
|
|
67
|
+
- Author raw measurable acceptance rows (`acceptance-criteria-builder`).
|
|
68
|
+
- Enforce per-stage checklist gates (`stage-gates`).
|
|
69
|
+
- Police mid-flight scope drift (`scope-guard`).
|
|
70
|
+
- Gate the final delivery (`pre-handoff-verification`) or upgrade runtime/artifact truth states.
|
|
@@ -0,0 +1,65 @@
|
|
|
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 (reference summary)
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Plan a wide environment / establishing-shot scene (locale, time of day, weather, focal subject, depth, atmosphere) before any modeling or render attempt.
|
|
6
|
+
|
|
7
|
+
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`.
|
|
8
|
+
|
|
9
|
+
## Metadata & truth boundary
|
|
10
|
+
- **Canonical skill:** `skills/environment-shot/SKILL.md`
|
|
11
|
+
- **Contract:** `skills/environment-shot/contract.json` (`v1.0.0`)
|
|
12
|
+
- **Category / role:** `scene-planners` / `environment-establishing-shot-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 establishing a wide place (landscape, cityscape, outdoor locale, or wide interior space where furniture/surfaces do not dominate)
|
|
18
|
+
- before any modeling, Geometry Nodes, or scene building
|
|
19
|
+
- when consumer is editorial, cinematic, or brand
|
|
20
|
+
|
|
21
|
+
## Trigger cues
|
|
22
|
+
- "establishing shot of"
|
|
23
|
+
- "wide shot of"
|
|
24
|
+
- "city / forest / desert / ocean scene"
|
|
25
|
+
- "set the scene"
|
|
26
|
+
|
|
27
|
+
## When not to use
|
|
28
|
+
- character portrait → delegate to `character-portrait` (`references/skills/character-portrait.md`; use character-portrait)
|
|
29
|
+
- product hero → delegate to `product-hero-scene-planner` (`references/skills/product-hero-scene-planner.md`; use product-hero-scene-planner)
|
|
30
|
+
- interior arch viz with focus on furniture / surfaces → delegate to `interior-scene` (`references/skills/interior-scene.md`; use interior-scene)
|
|
31
|
+
|
|
32
|
+
## Inputs & output/evidence contract
|
|
33
|
+
### Required inputs
|
|
34
|
+
- `locked_3d_brief` (`object`): Locked 3D brief specifying locale, mood, focal anchor, and delivery channel
|
|
35
|
+
- `atmosphere_and_time_of_day` (`object`): Target time of day, weather condition, and atmospheric haze/fog parameters
|
|
36
|
+
|
|
37
|
+
### Optional inputs
|
|
38
|
+
- `asset_discovery_constraints` (`object`): Available environment kitbash or terrain assets from asset-discovery
|
|
39
|
+
|
|
40
|
+
### Primary outputs
|
|
41
|
+
- `foreground_midground_background_layer_plan`
|
|
42
|
+
- `sun_sky_atmosphere_specification`
|
|
43
|
+
- `horizon_and_scale_anchor_plan`
|
|
44
|
+
|
|
45
|
+
## Quick-start procedure
|
|
46
|
+
1. confirm upstream brief from `intent-to-3d-brief-writer` and verify a realizable (non-invented) locale scope
|
|
47
|
+
2. pin locale, time of day, weather, and atmosphere
|
|
48
|
+
3. pin foreground (FG), midground (MG), and background (BG) depth layers
|
|
49
|
+
4. pin focal subject (or explicitly declare `none`)
|
|
50
|
+
5. record an explicit assumptions register
|
|
51
|
+
6. flag asset rows for `asset-discovery` and emit validation handoffs with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
52
|
+
|
|
53
|
+
## Handoff notes
|
|
54
|
+
- **[upstream_reference]** Brief writer → `intent-to-3d-brief-writer` (`references/skills/intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
55
|
+
- **[upstream_reference]** Asset discovery → `asset-discovery` (`references/skills/asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
56
|
+
- **[progression]** Composition validation → `composition-quality-checker` (`references/skills/composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
57
|
+
- **[progression]** Lighting validation → `lighting-quality-checker` (`references/skills/lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
58
|
+
- **[progression]** Quality readiness → `scene-readiness` (`references/skills/scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
59
|
+
|
|
60
|
+
## Safety boundaries & non-goals
|
|
61
|
+
- **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`.
|
|
62
|
+
- Model the environment.
|
|
63
|
+
- Generate Geometry Node setups.
|
|
64
|
+
- Render.
|
|
65
|
+
- Run Blender.
|