steipete/agent-scripts231 installs

native-app-performance

Q: How do I install this agent skill?

Run npx skills add https://github.com/steipete/agent-scripts --skill native-app-performance.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Native app performance: xctrace, Time Profiler, traces, hotspots.

How do I install this agent skill?

npx skills add https://github.com/steipete/agent-scripts --skill native-app-performance

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The skill provides a command-line workflow for recording and analyzing native app performance on macOS. It automates the use of standard developer tools like xctrace and atos to identify performance hotspots. No malicious patterns, network access, or data exfiltration attempts were found.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues
Runlayerwarn
4/4 files flagged
ZeroLeakspass
Score: 93/100 · 2 sections analyzed

What does this agent skill do?

Native App Performance (CLI-only)

Goal: record Time Profiler via xctrace, extract samples, symbolicate, and propose hotspots without opening Instruments.

Quick start (CLI)

Record Time Profiler (attach):

# Start app yourself, then attach
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>

Record Time Profiler (launch):

xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App

Extract time samples:

scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml

Get load address for symbolication:

# While app is running
vmmap <pid> | rg -m1 "__TEXT" -n

Symbolicate + rank hotspots:

scripts/top_hotspots.py --samples /tmp/time-sample.xml \
  --binary /path/App.app/Contents/MacOS/App \
  --load-address 0x100000000 --top 30

Workflow notes

Always confirm you’re profiling the correct binary (local build vs /Applications). Prefer direct binary path for --launch.
Ensure you trigger the slow path during capture (menu open/close, refresh, etc.).
If stacks are empty, capture longer or avoid idle sections.
xcrun xctrace help record and xcrun xctrace help export show correct flags.

Included scripts

scripts/record_time_profiler.sh: record via attach or launch.
scripts/extract_time_samples.py: export time-sample XML from a trace.
scripts/top_hotspots.py: symbolicate and rank top app frames.

Gotchas

ASLR means you must use the runtime __TEXT load address from vmmap.
If using a new build, update the --binary path; symbols must match the trace.
CLI-only flow: no need to open Instruments if stacks are symbolicated via atos.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/steipete/agent-scripts/native-app-performance">View native-app-performance on skillZs</a>