A collection of Agent Skills for Rstack.
AI-powered skills for debugging, tracing, upgrading, and analyzing Rstack projects.
- Usage
- Rspack Skills
- Rsbuild Skills
- Rslib Skills
- Rspress Skills
- Rsdoctor Skills
- Rstest Skills
- Rslint Skills
- Storybook Skills
- Contribution Workflow Skills
- Contributing
- License
Install any skill with:
npx skills add rstackjs/agent-skills --skill <skill-name>npx skills add rstackjs/agent-skills --skill rspack-best-practicesRspack best practices for config, CLI workflow, type checking, CSS, bundle optimization, assets and profiling. Use when writing, reviewing, or troubleshooting Rspack projects.
npx skills add rstackjs/agent-skills --skill rspack-v2-upgradeUse when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.
npx skills add rstackjs/agent-skills --skill rspack-debuggingHelps 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.
npx skills add rstackjs/agent-skills --skill rstack-eco-ci-debugDebug Rstack ecosystem CI failures and attribute the real source PR behind Rspack eco-ci red suites.
npx skills add rstackjs/agent-skills --skill rspack-tracingComprehensive 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.
npx skills add rstackjs/agent-skills --skill rspack-split-chunksDiagnose and optimize Rspack optimization.splitChunks configuration. Use when tuning production chunking, reducing duplicated modules, improving cache behavior, or debugging over-fetch caused by name and cacheGroups.
npx skills add rstackjs/agent-skills --skill rsbuild-best-practicesRsbuild best practices for config, CLI workflow, type checking, bundle optimization, assets, and debugging. Use when writing, reviewing, or troubleshooting Rsbuild projects.
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgradeUse when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.
npx skills add rstackjs/agent-skills --skill migrate-to-rsbuildMigrate webpack, Vite, create-react-app (CRA/CRACO), or Vue CLI projects to Rsbuild.
npx skills add rstackjs/agent-skills --skill rslib-best-practicesRslib best practices for config, CLI workflow, output, declaration files, dependency handling, build optimization and toolchain integration. Use when writing, reviewing, or troubleshooting Rslib projects.
npx skills add rstackjs/agent-skills --skill rslib-modern-packageOpinionated Rslib recommendations for modern JS/TS package design. Use when modernizing a package, checking package health, or reviewing package.json, exports, types, dependencies, docs, and release readiness.
npx skills add rstackjs/agent-skills --skill migrate-to-rslibMigrate tsc or tsup library projects to Rslib.
npx skills add rstackjs/agent-skills --skill rspress-docs-generatorRecommended install for Rspress documentation work. Use it to create or maintain a Rspress v2 docs site, add docs for user-facing feature PRs, avoid stale Rspress v1 scaffolds, or maintain a dedicated Rspress documentation project inside a monorepo.
npx skills add rstackjs/agent-skills --skill rspress-best-practicesRspress best practices for config, CLI workflow, content organization, frontmatter, MDX, themes, i18n, search, static assets, deployment, and debugging. Use when writing, reviewing, or troubleshooting Rspress documentation sites.
npx skills add rstackjs/agent-skills --skill rspress-v2-upgradeMigrate 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.
npx skills add rstackjs/agent-skills --skill rspress-custom-themeCustomize Rspress themes using CSS variables, Layout slots, component wrapping, or component ejection. Use when a user wants to change the look and feel of an Rspress site, override theme components, add custom navigation/sidebar/footer content, inject global providers, or modify the default Rspress theme in any way.
npx skills add rstackjs/agent-skills --skill rspress-description-generatorGenerate and maintain description frontmatter for Rspress documentation files (.md/.mdx). Use when adding SEO descriptions, improving search engine snippets, generating llms.txt metadata, preparing docs for AI summarization, or batch-updating frontmatter across an Rspress doc site.
---
description: A concise summary of the page content for SEO and AI consumption.
---
# Page Titlenpx skills add rstackjs/agent-skills --skill rsdoctor-analysisAnalyze 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.
npx skills add rstackjs/agent-skills --skill migrate-to-rstestMigrate 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.
npx skills add rstackjs/agent-skills --skill rstest-debuggingDebug Rstest issues systematically, including performance regressions. Use when Rstest is slower than expected, slower than Jest or Vitest, or when you need to determine whether the bottleneck is in build startup or test execution before trying config or code changes.
npx skills add rstackjs/agent-skills --skill rstest-best-practicesRstest best practices for config, CLI workflow, test writing, mocking, snapshot testing, DOM testing, coverage, multi-project setup, CI integration, performance and debugging. Use when writing, reviewing, or troubleshooting Rstest test projects.
npx skills add rstackjs/agent-skills --skill migrate-to-rslintMigrate ESLint or other lint tools to Rslint. Use when replacing ESLint flat config, lint scripts, VS Code ESLint settings, inline directives, rules, presets, plugins, or lint dependencies with Rslint equivalents.
npx skills add rstackjs/agent-skills --skill storybook-rsbuildSet up or migrate Storybook to use the Rsbuild builder. Handles fresh setup for React, Vue 3, HTML, Web Components, and React Native Web, migration from webpack5 or Vite frameworks, and integrations with Rslib, Modern.js, and Rspack.
Skills in this section are mainly intended for contribution workflows in repositories across the Rstack ecosystem.
npx skills add rstackjs/agent-skills --skill create-draft-release-notesCreate or update draft GitHub release notes, or output organized Markdown when draft creation is unavailable. Use for release notes, draft releases, release PR checks, npm staged publishing checks, and optional highlights.
npx skills add rstackjs/agent-skills --skill release-blog-writerWrite or revise release blog posts for product releases, with guidance for structure, tone, headings, examples, and links.
npx skills add rstackjs/agent-skills --skill pr-creatorUse when asked to create a pull request for this repository. It helps the PR follow the repository's branch safety rules, title convention, pull request template, and concise English writing style.
Contributions are welcome! Feel free to open an issue or submit a pull request.