performance-analysis

Detect performance bottlenecks in Claude Flow swarm operations.

67.5k|8.1k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill performance-analysis-ruvnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-analysis
Source: https://github.com/ruvnet/claude-flow/tree/main/.claude/skills/performance-analysis
Command: npx skills add https://github.com/ruvnet/claude-flow --skill performance-analysis-ruvnet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude-flow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies and resolves performance bottlenecks in Claude Flow swarms, providing detailed analysis, profiling, and actionable optimization recommendations. It helps users understand where their AI agents are slowing down, offering insights into communication, processing, memory, and network issues to improve overall efficiency and speed.

Core Features & Use Cases

  • Bottleneck Detection: Automatically pinpoint communication, processing, memory, and network bottlenecks.
  • Performance Profiling: Real-time monitoring and historical analysis of swarm operations for deep insights.
  • Optimization Recommendations: AI-powered suggestions for improving performance, including topology changes and caching strategies.
  • Use Case: Your multi-agent development swarm is running slower than expected. Use this skill to detect bottlenecks, which might reveal excessive inter-agent communication delays or inefficient memory access. The skill then recommends switching to a hierarchical topology and enabling memory caching to significantly boost performance.

Quick Start

Detect performance bottlenecks in your current swarm

npx claude-flow bottleneck detect

Generate a comprehensive HTML performance report

npx claude-flow analysis performance-report --format html --include-metrics

Automatically fix detected issues

npx claude-flow bottleneck detect --fix --threshold 15

Frequently Asked Questions about performance-analysis

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

FAQPage Schema
How do I detect performance bottlenecks in Claude Flow swarms?

Bottleneck detection in Claude Flow swarms identifies slowdowns across communication, processing, memory, and network layers. Run `npx claude-flow bottleneck detect` to automatically pinpoint which components are causing delays, then review the detailed analysis to understand where optimization is needed.

What types of performance issues can profiling reveal in multi-agent systems?

Performance profiling in multi-agent systems exposes inter-agent communication delays, inefficient memory access, compute bottlenecks, and network latency. Real-time monitoring and historical analysis show exactly where agents are slowing down, enabling targeted optimization across your swarm's coordination and processing layers.

How do I generate and export performance reports for Claude Flow swarms?

Generate comprehensive performance reports by running `npx claude-flow analysis performance-report --format html --include-metrics`. Export supports multiple formats and includes detailed metrics showing bottleneck locations, severity, and swarm behavior, making it easy to share findings and track improvements over time.

Can performance bottleneck detection automatically fix issues in swarms?

Yes, automatic fixing is available with threshold-driven correction. Run `npx claude-flow bottleneck detect --fix --threshold 15` to detect bottlenecks and apply recommended fixes simultaneously. The system implements actionable optimizations like topology changes and caching strategies to boost swarm efficiency.

What optimization strategies does the analysis recommend for slow swarms?

Optimization recommendations are AI-powered and tailored to detected issues. Common suggestions include switching to hierarchical topologies to reduce communication overhead, enabling memory caching to improve access speed, and rebalancing compute distribution. Recommendations target the specific bottleneck types found in your swarm.

Do I need Claude Flow installed to use bottleneck detection and profiling?

Yes, Claude Flow is a required dependency for this Skill. The performance analysis tools work directly with Claude Flow swarms through CLI commands, so you must have Claude Flow set up and your swarm initialized before running bottleneck detection, profiling, or optimization analysis.