migrate-to-rslib_skill

Overview

This skill migrates TypeScript library projects that use tsc or tsup to Rslib with minimal behavior changes and verifiable results. It detects the source tool, applies targeted migration deltas, and guides validation and cleanup. The goal is a smallest-change migration that preserves business logic and provides a clear summary of what changed.

How this skill works

The skill scans the repository to detect whether the project is built with tsup or tsc by checking config files, dependencies, and build scripts. It applies tool-specific migration steps mapped from the official Rslib migration guidance to update build configuration, outputs, and scripts. After applying changes it runs the existing build command to validate the migrated setup and lists any remaining manual follow-ups or obsolete artifacts that can be removed once validation succeeds.

When to use it

• You maintain a TypeScript library currently built with tsc or tsup and want to standardize on Rslib.
• You need a migration that minimizes risk to runtime and business logic behavior.
• You want automated detection and mapping of build options from tsup or tsc to Rslib.
• You prefer validating the new setup before removing old build tooling.

Best practices

• Follow the official Rslib migration docs as the primary source of truth during changes.
• Perform a baseline migration first, then address advanced customizations separately.
• Do not modify application business logic during migration unless explicitly required.
• Keep old build dependencies and configs temporarily until Rslib builds are verified.
• Summarize changed files, mapped options, and manual follow-ups for reviewers.

Example use cases

• Convert a monorepo package that uses tsup.config.js to an equivalent Rslib configuration while keeping output formats identical.
• Migrate a library using tsc composite builds to Rslib references and verify the build graph without touching source code.
• Replace tsup build scripts in package.json with Rslib scripts and validate by running the original build command.
• Perform a staged migration where old dependencies remain until Rslib passes CI builds, then remove obsolete tools.