About nuxt
A progressive guidance skill for Nuxt 4+ developers, with focused references for server routes, routing, middleware, composables, and configuration.
Key features
- 01Server routes and middleware
- 02File-based routing guidance
- 03Plugins and lifecycle patterns
- 04Nuxt composables reference
- 05Configuration and modules
Use cases
- 01Creating API endpoints
- 02Setting up pages and routes
- 03Adding middleware and plugins
- 04Configuring Nuxt modules
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nuxt-content/ nuxt-studio --skill nuxtAfter installing, type/nuxtin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/middleware-plugins.mdnuxt-components.mdnuxt-composables.mdnuxt-config.mdproject-setup.mdrouting.mdserver.mdDetails
From the project READMENuxt 4+ Development
Progressive guidance for Nuxt 4+ projects with latest patterns and conventions.
When to Use
Working with:
- Server routes (API endpoints, server middleware, server utils)
- File-based routing (pages, layouts, route groups)
- Nuxt middleware (route guards, navigation)
- Nuxt plugins (app extensions)
- Nuxt-specific features (auto-imports, layers, modules)
Available Guidance
Read specific files based on current work:
- references/server.md - API routes, server middleware, validation (Zod), WebSocket, SSE
- references/routing.md - File-based routing, route groups, typed router, definePage
- references/middleware-plugins.md - Route middleware, plugins, app lifecycle
- references/nuxt-composables.md - Nuxt composables (useRequestURL, useFetch, navigation)
- references/nuxt-components.md - NuxtLink, NuxtImg, NuxtTime (prefer over HTML elements)
- references/nuxt-config.md - Configuration, modules, auto-imports, layers
For Vue composables: See vue skill composables.md (VueUse, Composition API patterns)
For UI components: use nuxt-ui skill
For database/storage: use nuxthub skill
For content-driven sites: use nuxt-content skill
For creating modules: use nuxt-modules skill
For project scaffolding/CI: use personal-ts-setup skill
Usage Pattern
Progressive loading - only read what you need:
- Creating API endpoint? → references/server.md
- Setting up pages/routing? → references/routing.md
- Using composables/data fetching? → references/nuxt-composables.md
- Adding middleware/plugins? → references/middleware-plugins.md
- Configuring Nuxt? → references/nuxt-config.md
- Setting up CI/ESLint? → references/project-setup.md
DO NOT read all files at once. Load based on context:
- Working in
server/→ read server.md - Working in
pages/orlayouts/→ read routing.md - Using
useFetch,useRequestURL, navigation → read nuxt-composables.md - Using
<a>,<img>,<time>elements → read nuxt-components.md - Working in
middleware/orplugins/→ read middleware-plugins.md - Editing
nuxt.config.ts→ read nuxt-config.md
Nuxt 4 vs Older Versions
You are working with Nuxt 4+. Key differences:
| Old (Nuxt 2/3) | New (Nuxt 4) |
|---|---|
<Nuxt /> | <NuxtPage /> |
context.params | getRouterParam(event, 'name') |
window.origin | useRequestURL().origin |
| String routes | Typed router with route names |
| Separate layouts/ | Parent routes with <slot> |
If you're unsure about Nuxt 4 patterns, read the relevant guidance file first.
Latest Documentation
When to fetch latest docs:
- New Nuxt 4 features not covered here
- Module-specific configuration
- Breaking changes or deprecations
- Advanced use cases
Official sources:
- Nuxt: https://nuxt.com/docs
- h3 (server engine): https://v1.h3.dev/
- Nitro: https://nitro.build/
Token Efficiency
Main skill: ~300 tokens. Each sub-file: ~800-1500 tokens. Only load files relevant to current task.