performance-analysis

Detect bottlenecks in Claude Flow swarm performance across communication, processing, memory, and network domains.

1|Updated Jul 26, 2025
One-click install
npx skills add https://github.com/jcolano/claude-flow --skill performance-analysis-jcolano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: performance-analysis
Source: https://github.com/jcolano/claude-flow/tree/main/.claude/skills/performance-analysis
Command: npx skills add https://github.com/jcolano/claude-flow --skill performance-analysis-jcolano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifying and resolving performance bottlenecks in complex AI agent swarms can be challenging and time-consuming, impacting efficiency and cost. This Skill provides a comprehensive suite for performance analysis, bottleneck detection, and actionable optimization recommendations, ensuring your AI operations run smoothly.

Core Features & Use Cases

  • Bottleneck Detection: Automatically identifies communication, processing, memory, and network bottlenecks across your swarm operations.
  • Performance Profiling: Offers real-time monitoring and historical analysis of agent utilization, task completion times, and resource contention.
  • Report Generation & Optimization Recommendations: Creates detailed performance reports in multiple formats and provides AI-powered suggestions for topology optimization, caching, and concurrency tuning.
  • Use Case: Your AI development swarm is running slowly. Use this Skill to detect bottlenecks, revealing that inter-agent communication is delayed and neural pattern loading is inefficient. The Skill then recommends switching to a hierarchical topology and enabling memory caching, significantly improving overall performance.

Quick Start

Detect performance bottlenecks in your current swarm, then generate an HTML performance report including detailed metrics. npx claude-flow bottleneck detect npx claude-flow analysis performance-report --format html --include-metrics

Frequently Asked Questions about performance-analysis

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

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

Bottleneck detection identifies communication, processing, memory, and network delays across your swarm operations. Run `npx claude-flow bottleneck detect` to automatically scan agent interactions and resource contention, then review the profiling data to pinpoint where delays occur.

Can I analyze both real-time and historical performance data in my AI swarm?

Yes, performance profiling supports both real-time monitoring and historical analysis. Monitor agent utilization, task completion times, and resource contention across configurable time ranges to identify patterns and recurring bottlenecks in your swarm operations.

What optimization recommendations does performance analysis provide?

The Skill generates AI-powered optimization suggestions targeting topology, caching strategies, and concurrency tuning based on detected bottlenecks. Recommendations appear in detailed performance reports available in multiple formats, helping you resolve specific communication, processing, or memory issues.

How do I generate performance reports for my swarm operations?

Generate comprehensive performance reports using `npx claude-flow analysis performance-report --format html --include-metrics`. Reports include detailed metrics, bottleneck analysis, and optimization recommendations in your chosen format for review and decision-making.

Does performance analysis work with CLI-based workflows?

Yes, the Skill supports CLI-based workflows for bottleneck detection, profiling, and report generation. Configure time ranges, thresholds, and export options via command-line flags to integrate performance analysis into your existing development automation.

When should I use performance profiling instead of manual troubleshooting?

Use performance profiling when swarm efficiency degrades unexpectedly or costs rise without clear cause. Automated bottleneck detection across communication, processing, memory, and network domains surfaces root causes faster than manual investigation, enabling quicker optimization decisions.