Skills para agentes de IA
Si usas un agente de codificación con IA (Claude Code, Cursor, Copilot y similares), configura la carga de skills para que el agente genere código de configuración correcto. Las skills se distribuyen dentro del paquete test-proxy-recorder vía @tanstack/intent y viajan con él a través de las actualizaciones normales de tu gestor de paquetes.
1. Instala la librería (las skills se descubren a partir de los paquetes instalados):
npm install --save-dev test-proxy-recorder2. Escribe la guía del agente — install añade instrucciones de descubrimiento a tu config de agente (CLAUDE.md, .cursorrules, etc.) para que el agente cargue bajo demanda las skills del paquete que correspondan:
npx @tanstack/intent@latest installPasa --map si prefieres escribir asignaciones explícitas de tarea a skill en tu config de agente en lugar de la guía de descubrimiento genérica.
install necesita una terminal interactiva. Un agente que se ejecuta sin ella puede leer las skills desde node_modules/test-proxy-recorder/skills/*/SKILL.md.
El agente conocerá entonces la configuración correcta de proxy/fixture, el flujo de grabar vs. reproducir y los patrones de cabeceras SSR de Next.js sin necesitar orientación.
Las skills
Sección titulada «Las skills»test-proxy-recorder distribuye estas skills:
proxy-setup— la CLI del proxy, los scripts depackage.json, elwebServerdeplaywright.config.ts, los fixtures por prueba, los modos grabar/reproducir/transparente, el enmascaramiento de secretos y el ciclo de grabar una vez → commit → reproducir en CI.nextjs-ssr— etiquetar los fetch del lado del servidor conregisterProxyFetch/registerProxyAxios/createHeadersWithRecordingId, la advertencia de build-and-start frente anext dev, y por qué el middleware es opcional.tanstack-start— etiquetar los loaders, las server functions y las server routes de TanStack Start, la advertencia de build frente avite dev, la división de la URL de la API entre servidor y navegador, el prefetch SSR de TanStack Query y el patrón de auth real.
Lista lo disponible en tus paquetes instalados, o carga una directamente:
npx @tanstack/intent@latest list # muestra las skills detectablesnpx @tanstack/intent@latest load test-proxy-recorder#proxy-setupnpx @tanstack/intent@latest load test-proxy-recorder#nextjs-ssrnpx @tanstack/intent@latest load test-proxy-recorder#tanstack-startMantener las skills (para colaboradores)
Sección titulada «Mantener las skills (para colaboradores)»Las skills del agente viven en packages/test-proxy-recorder/skills/. Revísalas periódicamente — y siempre que cambie la API de la librería o los ejemplos:
npx @tanstack/intent@latest validate # comprobaciones de estructura/formato/límite de líneas (ejecuta antes de hacer commit de ediciones de skills)npx @tanstack/intent@latest stale # señala la deriva de versión frente a la librería publicada — vuelve a revisar las skills que listavalidate debe pasar; stale es orientativo — cuando reporte deriva tras una release, vuelve a revisar el contenido de la skill afectada (y sube su library_version).