getting-started

Agent skill

Install the void skill for Cursor and other agents so they know GSAP, MotionProvider, presets, and @void registry workflows.

Registry is hosted at https://void.ui.unsanity.ai. The shadcn CLI uses content negotiation (no .json in install URLs). Local dev: npm run dev with NEXT_PUBLIC_VOID_SITE_URL=http://localhost:3000.

What it does

# Installs skills/void/SKILL.md into your agent (e.g. Cursor)
# The agent then knows how to add @void components, scroll runway, presets, etc.

Option A — npx skills (recommended)

npx skills add unsanityinc/shadcn-void --skill void

# List without installing
npx skills add unsanityinc/shadcn-void -l

# Local repo (before GitHub publish)
npx skills add /path/to/shadcn-void --skill void

Option B — shadcn registry

# Requires @void in components.json (see Installation)
npx shadcn@latest add @void/skill

# Installs to ~/.agents/skills/void/SKILL.md

Register @void first (for Option B)

{
  "registries": {
    "@void": {
      "url": "https://void.ui.unsanity.ai/r/{name}"
    }
  }
}

After install

# Cursor loads skills from .agents/skills/ automatically.
# Re-open the project or start a new agent session if needed.

shadcn add

npx shadcn@latest add @void/skill

# Or URL (no .json):
npx shadcn@latest add https://void.ui.unsanity.ai/r/skill