# Nitro

> Nitro es el toolkit de servidor agnóstico de framework (usado por Nuxt) para construir y desplegar servidores web en cualquier lugar: routing, config, caching, tasks, websockets y despliegue en Node/Bun/Deno/Cloudflare/Vercel.

Fuente: https://skillsagentes.com/skills/antfu/skills/nitro
Markdown: https://skillsagentes.com/skills/antfu/skills/nitro.md

Repositorio: https://github.com/antfu/skills
Autor: antfu
Licencia: MIT
Actualizado: hace 4 meses
Coste de contexto: 69 tok instalada, 880 tok al activarse, 14k tok con todos los archivos del bundle
Bundle: 15 archivos, 55 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add antfu/skills --skill nitro --agent claude-code
# Cursor
npx -y skills add antfu/skills --skill nitro --agent cursor
# Codex
npx -y skills add antfu/skills --skill nitro --agent codex
# Gemini CLI
npx -y skills add antfu/skills --skill nitro --agent gemini
# Windsurf
npx -y skills add antfu/skills --skill nitro --agent windsurf
# Cline
npx -y skills add antfu/skills --skill nitro --agent cline
```

## Qué hace

- Provee referencias para construir servidores con Nitro: routing basado en filesystem, route rules, caching, storage y config
- Documenta features como tasks (cron), WebSockets/SSE, capa de base de datos SQL y OpenAPI auto-docs
- Guía deployment agnóstico a Node, Bun, Deno, Cloudflare, Vercel, Netlify y más
- Explica migración de v2 a v3 (nitropack → nitro, adopción de H3 v2)

## Cuándo usarla

- Trabajando con nitro.config, server routes/event handlers o route rules
- Implementando caching, storage, tasks o websockets en Nitro
- Desplegando a Node/Bun/Deno/Cloudflare/Vercel
- Dudas sobre diferencias de API entre Nitro v2 y v3

## Qué la activa

- "Cómo defino una route rule con caching en nitro.config.ts"
- "Necesito crear un event handler con defineHandler en Nitro"
- "Cómo migro mi proyecto de nitropack a nitro v3"
- "Configura una tarea cron con runTask en Nitro"

## Archivos

- GENERATION.md — 135 B
- SKILL.md — 3 KB
- references/advanced-migration.md — 4 KB
- references/core-assets.md — 3 KB
- references/core-cache.md — 5 KB
- references/core-configuration.md — 4 KB
- references/core-rendering.md — 4 KB
- references/core-routing.md — 6 KB
- references/core-storage.md — 3 KB
- references/deploy-presets.md — 4 KB
- references/features-database.md — 3 KB
- references/features-openapi.md — 3 KB
- references/features-plugins.md — 4 KB
- references/features-tasks.md — 3 KB
- references/features-websocket.md — 4 KB

## SKILL.md

Reproducido tal cual desde antfu/skills bajo MIT. Esta sección es el documento original y está en inglés.

> 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) |

## Dónde encaja

- Categoría: [Desarrollo de APIs](https://skillsagentes.com/categorias/desarrollo-apis.md) — Diseña, prueba y documenta APIs HTTP y GraphQL.
- Creador: [antfu](https://skillsagentes.com/creators/antfu.md) — 19 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Antfu](https://skillsagentes.com/skills/antfu/skills/antfu.md): Herramientas y convenciones de Anthony Fu para proyectos JavaScript/TypeScript: configuración de ESLint, monorepos y publicación de librerías.
- [Antfu Design](https://skillsagentes.com/skills/antfu/skills/antfu-design.md): Convenciones de diseño estilo antfu: tokens semánticos basados en clases con UnoCSS para light/dark, más reglas anti-slop y de micro-interacción para devtools y landing pages.
- [Nuxt](https://skillsagentes.com/skills/antfu/skills/nuxt.md): Framework full-stack Vue con SSR, auto-imports y routing basado en archivos. Úsalo para apps Nuxt, server routes, useFetch, middleware o hybrid rendering.
- [Pnpm](https://skillsagentes.com/skills/antfu/skills/pnpm.md): Gestor de paquetes de Node.js con resolución estricta de dependencias. Úsalo para comandos de pnpm, pnpm-workspace.yaml, catalogs, patches, overrides, config dependencies o el global virtual store.
- [Slidev](https://skillsagentes.com/skills/antfu/skills/slidev.md): Crea y presenta slidedecks web para desarrolladores con Slidev, usando Markdown, componentes Vue, resaltado de código, animaciones y funciones interactivas.

## Skills relacionadas

- [Api And Interface Design](https://skillsagentes.com/skills/addyosmani/agent-skills/api-and-interface-design.md): Guía para diseñar APIs e interfaces estables. Úsalo al diseñar APIs, límites entre módulos, endpoints REST o GraphQL, o contratos de tipos entre frontend y backend.
- [Browser Testing With Devtools](https://skillsagentes.com/skills/addyosmani/agent-skills/browser-testing-with-devtools.md): Prueba en navegadores reales usando Chrome DevTools MCP. Úsalo al construir o depurar cualquier cosa que corra en un navegador, o para inspeccionar DOM, consola, red o rendimiento.
- [Ci Cd And Automation](https://skillsagentes.com/skills/addyosmani/agent-skills/ci-cd-and-automation.md): Automatiza la configuración de pipelines de CI/CD: úsalo al montar o modificar pipelines de build y despliegue, o al configurar puertas de calidad y test runners en CI.
- [Code Review And Quality](https://skillsagentes.com/skills/addyosmani/agent-skills/code-review-and-quality.md): Realiza revisión de código en múltiples ejes. Úsalo antes de fusionar cualquier cambio, sea escrito por ti, otro agente o una persona, para evaluar la calidad antes de entrar a la rama principal.
- [Code Simplification](https://skillsagentes.com/skills/addyosmani/agent-skills/code-simplification.md): Simplifica código para mejorar su claridad sin cambiar su comportamiento, útil al refactorizar o revisar código que acumuló complejidad innecesaria.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)