nuxt-skills

Expose a local skills/ directory as Agent Skills discovery files under /.well-known/skills/.

nuxt-skills

npm version npm downloads License pkg.pr.new

Nuxt module for exposing local skills as .well-known files.

  • 🔎 Scans a local skills/ directory
  • ⚡ Serves the skills index and files in dev
  • 📦 Emits the same files during Nuxt builds

Installation

pnpm add -D nuxt-skills

Usage

Add the module to your Nuxt config.

export default defineNuxtConfig({
  modules: ['nuxt-skills'],
})

Options

Options use the same shape as unplugin-skills; the Nuxt module scans the skills directory, registers Nitro server assets, and exposes the .well-known routes through server handlers.

export default defineNuxtConfig({
  modules: ['nuxt-skills'],
  skills: {
    dir: 'skills',
  },
})

See unplugin-skills for skill directory structure and validation rules.

Credits

Heavily inspired by the Docus skills module. Huge thanks to the Nuxt team.

Sponsors

Sponsor Barbapapazes

License

MIT License © 2026-PRESENT Estéban Soubiran