# Perf Profiler

> Use when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence.

- Skill: `gabrielmoreira/perf-profiler` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/perf-profiler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/perf-profiler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/perf-profiler

---


# perf-profiler

Run profiling tools and capture hotspots with evidence.

Follow `docs/perf-requirements.md` as the canonical contract.

## Parse Arguments

```javascript
const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const tool = args[0] || '';
const command = args.slice(1).join(' ');
```

## Required Rules

- Verify debug symbols before profiling.
- Capture file:line for hotspots.
- Provide flame graph or equivalent output when possible.

## Output Format

```
tool: <profiler>
command: <command>
hotspots:
  - file:line - reason
artifacts:
  - <path to flame graph or profile>
```

## Constraints

- No profiling without a clear scenario.
- Keep outputs minimal and evidence-backed.