agent-perf

Analyze and optimize system performance under load with k6 or Artillery.

4|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/ryan-nguyen-01/agent-platform --skill agent-perf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-perf
Source: https://github.com/ryan-nguyen-01/agent-platform/tree/main/.claude/Agents/agent-perf
Command: npx skills add https://github.com/ryan-nguyen-01/agent-platform --skill agent-perf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Performance bottlenecks drain user experience and hinder growth. This Skill helps teams identify and optimize performance across APIs, frontend bundles, and infrastructure to meet SLAs.

Core Features & Use Cases

  • Phase 1: Performance Budget to define targets for APIs, frontend CWV, and database queries.
  • Phase 2: Load Testing using tools like k6 or Artillery to simulate normal, peak, spike, and soak conditions.
  • Phase 3: Profiling & Optimization to identify bottlenecks via traces, flame graphs, and heap snapshots.
  • Phase 4: Bundle Analysis for frontend performance and code-split improvements.
  • Phase 5: Capacity Planning to project scaling needs and guide resource allocation.

Quick Start

Run the performance workflow starting with a budget, then execute load tests and profiling to validate system performance.

Frequently Asked Questions about agent-perf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test API performance under load using k6 or Artillery?

You can test API performance under load by executing load tests with k6 or Artillery to simulate normal, peak, spike, and soak conditions. This validates whether your system meets the defined performance budget and SLA targets.

How do I set a performance budget for frontend bundles and APIs?

Setting a performance budget involves defining explicit targets for API latency, frontend Core Web Vitals, and database query execution times. This establishes baseline thresholds to enforce before running subsequent load testing and profiling phases.

What is the best way to profile system bottlenecks during load testing?

The best way to profile system bottlenecks is by analyzing traces, flame graphs, and heap snapshots after executing load tests. This identifies specific performance constraints in backend APIs, frontend bundles, or infrastructure components.

Does this performance workflow support capacity planning for scaling infrastructure?

Yes, this performance workflow supports capacity planning by projecting scaling needs based on load test results. It guides resource allocation to ensure infrastructure handles normal, peak, spike, and soak traffic conditions effectively.

Can I analyze frontend bundle size and improve code-splitting for performance?

Yes, you can analyze frontend bundle size and improve code-splitting through dedicated bundle analysis. This identifies optimization opportunities to reduce payload size and meet frontend performance budgets for Core Web Vitals.

Why does my system performance degrade during spike load testing?

System performance degrades during spike load testing when bottlenecks exceed capacity limits defined in your performance budget. Profiling tools like traces and flame graphs identify the specific infrastructure or API constraints causing the degradation.