AgentSkillsCN

shipwright

为“枯燥的 JavaScript 技术栈”打造 Shipwright 构建系统——基于 Rsbuild 的资产管道,取代 Grunt,并配备 React/Vue/Svelte 框架插件、Tailwind CSS、SSR 支持,以及带有 HMR 的开发服务器。在配置构建、管理资产,或调试开发服务器时,可使用此技能。

SKILL.md
--- frontmatter
name: shipwright
description: >
  Shipwright build system for The Boring JavaScript Stack — Rsbuild-based asset pipeline replacing Grunt,
  with framework plugins for React/Vue/Svelte, Tailwind CSS, SSR support, and dev server with HMR.
  Use this skill when configuring builds, managing assets, or debugging the development server.
metadata:
  author: sailscastshq
  version: '1.0.0'
  tags: shipwright, rsbuild, build, vite, assets, tailwind, ssr, hmr, boring-stack

Shipwright

Shipwright (sails-hook-shipwright) is the modern build system for The Boring JavaScript Stack. Built on Rsbuild, it replaces the legacy Grunt pipeline with a fast, zero-config asset pipeline that supports React, Vue, and Svelte through framework plugins.

When to Use

Use this skill when:

  • Configuring config/shipwright.js (framework plugins, build options)
  • Understanding the asset pipeline (CSS, JavaScript entry points, static assets)
  • Setting up Tailwind CSS with PostCSS
  • Configuring server-side rendering (SSR) with config/inertia.js
  • Debugging the dev server, HMR, or build issues
  • Understanding the views/app.ejs template and shipwright.styles()/shipwright.scripts() helpers
  • Managing path aliases (~/ for assets/js/)
  • Working with code splitting and third-party CSS imports

Rules

Read individual rule files for detailed explanations and code examples: