Argent Native Profiler

When your React Native app stutters or leaks on the native side, this skill grabs xctrace profiles on iOS or Perfetto traces on Android and breaks them down into CPU hotspots, UI hangs, and memory leaks. It auto-detects your running app, records while you interact, then parses the trace into a severity-ranked report you can drill into with stack queries. The workflow is end-to-end: start, stop, analyze, then query specific hang stacks or leak callchains. One thing to watch: iOS simulator leaks often come back unattributed because xctrace attaches without malloc stack logging, so you'll need to cold-launch with that flag enabled if you want real allocation backtraces.

skills.sh installs: 29.9K
GitHub stars: 3.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add software-mansion/argent --skill argent-native-profiler --agent claude-code

Installs into .claude/skills of the current project.

Files

1. Tools and platforms

native-profiler-start → native-profiler-stop → native-profiler-analyze: record, export, and report.
profiler-stack-query: drill into the analyzed data (hang stacks, function callers, thread breakdown, leaks).
profiler-load: reload an earlier session from disk.

iOS (Instruments via xctrace): simulator only; a physical iPhone is not supported. Needs full Xcode (xcrun xctrace version). Reports CPU hotspots, UI hangs and memory leaks.

Android (Perfetto): emulator or physical device. Reports CPU hotspots and UI hangs (with jank reasons and the main thread's blocking function), plus an RSS-growth signal for memory pressure: treat it as a hint to confirm, not a confirmed leak. The app must be debuggable or declare <profileable android:shell="true"/> in its manifest, or no perf_sample callstacks are captured.

argent-react-native-profiler starts native profiling alongside React profiling by default; this skill's workflow and investigation patterns apply in both cases.