component-migrate

Migrate Svelte components to bits-ui v2 headless primitives with API verification.

1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/s0lci700/OVERLAYS --skill component-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: component-migrate
Source: https://github.com/s0lci700/OVERLAYS/tree/main/.claude/skills/component-migrate
Command: npx skills add https://github.com/s0lci700/OVERLAYS --skill component-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrate a Svelte component to use bits-ui v2 headless primitives + tailwind-variants. Verifies the actual installed API before writing, updates all import references, runs lint and build.

Core Features & Use Cases

  • API-verified migration: Ensures the target bits-ui v2 primitives are available before rewriting imports.
  • Safe mapping: Reads current component usage to map props, slots, and related patterns to v2 equivalents.
  • Build-time validation: Runs lint and build to catch regressions early.

Quick Start

Run the component-migrate skill with a component name or path to perform an API-verified migration.

Frequently Asked Questions about component-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Svelte components to bits-ui v2 safely?

To migrate Svelte components to bits-ui v2 safely, use an API-verified migration process that validates the installed v2 primitives before rewriting imports, mapping props and slots to v2 equivalents, and running lint and build steps to catch regressions.

What is the best way to update Svelte component imports from bits-ui v1 to v2?

The best way to update bits-ui v1 imports to v2 is to verify the actual installed API first, then rewrite import references to target v2 headless primitives while mapping existing prop and slot patterns to their v2 equivalents.

Does bits-ui v2 migration automatically check for breaking changes before rewriting imports?

Yes, a safe bits-ui v2 migration enforces verification of the installed API before writing any code, ensuring that the target v2 headless primitives are actually available and preventing incompatible import rewrites.

How do I map props and slots when upgrading to bits-ui v2 headless primitives?

To map props and slots when upgrading to bits-ui v2, read the current component usage to identify existing patterns, then map those props and slots directly to their v2 headless primitive equivalents during the import rewrite.

Can I validate a bits-ui v2 component migration for build errors automatically?

Yes, you can validate a bits-ui v2 component migration automatically by running build-time validation steps that execute lint and build commands after rewriting imports, catching any regressions or errors early.

What are the limitations of migrating Svelte components to bits-ui v2?

A limitation of migrating Svelte components to bits-ui v2 is that the migration is constrained by the actual installed API, meaning the process cannot rewrite imports to v2 primitives unless they are verified as available in the current environment.