Agent Skills

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

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 plugin marketplace add rstackjs/agent-skills
codex plugin add rstack@rstack

Run Chat: Install Plugin From Source, then enter:

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

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

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

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

Install any skill with:

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

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

Configure, review, or troubleshoot Rspack builds, including loaders, CSS, assets, type checking, bundle optimization, and profiling.

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.

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

Debug native Rspack crashes, segmentation faults, deadlocks, or stuck builds with LLDB and matching debug symbols.

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

Capture or analyze Rspack build traces to locate slow compiler phases, plugins, loaders, or the last events before a build failure.

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

Diagnose or tune Rspack splitChunks for duplicate modules, route over-fetching, cache groups, caching, or oversized chunks.

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

Configure, review, or troubleshoot Rsbuild applications, including build/dev commands, assets, type checking, and bundle optimization.

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.

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

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

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

Configure, review, or troubleshoot Rslib library builds, output formats, declarations, dependency handling, and integrations.

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

Design, modernize, or review JS/TS npm packages using an opinionated Rslib baseline for ESM, exports, types, dependencies, and release readiness.

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

Migrate tsc or tsup library projects to Rslib.

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

Create a Rspress v2 docs site or maintain existing Rspress v2 documentation for project changes.

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

Configure, review, or troubleshoot Rspress v2 sites, including content conventions, navigation, MDX, assets, search, and deployment.

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.

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

Customize Rspress v2 themes with CSS variables, class overrides, Layout slots, icons, or component ejection.

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

Generate missing description frontmatter for Rspress Markdown/MDX pages, including new docs pages and site-wide SEO metadata updates.

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

# Page Title

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.

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

Migrate Jest, Vitest, or Playwright Test to Rstest while preserving test discovery, assertions, mocks, snapshots, and coverage.

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

Diagnose Rstest startup, build, runtime, logging, memory, or performance problems using traces and comparable measurements.

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

Set up, write, or review Rstest tests and configuration, including environments, mocks, snapshots, coverage, and CI.

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.

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

Set up or migrate Storybook to Rsbuild, configure rsbuildFinal, or integrate with Rslib, Modern.js, or Rspack.

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.

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.

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.

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

Write or revise Markdown and MDX documentation, including READMEs, guides, and Rspress-based docs.

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.

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

Create a pull request using repository branch rules, title conventions, templates, and concise English descriptions.

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

Audit or modernize Rstack repository infrastructure, package manifests, build/test tooling, CI, and release configuration against maintained baselines.

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

Triage Rstack ecosystem CI (eco-ci, rstack-ecosystem-ci), including daily multi-ecosystem status, green-to-red pivots, and Rspack canary bisects. Attribute failures to upstream or downstream changes while checking for flaky runs.

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

Benchmark and iteratively improve agent skills using matched skill-guided and baseline runs with Codex CLI or Claude Code.

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

MIT