Nuxt

What it does

This Nuxt skill provides progressive guidance for developing projects using Nuxt 4 and later versions, focusing on modern patterns and conventions. It offers targeted information based on your current task within a Nuxt project, helping you navigate server routes, file-based routing, middleware, plugins, and core Nuxt features like auto-imports and layers. The skill avoids loading all documentation at once, instead providing relevant files as needed to optimize token usage.

When to use it

• Developing API endpoints or server middleware: Access guidance on server-side logic and validation.
• Setting up pages and routing: Learn about file-based routing, route groups, and the typed router in Nuxt 4.
• Working with composables and data fetching: Get help using useRequestURL, useFetch, and navigation functions.
• Implementing middleware or plugins: Understand how to create route guards and app lifecycle extensions.
• Configuring your Nuxt project: Find information on modules, auto-imports, and layers within nuxt.config.ts.

Key capabilities

• Provides targeted guidance based on the current file being edited (e.g., server routes, routing files).
• Offers references to specific documentation files: references/server.md, references/routing.md, references/middleware-plugins.md, references/nuxt-composables.md, references/nuxt-components.md, references/nuxt-config.md.
• Highlights key differences between Nuxt 2/3 and Nuxt 4, such as <NuxtPage /> replacing <Nuxt /> and changes to accessing route parameters.
• Suggests consulting external resources like the official Nuxt documentation (https://nuxt.com/docs), h3 (https://v1.h3.dev/), and Nitro (https://nitro.build/) for advanced topics or breaking changes.

Example prompts

• "I'm creating an API endpoint in my Nuxt 4 project, what should I look at?"
• "How do I set up file-based routing in Nuxt 4?"
• "What's the best way to use useFetch for data fetching in Nuxt 4?"

Tips & gotchas

• Progressive Loading: Only load the relevant reference files based on your current task. Avoid loading all files at once to conserve tokens.
• Nuxt 4 Specificity: This skill is tailored for Nuxt 4 and later versions; older patterns may not apply.
• Token Efficiency: The main skill uses approximately 300 tokens, while each sub-file can range from 800-1500 tokens.