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
• Rslint Skills
• Storybook Skills
• Contribution Workflow Skills
• Contributing
• License

Usage

We recommend installing this repository as an Agent Plugin. The Rstack Agent Plugin follows the open, vendor-neutral Agent Plugins 1.0 standard and works with compatible agent clients, including VS Code, GitHub Copilot, Codex, Cursor, and more.

Codex

codex plugin marketplace add rstackjs/agent-skills
codex plugin add rstack@rstack

VS Code

Run Chat: Install Plugin From Source, then enter:

https://github.com/rstackjs/agent-skills

Cursor

git clone https://github.com/rstackjs/agent-skills.git ~/.cursor/plugins/local/rstack

GitHub Copilot

copilot plugin marketplace add rstackjs/agent-skills
copilot plugin install rstack@rstack

Claude Code

claude plugin marketplace add rstackjs/agent-skills
claude plugin install rstack@rstack

Individual skills

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.

rspack-split-chunks

npx skills add rstackjs/agent-skills --skill rspack-split-chunks

Diagnose 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.

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.

rslib-modern-package

npx skills add rstackjs/agent-skills --skill rslib-modern-package

Opinionated 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.

migrate-to-rslib

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

Migrate tsc or tsup library projects to Rslib.

Rspress Skills

rspress-docs-generator

npx skills add rstackjs/agent-skills --skill rspress-docs-generator

Recommended 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.

rspress-best-practices

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

Rspress 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.

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.

rspress-custom-theme

npx skills add rstackjs/agent-skills --skill rspress-custom-theme

Customize 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.

rspress-description-generator

npx skills add rstackjs/agent-skills --skill rspress-description-generator

Generate 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 Title

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.

rstest-debugging

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

Debug 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.

rstest-best-practices

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

Rstest 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.

Rslint Skills

migrate-to-rslint

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

Migrate 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.

Storybook Skills

storybook-rsbuild

npx skills add rstackjs/agent-skills --skill storybook-rsbuild

Set 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.

Contribution Workflow Skills

Skills in this section are internal contribution workflow Skills intended for Rstack repository maintainers and developers, not end users. Set INSTALL_INTERNAL_SKILLS=1 when installing them.

create-draft-release-notes

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill create-draft-release-notes

Create 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.

release-blog-writer

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill release-blog-writer

Write or revise release blog posts for product releases, with guidance for structure, tone, headings, examples, and links.

mdx-to-markdown

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill mdx-to-markdown

Convert MDX to portable Markdown with MDX syntax cleanup and link/code block normalization.

pr-creator

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill pr-creator

Use 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.

rstack-repo-maintain

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill rstack-repo-maintain

Audit and modernize RstackJS/Rspack ecosystem repositories to the current shared infrastructure baseline, including build output, linting, test tooling, Node.js support, TypeScript settings, docs, release workflow cleanup, dependency cleanup, and infra PR conventions.

rstack-eco-ci-debug

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill rstack-eco-ci-debug

Debug Rstack ecosystem CI failures and attribute the real source PR or downstream change. Use it for Rspack-first triage plus Rsbuild, Rslib, Rspress, Rstest, and Rsdoctor eco-ci, suite regressions, downstream failures, Rspack canary bisects, and daily multi-ecosystem triage.

rstack-skill-evaluator

INSTALL_INTERNAL_SKILLS=1 npx skills add rstackjs/agent-skills --skill rstack-skill-evaluator

Benchmark and iteratively improve agent skills with Codex CLI or Claude Code by generating eval cases, comparing skill-guided and baseline runs, grading outcomes, and recording actionable reports under skills-test/{skill-name}.

Contributing

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

License

MIT