Agent Skills

A collection of Agent Skills for Rstack.

AI-powered skills for debugging, tracing, upgrading, and analyzing Rstack projects.

Table of Contents

• Usage
• Rspack Skills
• Rsbuild Skills
• Rslib Skills
• Rspress Skills
• Rsdoctor Skills
• Rstest Skills
• Contributing
• License

Usage

Install any skill with:

npx skills add rstackjs/agent-skills --skill <skill-name>

Rspack Skills

rspack-best-practices

npx skills add rstackjs/agent-skills --skill rspack-best-practices

Rspack best practices for config, CLI workflow, type checking, CSS, bundle optimization, assets and profiling. Use when writing, reviewing, or troubleshooting Rspack projects.

rspack-v2-upgrade

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade

Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.

rspack-debugging

npx skills add rstackjs/agent-skills --skill rspack-debugging

Helps Rspack users and developers debug crashes or deadlocks/hangs in the Rspack build process using LLDB.

Use this Skill when users encounter "Segmentation fault" errors during Rspack builds or when the build progress gets stuck.

rspack-tracing

npx skills add rstackjs/agent-skills --skill rspack-tracing

Comprehensive guide and toolkit for diagnosing Rspack build issues. Quickly identify where crashes/errors occur, or perform detailed performance profiling to resolve bottlenecks.

Use when the user encounters build failures, slow builds, or wants to optimize Rspack performance.

Rsbuild Skills

rsbuild-best-practices

npx skills add rstackjs/agent-skills --skill rsbuild-best-practices

Rsbuild best practices for config, CLI workflow, type checking, bundle optimization, assets, and debugging. Use when writing, reviewing, or troubleshooting Rsbuild projects.

rsbuild-v2-upgrade

npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade

Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.

migrate-to-rsbuild

npx skills add rstackjs/agent-skills --skill migrate-to-rsbuild

Migrate webpack, Vite, create-react-app (CRA/CRACO), or Vue CLI projects to Rsbuild.

Rslib Skills

rslib-best-practices

npx skills add rstackjs/agent-skills --skill rslib-best-practices

Rslib best practices for config, CLI workflow, output, declaration files, dependency handling, build optimization and toolchain integration. Use when writing, reviewing, or troubleshooting Rslib projects.

Rspress Skills

rspress-v2-upgrade

npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade

Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update packages/configs/themes, or validate the upgrade.

Rsdoctor Skills

rsdoctor-analysis

npx skills add rstackjs/agent-skills --skill rsdoctor-analysis

Analyze Rspack/Webpack bundles from local Rsdoctor build data. Provides intelligent analysis of chunk, module, package, and loader data. Provides evidence-based conclusions and actionable optimization recommendations.

Use when you need to analyze bundle composition, identify duplicate packages, detect similar packages, find large chunks, analyze side effects modules, or get comprehensive bundle optimization recommendations.

Rstest Skills

migrate-to-rstest

npx skills add rstackjs/agent-skills --skill migrate-to-rstest

Migrate Jest or Vitest tests to Rstest. Use when a user asks to migrate Jest/Vitest tests to Rstest, follow migration guides, update test files, or validate the migration.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

License

MIT