unplugin について
unpluginは、共通のRollupスタイルAPIを使うプラグインの開発、統合、デバッグ向けスキルです。対応バンドラー、フック、互換性などを解説します。
主な機能
- 01共通のRollupスタイルプラグインAPI
- 02バンドラー統合のガイド
- 03フックとコンテキストの資料
- 04バンドラー間の互換性一覧
- 05フィルターとネストしたプラグイン
- 06仮想モジュールと出力アセット
活用シーン
- 01新しいunpluginの開発
- 02プラグインのバンドラーへの統合
- 03フック動作のデバッグ
- 04バンドラー間のAPI対応確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/unpluginを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdreferences/best-practices-conventions.mdbest-practices-diagnostics.mdbest-practices-scaffolding.mdcore-api.mdcore-hook-compatibility.mdcore-hooks-and-context.mdcore-integration.mdcore-overview.mdfeatures-bundler-specific.mdfeatures-filters.mdfeatures-nested-plugins.mdfeatures-output-and-assets.mdfeatures-parsing.mdfeatures-virtual-modules.md詳細
Unplugin は、Vite、Rollup、webpack、esbuild、Rspack、Rolldown、Farm、Bun で動作する、Rollup 形式の統一されたプラグイン API を提供します。新しい unplugin の実装、既存の unplugin の統合、バンドラー間でのフックやコンテキストの動作のデバッグに、これらのスキルを活用してください。
このスキルは unplugin v3.0.0 を基にしており、2026-01-30 に生成されました。
コアリファレンス
| トピック | 説明 | リファレンス |
|---|---|---|
| 概要 | unplugin とは何か、サポートするバンドラー、使用する場面 | core-overview |
| コア API | createUnplugin、ファクトリーのシグネチャ、バンドラー固有のクリエーター | core-api |
| フックとコンテキスト | ライフサイクルフック、フィルター、this.parse / emitFile / warn / error | core-hooks-and-context |
| フックの互換性 | フックとコンテキストに関するバンドラーごとの対応表 | core-hook-compatibility |
| 統合 | Vite、Rollup、webpack などへのインストールと登録 | core-integration |
機能
| トピック | 説明 | リファレンス |
|---|---|---|
| フィルター | resolveId、transform、load 用の filter オプション（パフォーマンス） | features-filters |
| 入れ子のプラグイン | ファクトリーからプラグインの配列を返す方法 | features-nested-plugins |
| バンドラー固有 | meta.framework、回避策（vite/webpack/esbuild/…）、createXxxPlugin | features-bundler-specific |
| 仮想モジュール | resolveId + load のパターン、load 用のフィルター | features-virtual-modules |
| パース | setParseImpl、this.parse、必要となる場面（esbuild、webpack など） | features-parsing |
| 出力とアセット | emitFile（EmittedAsset のみ）、writeBundle（タイミングのみ） | features-output-and-assets |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| 規約 | unplugin- プレフィックス、キーワード、default + サブパスのエクスポート | best-practices-conventions |
| 診断 | this.warn / this.error、UnpluginMessage の形式 | best-practices-diagnostics |
| スキャフォールディング | テンプレート（unplugin-starter）、オンラインで試す方法、前提条件 | best-practices-scaffolding |
コメント
Markdown 対応