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,194 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: plain-language-response
|
|
3
|
+
description: Translate technical Blender status, GLB handoffs, and quality caveats into jargon-free stakeholder updates for non-Blender users.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# plain-language-response
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Produce stakeholder-friendly outputs that preserve truthfulness, evidence boundaries, and clear next actions.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm this skill fits your goal
|
|
13
|
+
- provide required inputs first
|
|
14
|
+
- keep runtime claims evidence-bound
|
|
15
|
+
- follow suggested next-skill handoff
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
- in the final response phase to convert technical findings into plain-language user-facing wording
|
|
19
|
+
- after `render-export-evidence` classifies artifact evidence, validators (such as `scene-readiness`, `material-quality-checker`, `lighting-quality-checker`, `composition-quality-checker`, `polycount-budget-checker`) supply pass/warn/fail outcomes, `glb-web-handoff` supplies the handoff summary, and `pre-handoff-verification` gates the handoff
|
|
20
|
+
- when translating technical blockers, caveats, and verified/unverified status splits for non-Blender users
|
|
21
|
+
|
|
22
|
+
## When not to use
|
|
23
|
+
<!-- blendops:generated:start exclusions -->
|
|
24
|
+
- to hide blockers, drop caveats for readability, or overclaim runtime or artifact success → use `../render-export-evidence/SKILL.md` (Delegates out-of-scope requests to render-export-evidence)
|
|
25
|
+
- to upgrade Runtime or Artifact truth states → use `../scene-readiness/SKILL.md` (Delegates out-of-scope requests to scene-readiness)
|
|
26
|
+
- to classify raw artifact evidence → use `../render-export-evidence/SKILL.md` (use render-export-evidence)
|
|
27
|
+
- to generate technical pass/warn/fail checks → use `../scene-readiness/SKILL.md` (use scene-readiness or domain quality checkers)
|
|
28
|
+
- to assemble technical GLB/web compatibility summaries → use `../glb-web-handoff/SKILL.md` (use glb-web-handoff)
|
|
29
|
+
- to gate handoff readiness → use `../pre-handoff-verification/SKILL.md` (use pre-handoff-verification)
|
|
30
|
+
<!-- blendops:generated:end exclusions -->
|
|
31
|
+
|
|
32
|
+
## Trigger phrases
|
|
33
|
+
<!-- blendops:generated:start triggers -->
|
|
34
|
+
- "write final user summary"
|
|
35
|
+
- "explain this for non-Blender user"
|
|
36
|
+
- "make this stakeholder-friendly"
|
|
37
|
+
<!-- blendops:generated:end triggers -->
|
|
38
|
+
|
|
39
|
+
## Prerequisites / readiness
|
|
40
|
+
- classified Runtime and per-artifact evidence states from `render-export-evidence`
|
|
41
|
+
- pass/warn/fail findings from upstream validators (e.g. `scene-readiness`)
|
|
42
|
+
- handoff summary and caveats from `glb-web-handoff` (when applicable) and gate status from `pre-handoff-verification`
|
|
43
|
+
- complete list of active blockers and caveats
|
|
44
|
+
|
|
45
|
+
## Input schema
|
|
46
|
+
|
|
47
|
+
### Required inputs
|
|
48
|
+
- Runtime truth state (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact truth states (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) from `render-export-evidence`
|
|
49
|
+
- pass/warn/fail outcomes from upstream validators and gate status from `pre-handoff-verification`
|
|
50
|
+
- technical handoff summary (from `glb-web-handoff` when applicable), blockers, and caveats
|
|
51
|
+
|
|
52
|
+
### Optional inputs
|
|
53
|
+
- audience context (client, product owner, internal team)
|
|
54
|
+
- preferred response brevity
|
|
55
|
+
|
|
56
|
+
### Assumptions to confirm
|
|
57
|
+
- the reader is a non-Blender user who needs jargon-free language
|
|
58
|
+
- blockers and caveats must remain visible with clear user impact (never dropped for readability)
|
|
59
|
+
- truth states are strictly downgrade-only (never upgrade); contradictory status language must downgrade to safer wording
|
|
60
|
+
|
|
61
|
+
## Output schema
|
|
62
|
+
|
|
63
|
+
### Primary output
|
|
64
|
+
- concise, jargon-free plain-language summary of what was requested and current status
|
|
65
|
+
|
|
66
|
+
### Secondary output
|
|
67
|
+
- caveats translated into plain-language user impact
|
|
68
|
+
- prioritized next actions
|
|
69
|
+
|
|
70
|
+
### Evidence / caveat output
|
|
71
|
+
- explicit verified vs unverified split
|
|
72
|
+
- explicit Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`), strictly downgrade-only
|
|
73
|
+
|
|
74
|
+
## Required laws
|
|
75
|
+
- ../../laws/non-blender-user-language.md
|
|
76
|
+
- ../../laws/evidence-before-done.md
|
|
77
|
+
- ../../laws/official-runtime-only.md
|
|
78
|
+
- ../../laws/no-arbitrary-python-interface.md
|
|
79
|
+
|
|
80
|
+
## Official runtime boundary
|
|
81
|
+
Never imply runtime success or artifact existence without concrete evidence, never hide blockers, and never drop caveats for readability. Keep Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states strictly downgrade-only — if upstream status language is contradictory, downgrade to safer wording. Keep runtime vocabulary strictly within the 2-path + CLI appendix model. This skill writes final wording only and never executes Python or Blender or replaces upstream evidence, validator, handoff, or gate skills.
|
|
82
|
+
|
|
83
|
+
## Operating procedure
|
|
84
|
+
1. Identify the audience and restate the request in plain, jargon-free language.
|
|
85
|
+
2. Check upstream inputs (`render-export-evidence`, validators, `glb-web-handoff`, `pre-handoff-verification`); if status language is contradictory, downgrade to safer wording and never upgrade any truth state.
|
|
86
|
+
3. State current Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) in plain language.
|
|
87
|
+
4. Explicitly separate what is verified from what remains unverified.
|
|
88
|
+
5. Translate every technical blocker and caveat into concrete user impact without hiding blockers or dropping caveats for readability.
|
|
89
|
+
6. Preserve upstream pass/warn/fail meaning accurately.
|
|
90
|
+
7. List clear, prioritized next actions.
|
|
91
|
+
8. Audit final wording to remove dense Blender jargon and any unsupported certainty phrases.
|
|
92
|
+
|
|
93
|
+
## Decision tree
|
|
94
|
+
- If `pre-handoff-verification` passes, evidence is classified by `render-export-evidence`, and validator status is positive -> write plain-language readiness summary + explicit verified/unverified split + caveats with user impact + prioritized next actions.
|
|
95
|
+
- If evidence is partial, unverified, or contradictory -> downgrade contradictory status language to safer wording, highlight the unverified split and user impact, and list prioritized verification steps.
|
|
96
|
+
- If runtime is blocked or major validator/export failures exist -> state the `Failed`, `Not Run`, or `Not Produced` state plainly without hiding blockers, explain the user impact, and list prioritized remediation steps.
|
|
97
|
+
- If upstream evidence classification, handoff summary, or gate verification is missing -> route to `render-export-evidence`, `glb-web-handoff`, or `pre-handoff-verification` before claiming completion.
|
|
98
|
+
|
|
99
|
+
## Playbooks
|
|
100
|
+
- Playbook A: text-only planning path
|
|
101
|
+
- Playbook B: runtime-ready path with evidence gating
|
|
102
|
+
- Playbook C: blocked runtime path with caveat-first reporting
|
|
103
|
+
|
|
104
|
+
## Mode handling
|
|
105
|
+
|
|
106
|
+
### Text-only mode
|
|
107
|
+
- emphasize that work is currently in planning-only state
|
|
108
|
+
- state Runtime status as `Not Run` and artifact statuses as `Not Run` or default `Not Produced` (downgrade-only)
|
|
109
|
+
|
|
110
|
+
### Runtime-ready mode
|
|
111
|
+
- report evidence-linked Runtime status (`Not Run | Attempted | Produced | Verified | Failed`) and per-artifact statuses (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) alongside the verified/unverified split and caveats
|
|
112
|
+
|
|
113
|
+
### Blocked runtime mode
|
|
114
|
+
- state blockers, user impact, and setup next steps plainly without blame language
|
|
115
|
+
- keep Runtime and artifact statuses at `Not Run`, `Not Produced`, or `Failed` (never upgrade)
|
|
116
|
+
|
|
117
|
+
## Validation checklist
|
|
118
|
+
- [ ] plain-language summary present and jargon-free
|
|
119
|
+
- [ ] explicit verified vs unverified split included
|
|
120
|
+
- [ ] Runtime (`Not Run | Attempted | Produced | Verified | Failed`) and Artifact (`Not Run | Not Produced | Produced | Verified | Failed`, default `Not Produced`) truth states preserved (downgrade-only)
|
|
121
|
+
- [ ] contradictory status language downgraded to safer wording
|
|
122
|
+
- [ ] upstream pass/warn/fail meaning preserved without role blur
|
|
123
|
+
- [ ] all blockers visible and caveats translated into user impact (none dropped for readability)
|
|
124
|
+
- [ ] next actions clearly prioritized
|
|
125
|
+
- [ ] no unsupported certainty language or dense jargon blocks
|
|
126
|
+
- [ ] runtime vocabulary stays within the 2-path + CLI appendix model
|
|
127
|
+
|
|
128
|
+
## Pass / Warn / Fail rubric
|
|
129
|
+
|
|
130
|
+
| Category | Pass | Warn | Fail |
|
|
131
|
+
|---|---|---|---|
|
|
132
|
+
| Clarity | Non-technical reader understands outcome | Minor jargon remains | Jargon-heavy/confusing |
|
|
133
|
+
| Truthfulness | Claims align with evidence | Partial ambiguity | Overclaiming present |
|
|
134
|
+
| Actionability | Next steps clear and prioritized | Generic next steps | No clear next steps |
|
|
135
|
+
| Caveat quality | Caveats preserved with impact | Caveats vague | Caveats missing |
|
|
136
|
+
|
|
137
|
+
## Failure handling
|
|
138
|
+
- Missing evidence classification: keep artifact status at default `Not Produced` (or `Not Run`) and route to `render-export-evidence`.
|
|
139
|
+
- Contradictory upstream status language: downgrade immediately to the safer truth state and note the uncertainty in the unverified section.
|
|
140
|
+
- Missing technical handoff summary or gate check: route to `glb-web-handoff` or `pre-handoff-verification` rather than inventing technical guarantees.
|
|
141
|
+
- Excessive jargon in draft: rewrite technical terms into plain-language user impact while keeping every caveat intact.
|
|
142
|
+
|
|
143
|
+
## Troubleshooting
|
|
144
|
+
- If draft wording sounds certain when evidence is partial, rewrite with conditional phrasing and verify that truth states were not upgraded.
|
|
145
|
+
- If audience mismatch occurs, replace 3D terminology with plain everyday descriptions of visual or delivery impact.
|
|
146
|
+
- If the draft is too long, tighten phrasing in the summary while keeping the full verified/unverified split, all blockers, and all caveats with user impact intact — never drop caveats for readability.
|
|
147
|
+
|
|
148
|
+
## Best practices
|
|
149
|
+
- Lead with a plain-language summary of what the user asked for and the honest current truth state.
|
|
150
|
+
- Always pair technical caveats with their practical impact on the user's goal, never dropping caveats for readability.
|
|
151
|
+
- End with prioritized, actionable next steps grounded in the 2-path + CLI appendix runtime workflow.
|
|
152
|
+
|
|
153
|
+
## Good examples
|
|
154
|
+
"Summary: Your product scene plan is ready, but no 3D files or preview images have been generated yet. Verified vs Unverified: Scene layout and lighting steps are planned (`Pass` on planning checks), while Runtime status is `Not Run` and the GLB file and preview render are `Not Produced` (unverified in Blender). Caveats & User Impact: Web material appearance and file size cannot be confirmed until an export runs, meaning the model cannot be embedded on your website yet. Prioritized Next Actions: 1. Run `runtime-readiness` on your chosen runtime path. 2. Execute the scene build and classify outputs with `render-export-evidence`. 3. Complete `glb-web-handoff` and `pre-handoff-verification` before web delivery."
|
|
155
|
+
|
|
156
|
+
## Bad examples
|
|
157
|
+
“Everything is done and production-ready.” (without evidence)
|
|
158
|
+
|
|
159
|
+
## User-facing response template
|
|
160
|
+
1. Plain-language summary (what you asked for and current Runtime / Artifact truth state)
|
|
161
|
+
2. Verified vs unverified split (what is confirmed now vs what is still `Not Run`, `Not Produced`, or unverified)
|
|
162
|
+
3. Caveats and blockers with user impact (why each limitation matters to your delivery)
|
|
163
|
+
4. Prioritized next actions (ordered steps to verify or resolve)
|
|
164
|
+
|
|
165
|
+
## Anti-patterns
|
|
166
|
+
- skipping required laws or runtime boundary statements
|
|
167
|
+
- claiming runtime/artifact success without evidence
|
|
168
|
+
- using non-official runtime setup paths
|
|
169
|
+
- producing jargon-heavy final output without explanation
|
|
170
|
+
|
|
171
|
+
## Cross-skill handoff
|
|
172
|
+
<!-- blendops:generated:start handoffs -->
|
|
173
|
+
- [upstream_reference] Upstream artifact evidence classification → `../render-export-evidence/SKILL.md`
|
|
174
|
+
- [fallback] Upstream quality pass/warn/fail validation (scene-readiness) → `../scene-readiness/SKILL.md`
|
|
175
|
+
- [fallback] Upstream quality pass/warn/fail validation (composition-quality-checker) → `../composition-quality-checker/SKILL.md`
|
|
176
|
+
- [fallback] Upstream quality pass/warn/fail validation (lighting-quality-checker) → `../lighting-quality-checker/SKILL.md`
|
|
177
|
+
- [fallback] Upstream quality pass/warn/fail validation (material-quality-checker) → `../material-quality-checker/SKILL.md`
|
|
178
|
+
- [fallback] Upstream quality pass/warn/fail validation (polycount-budget-checker) → `../polycount-budget-checker/SKILL.md`
|
|
179
|
+
- [upstream_reference] Upstream GLB/web handoff summary → `../glb-web-handoff/SKILL.md`
|
|
180
|
+
- [upstream_reference] Upstream handoff gate check → `../pre-handoff-verification/SKILL.md`
|
|
181
|
+
- [upstream_reference] Runtime readiness check when runtime is unverified → `../runtime-readiness/SKILL.md`
|
|
182
|
+
<!-- blendops:generated:end handoffs -->
|
|
183
|
+
|
|
184
|
+
## Non-goals
|
|
185
|
+
- Dumping raw logs or unexplained 3D jargon as final output
|
|
186
|
+
- Hiding blockers or dropping caveats for readability
|
|
187
|
+
- Upgrading Runtime or Artifact truth states or overclaiming completion
|
|
188
|
+
- Executing Python or Blender
|
|
189
|
+
- Replacing `render-export-evidence` (evidence classification), validators (`scene-readiness`, etc.), `glb-web-handoff` (handoff summary), or `pre-handoff-verification` (handoff gating)
|
|
190
|
+
|
|
191
|
+
## References
|
|
192
|
+
- https://www.blender.org/lab/mcp-server/
|
|
193
|
+
- https://claude.com/resources/tutorials/using-the-blender-connector-in-claude
|
|
194
|
+
- https://docs.blender.org/manual/en/latest/advanced/command_line/index.html
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "plain-language-response",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "evidence-and-handoff",
|
|
6
|
+
"role": "plain-language-final-response-translator",
|
|
7
|
+
"purpose": "Convert technical Blender workflow findings into plain-language user-facing responses with honest caveats.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"write final user summary",
|
|
11
|
+
"explain this for non-Blender user",
|
|
12
|
+
"make this stakeholder-friendly"
|
|
13
|
+
],
|
|
14
|
+
"exclusions": [
|
|
15
|
+
{
|
|
16
|
+
"condition": "to hide blockers, drop caveats for readability, or overclaim runtime or artifact success",
|
|
17
|
+
"delegateTo": "render-export-evidence",
|
|
18
|
+
"reason": "Delegates out-of-scope requests to render-export-evidence"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"condition": "to upgrade Runtime or Artifact truth states",
|
|
22
|
+
"delegateTo": "scene-readiness",
|
|
23
|
+
"reason": "Delegates out-of-scope requests to scene-readiness"
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"condition": "to classify raw artifact evidence",
|
|
27
|
+
"delegateTo": "render-export-evidence",
|
|
28
|
+
"reason": "use render-export-evidence"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"condition": "to generate technical pass/warn/fail checks",
|
|
32
|
+
"delegateTo": "scene-readiness",
|
|
33
|
+
"reason": "use scene-readiness or domain quality checkers"
|
|
34
|
+
},
|
|
35
|
+
{
|
|
36
|
+
"condition": "to assemble technical GLB/web compatibility summaries",
|
|
37
|
+
"delegateTo": "glb-web-handoff",
|
|
38
|
+
"reason": "use glb-web-handoff"
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"condition": "to gate handoff readiness",
|
|
42
|
+
"delegateTo": "pre-handoff-verification",
|
|
43
|
+
"reason": "use pre-handoff-verification"
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"inputs": {
|
|
47
|
+
"required": [
|
|
48
|
+
{
|
|
49
|
+
"name": "verified_workflow_and_evidence_state",
|
|
50
|
+
"type": "object",
|
|
51
|
+
"description": "Final pre-handoff verification gate status, runtime truth state, and artifact truth state"
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"name": "deliverable_summary_inputs",
|
|
55
|
+
"type": "object",
|
|
56
|
+
"description": "Technical outputs from scene planners, quality checkers, or handoff packagers to translate"
|
|
57
|
+
}
|
|
58
|
+
],
|
|
59
|
+
"optional": [
|
|
60
|
+
{
|
|
61
|
+
"name": "stakeholder_audience_profile",
|
|
62
|
+
"type": "string",
|
|
63
|
+
"description": "Target reader role (product manager, web developer, creative director, end user)"
|
|
64
|
+
}
|
|
65
|
+
]
|
|
66
|
+
},
|
|
67
|
+
"outputs": {
|
|
68
|
+
"primary": [
|
|
69
|
+
"plain_language_stakeholder_response",
|
|
70
|
+
"explicit_runtime_and_artifact_status_block",
|
|
71
|
+
"jargon_free_next_steps"
|
|
72
|
+
],
|
|
73
|
+
"truthStatePolicy": {
|
|
74
|
+
"runtimeDefault": "Not Run",
|
|
75
|
+
"artifactDefault": "Not Produced",
|
|
76
|
+
"mutationRule": "downgrade_only"
|
|
77
|
+
}
|
|
78
|
+
},
|
|
79
|
+
"handoffs": [
|
|
80
|
+
{
|
|
81
|
+
"target": "render-export-evidence",
|
|
82
|
+
"type": "upstream_reference",
|
|
83
|
+
"label": "Upstream artifact evidence classification",
|
|
84
|
+
"when": {
|
|
85
|
+
"all": [
|
|
86
|
+
{
|
|
87
|
+
"field": "stage.current",
|
|
88
|
+
"operator": "equals",
|
|
89
|
+
"value": "post_execution_audit"
|
|
90
|
+
}
|
|
91
|
+
]
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
"target": "scene-readiness",
|
|
96
|
+
"type": "fallback",
|
|
97
|
+
"label": "Upstream quality pass/warn/fail validation (scene-readiness)",
|
|
98
|
+
"when": {
|
|
99
|
+
"all": [
|
|
100
|
+
{
|
|
101
|
+
"field": "quality.domain",
|
|
102
|
+
"operator": "equals",
|
|
103
|
+
"value": "holistic"
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
"field": "stage.current",
|
|
107
|
+
"operator": "equals",
|
|
108
|
+
"value": "quality_validation"
|
|
109
|
+
}
|
|
110
|
+
]
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
{
|
|
114
|
+
"target": "composition-quality-checker",
|
|
115
|
+
"type": "fallback",
|
|
116
|
+
"label": "Upstream quality pass/warn/fail validation (composition-quality-checker)",
|
|
117
|
+
"when": {
|
|
118
|
+
"all": [
|
|
119
|
+
{
|
|
120
|
+
"field": "quality.domain",
|
|
121
|
+
"operator": "equals",
|
|
122
|
+
"value": "composition"
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"field": "quality.verdict",
|
|
126
|
+
"operator": "equals",
|
|
127
|
+
"value": "not_run"
|
|
128
|
+
}
|
|
129
|
+
]
|
|
130
|
+
}
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
"target": "lighting-quality-checker",
|
|
134
|
+
"type": "fallback",
|
|
135
|
+
"label": "Upstream quality pass/warn/fail validation (lighting-quality-checker)",
|
|
136
|
+
"when": {
|
|
137
|
+
"all": [
|
|
138
|
+
{
|
|
139
|
+
"field": "quality.domain",
|
|
140
|
+
"operator": "equals",
|
|
141
|
+
"value": "lighting"
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"field": "quality.verdict",
|
|
145
|
+
"operator": "equals",
|
|
146
|
+
"value": "not_run"
|
|
147
|
+
}
|
|
148
|
+
]
|
|
149
|
+
}
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"target": "material-quality-checker",
|
|
153
|
+
"type": "fallback",
|
|
154
|
+
"label": "Upstream quality pass/warn/fail validation (material-quality-checker)",
|
|
155
|
+
"when": {
|
|
156
|
+
"all": [
|
|
157
|
+
{
|
|
158
|
+
"field": "quality.domain",
|
|
159
|
+
"operator": "equals",
|
|
160
|
+
"value": "material"
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"field": "quality.verdict",
|
|
164
|
+
"operator": "equals",
|
|
165
|
+
"value": "not_run"
|
|
166
|
+
}
|
|
167
|
+
]
|
|
168
|
+
}
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"target": "polycount-budget-checker",
|
|
172
|
+
"type": "fallback",
|
|
173
|
+
"label": "Upstream quality pass/warn/fail validation (polycount-budget-checker)",
|
|
174
|
+
"when": {
|
|
175
|
+
"all": [
|
|
176
|
+
{
|
|
177
|
+
"field": "quality.domain",
|
|
178
|
+
"operator": "equals",
|
|
179
|
+
"value": "polycount"
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
"field": "budget.verdict",
|
|
183
|
+
"operator": "equals",
|
|
184
|
+
"value": "Not Run"
|
|
185
|
+
}
|
|
186
|
+
]
|
|
187
|
+
}
|
|
188
|
+
},
|
|
189
|
+
{
|
|
190
|
+
"target": "glb-web-handoff",
|
|
191
|
+
"type": "upstream_reference",
|
|
192
|
+
"label": "Upstream GLB/web handoff summary",
|
|
193
|
+
"when": {
|
|
194
|
+
"all": [
|
|
195
|
+
{
|
|
196
|
+
"field": "artifact.type",
|
|
197
|
+
"operator": "equals",
|
|
198
|
+
"value": "glb"
|
|
199
|
+
},
|
|
200
|
+
{
|
|
201
|
+
"field": "handoff.consumerStack",
|
|
202
|
+
"operator": "equals",
|
|
203
|
+
"value": "web_glb"
|
|
204
|
+
}
|
|
205
|
+
]
|
|
206
|
+
}
|
|
207
|
+
},
|
|
208
|
+
{
|
|
209
|
+
"target": "pre-handoff-verification",
|
|
210
|
+
"type": "upstream_reference",
|
|
211
|
+
"label": "Upstream handoff gate check",
|
|
212
|
+
"when": {
|
|
213
|
+
"all": [
|
|
214
|
+
{
|
|
215
|
+
"field": "stage.current",
|
|
216
|
+
"operator": "equals",
|
|
217
|
+
"value": "final_verification"
|
|
218
|
+
}
|
|
219
|
+
]
|
|
220
|
+
}
|
|
221
|
+
},
|
|
222
|
+
{
|
|
223
|
+
"target": "runtime-readiness",
|
|
224
|
+
"type": "upstream_reference",
|
|
225
|
+
"label": "Runtime readiness check when runtime is unverified",
|
|
226
|
+
"when": {
|
|
227
|
+
"all": [
|
|
228
|
+
{
|
|
229
|
+
"field": "runtime.path",
|
|
230
|
+
"operator": "not_equals",
|
|
231
|
+
"value": "unselected"
|
|
232
|
+
},
|
|
233
|
+
{
|
|
234
|
+
"field": "runtime.verifiedReady",
|
|
235
|
+
"operator": "equals",
|
|
236
|
+
"value": false
|
|
237
|
+
}
|
|
238
|
+
]
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
]
|
|
242
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Caveat Language
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Preserve strict factual honesty about unverified runtime steps or partial outputs without confusing non-Blender users with jargon or vague hedging.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- Whenever runtime was `Not Run`, an export has not been validated yet, or a workaround/simplification was chosen for web performance.
|
|
8
|
+
|
|
9
|
+
## Four-Part Caveat Formula
|
|
10
|
+
Every caveat should explicitly state:
|
|
11
|
+
1. **What is unverified or skipped**: e.g., `"Blender did not run in this step."`
|
|
12
|
+
2. **Concrete impact on the user**: e.g., `"So there is no rendered image or 3D web file (.glb) on disk yet."`
|
|
13
|
+
3. **Why it is safe or blocked**: e.g., `"This pass was planning-only"` or `"Blender 5.1+ is missing the Lab MCP add-on."`
|
|
14
|
+
4. **Single clearest next step**: e.g., `"Open docs/install/cursor.md to enable Path 1, or run a read-only check first."`
|
|
15
|
+
|
|
16
|
+
## Good vs. Bad Caveat Examples
|
|
17
|
+
|
|
18
|
+
| Situation | Bad Caveat (Avoid) | Good Plain-Language Caveat |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| **Planning-only session** | `"Everything looks good, model ready soon!"` | `"This is a complete scene blueprint only. Blender has not run yet (Runtime status: Not Run), so no 3D file or image exists on disk yet (Artifact status: Not Produced). Next: connect Path 1 or CLI to build the scene."` |
|
|
21
|
+
| **File exported, validator not run** | `"GLB exported, should work fine in Three.js."` | `"The 3D web file was saved to exports/shoe.glb (3.1 MB), so the file exists (Artifact status: Produced), but it has not passed validator or browser viewer checks yet. Next: run blendops glb-inspect exports/shoe.glb."` |
|
|
22
|
+
| **Web material downgrade** | `"Removed transmission BSDF lobes."` | `"To keep mobile load fast (< 5 MB), glass transparency was switched to a glossy clearcoat finish instead of heavy refraction. You get smooth 60 fps scrolling with a slightly simpler glass look."` |
|
|
23
|
+
|
|
24
|
+
## Related skill
|
|
25
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Plain-Language Patterns
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Standardize clear, jargon-free user communication so anyone who has never opened Blender understands exactly what happened, what files exist, and what single action comes next.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- At the final synthesis step of any workflow (`plain-language-response`) before presenting results to stakeholders or end users.
|
|
8
|
+
|
|
9
|
+
## Core Communication Structure (4-Block Pattern)
|
|
10
|
+
1. **What you asked for (1 sentence)**: Mirror the user's goal in everyday terms (`"a clean 3D sneaker render and web file for your landing page"`).
|
|
11
|
+
2. **What is ready right now**: Plain bullet list of completed plans, decisions, or verified files (`"Camera plan, 3-point neon lighting setup, and web budget checklist are ready"`).
|
|
12
|
+
3. **What is NOT done yet (Truth boundary)**: Explicitly separate plans from actual 3D files (`Runtime status` + `Artifact status`), translating any unavoidable Blender term in brackets (`"cycles raytracing (photo-realistic lighting engine)"`).
|
|
13
|
+
4. **Your one next step**: A single concrete action — never dump five competing technical options on a beginner.
|
|
14
|
+
|
|
15
|
+
## Jargon Translation Quick Table
|
|
16
|
+
|
|
17
|
+
| Blender / 3D Term (Never leave unexplained) | Plain-Language Translation |
|
|
18
|
+
|---|---|
|
|
19
|
+
| `Principled BSDF / PBR` | Standard realistic surface shader (controls shine, roughness, and metal look) |
|
|
20
|
+
| `GLB / glTF 2.0` | Standard lightweight 3D file format that runs directly inside web browsers |
|
|
21
|
+
| `Triangle budget / Polycount` | How detailed the 3D shape is (fewer triangles = faster page loads on phones) |
|
|
22
|
+
| `View Transform (AgX / PBR Neutral)` | Color lens setting that keeps bright lights natural and brand colors true |
|
|
23
|
+
| `UV unwrap / Texel density` | How cleanly 2D textures wrap onto the 3D shape without blurry or stretched patches |
|
|
24
|
+
| `Bake textures` | Turning complex Blender effects into regular image maps so websites can load them |
|
|
25
|
+
|
|
26
|
+
## Bad Pattern to Avoid
|
|
27
|
+
- Pasting raw `bpy.ops` Python snippets, node-graph dumps, or ambiguous `"Done!"` claims when no render or `.glb` file was actually written.
|
|
28
|
+
|
|
29
|
+
## Related skill
|
|
30
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Stakeholder-Friendly Examples
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Provide concrete before-and-after response examples for non-technical product managers, founders, and designers receiving BlendOps updates.
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- When formatting final milestone summaries, blocked-runtime updates, or web-handoff reports.
|
|
8
|
+
|
|
9
|
+
## Three Canonical Examples
|
|
10
|
+
|
|
11
|
+
### 1. Concise Executive Summary (Planning Pass Complete)
|
|
12
|
+
> **Goal**: Futuristic sneaker hero visual + lightweight web 3D file for your product page.
|
|
13
|
+
> **What is ready**: Scene layout blueprint, three-quarter camera angle leaving the left side clear for your headline, neon rim lighting plan, and a 5 MB mobile web budget target.
|
|
14
|
+
> **Important note**: Blender has **not** run yet (`Runtime status: Not Run`), so **no image or `.glb` 3D file has been created yet** (`Artifact status: Not Produced`).
|
|
15
|
+
> **Next step**: Enable Blender Path 1 following `docs/install/cursor.md` and run a read-only check so we can generate your first preview render.
|
|
16
|
+
|
|
17
|
+
### 2. Implementation-Ready Web Handoff Summary (Verified Build)
|
|
18
|
+
> **Goal**: E-commerce 3D sneaker viewer ready for React/Next.js.
|
|
19
|
+
> **Verified output**: `exports/hero-shoe.glb` (**2.84 MB**, **31,420 triangles** — well under the 50k mobile limit; `gltf-validator`: **0 errors**). Color balance verified with `Khronos PBR Neutral` so brand reds stay accurate.
|
|
20
|
+
> **Truth status**: `Runtime status: Verified`, `Artifact status: Verified`.
|
|
21
|
+
> **Next step**: Drop `exports/hero-shoe.glb` into the `<Canvas>` starter component in `docs/examples/glb-web-handoff/README.md`.
|
|
22
|
+
|
|
23
|
+
### 3. Blocked-Runtime Summary (Missing Prerequisite)
|
|
24
|
+
> **Goal**: Render final PNG + turntable video.
|
|
25
|
+
> **What stopped us**: Blender 5.1+ is installed, but the **Lab MCP add-on** inside Blender Preferences is not switched on yet, so our agent cannot safely touch your scene.
|
|
26
|
+
> **Truth status**: `Runtime status: Failed` (connection refused), `Artifact status: Not Produced`.
|
|
27
|
+
> **Next step**: Open Blender -> *Edit -> Preferences -> Add-ons*, enable **Blender Lab MCP**, click **Start Server**, and re-run the check.
|
|
28
|
+
|
|
29
|
+
## Related skill
|
|
30
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Status Summary Templates
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
Ensure every final user update uses the exact status template matched to the actual execution mode (`Planning-only`, `Runtime Blocked`, `Runtime Produced-Unverified`, or `Verified`).
|
|
5
|
+
|
|
6
|
+
## When to use
|
|
7
|
+
- During the closing status block of `plain-language-response` or `blendops-help`.
|
|
8
|
+
|
|
9
|
+
## Templates by Mode
|
|
10
|
+
|
|
11
|
+
### 1. Planning-Only Mode (`Not Run` / `Not Produced`)
|
|
12
|
+
```txt
|
|
13
|
+
Summary: Blueprint ready; Blender has not run yet.
|
|
14
|
+
What is ready: <list of approved plans / checklists / budgets>
|
|
15
|
+
What is missing: Actual Blender build, render image, or .glb file on disk.
|
|
16
|
+
Runtime status: Not Run (planning-only pass)
|
|
17
|
+
Artifact status: Not Produced
|
|
18
|
+
Next single step: <choose runtime path via runtime-path-picker or run read-only setup check>
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### 2. Runtime Blocked / Failed Mode (`Failed` / `Not Produced`)
|
|
22
|
+
```txt
|
|
23
|
+
Summary: Stopped cleanly before changing your scene because <plain reason>.
|
|
24
|
+
Blocker: <exact missing add-on / Blender version / port conflict / missing brief slot>
|
|
25
|
+
Runtime status: Failed (<short error reason>)
|
|
26
|
+
Artifact status: Not Produced
|
|
27
|
+
Next single step: <exact 1-action fix + re-check command>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### 3. File Written, Not Yet Validated (`Produced` — Intermediate)
|
|
31
|
+
```txt
|
|
32
|
+
Summary: Output file saved to <path> (<size>), awaiting quality & validator checks.
|
|
33
|
+
Created file: <path> (<size>)
|
|
34
|
+
Unverified: <gltf-validator / visual render inspection / mobile frame-rate check>
|
|
35
|
+
Runtime status: Produced
|
|
36
|
+
Artifact status: Produced (validation pending)
|
|
37
|
+
Next single step: Run `blendops glb-inspect <path>` or visual review via `pre-handoff-verification`.
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### 4. Verified Delivery (`Verified` / `Verified`)
|
|
41
|
+
```txt
|
|
42
|
+
Summary: Ready for handoff — verified on disk with zero critical errors.
|
|
43
|
+
Verified file(s): <path> (<size>, <polycount>, <validator result>)
|
|
44
|
+
Runtime status: Verified (<Blender version + path used>)
|
|
45
|
+
Artifact status: Verified
|
|
46
|
+
Next single step: <plug into viewer / publish asset>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Related skill
|
|
50
|
+
[../SKILL.md](../SKILL.md)
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# EVAL — polycount-budget-checker
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
Use polycount-budget-checker on a mid-mobile product hero scene (total cap 50K) with 4 meshes: shoe-upper 18K, sole 8K, laces 5K, ground-shadow 1K.
|
|
5
|
+
|
|
6
|
+
## Expected behavior
|
|
7
|
+
- pinned budget header (50K total + per-mesh cap)
|
|
8
|
+
- per-mesh rows with triangle count + % of total + verdict + hint
|
|
9
|
+
- worst-offender highlight (shoe-upper at 18K = 36% of total)
|
|
10
|
+
- total: 32K of 50K (64%)
|
|
11
|
+
- top-line: Pass (within budget, no single dominator)
|
|
12
|
+
- evidence label honest
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
- Pass: full per-mesh data + correct totals + top-line consistent
|
|
16
|
+
- Warn: rows present but missing per-mesh cap comparison or hint advisory missing
|
|
17
|
+
- Fail: invents counts, claims compliance without numbers, decimates inside the skill
|
|
18
|
+
|
|
19
|
+
## Common failure modes
|
|
20
|
+
- broad summary without per-mesh rows
|
|
21
|
+
- skipping per-mesh cap comparison
|
|
22
|
+
- mixing other quality checks
|
|
23
|
+
- claiming Verified without measurement
|
|
24
|
+
|
|
25
|
+
## Evidence expectations
|
|
26
|
+
- triangle counts cited
|
|
27
|
+
- per-mesh + total cap headers
|
|
28
|
+
- hints labeled advisory
|
|
29
|
+
|
|
30
|
+
## Sample passing response outline
|
|
31
|
+
- Header: pinned budget
|
|
32
|
+
- 4 mesh rows
|
|
33
|
+
- Total + worst offender
|
|
34
|
+
- Top-line: Pass
|
|
35
|
+
- Next: handoff named
|
|
36
|
+
|
|
37
|
+
## Sample failing response outline
|
|
38
|
+
- "Polycount fine"
|
|
39
|
+
- No row data
|
|
40
|
+
- Verified without measurement
|