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 |
1---2name: arch-nuxt-module-builder3description: Build and ship Nuxt modules with @nuxt/module-builder. Use when scaffolding, building, or maintaining a Nuxt module (unbuild preset, types, runtime).4---5
6arch-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.
7
8> The skill is based on @nuxt/module-builder v1.0.2, generated at 2026-01-30.
9
10## Core References
11
12| Topic | Description | Reference |
13|-------|-------------|-----------|
14| Overview | What module-builder is, requirements, quick start | [core-overview](references/core-overview.md) |
15| Project structure | src/module.ts, src/runtime/, package.json, build.config.ts | [core-project-structure](references/core-project-structure.md) |
16| Module definition | defineNuxtModule, ModuleOptions, hooks, runtime config types | [core-module-definition](references/core-module-definition.md) |
17| Dist output | module.mjs, module.json, types.d.mts, runtime/* | [core-dist-output](references/core-dist-output.md) |
18| CLI | nuxt-module-build build/prepare, args (cwd, outDir, stub) | [core-cli](references/core-cli.md) |
19| CI | GitHub Actions — lint, typecheck, build, test | [core-ci](references/core-ci.md) |
20
21## Features
22
23| Topic | Description | Reference |
24|-------|-------------|-----------|
25| Runtime | src/runtime/ layout, plugins/composables/components, mkdist | [features-runtime](references/features-runtime.md) |
26| Types generation | types.d.mts, ModuleOptions inference, shims | [features-types-generation](references/features-types-generation.md) |
27| Build config | build.config.ts, extra entries, unbuild preset | [features-build-config](references/features-build-config.md) |
28
29## Best Practices
30
31| Topic | Description | Reference |
32|-------|-------------|-----------|
33| Package exports | exports, typesVersions, prepack, files | [best-practices-package-exports](references/best-practices-package-exports.md) |
34| Setup patterns | createResolver, addPlugin without extension | [best-practices-setup-patterns](references/best-practices-setup-patterns.md) |
35
36## Assets
37
38| Asset | Description |
39|-------|-------------|
40| [ci.yml](assets/ci.yml) | GitHub Actions CI workflow template — copy to `.github/workflows/ci.yml` |