Agentsys perf-profiler

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

install
source · Clone the upstream repo
git clone https://github.com/agent-sh/agentsys
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/agent-sh/agentsys "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.kiro/skills/perf-profiler" ~/.claude/skills/agent-sh-agentsys-perf-profiler && rm -rf "$T"
manifest: .kiro/skills/perf-profiler/SKILL.md
source content

perf-profiler

Run profiling tools and capture hotspots with evidence.

Follow

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

Parse Arguments

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.