add-registry-item
Installation
SKILL.md
Add or change a registry item
All paths below are under apps/www/src/registry-audio/bases/base/ unless they start with apps/. The rules for file names, exports, icons and colors are in AGENTS.md ("Registry items"); CONTRIBUTING.md has the long version with a full _registry.ts example.
1. Pick the place and the type
| You are adding | File | _registry.ts |
Item type |
|---|---|---|---|
| A styled element over a primitive | audio/elements/<name>.tsx |
audio/_registry.ts |
registry:ui |
| A device: its state, its engine, its face (controlled, no audio) | devices/<name>/device.ts, engine.ts, panel.tsx |
devices/_registry.ts |
registry:lib, registry:lib, registry:ui |
| A composed screen | components/<category>/block-<component>-<variant>.tsx |
components/_registry.ts |
registry:block |
| A focused example for the docs | components/<category>/<component>-<feature>-demo.tsx |
components/_registry.ts |
registry:example |
| A hook | hooks/use-<name>.ts |
hooks/_registry.ts |
registry:hook |
| Framework-free logic | lib/<name>.ts |
lib/_registry.ts |
registry:lib |
Before writing, open the closest existing item of the same kind and copy its shape. The catalog is deliberately small: prefer extending an existing block or demo over adding a near-duplicate, and ask before adding a new block.