rsbuild-best-practices

rstackjs/agent-skills · skills.sh

Open source Repository Open in the app JSON README (API)

About

Skill publicada por rstackjs/agent-skills no skills.sh. Instale com: npx skills add rstackjs/agent-skills@rsbuild-best-practices

Details

Kind: Agent skills
Topic: No topic detected
Publisher: rstackjs
Origin: skillssh
Category: ferramentas
Stars: 93
Forks: 4
Open pull requests: 6
Last push: 2026-09-04T03:09:08Z
Repository state: ativo
Language: JavaScript
License: MIT
Added: 2026-08-30 15:22:03
Updated: 2026-09-08 15:04:37
Origin id: rstackjs/agent-skills/rsbuild-best-practices

README

# Agent Skills

A collection of Agent Skills for [Rstack](https://rspack.rs/guide/start/ecosystem#rstack).

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

## Table of Contents

- [Usage](#usage)
- [Rspack Skills](#rspack-skills)
- [Rsbuild Skills](#rsbuild-skills)
- [Rslib Skills](#rslib-skills)
- [Rspress Skills](#rspress-skills)
- [Rsdoctor Skills](#rsdoctor-skills)
- [Rstest Skills](#rstest-skills)
- [Rslint Skills](#rslint-skills)
- [Storybook Skills](#storybook-skills)
- [Contribution Workflow Skills](#contribution-workflow-skills)
- [Contributing](#contributing)
- [License](#license)

## Usage

We recommend installing this repository as an [Agent Plugin](https://agent-plugins.org/). 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

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

### VS Code

Run **Chat: Install Plugin From Source**, then enter:

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

### Cursor

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

### GitHub Copilot

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

### Claude Code

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

### Individual skills

Install any skill with:

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

## Rspack Skills

### rspack-best-practices

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

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

Migrate tsc or tsup library projects to Rslib.

## Rspress Skills

### rspress-docs-generator

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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.

```md
---
description: A concise summary of the page content for SEO and AI consumption.
---

# Page Title
```

## Rsdoctor Skills

### rsdoctor-analysis

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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](https://github.com/rstackjs/agent-skills/issues) or submit a [pull request](https://github.com/rstackjs/agent-skills/pulls).

## License

[MIT](./LICENSE)

rsbuild-best-practices

About

Details

README

More