Perf Profiler
Testing & Qualityperf-profilerPerf Profiler is an Agent Skill for testing & quality published in the agent-sh/agentsys repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when profiling CPU/memory hot paths, generating flame graphs, or capturing JFR/perf evidence.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/agent-sh/agentsys/blob/HEAD/.kiro/skills/perf-profiler/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/perf-profiler, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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.