Agent skill

Nitro Server Toolkit

Reference for Nitro v3, the server toolkit behind Nuxt: file routing, route rules, caching, storage, tasks, websockets and deployment presets.

MITAuto-check passedBackend & APIs

Install Nitro Server Toolkit

skills CLI

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install antfu/skills nitro --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nitro .claude/skills/nitro && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .claude/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/antfu/skills/tree/main/skills/nitro

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add antfu/skills --skill nitro -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install antfu/skills nitro --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nitro .agents/skills/nitro && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .agents/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add antfu/skills --skill nitro -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install antfu/skills nitro --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nitro .cursor/skills/nitro && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .cursor/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/antfu/skills.git --path skills/nitro

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add antfu/skills --skill nitro -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install antfu/skills nitro --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nitro .gemini/skills/nitro && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .gemini/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install antfu/skills nitro

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add antfu/skills --skill nitro -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nitro .github/skills/nitro && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .github/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add antfu/skills --skill nitro -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install antfu/skills nitro --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/antfu/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nitro .opencode/skills/nitro && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "nitro" agent skill from https://github.com/antfu/skills/tree/main/skills/nitro into .opencode/skills/nitro/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nitro", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: nitro
GitHub stars: 5.9k
Token cost: ~948 tokens
SKILL.md length: 290 words
Files: 15 (incl. references)
Skills in repo: 2
Repo updated: Sep 30, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Reference for Nitro v3, the server toolkit behind Nuxt: file routing, route rules, caching, storage, tasks, websockets and deployment presets.

Writing server routes and event handlers in a Nitro project
SKILL.md covers Core, Features and Advanced / Deployment
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Configuring route rules, caching or storage in nitro.config

What it does

Nitro builds one codebase into output for Node.js, Bun, Deno, Cloudflare, Vercel, Netlify and more, and runs on H3 v2 and unstorage. The skill lists its capabilities: filesystem routing with event handlers, route rules for caching, headers, redirects, proxying and CORS, a caching layer with stale-while-revalidate, runtime config overridable by `NITRO_*` variables, scheduled and on-demand tasks, WebSockets and server-sent events, a SQL database layer, OpenAPI docs, plugins with lifecycle hooks and custom renderers.

A notice flags the changes from the older `nitropack` v2: the package is now `nitro`, auto-imports are removed, directory scanning is opt-in through `serverDir`, `useStorage` became `useKV` with a `kv` config option, and cache SWR now defaults to off. Fifteen files in `references` cover routing, configuration, storage, cache, assets, rendering, plugins, tasks, websockets, database, OpenAPI, deploy presets and migration, with a migration page to read first when versions are unclear.

When your agent uses it

Writing server routes and event handlers in a Nitro project
Configuring route rules, caching or storage in nitro.config
Deploying a Nitro app to Cloudflare, Vercel or another preset
Migrating from nitropack v2 to Nitro v3

Example prompts

“Add a cached API route in Nitro that revalidates with SWR and set it up for Cloudflare.”
“Convert this nitropack v2 storage code to the v3 KV API.”
“Create a scheduled Nitro task that runs nightly and write its config.”

Requirements

Node.js, Bun or Deno with a Nitro v3 project

What it can do on your machine

Read from SKILL.md and the folder at commit e53a142. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- h3.dev
- unstorage.unjs.io
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nitro Server Toolkit loads about 948 tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 290 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~71
When it runs · the whole SKILL.md, loaded when a task matches: ~948
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~17k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Download SKILL.mdSave it as .claude/skills/nitro/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.

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
metadata.version: 2026.9.25
metadata.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 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. 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 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

Files

SKILL.md and 14 other files (references) in skills/nitro of antfu/skills.

SKILL.md
GENERATION.md
references/advanced-migration.md
references/core-assets.md
references/core-cache.md
references/core-configuration.md
references/core-rendering.md
references/core-routing.md
references/core-storage.md
references/deploy-presets.md
references/features-database.md
references/features-openapi.md
references/features-plugins.md
references/features-tasks.md
references/features-websocket.md

Open the folder on GitHubat commit e53a142

Compare with similar skills

Nitro Server Toolkit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nitro Server Toolkit compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Nitro Server Toolkit this skillantfu/skills	5.9k	—	~948	Automated safety check: Pass	MIT	7 days ago
Nuxt Productionsecondsky/claude-skills	227	—	~3.3k	Automated safety check: Notes	MIT	9 days ago
Nuxt Productionsecondsky/claude-skills	227	—	~2.7k	Automated safety check: Pass	MIT	9 days ago
Golivemikehasa/golive-skill	1.2k	—	~13k	Automated safety check: Notes	MIT	3 days ago
Edge ComputingTheBeardedBearSAS/claude-craft	107	—	~485	Automated safety check: Pass	MIT	23 days ago
Vercel Functionsvercel/vercel-plugin	301	—	~12k	Automated safety check: Notes	Custom licence	today

Similar skills

Nuxt Production
secondsky/claude-skills
| Nuxt 4 production optimization: hydration, performance, testing with Vitest, deployment to Cloudflare/Vercel/Netlify, and v4 migration.
227 GitHub stars~3.3k tokensUpdated 9 days ago
Testing & QAAuto-check: notes
Nuxt Production
secondsky/claude-skills
| Nuxt 5 production optimization: hydration, performance, testing with Vitest, deployment to Cloudflare/Vercel/Netlify, and migration from Nuxt 4.
227 GitHub stars~2.7k tokensUpdated 9 days ago
Testing & QAAuto-check passed
Golive
mikehasa/golive-skill
Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).
1.2k GitHub stars~13k tokensUpdated 3 days ago
Backend & APIsAuto-check: notes
Edge Computing
TheBeardedBearSAS/claude-craft
Cloudflare Workers, Deno Deploy, Vercel Edge Functions, edge patterns (geo-routing, caching).
107 GitHub stars~485 tokensUpdated 23 days ago
Backend & APIsAuto-check passed
Vercel Functions
vercel/vercel-plugin
Official
Vercel Functions expert guidance — Node.js/Bun/Python runtimes, Fluid Compute, long-duration (30 min) functions, large functions (5 GB bundles), Docker/OCI container images, plan limits, streaming…
301 GitHub stars~12k tokensUpdated today
Backend & APIsAuto-check: notes
Olore Opennext Latest
olorehq/olore
Local opennext documentation reference (latest). An agent skill from olorehq/olore.
103 GitHub stars~825 tokensUpdated today
Backend & APIsAuto-check passed

Questions about Nitro Server Toolkit

What does Nitro Server Toolkit do?

Reference for Nitro v3, the server toolkit behind Nuxt: file routing, route rules, caching, storage, tasks, websockets and deployment presets. js, Bun, Deno, Cloudflare, Vercel, Netlify and more, and runs on H3 v2 and unstorage. The skill lists its capabilities: filesystem routing with event handlers, route rules for caching, headers, redirects, proxying and CORS, a caching layer with stale-while-revalidate, runtime config overridable by `NITRO_*` variables, scheduled and on-demand tasks, WebSockets and server-sent events, a SQL database layer, OpenAPI docs, plugins with lifecycle hooks and custom renderers.

When should I use Nitro Server Toolkit?

Nitro Server Toolkit fits situations like: writing server routes and event handlers in a Nitro project; configuring route rules, caching or storage in nitro.config; deploying a Nitro app to Cloudflare, Vercel or another preset; migrating from nitropack v2 to Nitro v3.

How do I install Nitro Server Toolkit in Claude Code?

Run `npx skills add antfu/skills --skill nitro -a claude-code`. Or copy the skill folder (skills/nitro in antfu/skills) into .claude/skills/nitro in your project. Claude Code loads it when a task matches its description.

How do I install Nitro Server Toolkit in Codex?

Run `npx skills add antfu/skills --skill nitro -a codex`. Or copy the skill folder (skills/nitro in antfu/skills) into .agents/skills/nitro in your project. Codex loads it when a task matches its description.

Can I use Nitro Server Toolkit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add antfu/skills --skill nitro -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nitro, .gemini/skills/nitro, .github/skills/nitro and .opencode/skills/nitro in your project.

What does Nitro Server Toolkit need to run?

SKILL.md names no scripts, command-line tools or credentials: Nitro Server Toolkit is instructions for the agent only. Our summary lists: Node.js, Bun or Deno with a Nitro v3 project.

Does Nitro Server Toolkit access the network?

SKILL.md names 2 domains. As links in the text: h3.dev and unstorage.unjs.io. This is read from the text; nothing was executed.

Is Nitro Server Toolkit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nitro Server Toolkit use?

Nitro Server Toolkit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nitro Server Toolkit use?

About 948 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.

What are the alternatives to Nitro Server Toolkit?

Skills that share tags, products or a category with Nitro Server Toolkit: Nuxt Production (secondsky/claude-skills, 227 stars), Nuxt Production (secondsky/claude-skills, 227 stars), Golive (mikehasa/golive-skill, 1.2k stars) and Edge Computing (TheBeardedBearSAS/claude-craft, 107 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nitro Server Toolkit?

antfu (a GitHub user) maintains it in antfu/skills, which has 5,943 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 30, 2026.

Source: antfu/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Nitro Server Toolkit

Install Nitro Server Toolkit

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Core

Features

Advanced / Deployment

Files

Compare with similar skills

Similar skills

Nuxt Production

Nuxt Production

Golive

Edge Computing

Vercel Functions

Olore Opennext Latest

More from antfu/skills

Create Pull Request

Questions about Nitro Server Toolkit

Install Nitro Server Toolkit

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Core

Features

Advanced / Deployment

Files

Compare with similar skills

Similar skills

Nuxt Production

Nuxt Production

Golive

Edge Computing

Vercel Functions

Olore Opennext Latest

More from antfu/skills

Create Pull Request

Related

Questions about Nitro Server Toolkit