elsabro 2.1.0 → 2.2.0

package/skills/api-setup.md

@@ -1,6 +1,16 @@
 ---
 name: api-setup
 description: Skill para crear APIs y endpoints. Usa este skill cuando el usuario quiere crear una API, backend, o endpoints.
+tags:
+  - api
+  - backend
+  - rest
+  - hono
+  - express
+  - fastify
+  - typescript
+difficulty: intermediate
+estimated_time: 25-40 min
 ---
 
 # Skill: Setup de API/Backend
@@ -16,6 +26,26 @@ Usar cuando el usuario menciona:
 - "rutas" (en contexto de backend)
 </when_to_use>
 
+<pre_requisites>
+## Pre-requisitos
+
+### Conocimientos
+- JavaScript/TypeScript basico
+- Conceptos HTTP (GET, POST, PUT, DELETE)
+- JSON
+- Terminal/CLI basico
+
+### Software
+- Node.js 20+ LTS
+- npm, yarn, o pnpm
+- Editor de codigo (VS Code recomendado)
+- Cliente HTTP para testing (curl, Postman, Insomnia, o Thunder Client)
+
+### Opcional
+- Docker (para containerizacion)
+- Base de datos (PostgreSQL, MySQL, MongoDB segun necesidad)
+</pre_requisites>
+
 <before_starting>
 ## Investigación Obligatoria
 
@@ -53,7 +83,7 @@ Usar cuando el usuario menciona:
 src/app/api/[endpoint]/route.ts
 ```
 
-### Proyecto nuevo → Hono (Recomendado)
+### Proyecto nuevo → Hono 4.x (Recomendado)
 
 **Pros:**
 - Ligero y rápido
@@ -70,12 +100,55 @@ npm create hono@latest my-api
 
 | Opción | Cuándo Usar |
 |--------|-------------|
-| Express | Equipo ya lo conoce |
-| Fastify | Necesita máximo rendimiento |
+| Express 5.x | Equipo ya lo conoce |
+| Fastify 5.x | Necesita maximo rendimiento |
 | tRPC | Frontend y backend TypeScript |
 | GraphQL | Queries complejas, múltiples clientes |
 </options_by_context>
 
+<project_structure>
+## Estructura de Proyecto
+
+### Hono Standalone API
+```
+my-api/
+├── src/
+│   ├── index.ts              # Entry point
+│   ├── routes/               # Route handlers
+│   │   ├── users.ts
+│   │   ├── products.ts
+│   │   └── index.ts          # Route aggregator
+│   ├── middleware/           # Custom middleware
+│   │   ├── auth.ts
+│   │   └── validation.ts
+│   ├── lib/                  # Utilities
+│   │   ├── db.ts
+│   │   └── utils.ts
+│   └── types/                # TypeScript types
+│       └── index.ts
+├── tests/                    # Test files
+├── package.json
+├── tsconfig.json
+└── .env
+```
+
+### Next.js API Routes
+```
+src/
+└── app/
+    └── api/
+        ├── users/
+        │   ├── route.ts           # GET /api/users, POST /api/users
+        │   └── [id]/
+        │       └── route.ts       # GET/PUT/DELETE /api/users/[id]
+        ├── products/
+        │   └── route.ts
+        └── webhooks/
+            └── stripe/
+                └── route.ts
+```
+</project_structure>
+
 <nextjs_api_setup>
 ## API Routes en Next.js
 

package/skills/auth-setup.md

@@ -1,6 +1,15 @@
 ---
 name: auth-setup
 description: Skill para implementar autenticación en cualquier proyecto. Usa este skill cuando el usuario quiere login, registro, o manejo de usuarios.
+tags:
+  - authentication
+  - security
+  - next-auth
+  - login
+  - users
+  - sessions
+difficulty: intermediate
+estimated_time: 30-60 minutes
 ---
 
 # Skill: Setup de Autenticación
@@ -16,6 +25,37 @@ Usar cuando el usuario menciona:
 - "contraseñas"
 </when_to_use>
 
+<pre_requisites>
+## Pre-requisitos
+
+- Node.js 18+ instalado
+- Next.js 14+ o 15+ (para NextAuth v5)
+- Base de datos configurada (ver skill: database-setup)
+- Variables de entorno configuradas (NEXTAUTH_SECRET, NEXTAUTH_URL)
+</pre_requisites>
+
+<project_structure>
+## Estructura de Archivos Resultante
+
+```
+proyecto/
+├── src/
+│   ├── lib/
+│   │   └── auth.ts                    # Configuracion NextAuth
+│   ├── app/
+│   │   └── api/
+│   │       └── auth/
+│   │           └── [...nextauth]/
+│   │               └── route.ts       # Route handlers
+│   └── middleware.ts                  # Proteccion de rutas
+├── .env.local
+│   ├── NEXTAUTH_SECRET=...
+│   ├── NEXTAUTH_URL=...
+│   └── [PROVIDER_SECRETS]=...
+└── package.json                       # + next-auth@5.0.0-beta.25
+```
+</project_structure>
+
 <before_starting>
 ## Investigación Obligatoria
 
@@ -48,7 +88,7 @@ Usar cuando el usuario menciona:
 
 **Setup:**
 ```bash
-npm install next-auth@beta
+npm install next-auth@5.0.0-beta.25
 ```
 
 ### Expo/React Native → Supabase Auth
@@ -80,14 +120,14 @@ npx expo install @supabase/supabase-js
 
 ### Paso 1: Instalar
 ```bash
-npm install next-auth@beta
+npm install next-auth@5.0.0-beta.25
 ```
 
 ### Paso 2: Crear auth.ts
 ```typescript
 // src/lib/auth.ts
-// VERIFICAR patrón actual con Context7
-import NextAuth from "next-auth"
+// NextAuth v5.0.0-beta.25 pattern
+import NextAuth from "next-auth" // v5.x
 import Credentials from "next-auth/providers/credentials"
 
 export const { handlers, auth, signIn, signOut } = NextAuth({
@@ -109,7 +149,7 @@ export const { handlers, auth, signIn, signOut } = NextAuth({
 ### Paso 3: Crear route handler
 ```typescript
 // src/app/api/auth/[...nextauth]/route.ts
-// VERIFICAR con Context7
+// NextAuth v5.x route handlers
 import { handlers } from "@/lib/auth"
 export const { GET, POST } = handlers
 ```
@@ -117,7 +157,7 @@ export const { GET, POST } = handlers
 ### Paso 4: Crear middleware
 ```typescript
 // src/middleware.ts
-// VERIFICAR con Context7
+// NextAuth v5.x middleware pattern
 export { auth as middleware } from "@/lib/auth"
 
 export const config = {