# Performance Profiler Tools

> Python tools for analyzing Instruments traces and performance data Use when this capability is needed.

- Skill: `tomevault-io/performance-profiler-tools` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/performance-profiler-tools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/performance-profiler-tools/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/performance-profiler-tools

---


# Performance Profiler Tools

Analyze Instruments trace files and performance data.

## Capabilities
- Parse Instruments .trace files
- Extract Time Profiler data
- Analyze Allocations data
- Generate performance reports
- Compare trace files
- Identify performance regressions
- Calculate time percentages
- Find memory growth patterns

## Tools
`instruments_analyzer.py` - Parse Instruments traces

## Commands
```bash
# Analyze trace
./instruments_analyzer.py analyze app.trace

# Compare traces
./instruments_analyzer.py compare --baseline baseline.trace --current current.trace

# Find hot paths
./instruments_analyzer.py hotpaths app.trace --threshold 5%

# Memory analysis
./instruments_analyzer.py memory app.trace
```

## Output
```
Performance Analysis
===================
Total Time: 2.45s
Top Methods:

1. drawRect: (456ms, 18.6%)
2. calculateStatistics (234ms, 9.5%)
3. readFromStore (198ms, 8.1%)

Recommendations:
- Cache drawRect results
- Optimize calculateStatistics algorithm
- Add index to database query
```

## Complements
`performance-profiler` agent (launches Instruments)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/paleoterra) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->