About arch-nuxt-module-builder
A reference skill for building and maintaining Nuxt modules with @nuxt/module-builder. It covers the official build stack, from module structure and runtime transformation to generated types and CI.
Key features
- 01Automated module build configuration
- 02Runtime asset transformation
- 03Type and schema shim generation
- 04CLI and CI guidance
- 05Package export practices
Use cases
- 01Starting a Nuxt module with module-builder
- 02Maintaining runtime plugins and components
- 03Preparing module builds for CI
- 04Configuring package exports
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/arch-nuxt-module-builderin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with 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.mdDetails
From the project READMEarch-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 |