Nitro — Agent Skill by Anthony Fu

From the author

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.

— the description by Anthony Fu

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Nitro is a server toolkit designed to build and deploy web servers that run on Node.js, Bun, Deno, and various cloud platforms like Cloudflare, Vercel, and Netlify. It provides a unified codebase for server development, featuring filesystem-based routing, a built-in KV storage layer, caching mechanisms, and support for tasks, WebSockets, and OpenAPI documentation. Nitro v3 introduces significant changes including a package rename, the removal of auto-imports, and a shift toward web-standard H3 v2 APIs.

What it does

Provides filesystem-based routing with H3 v2 event handlers.
Manages server configuration and runtime settings via nitro.config.ts.
Handles caching and storage using an unstorage-based KV layer.
Supports on-demand and scheduled tasks, WebSockets, and SSE.
Generates OpenAPI specifications automatically from route metadata.
Enables deployment to multiple runtimes and platforms through presets.

When to use it

When building a web server that needs to be portable across different deployment environments.
When you require a unified toolkit for handling routing, storage, and caching in a server project.
When migrating existing server projects from Nitro v2 to v3.
When you need to implement server-side tasks, WebSockets, or OpenAPI documentation.

Advantages

Framework-agnostic design allows for use with or without other frameworks.
Deployment-agnostic architecture supports a wide range of runtimes and cloud providers.
Unified storage and caching layer simplifies data management.
Declarative route rules for handling redirects, headers, and CORS.
Built-in support for modern web standards via H3 v2.

Usage examples

“How do I define a basic server route in Nitro v3?”: You create a file in your server directory and export a handler using defineHandler from the nitro package.
“How do I access KV storage in my Nitro server?”: You use the useKV function imported from nitro/kv to interact with your configured storage mount points.
“What is the correct way to import Nitro utilities in v3?”: You must use explicit imports from specific subpaths like nitro, nitro/kv, or nitro/h3, as auto-imports are no longer supported.
“How do I configure public assets in Nitro?”: You define a publicAssets array in your nitro.config.ts file, specifying the directory and base URL for your assets.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/antfu/nitro/download
Unzip it into the cross-client skills folder of your project:
```
mkdir -p .agents/skills && unzip nitro.zip -d .agents/skills
```

Documentation by Anthony Fu

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

ATTRIBUTION.mdAdded by AutoGineer892 B
GENERATION.md135 B
LICENSELicence file added by AutoGineer1.1 KiB
SKILL.md3.7 KiB
references/advanced-migration.md6.8 KiB
references/core-assets.md3.7 KiB
references/core-cache.md7.9 KiB
references/core-configuration.md5.7 KiB
references/core-rendering.md5.0 KiB
references/core-routing.md8.3 KiB
references/core-storage.md4.4 KiB
references/deploy-presets.md3.8 KiB
references/features-database.md3.5 KiB
references/features-openapi.md3.5 KiB
references/features-plugins.md3.9 KiB
references/features-tasks.md4.0 KiB
references/features-websocket.md3.8 KiB

LICENSE

MIT License

Copyright (c) 2025-PRESENT Anthony Fu <https://github.com/antfu>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Implement Spec
Matt Pocock· Community
A workflow for implementing technical specifications and tickets using concurrent subagents.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
MCP Builder
AnthropicOfficial
A comprehensive guide for building high-quality Model Context Protocol (MCP) servers to integrate external services with LLMs.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskHas scriptsGitHub stars of the source repository188.6k
Schema
Corey Haines· Community
Expert guidance for implementing and optimizing JSON-LD schema markup to improve search engine content understanding.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository59k
Postgresql Table Design
Seth Hobson· Community
A comprehensive guide for designing, reviewing, and optimizing PostgreSQL database schemas.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
SQL Optimization Patterns
Seth Hobson· Community
A comprehensive guide to optimizing SQL database performance through indexing, query plan analysis, and efficient coding patterns.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
API Scaffolding Fastapi Pro
Seth Hobson· Community
An expert FastAPI developer focused on high-performance, async-first API architecture and production-ready microservices.
Software developmentClaude Code
MITGitHub stars of the source repository42.3k