# Arch Nuxt Module Builder

> Build and ship Nuxt modules with @nuxt/module-builder. Use when scaffolding, building, or maintaining a Nuxt module (unbuild preset, types, runtime).

- Skill: `hairyf-skills/arch-nuxt-module-builder` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add hairyf-skills/arch-nuxt-module-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hairyf-skills/arch-nuxt-module-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hairyf (https://skillmd.com/u/hairyf-skills)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/hairyf-skills/arch-nuxt-module-builder

---


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](references/core-overview.md) |
| Project structure | src/module.ts, src/runtime/, package.json, build.config.ts | [core-project-structure](references/core-project-structure.md) |
| Module definition | defineNuxtModule, ModuleOptions, hooks, runtime config types | [core-module-definition](references/core-module-definition.md) |
| Dist output | module.mjs, module.json, types.d.mts, runtime/* | [core-dist-output](references/core-dist-output.md) |
| CLI | nuxt-module-build build/prepare, args (cwd, outDir, stub) | [core-cli](references/core-cli.md) |
| CI | GitHub Actions — lint, typecheck, build, test | [core-ci](references/core-ci.md) |

## Features

| Topic | Description | Reference |
|-------|-------------|-----------|
| Runtime | src/runtime/ layout, plugins/composables/components, mkdist | [features-runtime](references/features-runtime.md) |
| Types generation | types.d.mts, ModuleOptions inference, shims | [features-types-generation](references/features-types-generation.md) |
| Build config | build.config.ts, extra entries, unbuild preset | [features-build-config](references/features-build-config.md) |

## Best Practices

| Topic | Description | Reference |
|-------|-------------|-----------|
| Package exports | exports, typesVersions, prepack, files | [best-practices-package-exports](references/best-practices-package-exports.md) |
| Setup patterns | createResolver, addPlugin without extension | [best-practices-setup-patterns](references/best-practices-setup-patterns.md) |

## Assets

| Asset | Description |
|-------|-------------|
| [ci.yml](assets/ci.yml) | GitHub Actions CI workflow template — copy to `.github/workflows/ci.yml` |