argent-react-native-profiler: a skill that profiles React Native re-renders and CPU

argent-react-native-profiler makes your agent profile a React Native app on a simulator and report which components render too much or burn CPU.

Installs: 27.9K; on skills.sh
Stars: 3.1K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

The agent starts the React profiler and the native profiler together on the same device, you or the agent perform the interaction, then it stops both and runs the analysis. The report ranks hot React commits with the JS functions that ran during them. The agent must then ask whether to dig deeper, apply fixes or stop, and re-profile after any fix.

It triggers when you optimize performance, measure before and after a fix, look for slow components, re-renders or CPU hotspots. It needs the Argent profiler tools and a Hermes app on a simulator. A physical iPhone is not supported. SKILL.md says it complements argent-react-native-optimization and does not replace it.

Good for

React Native developers chasing re-renders and slow screens
Developers who want before-and-after numbers for a performance fix
Teams comparing several profiling sessions

Install argent-react-native-profiler

Claude Code

Copy this prompt.

Install the argent-react-native-profiler skill in Claude Code. Run this command:

npx @swmansion/argent@latest init

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

This runs the Argent installer. It sets up the Argent tools (an MCP server) that these skills call, plus the Argent skills, in the editors you pick. Skills copied on their own with the skills CLI have no tools to call. The installer offers to add Argent tools to your editor's auto-approve list. The default Automatic skills option installs all Argent skills, not only this one. Telemetry is on by default and argent telemetry disable turns it off.

From the project README. Source.

What's in the skill

When it loads

Profile a React Native Hermes app to measure re-render and CPU performance using argent profiler tools. Use when optimizing for performance, measuring before/after a fix, spotting slow components, diagnosing re-renders, checking CPU hotspots, or producing a ranked issue report.

Sections in SKILL.md

2. Tool Overview
React Profiler (Hermes / React commits)
Drill-Down Query Tools (call after analyze)
3. Agent Behavior Guidelines
After analysis: ask about next steps
During investigation: use query tools proactively
After fixes: always re-profile
Use e2e tests for reproducible profiling
4. Standard Profiling Workflow
Step 1: Start profiling
Step 2: Stop and collect
Step 3: Analyze
Step 4: Assess results
Step 5: Present findings and ask about next steps
Step 6: Drill-down investigation (iterative)
Step 7: Reload a previous session

Key facts

Author: Software Mansion (Argent)
Repo: software-mansion/argent, path packages/skills/skills/argent-react-native-profiler
Installs on skills.sh: 27,934 (as of Nov 2, 2026)
GitHub stars: 3,138 (shared repo, Nov 2, 2026)
License: Apache-2.0 for source code; some bundled binaries are proprietary
Last repo commit: Oct 31, 2026
Files: 2 files including SKILL.md: references/diagnostic-tools.md
Needs: The Argent tools (MCP server), set up by the installer in the box above

What it includes

Start and stop CPU sampling and React commit capture
Start injects a React commit-capture hook into the running app. Save startedAtEpochMs from the response for annotation offsets.
Runs code · react-profiler-start / stop
Ranks hot commits by total render time
Adds CPU hotspots per commit and saves raw data to disk. Takes annotations that mark when each tap or swipe happened.
Write · react-profiler-analyze
Finds the file, line and memoization status of a component
Returns 50 lines of source around the component.
Read · react-profiler-component-source
Live render counts and the component hierarchy
Work without a profiling session.
Read · react-profiler-renders / fiber-tree
Top functions, call trees and per-component CPU
Drill-down after analyze.
profiler-cpu-query
Look up commits by component, time range, index or cascade
Drill-down after analyze.
profiler-commit-query
iOS hang stacks, function callers, leak details
For native findings from the native profiler.
profiler-stack-query
Joins React and native results
Must be called when both profilers ran.
profiler-combined-report
List and reload earlier sessions from disk
Used to compare a pre-fix session with a new one.
Files · profiler-load
Eight steps: start, stop, analyze, assess, present, drill down, reload, fix and re-profile
The agent must ask what to do after the report and must not move on silently.
Workflow

From the official docs

Permissions

Low risk

It injects a profiling hook into your running app and saves profile data to disk. Run it against a debug build on a simulator.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Installer can auto-approve Argent tools
`argent init` asks whether to add Argent tools to your editor's auto-approve list and its prompt defaults to yes. Say no if you want a confirmation on every tool call. github.com
It injects a hook into the running app
react-profiler-start injects a React commit-capture hook and starts CPU sampling, which slows the app. SKILL.md says dev-mode renders are about 3x slower than production. github.com
Profile data is saved on your disk
react-profiler-analyze saves raw data to disk for later reload with profiler-load. It can include component names and function names from your app. github.com
It can take over another agent's session
If a profiling session belongs to another agent and is not stale, SKILL.md tells the agent to stop and ask you first. github.com
Argent telemetry is on by default
The README says telemetry is opt-out. Run `argent telemetry disable` to turn it off; the privacy notice says it collects no source code, file paths or tool inputs, and records a hashed installation identifier derived from a device identifier, never the raw one. github.com

Technical details

Talks to	Argent telemetry (on by default)
Sign-in and keys	The skill text does not use an account or API key.

Questions

What does argent-react-native-profiler do?

It makes your agent profile a React Native Hermes app, rank the components that re-render or use CPU, drill into causes, and re-profile after a fix to report what changed.

How do I install it in Claude Code?

Use the install box above. It runs the Argent installer, which sets up the profiler tools this skill calls along with the skills.

Does it work on a real iPhone?

No. SKILL.md says react-profiler tools reject a physical iPhone. Profile on a simulator.

Is it safe to run?

It injects a profiling hook into your running app and saves profile data to disk, so use a debug build on a simulator. It bundles no scripts. The installer can also add Argent tools to your editor's auto-approve list, which you can decline.

Why are my numbers different between runs?

SKILL.md lists confounders: live API data, profiler overhead and run-to-run noise. Variations under about 10 to 15 percent in commit duration may be noise. Recording the interaction as an e2e test keeps runs comparable.

How is it different from argent-react-native-optimization?

The optimization skill is the entry point for a full speed-up: lint, review, profile, fix. This one handles the measurement and drill-down, and SKILL.md says it is complementary to it.

Does it suggest useMemo everywhere?

No. If the report says React Compiler is enabled, it should not propose useCallback, useMemo or React.memo unless compiler bail-out is confirmed.

Information

updated Nov 2, 2026

Repository: software-mansion/argent
Folder: packages/skills/skills/argent-react-native-profiler

software-mansion/argent skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

SKILL.md · github.com
Argent README · github.com
Argent installer: editor adapters · github.com
Argent installer: auto-approve step · github.com
init-skills.ts · github.com