rspack
Provides comprehensive guidance for Rspack bundler including configuration, plugins, loaders, optimization, and Webpack compatibility. Use when the user asks about Rspack, needs to configure Rspack, optimize build performance, or migrate from Webpack.
Best use case
rspack is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Provides comprehensive guidance for Rspack bundler including configuration, plugins, loaders, optimization, and Webpack compatibility. Use when the user asks about Rspack, needs to configure Rspack, optimize build performance, or migrate from Webpack.
Provides comprehensive guidance for Rspack bundler including configuration, plugins, loaders, optimization, and Webpack compatibility. Use when the user asks about Rspack, needs to configure Rspack, optimize build performance, or migrate from Webpack.
Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.
Practical example
Example input
Use the "rspack" skill to help with this workflow task. Context: Provides comprehensive guidance for Rspack bundler including configuration, plugins, loaders, optimization, and Webpack compatibility. Use when the user asks about Rspack, needs to configure Rspack, optimize build performance, or migrate from Webpack.
Example output
A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.
When to use this skill
- Use this skill when you want a reusable workflow rather than writing the same prompt again and again.
When not to use this skill
- Do not use this when you only need a one-off answer and do not need a reusable workflow.
- Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/rspack/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How rspack Compares
| Feature / Agent | rspack | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Provides comprehensive guidance for Rspack bundler including configuration, plugins, loaders, optimization, and Webpack compatibility. Use when the user asks about Rspack, needs to configure Rspack, optimize build performance, or migrate from Webpack.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
## When to use this skill
Use this skill whenever the user wants to:
- Set up Rspack in a new or existing project
- Configure Rspack for different environments
- Use built-in plugins or create custom plugins
- Migrate from Webpack to Rspack
- Optimize build performance
- Understand Rspack configuration options
- Use Rspack CLI or JavaScript API
- Write custom loaders
- Understand plugin API and hooks
- Configure entry points and output
- Set up code splitting and optimization
- Configure development server
- Handle assets and resources
- Use TypeScript with Rspack
- Troubleshoot Rspack issues
## How to use this skill
This skill is organized to match the Rspack official documentation structure (https://rspack.rs/zh/guide/start/introduction, https://rspack.rs/zh/config/, https://rspack.rs/zh/plugins/, https://rspack.rs/zh/api/). When working with Rspack:
1. **Identify the topic** from the user's request:
- Getting started/快速上手 → `examples/guide/start/`
- Configuration/配置 → `examples/config/`
- Plugins/插件 → `examples/plugins/`
- API → `examples/api/`
2. **Load the appropriate example file** from the `examples/` directory:
**Guide (指南)** - `examples/guide/`:
- `examples/guide/compatibility/plugin.md`
- `examples/guide/features/asset-base-path.md`
- `examples/guide/features/asset-module.md`
- `examples/guide/features/builtin-lightningcss-loader.md`
- `examples/guide/features/builtin-swc-loader.md`
- `examples/guide/features/dev-server.md`
- `examples/guide/features/esm.md`
- `examples/guide/features/layer.md`
- `examples/guide/features/lazy-compilation.md`
- `examples/guide/features/loader.md`
- `examples/guide/features/module-federation.md`
- `examples/guide/features/module-resolution.md`
- `examples/guide/features/plugin.md`
- `examples/guide/features/web-workers.md`
- `examples/guide/migration/cra.md`
- `examples/guide/migration/rspack_0.x.md`
- `examples/guide/migration/storybook.md`
- `examples/guide/migration/webpack.md`
- `examples/guide/optimization/analysis.md`
- `examples/guide/optimization/code-splitting.md`
- `examples/guide/optimization/lazy-barrel.md`
- `examples/guide/optimization/production.md`
- `examples/guide/optimization/profile.md`
- `examples/guide/optimization/tree-shaking.md`
- `examples/guide/optimization/use-rsdoctor.md`
- `examples/guide/start/ecosystem.md`
- `examples/guide/start/introduction.md`
- `examples/guide/start/quick-start.md`
- `examples/guide/tech/css.md`
- `examples/guide/tech/json.md`
- `examples/guide/tech/nestjs.md`
- `examples/guide/tech/next.md`
- `examples/guide/tech/preact.md`
- `examples/guide/tech/react.md`
- `examples/guide/tech/solid.md`
- `examples/guide/tech/svelte.md`
- `examples/guide/tech/typescript.md`
- `examples/guide/tech/vue.md`
**Configuration (配置)** - `examples/config/`:
- `examples/config/cache.md`
- `examples/config/context.md`
- `examples/config/deprecated-options.md`
- `examples/config/dev-server.md`
- `examples/config/devtool.md`
- `examples/config/entry.md`
- `examples/config/experiments.md`
- `examples/config/extends.md`
- `examples/config/externals.md`
- `examples/config/filename-placeholders.md`
- `examples/config/index.md`
- `examples/config/infrastructure-logging.md`
- `examples/config/lazy-compilation.md`
- `examples/config/mode.md`
- `examples/config/module-rules.md`
- `examples/config/module.md`
- `examples/config/node.md`
- `examples/config/optimization-optimizationsplitchunks.md`
- `examples/config/optimization.md`
- `examples/config/other-options.md`
- `examples/config/output.md`
- `examples/config/performance.md`
- `examples/config/plugins.md`
- `examples/config/resolve-loader.md`
- `examples/config/resolve.md`
- `examples/config/stats.md`
- `examples/config/target.md`
- `examples/config/watch.md`
**Plugins (插件)** - `examples/plugins/`:
- `examples/plugins/index.md`
- `examples/plugins/rspack/circular-dependency-rspack-plugin.md`
- `examples/plugins/rspack/copy-rspack-plugin.md`
- `examples/plugins/rspack/css-chunking-plugin.md`
- `examples/plugins/rspack/css-extract-rspack-plugin.md`
- `examples/plugins/rspack/esm-library-plugin.md`
- `examples/plugins/rspack/html-rspack-plugin.md`
- `examples/plugins/rspack/lightning-css-minimizer-rspack-plugin.md`
- `examples/plugins/rspack/subresource-integrity-plugin.md`
- `examples/plugins/rspack/swc-js-minimizer-rspack-plugin.md`
- `examples/plugins/rspack/virtual-modules-plugin.md`
- `examples/plugins/webpack/banner-plugin.md`
- `examples/plugins/webpack/case-sensitive-plugin.md`
- `examples/plugins/webpack/context-replacement-plugin.md`
- `examples/plugins/webpack/define-plugin.md`
- `examples/plugins/webpack/dll-plugin.md`
- `examples/plugins/webpack/dll-reference-plugin.md`
- `examples/plugins/webpack/electron-target-plugin.md`
- `examples/plugins/webpack/enable-chunk-loading-plugin.md`
- `examples/plugins/webpack/enable-library-plugin.md`
- `examples/plugins/webpack/enable-wasm-loading-plugin.md`
- `examples/plugins/webpack/entry-plugin.md`
- `examples/plugins/webpack/environment-plugin.md`
- `examples/plugins/webpack/eval-source-map-dev-tool-plugin.md`
- `examples/plugins/webpack/externals-plugin.md`
- `examples/plugins/webpack/hot-module-replacement-plugin.md`
- `examples/plugins/webpack/ignore-plugin.md`
- `examples/plugins/webpack/index.md`
- `examples/plugins/webpack/internal-plugins.md`
- `examples/plugins/webpack/javascript-modules-plugin.md`
- `examples/plugins/webpack/limit-chunk-count-plugin.md`
- `examples/plugins/webpack/module-federation-plugin-v1.md`
- `examples/plugins/webpack/module-federation-plugin.md`
- `examples/plugins/webpack/no-emit-on-errors-plugin.md`
- `examples/plugins/webpack/node-target-plugin.md`
- `examples/plugins/webpack/node-template-plugin.md`
- `examples/plugins/webpack/normal-module-replacement-plugin.md`
- `examples/plugins/webpack/progress-plugin.md`
- `examples/plugins/webpack/provide-plugin.md`
- `examples/plugins/webpack/runtime-chunk-plugin.md`
- `examples/plugins/webpack/source-map-dev-tool-plugin.md`
- `examples/plugins/webpack/split-chunks-plugin.md`
**API Reference** - `examples/api/`:
- `examples/api/cli.md`
- `examples/api/index.md`
- `examples/api/javascript-api/browser.md`
- `examples/api/javascript-api/cache.md`
- `examples/api/javascript-api/compilation.md`
- `examples/api/javascript-api/compiler.md`
- `examples/api/javascript-api/index.md`
- `examples/api/javascript-api/logger.md`
- `examples/api/javascript-api/resolver.md`
- `examples/api/javascript-api/stats-json.md`
- `examples/api/javascript-api/stats.md`
- `examples/api/javascript-api/swc.md`
- `examples/api/loader-api/context.md`
- `examples/api/loader-api/index.md`
- `examples/api/loader-api/inline-match-resource.md`
- `examples/api/loader-api/inline.md`
- `examples/api/loader-api/writing-loaders.md`
- `examples/api/plugin-api/compilation-hooks.md`
- `examples/api/plugin-api/compiler-hooks.md`
- `examples/api/plugin-api/context-module-factory-hooks.md`
- `examples/api/plugin-api/index.md`
- `examples/api/plugin-api/javascript-modules-plugin-hooks.md`
- `examples/api/plugin-api/normal-module-factory-hooks.md`
- `examples/api/plugin-api/runtime-plugin-hooks.md`
- `examples/api/plugin-api/stats-hooks.md`
- `examples/api/runtime-api/hmr.md`
- `examples/api/runtime-api/module-methods.md`
- `examples/api/runtime-api/module-variables.md`
3. **Follow the specific instructions** in that example file for syntax, structure, and best practices
**Important Notes**:
- Rspack is compatible with most Webpack plugins and loaders
- Configuration format is similar to Webpack
- Rspack provides better performance than Webpack
- Examples include both JavaScript and TypeScript versions
- Each example file includes parameters, returns, common errors, best practices, and scenarios
4. **Reference the official documentation** when needed:
- Guide: https://rspack.rs/zh/guide/
- Configuration: https://rspack.rs/zh/config/
- Plugins: https://rspack.rs/zh/plugins/
- API: https://rspack.rs/zh/api/
### Inline Quick Start
```bash
# Create a new Rspack project
npm create rspack@latest
# Or add to existing project
npm install --save-dev @rspack/core @rspack/cli
```
```javascript
// rspack.config.js
const { HtmlRspackPlugin } = require('@rspack/core');
module.exports = {
entry: './src/index.js',
output: {
filename: '[name].[contenthash].js',
clean: true,
},
module: {
rules: [
{
test: /\.jsx?$/,
use: {
loader: 'builtin:swc-loader',
options: { jsc: { parser: { syntax: 'ecmascript', jsx: true } } },
},
},
],
},
plugins: [new HtmlRspackPlugin({ template: './index.html' })],
optimization: { splitChunks: { chunks: 'all' } },
};
```
```bash
# Development
npx rspack serve
# Production build
npx rspack build
```
## Best Practices
1. **Use TypeScript for configuration**: Better type safety and autocomplete
2. **Leverage built-in plugins**: Use Rspack plugins when available (faster than Webpack equivalents)
3. **Optimize for production**: Use production mode for builds
4. **Code splitting**: Use optimization.splitChunks for better performance
5. **Cache configuration**: Enable persistent caching for faster rebuilds
6. **Use HMR**: Enable Hot Module Replacement for better DX
## Troubleshooting
- **Webpack plugin not compatible**: Check Rspack compatibility list; some Webpack plugins need Rspack equivalents
- **Loader errors**: Use `builtin:swc-loader` instead of `babel-loader` for better performance
- **Build slower than expected**: Enable persistent caching; check for unoptimized loaders
- **Migration issues**: Use the webpack migration guide at `examples/guide/migration/webpack.md`
## Resources
- **Official Documentation**: https://rspack.rs/zh/
- **Getting Started**: https://rspack.rs/zh/guide/start/introduction
- **Configuration**: https://rspack.rs/zh/config/
- **Plugins**: https://rspack.rs/zh/plugins/
- **API Reference**: https://rspack.rs/zh/api/
- **GitHub Repository**: https://github.com/web-infra-dev/rspack
## Keywords
Rspack, rspack, bundler, webpack, rust, build tool, bundling, code splitting, HMR, hot module replacement, loader, plugin, configuration, entry, output, optimization, development server, 打包工具, 构建工具, 代码分割, 热模块替换, 加载器, 插件, 配置, 入口, 输出, 优化, 开发服务器Related Skills
vant-vue3
Provides structured guidance for Vant of Vue 3.0. Use when the user needs Vant with Vue 3, asks about mobile UI components such as Button, Cell, Form, Dialog, Toast, Popup, ConfigProvider, theme customization, project setup, or wants to implement mobile-first interfaces with vant or van- components.
layui-vue3
Provides comprehensive guidance for Layui Vue component library including components, layer dialogs, and utilities. Use when the user asks about Layui Vue, needs to use Layui components in Vue 3, or implement UI components.
element-plus-vue3
Provides comprehensive guidance for Element Plus Vue 3 component library including installation, components, themes, internationalization, and API reference. Use when the user asks about Element Plus for Vue 3, needs to build Vue 3 applications with Element Plus, or customize component styles.
bootstrap-vue3
Provides comprehensive guidance for Bootstrap Vue 3 component library including Bootstrap components, grid system, utilities, and Vue 3 integration. Use when the user asks about Bootstrap Vue 3, needs to use Bootstrap components in Vue 3, or implement responsive layouts.
vuex-vue2
Provides comprehensive guidance for Vuex 2.x state management in Vue 2 applications including state, mutations, actions, getters, modules, and plugins. Use when the user asks about Vuex for Vue 2, needs to manage state in Vue 2 applications, or implement Vuex patterns.
vue3
Guidance for Vue 3 using the official guide and API reference. Use when the user needs Vue 3 concepts, patterns, or API details to build components, apps, and tooling.
vue2
Provides comprehensive guidance for Vue 2.x development including Options API, components, directives, lifecycle hooks, computed properties, watchers, Vuex state management, and Vue Router. Use when the user asks about Vue 2, needs to create Vue 2 components, implement reactive data binding, handle component communication, or work with Vue 2 ecosystem tools.
vue-router
Provides comprehensive guidance for Vue Router including route configuration, navigation, dynamic routes, nested routes, route guards, programmatic navigation, and route meta. Use when the user asks about Vue Router, needs to set up routing, implement navigation guards, handle route parameters, or manage route transitions.
vue-router-v4
Provides comprehensive guidance for Vue Router v4 including route configuration, navigation, nested routes, route guards, and Vue 3 integration. Use when the user asks about Vue Router v4, needs to set up routing for Vue 3 applications, implement navigation guards, or work with Vue Router v4 features.
vue-router-v3
Guidance for Vue Router v3 using the official Installation, Guide, and API docs. Use when users need routing setup, navigation patterns, or API details for Vue 2 projects.
pinia
Provides comprehensive guidance for Pinia state management including stores, state, getters, actions, plugins, and TypeScript support. Use when the user asks about Pinia, needs to manage application state, create stores, implement state persistence, or migrate from Vuex.
vscode-project-init
Scaffold a new VS Code extension project using TypeScript via Yeoman generator (yo code), creating src/extension.ts entry point and package.json manifest. Use when the user wants to start a new VS Code extension project from scratch.