perf-analyzer — Claude Code skill: analysis and setup
Turns profiling and experiment results into evidence-backed performance recommendations. Use it when a decision needs a traceable basis.
npx skills add composio-community/awesome-claude-plugins --skill perf-analyzer -a claude-code
npx skills add composio-community/awesome-claude-plugins --skill analyzer -a claude-codeWhat perf-analyzer does
The skill takes baseline data, experiment results, profiling evidence, tested hypotheses, and breaking-point results. It turns them into a concise summary, actionable recommendations, abandoned hypotheses, and next steps.
It follows docs/perf-requirements.md as the canonical contract. Recommendations may use evidence found in logs or code only. When the material is insufficient, the skill asks for the investigation to be run again. Check the source logs before relying on the conclusion.
What it helps with
- summarize profiling results for a performance decision
- compare experiment results with tested hypotheses
- turn log and code evidence into concrete recommendations
- record experiments that did not support a hypothesis
- choose next steps after breaking-point tests
Example prompts for the agent
- Use the skill to turn
profile.logand experiment results into performance recommendations. - Compare the baseline with the latest experiment and identify the hypothesis that failed.
- Review the logs and code evidence, then say whether the investigation should be rerun.
How to install perf-analyzer
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill perf-analyzer -a claude-codenpx skills add composio-community/awesome-claude-plugins --skill analyzer -a claude-code2Manually: put the files in place
~/.claude/skills/analyzer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/analyzer/
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill analyzer -a codex2Manually: put the files in place
.agents/skills/analyzer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill analyzer -a cursor2Manually: put the files in place
.cursor/skills/analyzer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install composio-community/awesome-claude-plugins analyzer2Manually: put the files in place
.github/skills/analyzer/SKILL.md1Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill analyzer -a gemini-cli2Platform CLI
gemini skills install https://github.com/composio-community/awesome-claude-plugins --path perf/skills/analyzerManually: put the files in place
.devin/skills/analyzer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add composio-community/awesome-claude-plugins --skill analyzer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about perf-analyzer
How do I install perf-analyzer in Claude Code?
Run npx skills add composio-community/awesome-claude-plugins --skill perf-analyzer -a claude-code, then run npx skills add composio-community/awesome-claude-plugins --skill analyzer -a claude-code. Check ~/.claude/skills/analyzer/SKILL.md afterward.
What does perf-analyzer do?
It turns performance investigation results into a summary, recommendations, abandoned hypotheses, and next steps. The skill uses evidence from logs or code.
Which platforms support perf-analyzer?
The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.