Skip to main content
subagent CX Codex

perf-analyzer — Claude Code subagent: what it does, how to install

perf-analyzer — a Claude Code subagent that turns profiling results and benchmark experiments into evidence-backed recommendations structured by a strict template.

MIT ★ 2,003 updated 2026-07-26

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-plugins
Open on GitHub

What perf-analyzer does

Running on the opus model with Read and Write tools, this subagent digests raw benchmarking data. It reviews baseline metrics, profiler traces, tested hypotheses, and breaking point limits. The agent strictly treats docs/perf-requirements.md as its primary contract and must execute the perf-analyzer skill to deliver its findings.

The generated report follows a rigid structure containing summary, recommendations, abandoned, and next_steps. It highlights failed hypotheses alongside valid suggestions. Grounding is mandatory here: the subagent only cites data present in logs or code, requesting a complete test re-run whenever numbers are insufficient.

What it helps with

  • Synthesize benchmark results and profiling data into structured reports
  • Document failed optimization hypotheses under the abandoned section
  • Verify performance findings against docs/perf-requirements.md
  • Determine next testing steps based on verified log data

Example prompts for the agent

  • Analyze the profiler traces and generate a report using the perf-analyzer subagent
  • Review the benchmark metrics against docs/perf-requirements.md
  • Synthesize the load test results and identify failed hypotheses

How to install perf-analyzer

1Plugin marketplace

/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install perf@awesome-claude-plugins

2Manually: put the files in place

.claude/agents/perf-analyzer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about perf-analyzer

How do I install perf-analyzer in Claude Code?

Add the marketplace by running /plugin marketplace add composio-community/awesome-claude-plugins. Next, install the package using /plugin install perf@awesome-claude-plugins. The agent definition is placed at .claude/agents/perf-analyzer.md.

What does the perf-analyzer subagent do?

It converts performance tests, baseline data, and profiler evidence into a structured YAML-like summary. The agent records actionable recommendations, notes failed hypotheses, and insists on verifiable log facts.

What happens if benchmark data is incomplete?

The subagent will not guess without clear evidence in logs or code. According to its rules, it explicitly flags missing data and requests a test re-run.

Source text

perf-analyzer.md · MIT
---
name: perf-analyzer
description: Synthesize perf findings into evidence-backed recommendations and decisions.
tools: Read, Write
model: opus
---

# Perf Analyzer

You MUST follow `docs/perf-requirements.md` as the canonical contract.

Synthesize investigation outputs into clear, evidence-backed recommendations.

You MUST execute the perf-analyzer skill to produce the output. Do not bypass the skill.

## Inputs

- Baseline data
- Experiment results
- Profiling evidence
- Hypotheses tested
- Breaking point results

## Output Format

```
summary: <2-3 sentences>
recommendations:
  - <actionable recommendation 1>
  - <actionable recommendation 2>
abandoned:
  - <hypothesis or experiment that failed>
next_steps:
  - <if user should continue or stop>
```

## Constraints

- Only cite evidence that exists in logs or code.
- If data is insufficient, say so and request a re-run.

© Community · MIT · composio-community/awesome-claude-plugins

Similar subagents

All subagents for Testing and QA →

From the same set68

The whole set →
unpause-subs unpause-subs restarts the skill bus after it has been paused and reactivates subscription handling. Use it to quickly return to normal operation after stopping the bus. CX Codex +1 ★ 2,003repo stars code-review code-review inspects recent repository changes using git context. It spots security flaws, performance bottlenecks, and test gaps before you push code. CX Codex +1 ★ 2,003repo stars list-subs list-subs inspects active skill-bus subscriptions across global and project settings. Use it to trace conditions and predict which skills would run. CX Codex +1 ★ 2,003repo stars pause-subs pause-subs turns the skill bus off, everywhere or for one project. Subscriptions stay in place and stop firing until you switch them back. CX Codex +1 ★ 2,003repo stars documentation-generator The documentation-generator command turns code, APIs, and project details into structured developer documentation. Use it when setup notes, examples, or endpoint references need to be written. CX Codex +1 ★ 2,003repo stars perf-investigation-logger perf-investigation-logger — a subagent for structured documentation of performance investigations. Captures verbatim user statements, findings, and evidence in a single log. CX Codex ★ 2,003repo stars pause-subs pause-subs is a Claude Code skill that temporarily disables skill-bus subscriptions without removing their settings, for tasks interrupted by background triggers. CX Codex +1 ★ 2,003repo stars create-pr create-pr is a Claude Code command that turns working changes into a pull request. It branches the work, formats edited files, and prepares commits. CX Codex +1 ★ 2,003repo stars

Project sponsors

Companies that keep this analytics open