arch-nuxt-module-builder skills cover @nuxt/module-builder: the complete solution to build and ship Nuxt modules. It uses unbuild, automates module build config, generates types and shims for @nuxt/schema, and transforms src/runtime/ (plugins, composables, components) to dist/runtime/. Use these skills when creating or maintaining a Nuxt module with the official module-builder stack.
The skill is based on @nuxt/module-builder v1.0.2, generated at 2026-01-30.
Core References
| Topic | Description | Reference |
|---|---|---|
| Overview | What module-builder is, requirements, quick start | core-overview |
| Project structure | src/module.ts, src/runtime/, package.json, build.config.ts | core-project-structure |
| Module definition | defineNuxtModule, ModuleOptions, hooks, runtime config types | core-module-definition |
| Dist output | module.mjs, module.json, types.d.mts, runtime/* | core-dist-output |
| CLI | nuxt-module-build build/prepare, args (cwd, outDir, stub) | core-cli |
| CI | GitHub Actions — lint, typecheck, build, test | core-ci |
Features
| Topic | Description | Reference |
|---|---|---|
| Runtime | src/runtime/ layout, plugins/composables/components, mkdist | features-runtime |
| Types generation | types.d.mts, ModuleOptions inference, shims | features-types-generation |
| Build config | build.config.ts, extra entries, unbuild preset | features-build-config |
Best Practices
| Topic | Description | Reference |
|---|---|---|
| Package exports | exports, typesVersions, prepack, files | best-practices-package-exports |
| Setup patterns | createResolver, addPlugin without extension | best-practices-setup-patterns |
Assets
| Asset | Description |
|---|---|
| ci.yml | GitHub Actions CI workflow template — copy to .github/workflows/ci.yml |