migrate-to-rsbuild_skill

Overview

This skill automates and guides migration of webpack, Vite, Create React App (CRA/CRACO), or Vue CLI projects to Rsbuild with minimal behavioral changes and clear verification steps. It focuses on a smallest-change-first migration that preserves application runtime logic and provides a clear validation and cleanup workflow.

How this skill works

The skill detects the project’s original build tool by scanning package.json scripts/dependencies and well-known config files, then applies framework-specific deltas to produce an Rsbuild configuration. It runs the dev server and build commands to validate the migration, and reports remaining manual follow-ups. Old tool dependencies and configs are kept until Rsbuild is verified green, then removed.

When to use it

• You maintain a project using webpack, Vite, CRA/CRACO, or Vue CLI and want to migrate to Rsbuild.
• You need a predictable, minimal-impact migration that preserves runtime behavior.
• You want automated detection and step-by-step validation for the migration.
• You prefer keeping the old toolside-by-side until the new build is verified.
• You need a documented summary of changed files and manual tasks after migration.

Best practices

• Follow the official Rsbuild migration docs as the authoritative reference.
• Apply the smallest reachable change first: prioritize baseline dev/build parity before customizations.
• Do not modify application runtime code unless the user explicitly requests it.
• Validate dev server and production build before removing legacy configs or deps.
• Keep a concise summary of changed files and unresolved issues for manual follow-up.

Example use cases

• Migrate a webpack-based React app to Rsbuild while keeping runtime code untouched.
• Convert a Vite project to Rsbuild and verify the dev server and production build run cleanly.
• Replace CRA/CRACO with Rsbuild in an existing React project, preserving scripts and behavior.
• Move a Vue CLI project to Rsbuild, applying mappings for vue.config.js behaviors.
• Perform a staged migration: enable Rsbuild, validate, then remove legacy build deps.