Skip to content

ByteTerrace/Puck / .claude/skills/sdf-authoring

sdf-authoring

Verified

Authors creations: shape rows, primitives, blends, folds, palettes, paints, render lanes, rigs, bake work and bytes, creation stats. Use to sculpt or fix a part. Grammar: puck-dsl; GPU: rendering.

FileKindSize
SKILL.mdskill md28.6 KB
evals/s01-blocky-pauldron/graders/author-frame-kept.mdmarkdown250 B
evals/s01-blocky-pauldron/graders/curvature-from-curved-primitives.mdmarkdown180 B
evals/s01-blocky-pauldron/graders/edge-operation.mdmarkdown124 B
evals/s01-blocky-pauldron/graders/names-the-checks.mdmarkdown74 B
evals/s01-blocky-pauldron/graders/shape-count.mdmarkdown188 B
evals/s01-blocky-pauldron/graders/skill-fired.mdmarkdown36 B
evals/s01-blocky-pauldron/graders/sleek-exponent-band.mdmarkdown300 B
evals/s01-blocky-pauldron/prompt.mdmarkdown1.2 KB
evals/s02-damage-plates/graders/bottom-to-top-erosion.mdmarkdown157 B
evals/s02-damage-plates/graders/erosion-is-baked.mdmarkdown205 B
evals/s02-damage-plates/graders/lane-reads-bare-hp.mdmarkdown168 B
evals/s02-damage-plates/graders/no-engine-health.mdmarkdown164 B
evals/s02-damage-plates/graders/skill-fired.mdmarkdown36 B
evals/s02-damage-plates/graders/undersuit-remains.mdmarkdown72 B
evals/s02-damage-plates/graders/weathering-before-erosion.mdmarkdown152 B
evals/s02-damage-plates/graders/weathering-reads-live.mdmarkdown145 B
evals/s02-damage-plates/graders/weathering-with-under.mdmarkdown93 B
evals/s02-damage-plates/prompt.mdmarkdown1.6 KB
evals/s03-wrong-shoulder-and-soft-model/graders/author-frame-yaw.mdmarkdown127 B
evals/s03-wrong-shoulder-and-soft-model/graders/clamps-versus-global-scale.mdmarkdown131 B
evals/s03-wrong-shoulder-and-soft-model/graders/inspect-clamp-diagnostics.mdmarkdown115 B
evals/s03-wrong-shoulder-and-soft-model/graders/no-flare-always-softens.mdmarkdown112 B
evals/s03-wrong-shoulder-and-soft-model/graders/plus-x-is-the-subjects-left.mdmarkdown98 B
evals/s03-wrong-shoulder-and-soft-model/graders/skill-fired.mdmarkdown36 B
evals/s03-wrong-shoulder-and-soft-model/graders/two-diagnoses.mdmarkdown89 B
evals/s03-wrong-shoulder-and-soft-model/prompt.mdmarkdown368 B
evals/s04-flat-plastic/graders/eye-stops.mdmarkdown113 B
evals/s04-flat-plastic/graders/inset-eye.mdmarkdown155 B
evals/s04-flat-plastic/graders/painted-metal-armor.mdmarkdown135 B
evals/s04-flat-plastic/graders/skill-fired.mdmarkdown36 B
evals/s04-flat-plastic/graders/sky-panels.mdmarkdown147 B
evals/s04-flat-plastic/graders/unit-range-fields.mdmarkdown135 B
evals/s04-flat-plastic/prompt.mdmarkdown1.1 KB
evals/s05-hull-seam/graders/cutter-removed.mdmarkdown109 B
evals/s05-hull-seam/graders/groove-blend.mdmarkdown82 B
evals/s05-hull-seam/graders/groove-does-not-restore-panels.mdmarkdown207 B
evals/s05-hull-seam/graders/panel-remedy.mdmarkdown156 B
evals/s05-hull-seam/graders/separates-the-problems.mdmarkdown111 B
evals/s05-hull-seam/graders/skill-fired.mdmarkdown36 B
evals/s05-hull-seam/prompt.mdmarkdown1.1 KB
evals/s06-fin-stack/graders/domain-fold.mdmarkdown194 B
evals/s06-fin-stack/graders/fin-count-preserved.mdmarkdown96 B
evals/s06-fin-stack/graders/not-limit-twelve.mdmarkdown102 B
evals/s06-fin-stack/graders/shape-count-drops.mdmarkdown139 B
evals/s06-fin-stack/graders/skill-fired.mdmarkdown36 B
evals/s06-fin-stack/prompt.mdmarkdown2.1 KB
evals/s07-over-budget/graders/already-refuses-with-puck030.mdmarkdown189 B
evals/s07-over-budget/graders/budget-arithmetic.mdmarkdown194 B
evals/s07-over-budget/graders/creation-stats-under-budget.mdmarkdown227 B
evals/s07-over-budget/graders/detail-flags-do-not-save.mdmarkdown159 B
evals/s07-over-budget/graders/shape-count-levers.mdmarkdown217 B
evals/s07-over-budget/graders/skill-fired.mdmarkdown36 B
evals/s07-over-budget/prompt.mdmarkdown1.0 KB
evals/s08-subtraction-trap/graders/bore-is-the-cause.mdmarkdown118 B
evals/s08-subtraction-trap/graders/creation-scope-rule.mdmarkdown199 B
evals/s08-subtraction-trap/graders/fixture-already-refuses.mdmarkdown165 B
evals/s08-subtraction-trap/graders/no-scope-bypass.mdmarkdown113 B
evals/s08-subtraction-trap/graders/offers-a-remedy.mdmarkdown149 B
evals/s08-subtraction-trap/graders/skill-fired.mdmarkdown36 B
evals/s08-subtraction-trap/prompt.mdmarkdown1.4 KB
evals/s09-contact-mismatch/graders/admitted-near-outline.mdmarkdown252 B
evals/s09-contact-mismatch/graders/creation-stats-builds-contact.mdmarkdown196 B
evals/s09-contact-mismatch/graders/keeps-the-solid-placement.mdmarkdown69 B
evals/s09-contact-mismatch/graders/path-cause.mdmarkdown219 B
evals/s09-contact-mismatch/graders/renderer-not-at-fault.mdmarkdown85 B
evals/s09-contact-mismatch/graders/skill-fired.mdmarkdown36 B
evals/s09-contact-mismatch/prompt.mdmarkdown1.5 KB
evals/s10-morph-blend/graders/accepted-then-emission-fails.mdmarkdown154 B
evals/s10-morph-blend/graders/creation-stats-catches-it.mdmarkdown133 B
evals/s10-morph-blend/graders/morph-exists.mdmarkdown83 B
evals/s10-morph-blend/graders/pop-only-compose.mdmarkdown152 B
evals/s10-morph-blend/graders/shape-level-blend.mdmarkdown180 B
evals/s10-morph-blend/graders/skill-fired.mdmarkdown36 B
evals/s10-morph-blend/graders/validate-alone-misses-it.mdmarkdown149 B
evals/s10-morph-blend/prompt.mdmarkdown270 B
evals/s11-sweep-cable/graders/bezier-between-brackets.mdmarkdown98 B
evals/s11-sweep-cable/graders/curve-limits.mdmarkdown150 B
evals/s11-sweep-cable/graders/names-the-checks.mdmarkdown74 B
evals/s11-sweep-cable/graders/skill-fired.mdmarkdown36 B
evals/s11-sweep-cable/graders/sweep-with-a-curve.mdmarkdown113 B
evals/s11-sweep-cable/graders/uniform-scale.mdmarkdown132 B
evals/s11-sweep-cable/prompt.mdmarkdown976 B
evals/s12-live-tweak-and-capture/graders/reads-the-row-back.mdmarkdown84 B
evals/s12-live-tweak-and-capture/graders/row-set-on-creations.mdmarkdown162 B
evals/s12-live-tweak-and-capture/graders/save-to-a-json-path.mdmarkdown214 B
evals/s12-live-tweak-and-capture/graders/screenshot-fenced-by-wait.mdmarkdown162 B
evals/s12-live-tweak-and-capture/graders/skill-fired.mdmarkdown36 B
evals/s12-live-tweak-and-capture/graders/structural-check.mdmarkdown101 B
evals/s12-live-tweak-and-capture/graders/verbs-exist.mdmarkdown67 B
evals/s12-live-tweak-and-capture/graders/whole-array-row-set.mdmarkdown174 B
evals/s12-live-tweak-and-capture/prompt.mdmarkdown300 B
evals/s13-stripe-and-mouth-paints/graders/mouth-sweep.mdmarkdown149 B
evals/s13-stripe-and-mouth-paints/graders/paints-block.mdmarkdown68 B
evals/s13-stripe-and-mouth-paints/graders/parented-to-helmet.mdmarkdown105 B
evals/s13-stripe-and-mouth-paints/graders/relief-frays.mdmarkdown211 B
evals/s13-stripe-and-mouth-paints/graders/skill-fired.mdmarkdown36 B
evals/s13-stripe-and-mouth-paints/graders/stripe-stroked-plane.mdmarkdown141 B
evals/s13-stripe-and-mouth-paints/graders/uses-paints.mdmarkdown128 B
evals/s13-stripe-and-mouth-paints/prompt.mdmarkdown804 B
references/composition.mdmarkdown13.5 KB
references/loop.mdmarkdown11.5 KB
references/rig.mdmarkdown31.5 KB
references/shapes.mdmarkdown18.4 KB
references/surface.mdmarkdown26.8 KB

references/shapes.md

View on GitHub
# Primitives, profiles, and per-shape facets

Source: `src/Puck.SignedDistance/SdfSolidPrimitive.cs`, `SdfSolidGeometry.cs`,
`SdfPrismProfile.cs`, `SdfLift.cs`; document side
`src/Puck.World.Authoring/Authoring/CreationDocument.cs` and the
`CreationCanonicalizer*.cs` family.

Every primitive has a unit size; `scale` multiplies it. Every axis is clamped to
a magnitude of at least 0.0001.

## What `scale` means

| Type | `scale` reads as | Unit size |
|---|---|---|
| `Sphere` | uniform: radius. Non-uniform: baked as per-axis ellipsoid radii | r = 1 |
| `Box` | half-extents | (1,1,1): `scale` is the half-extent on each axis exactly, its corners filleted inside that box by 0.04 of the smallest axis |
| `Torus` | uniform multiplier only; non-uniform rides a generic scale | major 1, minor 0.4 — band width is 0.4 × major |
| `Cylinder` | x/z radius (x must equal z to bake), y half-height | r = 1, half-height 1 |
| `Capsule` | x/z radius (x must equal z), y twice the straight section's length | r = 1 around the segment from the position to 0.5 × y above it: **not centred**, it spans −r to 0.5y + r, a total height of 2r + 0.5y |
| `Ellipsoid` | per-axis radii | (1,1,1) |
| `RoundCone` | uniform multiplier | lower r 1, upper r 0.5, height 1 |
| `Plane` | **scale-invariant**; local +Y is the outward normal | — |
| `Cone` | x/z base radius (x must equal z), y half-height | r = 1, half-height 1, apex sharp |
| `Prism` | extrude: x bottom half-width, y half-height, z extrusion half-depth. **Revolve: z is a radial offset, not an extent** | all 1; top half-width is `taper` × x |
| `Superellipsoid` | per-axis radii | (1,1,1) |
| `Sweep` | **must be uniform**; multiplies every curve length | the curve carries its own units |

A `Plane`'s influence is unbounded, so an instance carrying one can never be
culled by a sphere. An `Intersection` blend is evaluated against the whole
accumulator, not just the preceding shape, and is likewise unmaskable.

## Which facets each primitive admits

| Type | taper | profile | lift | rounding | chamfer | exponent | curve |
|---|---|---|---|---|---|---|---|
| Box | | | | ≤ min(scale x,y,z) | ≤ min(scale x,y,z) | | |
| Cylinder | | | | ≤ min(radial, axial) | ≤ min(radial, axial) | | |
| Cone | | | | ceiling is **0** — the apex is sharp | | | |
| Prism | [0,1], default 0.5 | yes | yes | see below | extrude only | | |
| Superellipsoid | | | | | | [2, 8] | |
| Sweep | | | | | | | required, only here |
| Sphere, Torus, Capsule, Ellipsoid, RoundCone, Plane | | | | | | | |

`rounding` and `chamfer` may never both be nonzero on one shape. A Box is sharp
without them: no primitive carries a rounding of its own, so boxes that touch
(treads, slabs, a wall on a floor) meet as one solid with no groove at the seam,
and a solid placement collides as the same sharp or rounded box
([decision](../../../../docs/decisions/engine-design.md#a-box-is-sharp-unless-its-document-rounds-it)).
Round only an exposed edge.

Prism ceilings by profile, then additionally capped at `scale.z` for an extrude:

| Profile | rounding ceiling | chamfer ceiling |
|---|---|---|
| Trapezoid (null) | trapezoid inradius | min(inradius, z) |
| RoundedRectangle | min(x, y) | min(min(x,y), z) |
| Polygon | min(x,y)·cos(π/sides) | 0 |
| Ellipse | min(x,y) − 1e-4 | min(that, z) |
| ChamferedRectangle | chamfered-rect inradius | 0 — the profile carries its own |
| Convex | scaled polygon inradius minus the clamped `cornerRadius` fillet | 0 |

## Profiles and lifts

`profile` is `{ kind, cornerRadius, sides, vertices }` and is admitted on `Prism`
only.

| Kind | Parameters | Deterministic contact? |
|---|---|---|
| `Trapezoid` | uses the shape's `taper` | yes |
| `RoundedRectangle` | `cornerRadius` as a fraction of the smaller half-extent, [0,1] | yes |
| `Polygon` | `sides` in [3, 32] | yes (the convex polygon of its scaled vertices) |
| `Ellipse` | none | yes |
| `ChamferedRectangle` | `cornerRadius` as a chamfer fraction, [0,1] | yes |
| `Convex` | `vertices`, 3 to 32 points; `cornerRadius` rounds them uniformly | yes |
| `Path` | `path` contours; `cornerRadius: 0`; bounded line/Bezier/arc flattening, optional stroke or filled-outline shear | no — renderable only |

Path uses extrusion only, up to 128 compiled edges, and explicit normalized-space
tolerance. Its X and Y scale place the compiled edges, so a fill keeps its exact
outline at any scale, and a stroke stays a run of round disks whose radii scale
by the geometric mean of X and Y: a stroke stretched in one axis keeps its
width round rather than flattening with the stretch. Panel, trims (including a trim referencing a Path), rounding, and
chamfer are refused. Curves compile once into a packed edge table. Consult
[curved path profiles](../../../../docs/rendering/sdf/reference/materials-and-primitives.md#curved-path-profiles)
for fields and semantics; `experimental/tests/Puck.Parity/paths.puck` is the forcing fixture.

A convex hull's points must lie in [-1, 1] on both axes, be distinct and
non-collinear, and wind **strictly clockwise**.

`lift` is `Extrude` (the default, along local Z to `scale.z`) or `Revolve` (about
local Y, with `scale.z` as a radial offset). A revolve is refused on any solid or
body-collider row, because a revolve's radial offset is not a per-axis box.

The rounding and chamfer ceilings above are `SdfSolidGeometry.MaxRounding` and
`SdfSolidGeometry.MaxChamfer`; a value past either is refused by name. A
chamfered `Box` emits as an extruded ChamferedRectangle and a chamfered
`Cylinder` as a revolved one. A trapezoid Prism uses the Trapezoid/Extrude VM
path in static and animated emission and in the deterministic contact field, and
a `Convex` profile is the exact iq polygon SDF.

`Superellipsoid` is 1-Lipschitz over the whole admitted exponent range, so it
never oversteps: `SdfProgramBuilder.Superellipsoid`'s remarks carry the
derivation and `SuperellipsoidLawTests` the numeric proof. It is exact only at
exponent 2 under a uniform scale; any other exponent or a per-axis scale is a
bound, whose gain `creation shape` prints (`distance=bound gain=0.832` for
exponent 3). Every ellipsoid, and every non-uniformly scaled sphere, emits it
at exponent 2.

Verify profile admission and surfaces with `AuthoredShapeAdmissionLawTests` and
`SdfTrapezoidProfileLawTests`.

## Every per-shape field

### Placement

| Field | Meaning | Refused when |
|---|---|---|
| `id` | stable integer id | duplicated |
| `name` | the handle `parent` and a trim's `shape` reference | — |
| `type` | the primitive | unrecognized |
| `position`, `rotation`, `scale` | author-frame transform; scale defaults to 1 | non-finite; **any negative scale component** — mirror with a symmetry domain op, not a negative scale |
| `parent` | name of a shape declared **earlier** | names no shape, or names a later one |
| `joint` | hinge point used only when an effector bone declares no swings | non-finite |

### Primitive parameters

| Field | Range | Null default |
|---|---|---|
| `taper` | Prism only, [0,1] | 0.5 |
| `profile` | Prism only | trapezoid |
| `lift` | Prism only | extrude |
| `exponent` | Superellipsoid only, [2, 8] | 2 |
| `curve` | Sweep only, required there | — |

### Field operations

| Field | Range | Behavior |
|---|---|---|
| `onion` | clamped [0, 0.2] | hollow shell of that thickness |
| `dilate` | clamped [0, 0.2] | inflates the field |
| `rounding` | Box, Prism, Cylinder, Cone; ≥ 0 | curved edge |
| `chamfer` | Box, Cylinder, Prism-extrude; ≥ 0 | 45° bevel |

### Warps

Applied in this order on the local point: twist, bend, flare, shear, bumps,
warp, elongate, erode, then the primitive, then the relief field ops
(`displace`, `cells`) on the shape's rigid frame. Static and pooled/body
placements share `ShapePointOps.Apply` for the point operations; rates and
lengths are in creation units before placement scale.


| Field | Shape | Range |
|---|---|---|
| `twist` | scalar, radians per unit local Y | clamped ±3 |
| `bend` | scalar, radians per unit local Y | clamped ±1.5 |
| `flare` | `{ amount, bulge, span, top, axis, startScale }` | amount [−0.9, 4], bulge ±1, span > 0, axis 0..2 default 1 (Y), startScale (0, 5] |
| `shear` | `{ linear, quadratic, cubic, target, driver }` | coefficients ±4; target and driver must be **distinct** axes in 0..2 |
| `bumps` | up to 4 × `{ center, radii, push }` | push magnitude ≤ 2; radii floored at 0.001 |
| `warp` | `{ frequency, amplitude }` | `SdfOp.DomainWarp`: the point moves by amplitude × (sin(fx·y), sin(fy·z), sin(fz·x)); frequency ±64 per axis, amplitude ±0.2 |
| `displace` | `{ frequency, amplitude }` | `SdfOp.Displace`: amplitude × sin(fx·x) sin(fy·y) sin(fz·z) added to the field on the shape's rigid frame, like `cells`; frequency ±64 per axis, amplitude ±0.2; refused on a Sweep. The product is centred on the shape, so a flat face at offset h carries amplitude × \|sin(f·h)\| of it: at f·h a whole number of π the face reads flat, at (n + ½)π it carries all of it (`shape-displace` uses f = 3.5π / h) |
| `elongate` | `[x, y, z]` half-extents | [Elongate](../../../../src/Puck.SignedDistance/SdfFieldOps.cs) sweeps the cross-section over the box. The sweep is exact and 1-Lipschitz, so it needs no scope. Each half-extent is in [0, 2]. |
| `erode` | `{ lane, from, to, noise }` | lane 0..3; from and to must differ; noise defaults to 1 cell per unit |
| `cells` | `{ frequency, amplitude, seed, mode, randomness }` | frequency (0, 8]; amplitude [0, 4]; mode `F1` or `F2MinusF1`; randomness ≤ 0.46 (F1) or ≤ 0.2 (F2MinusF1); the relief slope amplitude × frequency (× 2 for F2MinusF1) must stay under 1, past which the surface pinches, folds over itself and sheds islands |

An erosion's range is consumed against the shape's **bound radius**
(`SdfSolidGeometry.Reach`), not its thinnest dimension, so a flat plate is
already fully gone a fraction of the way into its authored `from`/`to` window —
roughly a quarter of it for a thin plate. Back-solve the window from a measured
capture rather than assuming `to` is where the shape disappears.

A strong `flare` bulge placed far toward one end can break the field enough to
punch holes through the baked mesh. On the moth's pods, `amount: 0.3` with
`bulge: 0.8` opened an oval hole through two stacked plates, and the same flare
at `bulge: 0.6` baked whole. The validator accepts it, so look at a capture
after raising either value. For a part that widens steadily toward one end, a
linear `flare` (`amount: 0`, `startScale` below 1) with a matching `shear` to
keep one edge straight is safe.

A hollow shell (an outer shape with a smaller one subtracted) needs walls at least
about 4 cm thick to survive the mesh bake: the Moth's pod plates at 2.2 cm baked
with their backs missing, the core showing through, while the same shapes at
4.4 cm baked whole. The validator accepts the thin version, so look at a capture.

Creation contact honours `twist` and `bend` through the same ordered point chain
as rendering, evaluated in fixed point. A solid with either uses its deformed
field, with rotation-invariant bounds and no straight-primitive contact shortcut.
Creation contact emission omits `flare`, `shear`, `bumps`, `warp`, `displace`,
`elongate` and `erode`.
This is an authoring-path omission, not a statement that their low-level VM
operations all lack fixed-point interpreters. `cells` also leaves contact at
the base primitive. These fields are not generally refused by a solid row.

A `cells` facet additionally requires a closed primitive (never a `Sweep`), its
own scope, and a shape that is not detail-only.

### Sweep curves

`curve` is `{ a, b, c, radiusStart, radiusEnd, bulge, strands, twist, strandOffset }`
— a quadratic Bézier controlled by three points, with a tapered radius.
It passes through endpoints a and c, generally not b. At t = 0.5 it is
`(a + 2*b + c)/4`: to sag by d from the endpoint midpoint, displace b by 2d.

The points remain in the shape's local frame; the converted shape pose carries
them into engine space. They accept `state.<row>[.<key>]` vector bindings,
so a control point can be tuned through a state row.

A Sweep refuses domain folds, panel, trims, flare, shear, bumps, and cells.
Its shape scale must be uniform. Erosion has its own admission rules.

| Field | Limit |
|---|---|
| `radiusStart`, `radiusEnd` | finite and strictly positive; the taper `|end − start|` may not exceed 4 × the smaller |
| `bulge` | magnitude ≤ 16 × the larger radius |
| `strands` | 1 to 4; more than 1 is render-only |
| `strandOffset` | ≥ 0 and ≤ 2 × the larger radius |
| `twist` | finite, in turns along the curve |

The solid is the union of the spheres of radius `r(t)` swept along each
strand, and the field is the least gap to them over `t`, so the visible radii
are the authored ones. Strands closer than twice their radius fuse.

### Composition

| Field | Range | Null default |
|---|---|---|
| `material` | palette slot, clamped to [0, 32) | 0 |
| `blend` | see `composition.md` | `Union` |
| `smooth` | blend radius, clamped [0, 0.5] | 0 |
| `group` | ≥ 0 | 0, ungrouped |
| `domain` | up to 4 folds | none |
| `panel`, `trims` | see `composition.md` | none |

### Flags

| Field | Default | Meaning |
|---|---|---|
| `detail` | false | visual only — excluded from the contact field and colliders; the bake samples it like any other shape. Cannot combine with a panel or trims |

### Motion

`swings` and `slides`, any number of each; see `rig.md`. A shape carrying
`domain` folds may not carry either.

## Contact admission

- **Refused by name:** Revolve where contact is owed; folds that cannot expand
  within the contact copy budget. A Path prism (extruded; a fill or a stroke)
  is admitted: the fixed-point evaluator reads its edge table as the kernel
  does.
- **Accepted but omitted:** creation contact emission skips sweeps entirely
  (including single-strand sweeps) and detail shapes; it omits flare, shear,
  bumps, erode, panel, trims and cells. Base primitives remain for the omitted
  facets. Author a separate admitted contact shape if needed.
- **Relief collides as drawn:** a creation with a `noise` facet compiles, under
  the analytic provider, one field collider (`FixedStaticColliderKind.Field`)
  per stamped copy instead of its primitives' colliders. Its field is the
  copy's contact shapes in one scope with the relief over their union, the
  program the field provider reads too (`NoiseDisplace` is a contact op), so
  contact and the bake read one field. Noise amplitude and wavelength are creation units:
  a placement of scale `s` has amplitude `s * amplitude` and wavelength `s / frequency`.
  Rigid attached rows carry a cached local field in their sampled fixed-point frame.
  `sizeBy` reads a numeric state binding in authority fixed point. The sampled scale carries contact, relief and blend radii together; zero contributes no solid.
  The narrowphase is the certified
  surface solve the field provider reads too (`FixedFieldColliderContact.Solve`):
  the field's certified box bounds (its evaluator's interval walk, the relief
  charged at the most its own arithmetic can move the field) prove a body clear,
  and otherwise a converged solve measures the Euclidean distance to a
  bracketed surface point, never the field's value. `world.counters
  physics.contact` prices it as `field-queries`, `field-bounds`, `field-reads`,
  `field-samples` and `field-unproved`; an unrelieved carved creation's queries
  that no carve reaches read its exact union pieces instead, counted as
  `field-narrowed` (`FixedFieldPartition`). Every boolean inside the creation
  still collides as its contact shapes do (detail shapes drop), and a creation
  whose shapes contact drops entirely compiles no collider. An embedded body
  the field measures no way out of (a symmetric point) is stuck, never pushed
  along an invented normal; box and ellipsoid bodies still solve from their
  centre ([certified field contact](../../../../docs/plans/open-items.md#certified-field-contact)).

A low-level SDF operation's CPU support does not guarantee that a creation's
contact compiler emits it. Conversely, a supported primitive or profile name
does not prove the whole transform chain is admitted: `SdfFieldEvaluator`
refuses a residual **nonuniform `Scale`** op, because a nonuniform scale carries
no distance.

Whether one appears is decided by the primitive, not by the solid row. Arms that
bake the authored dimensions into the shape emit no `Scale`; everything else
rides a generic `Scale(scale)`, nonuniform exactly when the authored scale is.
A uniform scale is always admitted, so this only bites an anisotropic shape.

| Bakes its dimensions | Rides a generic `Scale` |
|---|---|
| Sphere, Ellipsoid, Superellipsoid, Box, Plane | RoundCone |
| Torus when `scale.x == scale.z` (an elliptic section revolved) | Torus when `scale.x != scale.z` |
| Prism with any profile (a Path prism scales its edges natively, and the fixed-point evaluator reads them at that scale) | none |
| Capsule and Cone when `scale.x == scale.z`; Cylinder at any scale (elliptic when `scale.x != scale.z`) | Capsule and Cone when `scale.x != scale.z` |

None of the right column is refused by name — each validates, renders, and fails
only when the contact field is constructed. For an anisotropic solid, prefer a
left-column spelling: every prism profile but Path takes its half-extents
natively, a Convex or Polygon one by scaling its vertices into place.

`creation stats` constructs the world's deterministic contact field through the
same builder used at boot. A residual nonuniform Scale in a solid placement
therefore exits 1 with a contact-inspection diagnostic. This check covers the
whole world even with `--prototype`; it does not demand contact support from
unplaced prototypes or non-solid placements.

## Reading a refusal

Validator messages name the field and the reason, and geometry refusals arrive
as `scale authors <reason>` at `shapes[i].scale`. Common ones worth recognizing:

- `an edge-rounding radius R past the C this shape can carry (the profile inradius, and for an extrude its half-depth)`
- `chamfer and rounding cannot both be nonzero on one shape.`
- `scale has a negative component; emission reads scale magnitudes, so the sign mirrors nothing — author a mirror as a symmetry domain op.`
- `a non-uniform scale on a Sweep, whose control points already carry creation-unit dimensions directly`
- `a cone whose radial scale … under the 0.003 the deterministic fixed-point field evaluator can distinguish from a point`

Convex profiles admit separate `rounding` after their `cornerRadius` fillet;
`SdfSolidGeometry.MaxRounding` gives the remaining inset and lift ceiling.
Profiles default to sharp corners (`cornerRadius: 0`).
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall