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,245 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: character-portrait
|
|
3
|
+
description: Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# character-portrait
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
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`.
|
|
10
|
+
|
|
11
|
+
## Quick start
|
|
12
|
+
- confirm single-subject scope and upstream brief from `intent-to-3d-brief-writer`
|
|
13
|
+
- confirm likeness rights before use if the subject is a real person
|
|
14
|
+
- pin subject identity, pose, expression, wardrobe, framing, lighting, and background
|
|
15
|
+
- record an explicit assumptions register
|
|
16
|
+
- flag needed assets for `asset-discovery`
|
|
17
|
+
- emit handoffs to `camera-composition`, `lighting-material-plan`, and quality checkers with `Runtime status: Not Run` and `Artifact status: Not Produced`
|
|
18
|
+
|
|
19
|
+
## When to use
|
|
20
|
+
- intent is explicitly a character / person / creature portrait
|
|
21
|
+
- before any modeling or scene file is built
|
|
22
|
+
- when the consumer is editorial / brand / catalog / cinematic
|
|
23
|
+
|
|
24
|
+
## When not to use
|
|
25
|
+
<!-- blendops:generated:start exclusions -->
|
|
26
|
+
- product hero scenes → use `../product-hero-scene-planner/SKILL.md` (use product-hero-scene-planner)
|
|
27
|
+
- environment establishing shots → use `../environment-shot/SKILL.md` (use environment-shot)
|
|
28
|
+
- interior arch viz → use `../interior-scene/SKILL.md` (use interior-scene)
|
|
29
|
+
- multi-character ensemble (this skill is single-subject) → use `../intent-to-3d-brief-writer/SKILL.md` (this skill is single-subject)
|
|
30
|
+
<!-- blendops:generated:end exclusions -->
|
|
31
|
+
|
|
32
|
+
## Trigger phrases
|
|
33
|
+
<!-- blendops:generated:start triggers -->
|
|
34
|
+
- "portrait of"
|
|
35
|
+
- "character looking at the camera"
|
|
36
|
+
- "headshot"
|
|
37
|
+
- "hero shot of [person / mascot / creature]"
|
|
38
|
+
<!-- blendops:generated:end triggers -->
|
|
39
|
+
|
|
40
|
+
## Prerequisites / readiness
|
|
41
|
+
- brief from `intent-to-3d-brief-writer` is locked
|
|
42
|
+
- single-subject character identity and style are known
|
|
43
|
+
- likeness rights are confirmed before use if the subject depicts a real person
|
|
44
|
+
- target framing and use case are known
|
|
45
|
+
|
|
46
|
+
## Input schema
|
|
47
|
+
|
|
48
|
+
### Required inputs
|
|
49
|
+
|
|
50
|
+
| Input | Why it is required |
|
|
51
|
+
|---|---|
|
|
52
|
+
| Subject identity | Defines single-subject character traits and asset needs |
|
|
53
|
+
| Likeness rights confirmation (if real person) | Must be confirmed before use; blocks planning if unconfirmed |
|
|
54
|
+
| Pose + expression | Drives framing and lighting intent |
|
|
55
|
+
| Framing + background intent | Sets portrait boundaries before camera/lookdev deep-dives |
|
|
56
|
+
|
|
57
|
+
### Optional inputs
|
|
58
|
+
|
|
59
|
+
| Input | Use |
|
|
60
|
+
|---|---|
|
|
61
|
+
| Reference images | Align style and character details (with rights confirmed) |
|
|
62
|
+
| Wardrobe / prop list | Populates asset rows for `asset-discovery` |
|
|
63
|
+
| Existing asset notes | Flags reuse candidates for discovery |
|
|
64
|
+
|
|
65
|
+
### Assumptions to confirm
|
|
66
|
+
- Single subject only (multi-character ensembles are out of scope).
|
|
67
|
+
- Likeness rights are confirmed for any real person depicted.
|
|
68
|
+
- Style is consistent across subject, wardrobe, and background.
|
|
69
|
+
- Planning-only output: runtime stays `Not Run` and artifacts stay `Not Produced`.
|
|
70
|
+
|
|
71
|
+
## Output schema
|
|
72
|
+
|
|
73
|
+
### Primary output
|
|
74
|
+
A structured single-subject character portrait plan covering: Subject identity, Likeness rights status, Pose / expression, Wardrobe, Framing, Lighting, Background, and an Assumptions register.
|
|
75
|
+
|
|
76
|
+
### Secondary output
|
|
77
|
+
- asset rows flagged for `asset-discovery`
|
|
78
|
+
- deep-dive handoffs to `camera-composition` (framing) and `lighting-material-plan` (lookdev)
|
|
79
|
+
- validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness`
|
|
80
|
+
- explicit `Runtime status: Not Run` and `Artifact status: Not Produced` labels
|
|
81
|
+
|
|
82
|
+
### Evidence / caveat output
|
|
83
|
+
|
|
84
|
+
```txt
|
|
85
|
+
Runtime status: Not Run | Attempted | Produced | Verified | Failed
|
|
86
|
+
Artifact status: Not Produced | Produced | Verified | Failed
|
|
87
|
+
Evidence used: <links, paths, logs, or "none">
|
|
88
|
+
Limitations: <known gaps>
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Required laws
|
|
92
|
+
- `../../laws/evidence-before-done.md`
|
|
93
|
+
- `../../laws/non-blender-user-language.md`
|
|
94
|
+
- `../../laws/no-arbitrary-python-interface.md`
|
|
95
|
+
- `../../laws/official-runtime-only.md`
|
|
96
|
+
|
|
97
|
+
## Official runtime boundary
|
|
98
|
+
|
|
99
|
+
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`.
|
|
100
|
+
|
|
101
|
+
## Operating procedure
|
|
102
|
+
1. Read the brief from `intent-to-3d-brief-writer` and verify single-subject portrait scope.
|
|
103
|
+
2. Check if the subject is a real person; require confirmed likeness rights before proceeding.
|
|
104
|
+
3. Fill subject identity, pose, expression, and wardrobe sections.
|
|
105
|
+
4. Define portrait framing, lighting intent, and background intent without overclaiming rendered results.
|
|
106
|
+
5. Record all open assumptions in the assumptions register.
|
|
107
|
+
6. List required assets and hand off asset rows to `asset-discovery`.
|
|
108
|
+
7. Hand off camera/framing deep-dives to `camera-composition` and lookdev deep-dives to `lighting-material-plan`.
|
|
109
|
+
8. Emit validation handoffs to `composition-quality-checker`, `lighting-quality-checker`, and `scene-readiness` with `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
110
|
+
|
|
111
|
+
## Decision tree
|
|
112
|
+
|
|
113
|
+
```txt
|
|
114
|
+
More than one character, or focus is a product / place / room?
|
|
115
|
+
→ Stop; route to product-hero-scene-planner, environment-shot, or interior-scene
|
|
116
|
+
Subject is a real person without confirmed likeness rights?
|
|
117
|
+
→ Stop (Fail); require likeness rights confirmation before use
|
|
118
|
+
Subject is identifiable real person?
|
|
119
|
+
→ Add Warn for likeness rights + reference image needed
|
|
120
|
+
Pose unclear?
|
|
121
|
+
→ Hand off to intent-to-3d-brief-writer
|
|
122
|
+
Framing close-up but lens 18mm?
|
|
123
|
+
→ Warn (likely distortion); propose 50–85mm
|
|
124
|
+
Background detailed but framing tight close-up?
|
|
125
|
+
→ Warn (background mostly out of frame; simplify)
|
|
126
|
+
Need detailed camera/framing or lookdev execution plan?
|
|
127
|
+
→ Hand off framing to camera-composition and lookdev to lighting-material-plan
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
## Playbooks
|
|
131
|
+
|
|
132
|
+
### Playbook A: Hero close-up (16:9 web)
|
|
133
|
+
50–85mm equivalent; eyes on upper third; key + soft fill; rim for separation; simple gradient or studio HDRI background.
|
|
134
|
+
|
|
135
|
+
### Playbook B: Editorial 9:16 mobile
|
|
136
|
+
24–35mm; subject head + upper body; environmental story background; mixed warm + cool lighting.
|
|
137
|
+
|
|
138
|
+
### Playbook C: Stylized character mascot
|
|
139
|
+
Style-specific; flat or simplified background; key + bounce; consistent stylization across face + wardrobe.
|
|
140
|
+
|
|
141
|
+
## Mode handling
|
|
142
|
+
|
|
143
|
+
### Text-only mode
|
|
144
|
+
Produce the portrait plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`.
|
|
145
|
+
|
|
146
|
+
### Runtime-ready mode
|
|
147
|
+
Planning-only even when runtime is available downstream: keep `Runtime status: Not Run` and `Artifact status: Not Produced` (downgrade-only, never upgrade), and hand off to downstream planners and checkers.
|
|
148
|
+
|
|
149
|
+
### Blocked runtime mode
|
|
150
|
+
Produce the portrait plan and assumptions register; keep `Runtime status: Not Run` and `Artifact status: Not Produced`, and log blockers under `Limitations`.
|
|
151
|
+
|
|
152
|
+
## Validation checklist
|
|
153
|
+
- [ ] Single-subject portrait scope confirmed
|
|
154
|
+
- [ ] Likeness rights confirmed before use (if real person)
|
|
155
|
+
- [ ] Subject identity, pose, expression, and wardrobe filled
|
|
156
|
+
- [ ] Framing, lighting, and background filled
|
|
157
|
+
- [ ] Assumptions register included
|
|
158
|
+
- [ ] Asset rows flagged for `asset-discovery`
|
|
159
|
+
- [ ] Deep-dive handoffs named (`camera-composition`, `lighting-material-plan`)
|
|
160
|
+
- [ ] Validation handoffs named (`composition-quality-checker`, `lighting-quality-checker`, `scene-readiness`)
|
|
161
|
+
- [ ] `Runtime status: Not Run` and `Artifact status: Not Produced` explicitly set
|
|
162
|
+
|
|
163
|
+
## Pass / Warn / Fail rubric
|
|
164
|
+
|
|
165
|
+
| Verdict | Criteria |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| Pass | All portrait sections and assumptions register complete; likeness rights confirmed (if applicable); truth states locked to `Not Run` / `Not Produced`; downstream handoffs named. |
|
|
168
|
+
| Warn | Minor non-blocking detail open in the assumptions register; asset list partial. |
|
|
169
|
+
| Fail | Multi-character or non-portrait scope; real person used without confirmed likeness rights; missing lighting/framing/assumptions sections; truth states upgraded above `Not Run` / `Not Produced`. |
|
|
170
|
+
|
|
171
|
+
## Failure handling
|
|
172
|
+
- Brief unclear → hand off to `intent-to-3d-brief-writer`.
|
|
173
|
+
- Real person without confirmed likeness rights → block plan and require rights confirmation before use.
|
|
174
|
+
- Framing or lookdev underspecified → hand off deep-dives to `camera-composition` and `lighting-material-plan`.
|
|
175
|
+
- Style inconsistent → flag in assumptions register and require user confirmation.
|
|
176
|
+
|
|
177
|
+
## Troubleshooting
|
|
178
|
+
|
|
179
|
+
| Problem | Response |
|
|
180
|
+
|---|---|
|
|
181
|
+
| Real person reference has no confirmed likeness rights | Stop immediately; require likeness rights confirmation before use. |
|
|
182
|
+
| Stylization clashes between character and wardrobe | Re-lock style in the plan and update rows for `asset-discovery`. |
|
|
183
|
+
| Lighting and background compete with the subject | Hand off lookdev adjustments to `lighting-material-plan`, then validate with `lighting-quality-checker`. |
|
|
184
|
+
|
|
185
|
+
## Best practices
|
|
186
|
+
- Lock style early; revisions are cheap pre-modeling.
|
|
187
|
+
- Pair pose decisions with camera decisions in one row.
|
|
188
|
+
- Always flag assets for `asset-discovery` before committing modeling work.
|
|
189
|
+
|
|
190
|
+
## Good examples
|
|
191
|
+
- "Subject: stylized founder character, single subject (fictional, no real-person likeness). Pose/expression: three-quarter turn, calm smile, direct gaze. Wardrobe: dark knit top. Framing: close-up head-and-shoulders portrait (deep-dive via `camera-composition`). Lighting: soft key, gentle fill, subtle rim for separation (lookdev via `lighting-material-plan`). Background: neutral studio gradient. Assumptions register: single static frame; fictional character; no existing rig. Runtime status: Not Run. Artifact status: Not Produced."
|
|
192
|
+
|
|
193
|
+
## Bad examples
|
|
194
|
+
- "Person looking at camera." — no proportions, lighting, or framing.
|
|
195
|
+
- "Verified ready" — no rendered evidence.
|
|
196
|
+
|
|
197
|
+
## User-facing response template
|
|
198
|
+
|
|
199
|
+
```txt
|
|
200
|
+
Subject identity: <single-subject description>
|
|
201
|
+
Likeness rights: <confirmed | fictional N/A | unconfirmed — BLOCKED>
|
|
202
|
+
Pose / expression: <pose and expression>
|
|
203
|
+
Wardrobe: <wardrobe and props>
|
|
204
|
+
Framing: <portrait framing intent>
|
|
205
|
+
Lighting: <key / fill / rim intent>
|
|
206
|
+
Background: <background intent>
|
|
207
|
+
Assumptions register: <explicit list of assumptions>
|
|
208
|
+
|
|
209
|
+
Assets to discover: <rows for asset-discovery>
|
|
210
|
+
Runtime status: Not Run
|
|
211
|
+
Artifact status: Not Produced
|
|
212
|
+
Evidence used: <links, paths, logs, or "none">
|
|
213
|
+
Limitations: <known gaps>
|
|
214
|
+
Next: asset-discovery | camera-composition | lighting-material-plan | composition-quality-checker | lighting-quality-checker | scene-readiness
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
## Anti-patterns
|
|
218
|
+
- Performing modeling, animation, rendering, or Blender execution inside this skill.
|
|
219
|
+
- Proceeding with a real person's likeness without confirmed rights before use.
|
|
220
|
+
- Upgrading `Runtime status` above `Not Run` or `Artifact status` above `Not Produced`.
|
|
221
|
+
- Blurring boundaries with `product-hero-scene-planner`, `environment-shot`, `interior-scene`, or multi-character ensembles.
|
|
222
|
+
- Bypassing `camera-composition` (framing) or `lighting-material-plan` (lookdev).
|
|
223
|
+
|
|
224
|
+
## Cross-skill handoff
|
|
225
|
+
<!-- blendops:generated:start handoffs -->
|
|
226
|
+
- [upstream_reference] Upstream brief → `../intent-to-3d-brief-writer/SKILL.md`
|
|
227
|
+
- [progression] Framing deep-dive → `../camera-composition/SKILL.md`
|
|
228
|
+
- [progression] Lookdev deep-dive → `../lighting-material-plan/SKILL.md`
|
|
229
|
+
- [upstream_reference] Asset discovery → `../asset-discovery/SKILL.md`
|
|
230
|
+
- [progression] Composition validation → `../composition-quality-checker/SKILL.md`
|
|
231
|
+
- [progression] Lighting validation → `../lighting-quality-checker/SKILL.md`
|
|
232
|
+
- [progression] Scene quality validation → `../scene-readiness/SKILL.md`
|
|
233
|
+
<!-- blendops:generated:end handoffs -->
|
|
234
|
+
|
|
235
|
+
## Non-goals
|
|
236
|
+
- Model the character.
|
|
237
|
+
- Animate the character.
|
|
238
|
+
- Render.
|
|
239
|
+
- Run Blender.
|
|
240
|
+
|
|
241
|
+
## References
|
|
242
|
+
- `references/portrait-framing-rules.md`
|
|
243
|
+
- `references/portrait-lighting-patterns.md`
|
|
244
|
+
- `references/style-consistency-rules.md`
|
|
245
|
+
- `../../docs/skill-system.md`
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../../schemas/skill-contract.schema.json",
|
|
3
|
+
"id": "character-portrait",
|
|
4
|
+
"version": "1.0.0",
|
|
5
|
+
"category": "scene-planners",
|
|
6
|
+
"role": "character-portrait-and-turntable-architect",
|
|
7
|
+
"purpose": "Plan a character-portrait scene (subject, pose, expression, wardrobe, framing, lighting, background) before any modeling or render attempt.",
|
|
8
|
+
"capabilityTier": "L0",
|
|
9
|
+
"triggers": [
|
|
10
|
+
"portrait of",
|
|
11
|
+
"character looking at the camera",
|
|
12
|
+
"headshot",
|
|
13
|
+
"hero shot of [person / mascot / creature]"
|
|
14
|
+
],
|
|
15
|
+
"exclusions": [
|
|
16
|
+
{
|
|
17
|
+
"condition": "product hero scenes",
|
|
18
|
+
"delegateTo": "product-hero-scene-planner",
|
|
19
|
+
"reason": "use product-hero-scene-planner"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"condition": "environment establishing shots",
|
|
23
|
+
"delegateTo": "environment-shot",
|
|
24
|
+
"reason": "use environment-shot"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"condition": "interior arch viz",
|
|
28
|
+
"delegateTo": "interior-scene",
|
|
29
|
+
"reason": "use interior-scene"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"condition": "multi-character ensemble (this skill is single-subject)",
|
|
33
|
+
"delegateTo": "intent-to-3d-brief-writer",
|
|
34
|
+
"reason": "this skill is single-subject"
|
|
35
|
+
}
|
|
36
|
+
],
|
|
37
|
+
"inputs": {
|
|
38
|
+
"required": [
|
|
39
|
+
{
|
|
40
|
+
"name": "locked_3d_brief",
|
|
41
|
+
"type": "object",
|
|
42
|
+
"description": "Locked 3D brief specifying character subject, expression/pose, and framing intent"
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "character_asset_posture",
|
|
46
|
+
"type": "object",
|
|
47
|
+
"description": "Available character model/rig status and material readiness from asset discovery"
|
|
48
|
+
}
|
|
49
|
+
],
|
|
50
|
+
"optional": [
|
|
51
|
+
{
|
|
52
|
+
"name": "turntable_or_still_preference",
|
|
53
|
+
"type": "string",
|
|
54
|
+
"description": "Whether the deliverable is a portrait still, bust turntable, or full-body pose"
|
|
55
|
+
}
|
|
56
|
+
]
|
|
57
|
+
},
|
|
58
|
+
"outputs": {
|
|
59
|
+
"primary": [
|
|
60
|
+
"character_staging_and_pose_plan",
|
|
61
|
+
"eyeline_and_portrait_camera_anchors",
|
|
62
|
+
"skin_hair_rim_lighting_hooks"
|
|
63
|
+
],
|
|
64
|
+
"truthStatePolicy": {
|
|
65
|
+
"runtimeDefault": "Not Run",
|
|
66
|
+
"artifactDefault": "Not Produced",
|
|
67
|
+
"mutationRule": "downgrade_only"
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
"handoffs": [
|
|
71
|
+
{
|
|
72
|
+
"target": "intent-to-3d-brief-writer",
|
|
73
|
+
"type": "upstream_reference",
|
|
74
|
+
"label": "Upstream brief",
|
|
75
|
+
"when": {
|
|
76
|
+
"all": [
|
|
77
|
+
{
|
|
78
|
+
"field": "goal.clarity",
|
|
79
|
+
"operator": "equals",
|
|
80
|
+
"value": "clear"
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"field": "brief.locked",
|
|
84
|
+
"operator": "equals",
|
|
85
|
+
"value": false
|
|
86
|
+
}
|
|
87
|
+
]
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"target": "camera-composition",
|
|
92
|
+
"type": "progression",
|
|
93
|
+
"label": "Framing deep-dive",
|
|
94
|
+
"when": {
|
|
95
|
+
"all": [
|
|
96
|
+
{
|
|
97
|
+
"field": "brief.locked",
|
|
98
|
+
"operator": "equals",
|
|
99
|
+
"value": true
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"field": "stage.current",
|
|
103
|
+
"operator": "equals",
|
|
104
|
+
"value": "camera_planning"
|
|
105
|
+
}
|
|
106
|
+
]
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
{
|
|
110
|
+
"target": "lighting-material-plan",
|
|
111
|
+
"type": "progression",
|
|
112
|
+
"label": "Lookdev deep-dive",
|
|
113
|
+
"when": {
|
|
114
|
+
"all": [
|
|
115
|
+
{
|
|
116
|
+
"field": "brief.locked",
|
|
117
|
+
"operator": "equals",
|
|
118
|
+
"value": true
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
"field": "stage.current",
|
|
122
|
+
"operator": "equals",
|
|
123
|
+
"value": "lookdev_planning"
|
|
124
|
+
}
|
|
125
|
+
]
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"target": "asset-discovery",
|
|
130
|
+
"type": "upstream_reference",
|
|
131
|
+
"label": "Asset discovery",
|
|
132
|
+
"when": {
|
|
133
|
+
"all": [
|
|
134
|
+
{
|
|
135
|
+
"field": "brief.locked",
|
|
136
|
+
"operator": "equals",
|
|
137
|
+
"value": true
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"field": "assets.discoveryComplete",
|
|
141
|
+
"operator": "equals",
|
|
142
|
+
"value": false
|
|
143
|
+
}
|
|
144
|
+
]
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
"target": "composition-quality-checker",
|
|
149
|
+
"type": "progression",
|
|
150
|
+
"label": "Composition validation",
|
|
151
|
+
"when": {
|
|
152
|
+
"all": [
|
|
153
|
+
{
|
|
154
|
+
"field": "quality.domain",
|
|
155
|
+
"operator": "equals",
|
|
156
|
+
"value": "composition"
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"field": "quality.verdict",
|
|
160
|
+
"operator": "equals",
|
|
161
|
+
"value": "not_run"
|
|
162
|
+
}
|
|
163
|
+
]
|
|
164
|
+
}
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"target": "lighting-quality-checker",
|
|
168
|
+
"type": "progression",
|
|
169
|
+
"label": "Lighting validation",
|
|
170
|
+
"when": {
|
|
171
|
+
"all": [
|
|
172
|
+
{
|
|
173
|
+
"field": "quality.domain",
|
|
174
|
+
"operator": "equals",
|
|
175
|
+
"value": "lighting"
|
|
176
|
+
},
|
|
177
|
+
{
|
|
178
|
+
"field": "quality.verdict",
|
|
179
|
+
"operator": "equals",
|
|
180
|
+
"value": "not_run"
|
|
181
|
+
}
|
|
182
|
+
]
|
|
183
|
+
}
|
|
184
|
+
},
|
|
185
|
+
{
|
|
186
|
+
"target": "scene-readiness",
|
|
187
|
+
"type": "progression",
|
|
188
|
+
"label": "Scene quality validation",
|
|
189
|
+
"when": {
|
|
190
|
+
"all": [
|
|
191
|
+
{
|
|
192
|
+
"field": "quality.domain",
|
|
193
|
+
"operator": "equals",
|
|
194
|
+
"value": "holistic"
|
|
195
|
+
},
|
|
196
|
+
{
|
|
197
|
+
"field": "stage.current",
|
|
198
|
+
"operator": "equals",
|
|
199
|
+
"value": "quality_validation"
|
|
200
|
+
}
|
|
201
|
+
]
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
]
|
|
205
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Portrait framing rules
|
|
2
|
+
|
|
3
|
+
## Lens / focal length per framing
|
|
4
|
+
|
|
5
|
+
| Framing | Equivalent focal length | Distance |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Tight close-up (face only) | 85–135mm | 1.5–2.5m |
|
|
8
|
+
| Close-up (head + shoulders) | 50–85mm | 1.5–2m |
|
|
9
|
+
| Medium (head to waist) | 35–50mm | 2–3m |
|
|
10
|
+
| Wide (full body) | 24–35mm | 3–5m |
|
|
11
|
+
| Environmental portrait (subject in space) | 18–35mm | 4m+ |
|
|
12
|
+
|
|
13
|
+
Wider lenses on close-ups distort facial proportions. Avoid 16–18mm for any tight portrait.
|
|
14
|
+
|
|
15
|
+
## Eye-line placement
|
|
16
|
+
|
|
17
|
+
- Tight close-up: eyes upper third (rule of thirds top line)
|
|
18
|
+
- Close-up: eyes upper third
|
|
19
|
+
- Medium / wide: eyes upper third or upper half
|
|
20
|
+
- Environmental: eyes anywhere; subject placement matters more
|
|
21
|
+
|
|
22
|
+
## Subject placement
|
|
23
|
+
|
|
24
|
+
| Mood | Placement |
|
|
25
|
+
|---|---|
|
|
26
|
+
| Confident hero (centered or right-third for negative space CTA) | Right-third |
|
|
27
|
+
| Editorial documentary | Off-center, gaze leads into negative space |
|
|
28
|
+
| Symmetric brand portrait | Centered |
|
|
29
|
+
| Cinematic narrative | Variable; depth cues drive placement |
|
|
30
|
+
|
|
31
|
+
## Aspect-specific notes
|
|
32
|
+
|
|
33
|
+
- 16:9: room for headline / CTA on opposite side of subject; use right-third.
|
|
34
|
+
- 1:1: subject fills frame; minimal negative space.
|
|
35
|
+
- 9:16: subject upper third; lower third reserved for caption / CTA.
|
|
36
|
+
- 2.39:1: subject off-center; horizontal negative space tells story.
|
|
37
|
+
|
|
38
|
+
## Related skill
|
|
39
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Portrait lighting patterns
|
|
2
|
+
|
|
3
|
+
## Standard 3-point (default for hero / editorial)
|
|
4
|
+
|
|
5
|
+
- **Key**: 50–500W area light, 45° from camera, slightly above subject eye-line. Soft size 0.4–1.0m for soft hero; 0.1–0.3m for harder editorial.
|
|
6
|
+
- **Fill**: 10–20% of key strength, opposite side of subject, larger soft size.
|
|
7
|
+
- **Rim**: 50–100W spot or area, behind subject 135° from camera, separates subject from background.
|
|
8
|
+
|
|
9
|
+
## Rembrandt (editorial / dramatic)
|
|
10
|
+
|
|
11
|
+
- Key at 45° creating triangle of light on shadow-side cheek.
|
|
12
|
+
- Minimal fill; shadow-side is darker.
|
|
13
|
+
- Rim optional.
|
|
14
|
+
- Mood: classic, painterly, contemplative.
|
|
15
|
+
|
|
16
|
+
## Butterfly (beauty / glamour)
|
|
17
|
+
|
|
18
|
+
- Key directly in front of subject, slightly above; soft.
|
|
19
|
+
- Fill from below to lift shadows under chin.
|
|
20
|
+
- Rim optional.
|
|
21
|
+
- Mood: glamorous, polished.
|
|
22
|
+
|
|
23
|
+
## Split (dramatic / mystery)
|
|
24
|
+
|
|
25
|
+
- Key 90° to one side; one half of face lit, other half in shadow.
|
|
26
|
+
- Minimal fill.
|
|
27
|
+
- Mood: noir, character study.
|
|
28
|
+
|
|
29
|
+
## Loop (versatile portrait)
|
|
30
|
+
|
|
31
|
+
- Key just off-center, slightly above; small loop shadow from nose.
|
|
32
|
+
- Fill subordinate.
|
|
33
|
+
- Rim optional.
|
|
34
|
+
- Mood: friendly, accessible.
|
|
35
|
+
|
|
36
|
+
## HDRI use in portraits
|
|
37
|
+
|
|
38
|
+
- Studio HDRI 0.5–1.0 for ambient + ground reflection.
|
|
39
|
+
- Outdoor HDRI 0.7–1.5 for environmental context.
|
|
40
|
+
- Avoid HDRI alone for hero portraits — explicit key light gives the snap that HDRI alone lacks.
|
|
41
|
+
|
|
42
|
+
## Background
|
|
43
|
+
|
|
44
|
+
- Solid color seamless: cleanest hero look.
|
|
45
|
+
- Gradient: subtle depth.
|
|
46
|
+
- Studio backdrop with subtle texture: editorial.
|
|
47
|
+
- Environmental: storytelling but ensure subject still reads.
|
|
48
|
+
|
|
49
|
+
## Related skill
|
|
50
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Style consistency rules
|
|
2
|
+
|
|
3
|
+
A character portrait reads as broken if the subject, wardrobe, props, and background do not share the same stylization. Lock style early.
|
|
4
|
+
|
|
5
|
+
## Style axes
|
|
6
|
+
|
|
7
|
+
- **Realism**: photorealistic ↔ stylized ↔ flat / cartoon
|
|
8
|
+
- **Detail density**: high (PBR + micro-detail) ↔ medium ↔ low (stylized)
|
|
9
|
+
- **Color treatment**: natural ↔ graded ↔ stylized palette
|
|
10
|
+
- **Surface complexity**: realistic textures ↔ painterly ↔ flat color blocks
|
|
11
|
+
|
|
12
|
+
## Per-axis decision
|
|
13
|
+
|
|
14
|
+
For each axis, lock one position and apply across:
|
|
15
|
+
1. Subject skin / face
|
|
16
|
+
2. Subject hair
|
|
17
|
+
3. Wardrobe
|
|
18
|
+
4. Props
|
|
19
|
+
5. Background / environment
|
|
20
|
+
|
|
21
|
+
## Common consistency failures
|
|
22
|
+
|
|
23
|
+
- Photoreal subject + stylized cartoon background → reads as compositing error.
|
|
24
|
+
- Stylized subject + PBR wardrobe with detailed materials → wardrobe upstages subject.
|
|
25
|
+
- Mix of realistic + flat-color props in the same hand → distracting.
|
|
26
|
+
- Background more detailed than subject → eye reads background first.
|
|
27
|
+
|
|
28
|
+
## Color harmony
|
|
29
|
+
|
|
30
|
+
- Subject's primary palette → wardrobe accents → background ambient color → prop color.
|
|
31
|
+
- Use a 60-30-10 distribution (dominant / secondary / accent).
|
|
32
|
+
- Verify against `composition-quality-checker` hierarchy rules.
|
|
33
|
+
|
|
34
|
+
## Verdicts
|
|
35
|
+
|
|
36
|
+
- Pass: all 5 elements share style axis position.
|
|
37
|
+
- Warn: one element drifts (e.g. wardrobe slightly more realistic than subject).
|
|
38
|
+
- Fail: clear mix of realism + stylized (subject photoreal, props flat color block).
|
|
39
|
+
|
|
40
|
+
## Related skill
|
|
41
|
+
`../SKILL.md`
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# EVAL — cli-appendix-job-outline
|
|
2
|
+
|
|
3
|
+
## Text-only eval prompt
|
|
4
|
+
|
|
5
|
+
CI must nightly export GLBs from `.blend` files on Linux agents without MCP. Outline job.
|
|
6
|
+
|
|
7
|
+
## Expected behavior
|
|
8
|
+
|
|
9
|
+
- CLI appendix framing + first-class upstream mention + no in-repo BlendOps evidence claim
|
|
10
|
+
- Phases: background startup, load file, export, verify output path logging
|
|
11
|
+
- Stateless limits noted
|
|
12
|
+
- Hand off to render-export-evidence for ledger expectations
|
|
13
|
+
|
|
14
|
+
## Pass / Warn / Fail criteria
|
|
15
|
+
|
|
16
|
+
- Pass: phases + hook points + doc pointer
|
|
17
|
+
- Warn: GPU ambiguity
|
|
18
|
+
- Fail: drops evidence discipline
|
|
19
|
+
|
|
20
|
+
## Sample passing response outline
|
|
21
|
+
|
|
22
|
+
- Numbered phases + caution banner
|
|
23
|
+
|
|
24
|
+
## Sample failing response outline
|
|
25
|
+
|
|
26
|
+
- Paste 200-line script as "the solution"
|