Volver a Learning
🔥
Handbook 20 min lectura Claude Code 5 skills · Open Source

Performance Testing Skills
Colección completa para Claude Code

Cinco skills open source que cubren el ciclo completo de performance testing con Claude Code: desde diseñar la estrategia hasta analizar los resultados. Cada skill resuelve un problema concreto en el flujo de trabajo del performance engineer.

Claude CodePerformance Testingk6GatlingLocustLoad TestingSkillsStrategyReport Analysis
Por Rodrigo Campos · 2026-03-18
Tabla de contenidos

rcampos09/performance-testing-skills

5 skills · MIT License · Compatible con Claude Code, Cursor y Windsurf

¿Qué resuelve esta colección?

El performance testing tiene un problema de fricción: cada herramienta tiene sus propias convenciones, errores comunes y patrones correctos. Sin guía, Claude Code puede generar scripts que compilan pero que tienen antipatrones de carga, thresholds mal configurados o métricas incorrectas.

Esta colección resuelve eso. Cada skill es un conjunto de instrucciones especializadas que le enseñan a Claude el criterio de un performance engineer para una tarea específica.

❌ Sin los skills

  • • Scripts de k6 sin thresholds ni custom metrics
  • • Gatling sin el patrón correcto de simulación
  • • Estrategia genérica que no considera tus SLAs
  • • Reportes crudos que nadie fuera del equipo técnico entiende
  • • Cada sesión empieza de cero, sin contexto acumulado

✅ Con los skills instalados

  • • Scripts listos para producción desde el primer intento
  • • Patrones correctos aplicados automáticamente
  • • Estrategia adaptada a tu contexto y herramienta
  • • Dos reportes: uno técnico, uno para el negocio
  • • Claude actúa como un performance engineer senior

Cobertura de la colección en el ciclo de performance testing

Fase Skill Qué resuelve
Planificación performance-testing-strategy Define qué probar, cuándo y con qué herramienta antes de escribir código
Scripting gatling-best-practices Scripts Gatling correctos en Java, Kotlin, Scala o TypeScript
Scripting k6-best-practices Scripts k6 con executors correctos, métricas custom y thresholds
Scripting locust-best-practices Scripts Locust en Python con patrones correctos de wait_time y usuarios
Análisis performance-report-analysis Interpreta resultados de cualquier herramienta y genera reporte técnico + de negocio

Los 5 skills

🎯

performance-testing-strategy

Tool-agnostic · Planificación

No genera scripts. Genera el plan. Te hace las 4 preguntas clave antes de escribir una línea de código: ¿qué tipo de prueba necesitás?, ¿cuáles son tus SLAs?, ¿qué herramienta tenés disponible?, ¿cuál es tu entorno? Con eso, arma la estrategia completa.

Smoke Load Stress Spike Endurance
Ver documentación completa
⚡

gatling-best-practices

Java · Kotlin · Scala · TypeScript

Aplica el patrón de 5 bloques para cualquier simulación Gatling y evita los 7 errores críticos que generan resultados incorrectos. Soporta los cuatro lenguajes del SDK oficial. Si describís lo que necesitás, Claude genera el script correcto sin que vos tengas que recordar la sintaxis.

Java DSL Kotlin Scala TypeScript
Ver documentación completa
🚀

k6-best-practices

JavaScript · TypeScript

Cubre los 5 bloques esenciales de cualquier script k6, los 10 errores críticos a evitar y una guía completa de executors. Diferencia entre escenarios, stages y thresholds. Incluye soporte para HTTP, WebSocket y gRPC.

HTTP WebSocket gRPC Executors Thresholds
Ver documentación completa
🦗

locust-best-practices

Python · HTTP/REST

Aplica el patrón de 4 bloques para Locust con Python, la guía completa de wait_time y los 7 errores críticos. Cubre desde tests unitarios de Locust hasta configuración distribuida para alta concurrencia.

Python HTTP/REST wait_time Distribuido
Ver documentación completa
📊

performance-report-analysis

Multi-herramienta · Reportes

El único skill de análisis de resultados de la colección. Interpreta output de cualquier herramienta (k6, Gatling, Locust, JMeter, Artillery) y genera dos reportes: uno técnico con SLA compliance y acciones concretas, y uno de negocio sin jerga técnica para stakeholders.

k6 Gatling Locust JMeter Artillery
Ver documentación completa

El path recomendado

Los skills no son independientes — están diseñados para usarse en secuencia. Este es el orden correcto para un ciclo completo de performance testing.

Flujo completo con los 5 skills

1

Estrategia

performance-testing-strategy

Definí qué vas a probar, con qué herramienta y cuáles son tus SLAs. Sin esto, el script puede ser técnicamente correcto pero probar lo equivocado.

2

Scripting

gatling-best-practices o k6-best-practices o locust-best-practices

Usá el skill que corresponde a tu herramienta. Claude aplicará automáticamente los patrones correctos al generar o revisar el script.

3

Ejecución

(fuera de Claude Code)

Corré el test en tu entorno. Este paso no tiene skill — es ejecución pura. Guardá el output o el reporte generado.

4

Análisis

performance-report-analysis

Pasale el output del test. Claude hace el triage de errores, valida SLA compliance y genera los dos reportes: técnico y de negocio.

💡 Si sos nuevo en performance testing

Empezá siempre por performance-testing-strategy. Las 4 preguntas que te hace no solo sirven para que Claude genere el plan — te ayudan a pensar correctamente el problema antes de correr el primer test.

Instalación

Podés instalar los skills de tres formas según tu caso de uso: globalmente para usarlos en cualquier proyecto, a nivel de proyecto para compartirlos con el equipo, o todos de una vez clonando el repo.

Opción A

Instalar toda la colección de una vez (recomendado)

# Clonar el repositorio
git clone https://github.com/rcampos09/performance-testing-skills

# Instalar globalmente (disponible en todos tus proyectos)
cp -r performance-testing-skills/.claude/skills/* ~/.claude/skills/

# O instalar solo en el proyecto actual
cp -r performance-testing-skills/.claude/skills/* .claude/skills/
Opción B

Instalar un skill específico

# Ejemplo: solo k6
mkdir -p ~/.claude/skills
cp -r performance-testing-skills/.claude/skills/k6-best-practices ~/.claude/skills/

# Verificar instalación
ls ~/.claude/skills/

Verificar que los skills están activos

Una vez instalados, iniciá Claude Code en tu proyecto. Los skills se activan automáticamente cuando el contexto lo requiere — no necesitás invocarlos con un slash command.

claude
# Dentro de Claude Code:
# "Necesito un script de k6 para el endpoint GET /api/users"
# → Claude aplicará automáticamente las best practices del skill

Compatibilidad

Claude Code (CLI oficial)

Cursor

Windsurf

Workflow completo

Ejemplo real de cómo usar los 5 skills en un ciclo completo. Escenario: necesitás testear la performance de una API de pagos antes de un lanzamiento.

1

Diseñar la estrategia

"Necesito diseñar una estrategia de performance testing para una API de pagos.
El equipo usa k6. El lanzamiento es en 2 semanas. El SLA es p95 menor a 800ms
y error rate menor a 0.1%. Esperamos 500 transacciones por minuto en peak."

→ El skill hace las 4 preguntas y genera el plan completo con tipos de prueba,
  thresholds configurados y secuencia de ejecución.
2

Escribir el script de carga

"Basándome en la estrategia anterior, generá el script de k6 para el test de carga.
Endpoint: POST /api/payments. Ramp-up 5 min → 500 VUs → steady 10 min → ramp-down."

→ El skill k6 genera el script con executors correctos, thresholds del plan,
  métricas custom y checks para el endpoint de pagos.
3

Correr el test

k6 run --out json=results.json payment-load-test.js

→ k6 genera el output JSON con todas las métricas.
  Guardá el archivo results.json o el HTML report.
4

Analizar los resultados

"Analizá estos resultados del test de carga. El SLA era p95 menor a 800ms."
[pegás el contenido de results.json o el output de consola]

→ El skill report-analysis hace el triage de errores primero, valida SLA compliance,
  identifica bottlenecks y genera:
  • Reporte técnico con métricas, errores y acciones de remediación
  • Reporte de negocio: "El sistema soportó el 87% de la carga esperada.
    Se recomienda posponer el lanzamiento."

¿Cuál usar según tu tarea?

Si necesitás... Usá este skill
Saber qué tipo de test hacer antes de empezar performance-testing-strategy
Definir SLAs y thresholds realistas performance-testing-strategy
Escribir scripts de carga en k6 (JS/TS) k6-best-practices
Elegir el executor correcto en k6 k6-best-practices
Escribir simulaciones en Gatling (Java/Kotlin/Scala/TS) gatling-best-practices
Escribir tests de carga en Python con Locust locust-best-practices
Interpretar resultados de k6, Gatling, Locust, JMeter o Artillery performance-report-analysis
Generar un reporte para tu manager o el equipo de negocio performance-report-analysis
Diagnosticar bottlenecks a partir de resultados performance-report-analysis

Comparativa de herramientas

Si todavía no elegiste herramienta o estás evaluando migrar, esta comparativa te ayuda a decidir cuál skill instalar primero.

Criterio k6 Gatling Locust
Lenguaje JavaScript / TypeScript Java, Kotlin, Scala, TS Python
Curva de aprendizaje Baja Media-Alta Baja-Media
Escenarios complejos Muy bueno Excelente Bueno
CI/CD integration Muy bueno Muy bueno (Maven/Gradle) Bueno
WebSocket / gRPC Nativo HTTP principalmente Via plugins
Recomendado para APIs REST, microservicios, DevOps Equipos Java/JVM, enterprise Equipos Python, ML backends

🚀 k6 Best Practices →

Para equipos JS/TS

⚡ Gatling Best Practices →

Para equipos JVM

🦗 Locust Best Practices →

Para equipos Python