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://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

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