skill CX Codex

perf-profiler — Claude Code skill: what it does, how to install

Q: How to install perf-profiler in Claude Code?

Run `npx skills add composio-community/awesome-claude-plugins --skill perf-profiler -a claude-code` in your terminal.

Runs profilers against CPU and memory hot paths, captures flame graphs, and records file and line evidence.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add composio-community/awesome-claude-plugins --skill perf-profiler -a claude-code
npx skills add composio-community/awesome-claude-plugins --skill profile -a claude-code

Open on GitHub

What perf-profiler does

The skill standardizes performance profiling across development sessions. Before collecting metrics, the agent inspects debug symbols and expects a clear benchmark scenario. Profiling without a concrete scenario violates the skill rules.

Results come back in a compact format. The report details the invoked command, the profiler name, specific hotspots formatted as file:line, and paths to captured artifacts like flame graphs or JFR snapshots. Canonical rules and contracts are drawn directly from docs/perf-requirements.md.

This stops guessing. Every performance bottleneck remains anchored to verifiable traces and symbol lines.

What it helps with

pinpoint CPU and memory bottlenecks down to file and line
generate flame graphs and capture JFR or perf traces
enforce verification of debug symbols prior to profiling
produce structured reports with benchmark artifacts

Example prompts for the agent

Profile CPU usage with perf for ./build/bin/server --bench
Capture a JFR recording and flame graph while running mvn test

How to install perf-profiler

1Skills CLI (Vercel)

npx skills add composio-community/awesome-claude-plugins --skill perf-profiler -a claude-code

npx skills add composio-community/awesome-claude-plugins --skill profile -a claude-code

2Manually: put the files in place

~/.claude/skills/profile/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/profile/

1Skills CLI (Vercel)

npx skills add composio-community/awesome-claude-plugins --skill profile -a codex

2Manually: put the files in place

.agents/skills/profile/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add composio-community/awesome-claude-plugins --skill profile -a cursor

2Manually: put the files in place

.cursor/skills/profile/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install composio-community/awesome-claude-plugins profile

2Manually: put the files in place

.github/skills/profile/SKILL.md

1Skills CLI (Vercel)

npx skills add composio-community/awesome-claude-plugins --skill profile -a gemini-cli

2Platform CLI

gemini skills install https://github.com/composio-community/awesome-claude-plugins --path perf/skills/profile

Manually: put the files in place

.devin/skills/profile/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add composio-community/awesome-claude-plugins --skill profile -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about perf-profiler

How to install perf-profiler in Claude Code?

Run npx skills add composio-community/awesome-claude-plugins --skill perf-profiler -a claude-code in your terminal.

What does perf-profiler do?

It runs profiling commands under a defined scenario and returns hotspots with line numbers and flame graphs.

What prerequisites does perf-profiler enforce?

It requires debug symbols to be present and follows the contract defined in docs/perf-requirements.md.

Similar skills

All skills for Backend and APIs →

linux-perf mohitmishra786 Walks an agent through perf on Linux: sampling, hardware counters, hotspot hunting and flamegraph output. Handy when a program is slow and you can't tell where. CX Codex +1 753installs flamegraphs mohitmishra786 Guides agents through turning profiler outputs into SVG flamegraphs and interpreting hot frames to resolve CPU bottlenecks. CX Codex +1 673installs android-profiler Google LLC Captures and inspects Android performance metrics, from Perfetto traces and memory leaks to frame drops and battery drain. CX Codex +1 1,000installs performance-profiler davila7 A Claude subagent that hunts down performance bottlenecks, memory leaks and load problems. Useful when an app is slow and the cause is not obvious. 1,875installs game-performance-profiler davila7 Audits a game project for frame rate, memory and rendering bottlenecks, then hands back a prioritized optimization list. 227installs pyroscope grafana A skill for continuous profiling with Grafana Pyroscope: CPU, memory and allocation flame graphs read straight from the agent chat. CX Codex +1 4,700installs

From the same set8

perf-investigation-logger Appends structured performance investigation notes, quotes, and evidence to project logs. Keeps benchmarks and optimization decisions organized. CX Codex +1 1,600installs perf-theory-tester A skill that keeps perf experiments honest: one change per hypothesis, repeated runs, a recorded verdict. Useful when you need proof that an optimization helped. CX Codex +1 1,500installs perf-code-paths This skill maps likely execution paths, entrypoints, and related files for a performance scenario before profiling. Useful when the hot area is unclear. CX Codex +1 1,600installs perf-theory-gatherer A skill that turns git history and code evidence into up to five hypotheses about a performance problem. CX Codex +1 1,600installs perf-benchmarker Runs benchmarks sequentially under strict duration rules to catch performance regressions and set baseline metrics. CX Codex +1 1,600installs perf-analyzer Turns profiling and experiment results into evidence-backed performance recommendations. Use it when a decision needs a traceable basis. CX Codex +1 1,600installs changelog-generator Turns git history into a user-facing changelog: sorts commits into categories and rewrites developer messages for customers. CX Codex +1 1,500installs