Communitygithub.com

mike1026915/performance-audit-skill

Skill de auditoría de rendimiento estática para Claude Code y Cursor: detecta consultas N+1, índices faltantes y código O(n²) en aplicaciones NestJS/Next.js/Prisma/PostgreSQL

¿Qué es performance-audit-skill?

Este skill de auditoría de rendimiento estática analiza el código fuente de proyectos que usan NestJS, Next.js, Prisma y PostgreSQL para identificar patrones anti-rendimiento sin necesidad de ejecutar el servidor ni perfilar la aplicación en vivo. Escanea el código en busca de 35 reglas distribuidas en 5 capas: acceso a datos (consultas N+1, findMany sin límite, sobrecarga de datos), API NestJS (llamadas síncronas bloqueantes, endpoints sin paginación, llamadas externas secuenciales), React/Next.js (bundles pesados no divididos, 'use client' innecesario, falta de debounce en búsquedas), esquema PostgreSQL (índices faltantes en claves foráneas, búsquedas ILIKE no ancladas, columnas vectoriales no indexables) y complejidad algorítmica O(n²) como bucles anidados con búsquedas lineales. Cada regla se verifica en contexto para evitar falsos positivos, y el skill genera un informe clasificado por gravedad (Alta, Media, Baja) con la línea exacta del archivo, la razón de lentitud y una solución concreta. Funciona automáticamente con Claude Code y Cursor, detecta qué capas aplicar según la pila del proyecto y nunca modifica el código.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mike1026915/performance-audit-skill/tree/main

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

performance-audit

Un skill para Claude Code (y una regla compatible con Cursor) que audita estáticamente una base de código NestJS + Next.js + Prisma + PostgreSQL en busca de anti-patrones de rendimiento y genera un informe clasificado por gravedad.

No es necesario tener el servidor en ejecución: funciona escaneando el código fuente, no perfilando una aplicación en vivo.

Qué detecta

35 reglas distribuidas en 5 capas:

CapaCubre
D — Prisma / acceso a datosConsultas N+1, findMany sin límite, sobrecarga de datos, SQL sin límites, trabajo lento dentro de transacciones, E/S paralela sin límite
A — API NestJSLlamadas síncronas bloqueantes en la ruta de la solicitud, endpoints sin paginación, llamadas externas secuenciales, cachés en memoria sin límite
F — Next.js / ReactBundles pesados del cliente no divididos, 'use client' innecesario, obtención inicial de datos desde el cliente, falta de debounce en campos de búsqueda
S — Esquema PostgreSQLÍndices faltantes en claves foráneas / campos de consulta activos, búsqueda ILIKE sin anclaje, columnas vectoriales no indexables
G — Complejidad algorítmicaPatrones O(n²): búsquedas lineales repetidas en bucles, comparaciones pareadas anidadas, ordenamientos dentro de bucles, copias con acumulador mediante spread, clonaciones con JSON.parse(JSON.stringify())

Cada regla se asigna a un patrón de grep, pero cada coincidencia se verifica en contexto antes de ser reportada; los falsos positivos conocidos (consultas acotadas, colecciones pequeñas de tamaño fijo, await secuenciales con dependencia real de datos, etc.) se filtran. Nunca modifica el código — solo genera un informe.

Instalación

Copia esta carpeta dentro de tu proyecto:

# Claude Code
cp -r performance-audit /ruta/a/tu-proyecto/.claude/skills/

# Cursor
cp performance-audit.mdc /ruta/a/tu-proyecto/.cursor/rules/

Eso es todo — sin dependencias, sin paso de compilación.

Uso

Simplemente pregunta, en cualquiera de las herramientas:

revisa el rendimiento encuentra consultas lentas por qué la aplicación va lenta audita el rendimiento del módulo candidato

Puedes acotarlo ("revisa el rendimiento solo en packages/api") o pedir un pase rápido ("revisión rápida de rendimiento" ejecuta solo las reglas de gravedad Alta).

Requisitos

  • Detecta tu pila automáticamente y omite las capas que no aplican (ej. sin archivos *.prisma → las capas D y S se saltan). La capa G (complejidad algorítmica) siempre se ejecuta, ya que es TS/JS puro, no específico de un framework.
  • Construido y ajustado para un monorepo NestJS + Next.js + Prisma + PostgreSQL, pero las capas D/A/F/S se adaptan correctamente a pilas parciales (ej. NestJS sin Next.js), y G funciona en cualquier proyecto TS/JS.

Resultado

Un informe en markdown clasificado como Alta → Media → Baja, cada hallazgo con archivo:línea, por qué es lento y una solución concreta:

# Auditoría de Rendimiento — 2026-07-09
Capas escaneadas: D, A, F, S, G (omitidas: ninguna)

## Alta
1. `src/foo.service.ts:123` — [D1] N+1: una consulta por candidato en `.map(async)`
   Por qué es lento: N candidatos → N+1 viajes redondos; crece linealmente con los datos.
   Solución: un solo `findMany` con `where: { id: { in: ids } }`, o `include` la relación.

Los informes con más de 20 hallazgos también se guardan en performance-audit-report.md en la raíz del repositorio.

Licencia

MIT — úsalo, haz fork, adapta las reglas a tu propia pila.

Skills relacionados