About nitro
A skill for working with Nitro v3, a framework- and deployment-agnostic server toolkit used by Nuxt and standalone projects. It covers routing, storage, caching, server features, and deployment configuration, including v2-to-v3 migration guidance.
Key features
- 01Filesystem routing and route rules
- 02KV storage and caching
- 03Runtime configuration and deployment presets
- 04Scheduled tasks, WebSockets, and SSE
- 05SQL database and OpenAPI documentation
- 06v2-to-v3 migration guidance
Use cases
- 01Building server routes for a Nitro project
- 02Configuring caching and KV storage
- 03Adding scheduled tasks or WebSocket handlers
- 04Planning a migration from nitropack v2
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ onmax/ nuxt-skills --skill nitroAfter installing, type/nitroin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/advanced-migration.mdcore-assets.mdcore-cache.mdcore-configuration.mdcore-rendering.mdcore-routing.mdcore-storage.mddeploy-presets.mdfeatures-database.mdfeatures-openapi.mdfeatures-plugins.mdfeatures-tasks.mdfeatures-websocket.mdDetails
From the project READMEThe skill is based on Nitro v3 (beta, 3.0.260903), generated at 2026-09-25.
Nitro is a framework-agnostic, deployment-agnostic server toolkit powered by H3 v2, unstorage, and Vite/Rolldown/Rollup. It powers Nuxt and works standalone. From one codebase it builds optimized output for Node.js, Bun, Deno, Cloudflare, Vercel, Netlify, and more.
Key capabilities:
- Filesystem routing with H3 v2 event handlers, dynamic params, and method suffixes.
- Route rules for declarative caching, headers, redirects, proxying, and CORS.
- Caching layer (cached handlers/functions, SWR) on top of the unstorage KV layer.
- Runtime config overridable via
NITRO_*env vars. - Tasks (on-demand + scheduled/cron), WebSockets/SSE, a SQL database layer, and OpenAPI auto-docs.
- Plugins & lifecycle hooks, custom renderer/server entry, and portable deployment presets.
Key v3 changes (vs.
nitropackv2): the package is renamednitropack→nitrowith H3 v2 (web-standardRequest/Response); auto-imports are removed (import everything explicitly); directory scanning is opt-in viaserverDir;useStorage→useKV(nitro/kv) and thestorageconfig option →kv; cacheswrnow defaults tofalse. If unsure about v2-vs-v3 APIs, read advanced-migration first.
Core
| Topic | Description | Reference |
|---|---|---|
| Routing | File-based routes, defineHandler, params, middleware, route rules, errors | core-routing |
| Configuration | nitro.config.ts, defineConfig, key options, runtime config | core-configuration |
| Storage | unstorage KV, mount points, drivers, dynamic mounts | core-storage |
| Cache | defineCachedHandler, defineCachedFunction, SWR, invalidation | core-cache |
| Assets | Public assets, compression, server assets via storage | core-assets |
| Rendering | Renderer (HTML/SSR), server entry, framework integration | core-rendering |
Features
| Topic | Description | Reference |
|---|---|---|
| Plugins & Hooks | definePlugin, runtime lifecycle hooks, error capture | features-plugins |
| Tasks | On-demand & scheduled (cron) tasks, runTask | features-tasks |
| WebSocket & SSE | defineWebSocketHandler, pub/sub, namespaces, event streams | features-websocket |
| Database | Built-in SQL layer via db0, useDatabase, connectors | features-database |
| OpenAPI | Auto spec from defineRouteMeta, Scalar/Swagger UIs | features-openapi |
Advanced / Deployment
| Topic | Description | Reference |
|---|---|---|
| Deployment Presets | Runtimes & providers, compatibility dates, platform integration | deploy-presets |
| v2 → v3 Migration | Package rename, nitro/* imports, H3 v2 API, preset changes | advanced-migration |