using-effectslisted
Install: claude install-skill Nagellabs/libi
# Using Effects
Effects are time-based animations on a layer's three slots — **in** (entrance),
**out** (exit), **loop** (continuous). They coexist (fade in + gentle float + slide
out). Every overlay kind (including a full-frame base video/image overlay), canvas
scene, and audio clip can carry effects.
## Discover, never guess
`libi.list_effects` is the AUTHORITATIVE, always-current catalog (including custom
effects the user may have installed). Call it — optionally filtered by `kind`,
`phase` — before applying. Treat any ids named in this skill as illustrative, not
exhaustive. An unknown id passed to `apply_layer_effect` comes back with the valid
set; correct and retry.
## Apply
- `libi.apply_layer_effect({ pieceId, layerId, phase, effectId, durationMs?, params? })`
— `layerId` is any overlay or audio clip id.
- `libi.clear_layer_effect({ pieceId, layerId, phase })` — remove one slot.
- New overlays — pass `effects` on `libi.add_overlay` so the layer is born with motion.
- `libi.highlight_effect({ pieceId, target })` — when the user asks how to add an
effect, or says one looks off, flash it (catalog or applied) so they see the control.
## Tasteful defaults (apply these out of the box)
- **Caption / title text** — `fade` or `typewriter` in. Short (300-500ms).
- **Logo / sticker / badge** — `pop` in. Playful but settles.
- **Emphasis on a held element** — a subtle `pulse` or `breathe` loop (small amount).
- **Photo / image overlay used as a full-frame base** — a gen