Skip to content

feat(skills): make skills directory configurable via module options#1341

Merged
larbish merged 4 commits intonuxt-content:mainfrom
francoisauclair911:main
Apr 17, 2026
Merged

feat(skills): make skills directory configurable via module options#1341
larbish merged 4 commits intonuxt-content:mainfrom
francoisauclair911:main

Conversation

@francoisauclair911
Copy link
Copy Markdown
Contributor

Summary

  • Adds a dir option to the skills Nuxt module so users can specify a
    custom skills directory instead of the hardcoded skills/ default
  • Fully backward compatible — defaults to 'skills' when not set
  • Documents the new option in both English and French docs

Usage

// nuxt.config.ts
export default defineNuxtConfig({
  skills: {
    dir: 'agent-skills'
  }
})

Changes

  • layer/modules/skills/index.ts — added ModuleOptions interface, typed
    defineNuxtModule<ModuleOptions>, added defaults: { dir: 'skills' },
    replaced hardcoded path with options.dir
  • docs/content/en/4.ai/3.skills.md — added Configuration section
  • docs/content/fr/4.ai/3.skills.md — added Configuration section (French)

Test plan

  • Run pnpm playground:dev and confirm skills/ is still discovered by default
  • Add skills: { dir: 'custom-dir' } to playground/nuxt.config.ts, create
    a skill there, and confirm it is served at /.well-known/skills/
  • Confirm /.well-known/skills/index.json returns the correct skill

Francois Auclair added 3 commits April 16, 2026 13:16
Add ModuleOptions interface with configurable `dir` option that defaults to 'skills'. This allows consumers to specify a custom directory path for skills instead of being hardcoded to the 'skills' folder.
Documents the `skills.dir` configuration option in nuxt.config.ts that allows users to specify a custom directory for skills instead of the default `skills/` folder. Added to both English and French documentation.
Add skills.dir configuration to playground's nuxt.config.ts to test the configurable skills directory feature that was recently implemented in the module options.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 16, 2026

Someone is attempting to deploy a commit to the NuxtLabs Team on Vercel.

A member of the Team first needs to authorize it.

Copy link
Copy Markdown
Collaborator

@larbish larbish left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your PR! I'll merge this one but I will provide an update in a following PR to expose both assistant and skills config keys in a docus parent.

So once both PR merged and released, you'll have to move your skills dir config in a docus parent.

I'll update doc ofc.

@larbish larbish merged commit 764329f into nuxt-content:main Apr 17, 2026
1 of 2 checks passed
@larbish
Copy link
Copy Markdown
Collaborator

larbish commented Apr 17, 2026

👉 #1346

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants