Skip to content

anbeime/skill / skills/img2threejs/img2threejs

img2threejs

Verified

Turn an object or character reference image into a quality-gated, animation-ready procedural Three.js model built in code. Use for image-to-3D reconstruction, detail-accurate object rebuilds, stylized/likeness-maximized human characters, sculpt specs, and staged code generation.

FileKindSize
.github/FUNDING.ymlconfig94 B
.github/ISSUE_TEMPLATE/bug_report.ymlconfig2.3 KB
.github/ISSUE_TEMPLATE/contribution_intent.ymlconfig1.8 KB
.github/ISSUE_TEMPLATE/feature_request.ymlconfig1.4 KB
.github/pull_request_template.mdmarkdown1.1 KB
.github/release.ymlconfig471 B
.github/workflows/beta-release.ymlconfig1.9 KB
.github/workflows/ci.ymlconfig349 B
.github/workflows/issue-triage.ymlconfig783 B
.github/workflows/pr-issue-close-policy.ymlconfig279 B
.github/workflows/release.ymlconfig625 B
.gitignoreother2.4 KB
CHANGELOG.mdmarkdown33.1 KB
CLAUDE.mdmarkdown2.8 KB
CONTRIBUTING.mdmarkdown4.7 KB
LAB-FINDINGS.mdmarkdown5.7 KB
LICENSEother11.1 KB
README.mdmarkdown38.9 KB
ROADMAP.mdmarkdown16.3 KB
SKILL.mdskill md30.8 KB
assets/logo.svgother2.0 KB
assets/sponsors/atlas-cloud-logomark-black.svgother595 B
assets/sponsors/atlas-cloud-logomark-white.svgother595 B
assets/sponsors/hyper3d-logomark-black.pngbinary1.1 KB
assets/sponsors/hyper3d-logomark-white.pngbinary1.2 KB
assets/sponsors/tripo-logomark-black.svgother1002 B
assets/sponsors/tripo-logomark-white.svgother1002 B
docs/ARCHITECTURE.mdmarkdown14.0 KB
docs/GLB_ANIMATED_CHARACTER_PROMPT.mdmarkdown13.1 KB
docs/GLB_CHARACTER_ANIMATION_PROMPT.mdmarkdown14.6 KB
docs/GLB_CHARACTER_POLISH_PROMPT.mdmarkdown10.6 KB
docs/GLB_CHARACTER_PROMPT.mdmarkdown19.1 KB
docs/HAIR_PIPELINE.mdmarkdown10.5 KB
docs/RESEARCH_TRELLIS2_TO_IMG2THREEJS.mdmarkdown35.4 KB
docs/STAGE_R_BACKLOG.mdmarkdown18.0 KB
docs/STAGE_R_TEST_PLAN.mdmarkdown14.0 KB
docs/TOKEN_COST.mdmarkdown2.5 KB
docs/UPGRADE_PLAN.mdmarkdown30.4 KB
docs/cs2-anatomy/gloves.mdmarkdown11.6 KB
docs/cs2-anatomy/heavy.mdmarkdown13.8 KB
docs/cs2-anatomy/knives.mdmarkdown18.2 KB
docs/cs2-anatomy/pistols.mdmarkdown12.0 KB
docs/cs2-anatomy/rifles.mdmarkdown13.1 KB
docs/cs2-anatomy/smgs.mdmarkdown13.4 KB
docs/cs2-anatomy/snipers.mdmarkdown13.8 KB
docs/cs2/3D_Technical_Mapping.jsonconfig10.6 KB
docs/cs2/3D_Technical_Reference.mdmarkdown22.2 KB
docs/cs2/3D_Vocabulary_CS2.jsonconfig10.0 KB
docs/cs2/3D_Vocabulary_CS2_Dictionary.mdmarkdown26.6 KB
docs/cs2/distill.mdmarkdown9.9 KB
docs/cs2/review-gates.mdmarkdown2.5 KB
docs/integrations/reference_fidelity_tooling.mdmarkdown6.2 KB
docs/issue-triage.mdmarkdown1.8 KB
docs/materials/IMAGE_MATERIAL_ANALYSIS.mdmarkdown5.0 KB
docs/materials/README.mdmarkdown5.2 KB
docs/materials/THREEJS_MATERIAL_REFERENCE.mdmarkdown11.4 KB
docs/materials/material-reference.jsonconfig55.0 KB
docs/pipelines/character-rigging-animation-1.5.2.mdmarkdown22.3 KB
docs/raw/.keepother0 B
docs/raw/img2threejs-skill-dataset.jsonconfig107.3 KB
docs/specs/render-profile.v2.example.jsonconfig2.6 KB
docs/specs/render-profile.v2.schema.jsonconfig3.8 KB
docs/specs/vocabulary/README.mdmarkdown4.4 KB
docs/specs/vocabulary/core_3d.jsonlother13.2 KB
docs/specs/vocabulary/core_3d_reconstruction.jsonlother56.1 KB
docs/specs/vocabulary/cs2.jsonlother7.1 KB
docs/specs/vocabulary/cs2_reconstruction.jsonlother85.7 KB
docs/standard-prompts/README.mdmarkdown2.2 KB
docs/standard-prompts/build.mdmarkdown5.2 KB
docs/standard-prompts/glb-force-measured.mdmarkdown8.6 KB
docs/standard-prompts/polish.mdmarkdown2.7 KB
docs/standard-prompts/vfx.mdmarkdown5.7 KB
forge/_shared/artifact_cache.pyscript1.7 KB
forge/_shared/chirality.pyscript12.1 KB
forge/_shared/color_metrics.pyscript3.6 KB
forge/_shared/feature_acceptance_policy.pyscript4.2 KB
forge/_shared/image_hash.pyscript4.0 KB
forge/_shared/jpeg.pyscript16.0 KB
forge/_shared/material_physics.pyscript12.2 KB
forge/_shared/pipeline_routing.pyscript7.0 KB
forge/_shared/scalp_field.pyscript14.3 KB
forge/_shared/sdf_primitives.pyscript8.3 KB
forge/_shared/spec_search.pyscript61.9 KB
forge/_shared/spec_search_profiles.jsonconfig1.4 KB
forge/_shared/status_banner.pyscript1.4 KB
forge/_shared/subdivision.pyscript10.5 KB
forge/_shared/vertex_paint.pyscript10.8 KB
forge/_shared/workflow_state.pyscript20.5 KB
forge/materials/__init__.pyscript355 B
forge/materials/compatibility.pyscript5.1 KB
forge/materials/reference.pyscript10.2 KB
forge/next.pyscript4.4 KB
forge/report.pyscript1.5 KB
forge/requirements.txtmanifest335 B
forge/stage1_intake/analyze_texture.pyscript12.1 KB
forge/stage1_intake/bind_detail_properties.pyscript4.6 KB
forge/stage1_intake/build_detail_inventory.pyscript13.0 KB
forge/stage1_intake/camera_fitting_math.pyscript5.5 KB
forge/stage1_intake/camera_fitting_solver.pyscript8.2 KB
forge/stage1_intake/camera_fitting_types.pyscript8.2 KB
forge/stage1_intake/camera_image_helpers.pyscript6.0 KB
forge/stage1_intake/check_intake_correctness.pyscript4.8 KB
forge/stage1_intake/check_reference_admission.pyscript7.6 KB
forge/stage1_intake/cs2_foundation.pyscript7.9 KB
forge/stage1_intake/cs2_manifest.pyscript10.5 KB
forge/stage1_intake/cs2_review_contract.pyscript1.7 KB
forge/stage1_intake/delight_albedo.pyscript14.2 KB
forge/stage1_intake/detect_cs2.pyscript9.7 KB
forge/stage1_intake/detect_reference_effects.pyscript8.9 KB
forge/stage1_intake/extract_cs2_textures.pyscript5.6 KB
forge/stage1_intake/extract_gradient_stops.pyscript5.8 KB
forge/stage1_intake/extract_hair_evidence.pyscript18.6 KB
forge/stage1_intake/extract_landmarks.pyscript16.0 KB
forge/stage1_intake/extract_part_color_recipe.pyscript20.8 KB
forge/stage1_intake/extract_pbr_evidence.pyscript32.5 KB
forge/stage1_intake/fetch_cs2_metadata.pyscript6.4 KB
forge/stage1_intake/label_glb_nodes.pyscript13.0 KB
forge/stage1_intake/locate_cs2_vpk.pyscript2.6 KB
forge/stage1_intake/material_region_analysis.pyscript9.8 KB
forge/stage1_intake/probe_glb.pyscript15.0 KB
forge/stage1_intake/probe_image.pyscript5.4 KB
forge/stage1_intake/run_vision_adapter.pyscript1.6 KB
forge/stage1_intake/search_specs.pyscript7.5 KB
forge/stage1_intake/semantic_decomposition.pyscript4.5 KB
forge/stage1_intake/solve_camera_pose.pyscript10.7 KB
forge/stage2_spec/apply_material_analysis.pyscript8.6 KB
forge/stage2_spec/cs2_adapters.pyscript3.0 KB
forge/stage2_spec/derive_geometry.pyscript4.3 KB
forge/stage2_spec/hair_profile.pyscript14.5 KB
forge/stage2_spec/humanoid_proportions.pyscript9.0 KB
forge/stage2_spec/new_pre_spec_assessment.pyscript12.1 KB
forge/stage2_spec/new_sculpt_spec.pyscript127.4 KB
forge/stage2_spec/validate_sculpt_spec.pyscript144.5 KB
forge/stage3_build/bake_projected_texture.pyscript8.8 KB
forge/stage3_build/decimate.pyscript10.4 KB
forge/stage3_build/generate_threejs_factory.pyscript207.6 KB
forge/stage3_build/module_cache.pyscript5.6 KB
forge/stage3_build/morph_targets.pyscript7.3 KB
forge/stage3_build/orchestrate_passes.pyscript27.6 KB
forge/stage3_build/uv_unwrap.pyscript24.7 KB
forge/stage3_build/visual_hull.pyscript16.4 KB
forge/stage4_review/_fit_divine_eye.pyscript2.6 KB
forge/stage4_review/append_review.pyscript20.4 KB
forge/stage4_review/attachment_anchor.pyscript16.2 KB
forge/stage4_review/calibrate_eye.pyscript5.4 KB
forge/stage4_review/check_part_coverage.pyscript13.1 KB
forge/stage4_review/compare_region_passes.pyscript7.6 KB
forge/stage4_review/correction_loop.pyscript10.2 KB
forge/stage4_review/cs2_review.pyscript8.7 KB
forge/stage4_review/diagnose_render.pyscript15.5 KB
forge/stage4_review/diagnose_render_multi_angle.pyscript5.6 KB
forge/stage4_review/divine_eye.pyscript21.0 KB
forge/stage4_review/fit_params.pyscript16.6 KB
forge/stage4_review/geometry_integrity.pyscript15.1 KB
forge/stage4_review/hair_gate.pyscript9.5 KB
forge/stage4_review/interior_difference.pyscript7.8 KB
forge/stage4_review/joint_loops.pyscript8.2 KB
forge/stage4_review/make_comparison_sheet.pyscript10.9 KB
forge/stage4_review/material_comparator.pyscript7.9 KB
forge/stage4_review/material_feedback.pyscript6.7 KB
forge/stage4_review/material_gate.pyscript5.8 KB
forge/stage4_review/material_views.pyscript7.5 KB
forge/stage4_review/mesh_reference_compare.pyscript16.2 KB
forge/stage4_review/multi_pass.pyscript3.1 KB
forge/stage4_review/objectness.pyscript5.4 KB
forge/stage4_review/pairwise_penetration.pyscript16.2 KB
forge/stage4_review/per_feature.pyscript6.8 KB
forge/stage4_review/render_bridge.pyscript24.1 KB
forge/stage4_review/scalp_exposure.pyscript11.5 KB
forge/stage4_review/self_intersection.pyscript26.3 KB
forge/stage4_review/swept_arc_gate.pyscript14.3 KB
forge/stage4_review/turntable_gate.pyscript17.6 KB
forge/stage4_review/validate_render_profile.pyscript8.9 KB
forge/stage4_review/vertex_region_gate.pyscript20.3 KB
forge/stage4_review/vlm_gate.pyscript8.8 KB
forge/stage5_rig/CONTRACT_1.5.2.mdmarkdown3.6 KB
forge/stage5_rig/NOTES.mdmarkdown8.5 KB
forge/stage5_rig/__init__.pyscript302 B
forge/stage5_rig/action_design.pyscript88.2 KB
forge/stage5_rig/clip_features.pyscript33.2 KB
forge/stage5_rig/emit_animation_runtime.pyscript17.7 KB
forge/stage5_rig/emit_rig.pyscript17.6 KB
forge/stage5_rig/geodesic_skinning.pyscript23.0 KB
forge/stage5_rig/glb_rig_reference.pyscript58.8 KB
forge/stage5_rig/mesh_parity.pyscript36.7 KB
forge/stage5_rig/rig_gates.pyscript78.7 KB
forge/stage5_rig/rig_spec.pyscript6.4 KB
forge/stage5_rig/skin_conditioning.pyscript25.9 KB
forge/stage5_rig/validate_rig_payload.pyscript8.8 KB
forge/state.pyscript3.5 KB
forge/tests/fixtures/implicit_character_torso_limb.jsonconfig1.4 KB
forge/tests/fixtures/knife_review_scene.jsonconfig1.3 KB
forge/tests/fixtures/stand_proud_hair_on_head.jsonconfig3.0 KB
forge/tests/fixtures/subdivision_cage.jsonconfig812 B
forge/tests/fixtures/visual_hull_two_views.jsonconfig2.6 KB
forge/tests/showcase_test_support.pyscript698 B
forge/tests/test_action_design.pyscript37.3 KB
forge/tests/test_albedo_color_space.pyscript4.6 KB
forge/tests/test_analyze_texture.pyscript6.0 KB
forge/tests/test_attachment_anchor.pyscript8.2 KB

forge/_shared/material_physics.py

View on GitHub
#!/usr/bin/env python3
"""What three.js actually does with a material value, as code rather than as a comment.

WHY THIS MODULE EXISTS. A material number can be authored, validated, emitted, rendered -- and still
never reach a pixel, because the engine gates it behind another value, clamps it, adds to it, or folds
it into a different uniform. None of that is on the docs page. All of it is in the source, and every
constant below cites the file:line in `three@0.169.0` it came from.

The two failure modes this prevents:

    AUTHORING A VALUE THE ENGINE IGNORES.  `sheen: 0.65` with three's default `sheenColor` of
                                           0x000000 contributes exactly zero, because the sheen term
                                           is `sheenColor * (D * V)` -- a multiply by black.

    EXPOSING ONE DEGREE OF FREEDOM TWICE.  `sheen` and `sheenColor` are multiplied together before
                                           upload, so `sheen 1.0 / #808080` is bit-identical to
                                           `sheen 0.5 / #ffffff`. Extracting both from a reference as
                                           independent evidence extracts the same number twice and
                                           produces priors that contradict each other on paper while
                                           rendering identically.

Full derivation, with every citation: `grimoire/build/threejs_skin_and_cloth_materials.md`.

Pure Python 3.10+ standard library.
"""
from __future__ import annotations

from typing import Any, Final

# ---------------------------------------------------------------------------------------------
# Engine constants. Each is a measured property of three@0.169.0, not a policy choice.
# ---------------------------------------------------------------------------------------------

THREE_VERSION: Final = "0.169.0"

# `material.clearcoatRoughness = max( clearcoatRoughness, 0.0525 )`
#   ShaderChunk/lights_physical_fragment.glsl.js:72
# Anything below this renders identically to it, so accepting a smaller number as meaningful is
# accepting a value the engine will not honour.
CLEARCOAT_ROUGHNESS_FLOOR: Final = 0.0525

# `float sheenEnergyComp = 1.0 - 0.157 * max3( material.sheenColor );`
# `outgoingLight = outgoingLight * sheenEnergyComp + sheenSpecularDirect + sheenSpecularIndirect;`
#   ShaderLib/meshphysical.glsl.js:205,207
# Turning sheen on DARKENS the diffuse base by this coefficient times the effective sheen strength.
SHEEN_ENERGY_COMPENSATION_COEFFICIENT: Final = 0.157

# `clearcoatF0 = vec3( 0.04 )` -- fixed, not authorable.
#   ShaderChunk/lights_physical_fragment.glsl.js:56
CLEARCOAT_F0: Final = 0.04

# three's own defaults, needed to know when an omitted value is a silent no-op rather than a
# reasonable fallback. MeshPhysicalMaterial.js:52,54 / Material.js:24,25
THREE_DEFAULT_SHEEN_COLOR: Final = "#000000"
THREE_DEFAULT_SHEEN_ROUGHNESS: Final = 1.0
THREE_DEFAULT_SIDE: Final = "FrontSide"

# Properties whose entire uniform block is gated behind the scalar being > 0, and whose crossing of
# zero bumps `material.version` and forces a shader recompile.
#   WebGLMaterials.js:406 (sheen); MeshPhysicalMaterial.js getters for the rest.
ZERO_GATED_FEATURES: Final = frozenset({
    "sheen", "clearcoat", "transmission", "iridescence", "anisotropy", "dispersion",
})

# Pairs the engine collapses into a single degree of freedom. Authoring both as independent
# reference-derived evidence is authoring one number twice.
#   sheen x sheenColor: WebGLMaterials.js:408
#   ior <-> reflectivity: MeshPhysicalMaterial.js:34-44
COLLAPSED_DEGREES_OF_FREEDOM: Final = (
    ("sheen", "sheenColor", "multiplied into one uniform before upload"),
    ("ior", "reflectivity", "reflectivity is a derived accessor over ior"),
)

# Skin's real signature at this fidelity is a broad soft dielectric highlight over a warm diffuse
# base, which is a low-strength mid-roughness clearcoat. `transmission` is a SCREEN-SPACE REFRACTION
# model -- glass, not subsurface -- and on a closed opaque body mesh it produces a glassy figure at
# the cost of an extra render target. The registry states the same limit for skin.human.
SKIN_FORBIDDEN_PROPERTIES: Final = frozenset({"transmission", "thickness", "attenuationDistance"})


def effective_sheen_strength(sheen: float, sheen_color: str | None) -> float:
    """What the engine actually applies, after folding the scalar into the colour.

    `uniforms.sheenColor = sheenColor x sheen` (WebGLMaterials.js:408), and the BRDF multiplies by
    that colour, so the strength that matters is the scalar times the colour's largest channel --
    `max3` is exactly what the energy term reads.
    """
    if sheen <= 0.0:
        return 0.0
    channel = _max_channel(sheen_color if sheen_color is not None else THREE_DEFAULT_SHEEN_COLOR)
    return sheen * channel


def sheen_base_darkening(sheen: float, sheen_color: str | None) -> float:
    """How much the diffuse base is scaled DOWN by enabling sheen, in [0, 0.157].

    This is the number that makes "the garment came out too dark" diagnosable rather than a matter of
    opinion: given the authored sheen, the darkening is known before the render exists.
    """
    return SHEEN_ENERGY_COMPENSATION_COEFFICIENT * effective_sheen_strength(sheen, sheen_color)


def compensated_base_luminance(target: float, sheen: float, sheen_color: str | None) -> float:
    """The base luminance to author so the RENDER matches `target` once sheen has darkened it.

    Returns `target` unchanged when sheen is off, so it is safe to apply unconditionally.
    """
    darkening = sheen_base_darkening(sheen, sheen_color)
    if darkening <= 0.0:
        return target
    return min(1.0, target / (1.0 - darkening))


def _max_channel(color: str) -> float:
    """Largest of r, g, b in [0, 1] for a `#rgb` or `#rrggbb` string. Unparseable -> 0.0.

    Returning 0 rather than raising is deliberate: an unparseable colour cannot be shown to carry
    sheen, and the caller's job here is to detect a no-op, not to validate colour syntax.
    """
    text = str(color).strip().lstrip("#")
    if len(text) == 3:
        text = "".join(ch * 2 for ch in text)
    if len(text) != 6:
        return 0.0
    try:
        channels = [int(text[i:i + 2], 16) / 255.0 for i in (0, 2, 4)]
    except ValueError:
        return 0.0
    return max(channels)


def check_material_physics(
    material_id: str,
    material: dict[str, Any],
    *,
    family: str | None = None,
) -> tuple[list[str], list[str]]:
    """`(errors, warnings)` for one material, judged against what the engine will do with it.

    `family` routes the family-specific rules -- `skin` forbids transmission, and a `fabric` or
    `hair` family that ships no sheen tint has no woven cue at all.
    """
    errors: list[str] = []
    warnings: list[str] = []

    sheen = _number(material.get("sheen"))
    sheen_color = material.get("sheenColor")

    # A no-op, not a subtle mis-tune: the term is a multiply by colour and the default colour is black.
    if sheen is not None and sheen > 0.0:
        if sheen_color is None:
            errors.append(
                f"material {material_id!r} sets sheen {sheen} but no sheenColor. three's default "
                f"sheenColor is {THREE_DEFAULT_SHEEN_COLOR} and the sheen term is a multiply by that "
                f"colour, so this contributes exactly zero. Declare sheenColor."
            )
        elif _max_channel(str(sheen_color)) == 0.0:
            errors.append(
                f"material {material_id!r} sets sheen {sheen} with sheenColor {sheen_color!r}, whose "
                f"channels are all zero, so the sheen term evaluates to zero."
            )
        else:
            darkening = sheen_base_darkening(sheen, str(sheen_color))
            if darkening > 0.0:
                warnings.append(
                    f"quality: material {material_id!r} sheen darkens its own diffuse base by "
                    f"{darkening * 100:.1f}% (sheenEnergyComp). Author the base colour "
                    f"{1.0 / (1.0 - darkening):.3f}x brighter than the reference sample, or the "
                    f"render lands darker than the reference at every non-grazing angle."
                )

    # A value below the clamp is indistinguishable from the clamp, so reporting it as authored is
    # reporting a precision the engine does not have.
    clearcoat_roughness = _number(material.get("clearcoatRoughness"))
    if clearcoat_roughness is not None and 0.0 < clearcoat_roughness < CLEARCOAT_ROUGHNESS_FLOOR:
        warnings.append(
            f"quality: material {material_id!r} clearcoatRoughness {clearcoat_roughness} is below "
            f"three's floor of {CLEARCOAT_ROUGHNESS_FLOOR} and will render as exactly that. Author "
            f"{CLEARCOAT_ROUGHNESS_FLOOR} so the spec says what ships."
        )

    # Both halves of a collapsed pair authored at once: the spec looks richer than it is, and the two
    # numbers can disagree while rendering identically.
    for first, second, why in COLLAPSED_DEGREES_OF_FREEDOM:
        if material.get(first) is not None and material.get(second) is not None:
            if (first, second) == ("ior", "reflectivity"):
                errors.append(
                    f"material {material_id!r} sets both {first} and {second}: {why}. Author {first} "
                    f"only -- it is the physical quantity."
                )
            else:
                warnings.append(
                    f"quality: material {material_id!r} sets both {first} and {second}: {why}. They "
                    f"are one control, so these are not independent evidence."
                )

    normalized_family = (family or material.get("family") or "").lower()

    if normalized_family == "skin":
        for forbidden in sorted(SKIN_FORBIDDEN_PROPERTIES):
            if material.get(forbidden) is not None:
                errors.append(
                    f"material {material_id!r} is family 'skin' and sets {forbidden!r}. transmission "
                    f"is a screen-space refraction (glass) model, not subsurface scattering; on a "
                    f"closed body mesh it renders a glassy figure and costs an extra render target. "
                    f"Use clearcoat over a warm base instead. A thin translucent membrane is a "
                    f"separate component with a separate material, declared as an approximation."
                )

    if normalized_family in {"fabric", "hair"} and (sheen is None or sheen <= 0.0):
        warnings.append(
            f"quality: material {material_id!r} is family {normalized_family!r} but carries no sheen. "
            f"With no textures available, sheen is the whole of the woven or fibre cue this pipeline "
            f"can emit."
        )

    return errors, warnings


def check_open_boundary_sides(component_id: str, component: dict[str, Any]) -> list[str]:
    """A garment shell with an open boundary must render both sides.

    `Material.side` defaults to `FrontSide` (Material.js:24), which culls backfaces. A sleeve, hem or
    collar opening therefore shows a HOLE rather than the inside of the garment: the geometry is
    there, the engine simply does not draw the faces pointing away. Reported as an error because a
    hole at a hem is indistinguishable at a glance from a garment that is too short, and the two want
    completely different fixes.
    """
    garment = component.get("garment")
    if not isinstance(garment, dict):
        return []
    boundaries = garment.get("boundaries")
    if not isinstance(boundaries, list) or not boundaries:
        return []
    has_open = any(
        isinstance(entry, dict) and entry.get("closed") is not True for entry in boundaries
    )
    if not has_open:
        return []
    if str(component.get("side") or THREE_DEFAULT_SIDE) == "FrontSide":
        return [
            f"component {component_id!r} is a garment with an open boundary but leaves side at "
            f"'FrontSide', so backfaces are culled and the opening renders as a hole rather than as "
            f"the inside of the garment. Set side to 'DoubleSide', or author the garment as a closed "
            f"offset volume and mark its boundaries closed."
        ]
    return []


def _number(value: Any) -> float | None:
    if isinstance(value, bool) or not isinstance(value, (int, float)):
        return None
    return float(value)
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 321kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 321kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 321kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 321kUpdated Claude CodeCodexVerifiedInstall