.gemini/skills/nuxt/SKILL.md
Use when working on Nuxt 4+ projects - provides server routes, file-based routing, middleware patterns, Nuxt-specific composables, and configuration with latest docs. Covers h3 v1 helpers (validation, WebSocket, SSE) and nitropack v2 patterns.
npx skillsauth add hdkiller/coach nuxtInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Progressive guidance for Nuxt 4+ projects with latest patterns and conventions.
Working with:
Read specific files based on current work:
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
Progressive loading - only read what you need:
DO NOT read all files at once. Load based on context:
server/ → read server.mdpages/ or layouts/ → read routing.mduseFetch, useRequestURL, navigation → read nuxt-composables.md<a>, <img>, <time> elements → read nuxt-components.mdmiddleware/ or plugins/ → read middleware-plugins.mdnuxt.config.ts → read nuxt-config.mdYou 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.
When to fetch latest docs:
Official sources:
Main skill: ~300 tokens. Each sub-file: ~800-1500 tokens. Only load files relevant to current task.
development
Use when editing .vue files, creating Vue 3 components, writing composables, or testing Vue code - provides Composition API patterns, props/emits best practices, VueUse integration, and reactive destructuring guidance
tools
Use when authoring TypeScript libraries - covers project setup, package exports, build tooling (tsdown/unbuild), API design patterns, type inference tricks, testing, and release workflows. Patterns extracted from 20+ high-quality ecosystem libraries.
development
Use when building with Reka UI (headless Vue components) - provides component API, accessibility patterns, composition (asChild), controlled/uncontrolled state, virtualization, and styling integration. Formerly Radix Vue.
development
Use when building styled UI with @nuxt/ui v4 components (Button, Modal, Form, Table, etc.) - provides ready-to-use components with Tailwind Variants theming. Use vue skill for raw component patterns, reka-ui for headless primitives.