arch-nuxt-module-builder について
Nuxt モジュールの開発・保守に使う @nuxt/module-builder のリファレンススキルです。公式ビルドスタックに沿って、ランタイム変換、型生成、CI 設定を扱います。
主な機能
- 01モジュールビルド設定の自動化
- 02ランタイムファイルの変換
- 03型と schema shim の生成
- 04CLI と CI のガイダンス
- 05パッケージエクスポートの設定
活用シーン
- 01module-builder での Nuxt モジュール作成
- 02ランタイムプラグインやコンポーネントの保守
- 03CI 向けモジュールビルドの準備
- 04パッケージエクスポートの設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hairyf/ skills --skill arch-nuxt-module-builderインストール後、Claude Code で/arch-nuxt-module-builderを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdassets/ci.ymlreferences/best-practices-package-exports.mdbest-practices-setup-patterns.mdcore-ci.mdcore-cli.mdcore-dist-output.mdcore-module-definition.mdcore-overview.mdcore-project-structure.mdfeatures-build-config.mdfeatures-runtime.mdfeatures-types-generation.md詳細
arch-nuxt-module-builder のスキルは、Nuxt モジュールのビルドと公開を完全にサポートする @nuxt/module-builder を扱います。unbuild を使用し、モジュールのビルド設定を自動化して、@nuxt/schema 用の型とシムを生成し、src/runtime/(プラグイン、コンポーザブル、コンポーネント)を dist/runtime/ に変換します。公式の module-builder スタックを使って Nuxt モジュールを作成または保守する場合に、これらのスキルを使用してください。
このスキルは @nuxt/module-builder v1.0.2 に基づいており、2026-01-30 に生成されました。
コアリファレンス
| トピック | 説明 | リファレンス |
|---|---|---|
| 概要 | module-builder の概要、要件、クイックスタート | core-overview |
| プロジェクト構成 | src/module.ts、src/runtime/、package.json、build.config.ts | core-project-structure |
| モジュール定義 | defineNuxtModule、ModuleOptions、フック、ランタイム設定の型 | core-module-definition |
| Dist 出力 | module.mjs、module.json、types.d.mts、runtime/* | core-dist-output |
| CLI | nuxt-module-build build/prepare、引数(cwd、outDir、stub) | core-cli |
| CI | GitHub Actions — lint、typecheck、build、test | core-ci |
機能
| トピック | 説明 | リファレンス |
|---|---|---|
| ランタイム | src/runtime/ の構成、プラグイン/コンポーザブル/コンポーネント、mkdist | features-runtime |
| 型生成 | types.d.mts、ModuleOptions の推論、シム | features-types-generation |
| ビルド設定 | build.config.ts、追加エントリー、unbuild プリセット | features-build-config |
ベストプラクティス
| トピック | 説明 | リファレンス |
|---|---|---|
| パッケージのエクスポート | exports、typesVersions、prepack、files | best-practices-package-exports |
| セットアップパターン | createResolver、拡張子を指定しない addPlugin | best-practices-setup-patterns |
アセット
| アセット | 説明 |
|---|---|
| ci.yml | GitHub Actions CI ワークフローテンプレート — .github/workflows/ci.yml にコピーします |
コメント
Markdown 対応