Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

nitro — Claude Code skill for server routes, cache, deploys

A skill with Nitro v3 references: file-based routing, route rules, caching, storage and deployment presets. Use it when the agent edits nitro.config or writes H3 handlers.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add antfu/skills --skill nitro -a claude-code
Open on GitHub

What nitro does

The skill is generated from Nitro v3 docs (beta, 3.0.260903) and covers the server toolkit that powers Nuxt but also works standalone. References include routing, configuration, storage, cache, assets and rendering, with separate files for tasks, WebSocket, database and OpenAPI.

The big shift from v2: the package is renamed nitropack to nitro, H3 moves to v2 with web-standard Request/Response, and auto-imports are gone — everything is imported explicitly. Directory scanning is opt-in via serverDir, useStorage becomes useKV from nitro/kv, and cache swr defaults to false.

When the agent is unsure which API version applies, the skill ships an advanced-migration.md reference — read that first. The skill does not install Nitro itself; the library and its dependencies belong in the project.

What it helps with

  • map file-based routes and dynamic H3 v2 params
  • set route rules for cache, headers, redirects, CORS
  • wire up unstorage KV mounts
  • add cron tasks and WebSocket handlers
  • build for Node, Bun, Deno, Cloudflare or Vercel

Example prompts for the agent

  • Add a handler for /api/users with a dynamic id param
  • Set a route rule so /api is cached for an hour
  • Migrate this code from useStorage to useKV from nitro/kv

How to install nitro

1Skills CLI (Vercel)

npx skills add antfu/skills --skill nitro -a claude-code

2Manually: put the files in place

~/.claude/skills/nitro/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/nitro/

From the same set8

The whole set →
vitest Anthony Fu This skill guides work with Vitest tests, mocks, coverage, filtering, and fixtures. Use it when setting up tests or checking how Vitest fits a Vite project. Claude Code CX Codex Cursor +1 43,600installs vite Anthony Fu This skill covers Vite configuration, plugin development, SSR builds, and the Vite 8 move to Rolldown. Use it with vite.config.ts work. Claude Code CX Codex Cursor +1 39,800installs vue Anthony Fu This skill guides agents through Vue 3 Composition API, script setup, and reactivity. Use it when writing Vue SFCs or built-in component flows. Claude Code CX Codex Cursor +1 35,800installs nuxt Anthony Fu This skill equips your AI agent with Nuxt 5 knowledge: server-side rendering, file-based routing, auto-imports, and Nitro v3 deployment. Use it when building Nuxt apps, server routes, useFetch calls, middleware, or hybrid rendering. Claude Code CX Codex Cursor +1 24,100installs pnpm Anthony Fu Skill for working with pnpm, a Node.js package manager with strict dependency resolution. Use it when your project relies on workspaces, version catalogs, patches, or dependency overrides. Claude Code CX Codex Cursor +1 22,300installs pinia Anthony Fu Pinia skill adds reference documentation to Claude Code for the official Vue state management library. Use it when defining stores, managing state, getters, and actions in Vue apps. Claude Code CX Codex Cursor +1 19,700installs unocss Anthony Fu A skill that gives the agent reference material on UnoCSS configuration, rules, shortcuts and presets. Useful when setting up UnoCSS or reusing Tailwind knowledge in it. Claude Code CX Codex Cursor +1 16,000installs

Similar

eval-harness-first Seth Hobson Builds the evaluation harness before fine-tuning with goldens, graders, judge calibration, and a base-model baseline. Useful for tracking regressions. Claude Code CX Codex Cursor 2,600installs cron-schedule ruvnet Schedules background worker runs via CronCreate during an active session. Useful for recurring security audits, test gap reviews, and codebase mapping. Claude Code CX Codex Cursor +1 902installs react-email vercel-labs Turns JSON email specs into HTML or plain-text output with React Email. Use it for email catalogs, generated specs, and transactional message templates. Claude Code CX Codex Cursor +1 1,400installs validate-skills Callstack Checks skills in skills/ against the agentskills.io specification and Claude Code practices. Use it when authoring or reviewing a skill collection. Claude Code CX Codex Cursor +1 7,200installs image-to-ui UIZZE Turn a screenshot, mockup, or sketch into working interface code. The skill views the image, reproduces it exactly in code, then renders and compares to fix any mismatches. Claude Code CX Codex Cursor +1 63,500installs mmx-cli MiniMax-AI Teaches your agent to use the MiniMax CLI directly from the terminal. Helps generate text, images, video, speech, and music inside coding workflows. Claude Code CX Codex Cursor +1 1,600installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs

Questions about nitro

How do I install nitro in Claude Code?

Run npx skills add antfu/skills --skill nitro -a claude-code. The skill lands in ~/.claude/skills/nitro/SKILL.md.

What does the nitro skill do?

It gives the agent Nitro v3 references: file-based routing, route rules, caching on top of unstorage, runtime config via NITRO_*, tasks, WebSocket, the SQL layer and deployment presets.

How is Nitro v3 different from v2?

The package is renamed from nitropack to nitro, H3 is v2 with web-standard Request/Response. Auto-imports are removed, directory scanning is opt-in via serverDir, useStorage is replaced by useKV, and cache swr defaults to false.

Source text

SKILL.md · MIT
---
name: nitro
description: Nitro is the framework-agnostic server toolkit (powering Nuxt) for building and deploying web servers anywhere. Use when working with nitro.config, server routes/event handlers, route rules, caching, storage, tasks, websockets, or deploying to Node/Bun/Deno/Cloudflare/Vercel.
metadata:
  author: Anthony Fu
  version: "2026.9.25"
  source: Generated from https://github.com/nitrojs/nitro, scripts located at https://github.com/antfu/skills
---

> The 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](https://h3.dev) v2, [unstorage](https://unstorage.unjs.io), 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. `nitropack` v2): the package is renamed `nitropack` → `nitro` with H3 v2 (web-standard `Request`/`Response`); **auto-imports are removed** (import everything explicitly); directory scanning is **opt-in** via `serverDir`; `useStorage` → `useKV` (`nitro/kv`) and the `storage` config option → `kv`; cache `swr` now defaults to `false`. If unsure about v2-vs-v3 APIs, read [advanced-migration](references/advanced-migration.md) first.

## Core

| Topic | Description | Reference |
|-------|-------------|-----------|
| Routing | File-based routes, `defineHandler`, params, middleware, route rules, errors | [core-routing](references/core-routing.md) |
| Configuration | `nitro.config.ts`, `defineConfig`, key options, runtime config | [core-configuration](references/core-configuration.md) |
| Storage | unstorage KV, mount points, drivers, dynamic mounts | [core-storage](references/core-storage.md) |
| Cache | `defineCachedHandler`, `defineCachedFunction`, SWR, invalidation | [core-cache](references/core-cache.md) |
| Assets | Public assets, compression, server assets via storage | [core-assets](references/core-assets.md) |
| Rendering | Renderer (HTML/SSR), server entry, framework integration | [core-rendering](references/core-rendering.md) |

## Features

| Topic | Description | Reference |
|-------|-------------|-----------|
| Plugins & Hooks | `definePlugin`, runtime lifecycle hooks, error capture | [features-plugins](references/features-plugins.md) |
| Tasks | On-demand & scheduled (cron) tasks, `runTask` | [features-tasks](references/features-tasks.md) |
| WebSocket & SSE | `defineWebSocketHandler`, pub/sub, namespaces, event streams | [features-websocket](references/features-websocket.md) |
| Database | Built-in SQL layer via db0, `useDatabase`, connectors | [features-database](references/features-database.md) |
| OpenAPI | Auto spec from `defineRouteMeta`, Scalar/Swagger UIs | [features-openapi](references/features-openapi.md) |

## Advanced / Deployment

| Topic | Description | Reference |
|-------|-------------|-----------|
| Deployment Presets | Runtimes & providers, compatibility dates, platform integration | [deploy-presets](references/deploy-presets.md) |
| v2 → v3 Migration | Package rename, `nitro/*` imports, H3 v2 API, preset changes | [advanced-migration](references/advanced-migration.md) |

© Anthony Fu · MIT · antfu/skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor