Skip to content

JPeetz/agent-skills / skills/qa-testing/performance-testing

performance-testing

Verified

Use this skill when planning, executing, or analyzing performance tests — load testing with k6, stress testing, soak/endurance testing, spike testing, Lighthouse CI for Core Web Vitals, performance budgets as CI gates, bottleneck identification, and capacity planning. Covers k6 scripting, thresholds, scenarios, browser-level metrics, and Lighthouse audit configuration.

FileKindSize
CHANGELOG.mdmarkdown2.3 KB
LICENSEother1.0 KB
SKILL.mdskill md19.6 KB
evals/evals.jsonconfig2.9 KB
references/sources.mdmarkdown4.3 KB
scripts/k6-helpers.jsscript4.0 KB

CHANGELOG.md

View on GitHub
# Changelog — Performance Testing Agent Skill

All notable changes to this skill package will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] — 2026-11-13

### Added
- Initial release of the Performance Testing skill
- Test-type decision matrix covering smoke, load, stress, soak/endurance, spike, scalability,
  and browser/RUM testing, with load shapes and pass criteria for each
- Goal-definition template requiring numeric SLOs, baseline, environment, and abort conditions
- k6 scripting guidance: options, stages, thresholds (including per-tag and custom-metric
  thresholds), scenarios and all seven executors, checks vs thresholds semantics
- Custom metrics (Trend, Rate, Counter, Gauge) and business-level gating
- Data and auth realism: `SharedArray`, `setup()` token caching, `__ENV` configuration,
  deterministic data selection
- k6 execution guidance: summary export for baseline diffing, Prometheus remote write,
  JSON output, cloud runs
- Lighthouse CI configuration with `lighthouserc.js`, numeric assertions, median-run
  aggregation, and performance budgets file
- Core Web Vitals thresholds table (LCP, INP, CLS, FCP, TTFB) with the INP-replaced-FID note
  and lab-vs-field guidance (TBT as lab proxy)
- GitHub Actions workflows for Lighthouse CI on PRs and smoke-level k6 gates
- RUM instrumentation with the `web-vitals` library and k6 browser module journeys
- Bottleneck identification playbooks for frontend, backend, database, and network layers,
  including the throughput-knee concept
- Six-step capacity planning methodology with headroom and N+1 guidance
- Anti-pattern catalog with twelve common mistakes and concrete fixes
- Performance report structure requirements
- `scripts/k6-helpers.js` with ramp/stress/spike stage builders, SLO threshold factory,
  tagged API helpers, think-time jitter, deterministic data selection, and `requireEnv()`
- 3 eval cases: k6 load test authoring, Lighthouse CI budget gating, soak-test diagnosis
- `references/sources.md` with authoritative k6, Lighthouse CI, Web Vitals, and SRE links

### Notes
- Targets k6 v0.50+ (stable `k6/browser`) and `@lhci/cli` 0.13+
- MIT licensed
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall