⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

openclawv1.0.0

Instruments Profiling

@steipete⭐ 0 stars

Use when profiling native macOS or iOS apps with Instruments/xctrace. Covers correct binary selection, CLI arguments, exports, and common gotchas.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

🔵ClawHub
★ 3⬇ 3.6k on ClawHubView ↗

3.6k downloads · 107 installs · 3 stars on ClawHub · checked Nov 15, 2026

🟢ProSkills Score
—

// README

Instruments Profiling (macOS/iOS)

Use this skill when the user wants performance profiling or stack analysis for native apps. Focus: Time Profiler, xctrace CLI, and picking the correct binary/app instance.

Quick Start (CLI)

List templates: xcrun xctrace list templates

Record Time Profiler (launch):

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

Record Time Profiler (attach):

Launch app yourself, get PID, then:

xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach

Open trace in Instruments:

open -a Instruments /tmp/App.trace

Note: xcrun xctrace --help is not a valid subcommand. Use xcrun xctrace help record .

Picking the Correct Binary (Critical)

Gotcha: Instruments may profile the wrong app (e.g., one in /Applications ) if LaunchServices resolves a different bundle. Use these rules:

Prefer direct binary path for deterministic launch:

xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App

If launching .app , ensure it’s the intended bundle:

open -n /path/App.app

Verify with ps -p -o comm= -o command=

If both /Applications/App.app and a local build exist, explicitly target the local build path.

After launch, confirm the process path before trusting the trace.

Command Arguments (xctrace)

--template 'Time Profiler' : template name from xctrace list templates .

--launch -- : everything after -- is the target command (binary or app bundle).

--attach <pid|name> : attach to running process.

--output : .trace output. If omitted, file saved in CWD.

--time-limit 60s|5m : set capture duration.

--device <name|UDID> : required for iOS device runs.

--target-stdout - : stream launched process stdout to terminal (useful for CLI tools).

Exporting Stacks (CLI)

Inspect trace tables:

xcrun xctrace export --input /tmp/App.trace --toc

Export raw time-profile samples:

xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml

Post-process in a script (Python/Rust) to aggregate stacks.

Instruments UI Workflow

Template: Time Profiler

Use “Record” and capture the slow path (startup vs steady-state)

Call Tree tips:

Hide System Libraries

Invert Call Tree

Separate by Thread

Focus on hot frames and call counts

Gotchas & Fixes

Wrong app profiled: LaunchServices resolves installed app instead of local build.

Fix: use direct binary path or --attach with known PID.

No samples / empty trace: App exits quickly or never hits work.

Fix: longer capture, trigger workload during recording.

Privacy prompts: xctrace may need Developer Tools permission.

Fix: System Settings → Privacy & Security → Developer Tools → allow Terminal/Xcode.

Large XML exports: time-profile exports are huge.

Fix: filter with XPath and aggregate offline; don’t print to terminal.

iOS Specific Notes

Device: use xcrun xctrace list devices and --device .

Launch via Xcode if needed; attach with xctrace --attach .

Ensure debug symbols for meaningful stacks.

Verification Checklist

Confirm trace process path matches target build.

Confirm stacks show expected app frames.

Capture covers the slow operation (startup/refresh).

Export stacks for automated diffing if optimizing.

Read more

Downloads

Security auditPass

Last updated4mo ago Current versionv1.0.0

LicenseMIT-0 Report

Bookmark3 Downloads

Security auditPass

Last updated4mo ago Current versionv1.0.0

LicenseMIT-0 Report

ClawHubSkills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem. Explore docs Browse SkillsPluginsOfficialAudits

Publish Publish SkillPublish PluginCreate org

Ecosystem OverviewOpenClawDocsBlog

Community GitHubDiscord

Built alongside the OpenClaw ecosystem LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects

© 2026 OpenClaw Foundation Status·Deployed on Vercel·Powered by Convex

....:: clawhub/openclaw ::.... skills plugins publishers trust signals :::: signed manifests ::::: moderated releases ::::: version history :::: openclaw ecosystem crabbox clickclack crawler packs gateway plugins

install scan publish verify @@ gateway @@ registry @@ agents @@ hooks runners slash-commands skill.md templates scanners review-bots ---- downloads installs stars lineage ownership docs package integrity 30 skills 12 plugins /api/v1/skills /owners /audit /ship openclaw ecosystem crabbox clickclack crawler packs gateway plugins safe browse paths official gateways publisher handles org trust :::: signed manifests ::::: moderated releases ::::: version history :::: ---- downloads installs stars lineage ownership docs package integrity ....:: clawhub/openclaw ::.... skills plugins publishers trust signals hooks runners slash-commands skill.md templates scanners review-bots safe browse paths official gateways publisher handles org trust >>> install scan publish verify @@ gateway @@ registry @@ agents @@ openclaw ecosystem crabbox clickclack crawler packs gateway plugins ....:: clawhub/openclaw ::.... skills plugins publishers trust signals 30 skills 12 plugins /api/v1/skills /owners /audit /ship ---- downloads installs stars lineage ownership docs package integrity >>> install scan publish verify @@ gateway @@ registry @@ agents @@ :::: signed manifests ::::: moderated releases ::::: version history :::: safe browse paths official gateways publisher handles org trust 30 skills 12 plugins /api/v1/skills /owners /audit /ship hooks runners slash-commands skill.md templates scanners review-bots ....:: clawhub/openclaw ::.... skills plugins publishers trust signals :::: signed manifests ::::: moderated releases ::::: version history :::: openclaw ecosystem crabbox clickclack crawler packs gateway plugins install scan publish verify @@ gateway @@ registry @@ agents @@ hooks runners slash-commands skill.md templates scanners review-bots ---- downloads installs stars lineage ownership docs package integrity 30 skills 12 plugins /api/v1/skills /owners /audit /ship openclaw ecosystem crabbox clickclack crawler packs gateway plugins safe browse paths official gateways publisher handles org trust :::: signed manifests ::::: moderated releases ::::: version history :::: ---- downloads installs stars lineage ownership docs package integrity ....:: clawhub/openclaw ::.... skills plugins publishers trust signals hooks runners slash-commands skill.md templates scanners review-bots safe browse paths official gateways publisher handles org trust >>> install scan publish verify @@ gateway @@ registry @@ agents @@ openclaw ecosystem crabbox clickclack crawler packs gateway plugins ....:: clawhub/openclaw ::.... skills plugins publishers trust signals 30 skills 12 plugins /api/v1/skills /owners /audit /ship ---- downloads installs stars lineage ownership docs package integrity >>> install scan publish verify @@ gateway @@ registry @@ agents @@ :::: signed manifests ::::: moderated releases ::::: version history :::: safe browse paths official gateways publisher handles org trust 30 skills 12 plugins /api/v1/skills /owners /audit /ship hooks runners slash-commands skill.md templates scanners review-bots ....:: clawhub/openclaw ::.... skills plugins publishers trust signals :::: signed manifests ::::: moderated releases

// HOW IT'S BUILT

// FILES

1 file shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md7.8 KB
    Instruments Profiling (macOS/iOS)
    
    Use this skill when the user wants performance profiling or stack analysis for native apps.
    Focus: Time Profiler, xctrace
     CLI, and picking the correct binary/app instance.
    
    Quick Start (CLI)
    
    List templates: xcrun xctrace list templates
    
    Record Time Profiler (launch):
    
    xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app
    
    Record Time Profiler (attach):
    
    Launch app yourself, get PID, then:
    
    xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
    
    Open trace in Instruments:
    
    open -a Instruments /tmp/App.trace
    
    Note: xcrun xctrace --help
     is not a valid subcommand. Use xcrun xctrace help record
    .
    
    Picking the Correct Binary (Critical)
    
    Gotcha: Instruments may profile the wrong app (e.g., one in /Applications
    ) if LaunchServices resolves a different bundle.
    Use these rules:
    
    Prefer direct binary path for deterministic launch:
    
    xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App
    
    If launching .app
    , ensure it’s the intended bundle:
    
    open -n /path/App.app
    
    Verify with ps -p <pid> -o comm= -o command=
    
    If both /Applications/App.app
     and a local build exist, explicitly target the local build path.
    
    After launch, confirm the process path before trusting the trace.
    
    Command Arguments (xctrace)
    
    --template 'Time Profiler'
    : template name from xctrace list templates
    .
    
    --launch -- <cmd>
    : everything after --
     is the target command (binary or app bundle).
    
    --attach <pid|name>
    : attach to running process.
    
    --output <path>
    : .trace
     output. If omitted, file saved in CWD.
    
    --time-limit 60s|5m
    : set capture duration.
    
    --device <name|UDID>
    : required for iOS device runs.
    
    --target-stdout -
    : stream launched process stdout to terminal (useful for CLI tools).
    
    Exporting Stacks (CLI)
    
    Inspect trace tables:
    
    xcrun xctrace export --input /tmp/App.trace --toc
    
    Export raw time-profile samples:
    
    xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
    
    Post-process in a script (Python/Rust) to aggregate stacks.
    
    Instruments UI Workflow
    
    Template: Time Profiler
    
    Use “Record” and capture the slow path (startup vs steady-state)
    
    Call Tree tips:
    
    Hide System Libraries
    
    Invert Call Tree
    
    Separate by Thread
    
    Focus on hot frames and call counts
    
    Gotchas & Fixes
    
    Wrong app profiled: LaunchServices resolves installed app instead of local build.
    
    Fix: use direct binary path or --attach
     with known PID.
    
    No samples / empty trace: App exits quickly or never hits work.
    
    Fix: longer capture, trigger workload during recording.
    
    Privacy prompts: xctrace
     may need Developer Tools permission.
    
    Fix: System Settings → Privacy & Security → Developer Tools → allow Terminal/Xcode.
    
    Large XML exports: time-profile
     exports are huge.
    
    Fix: filter with XPath and aggregate offline; don’t print to terminal.
    
    iOS Specific Notes
    
    Device: use xcrun xctrace list devices
     and --device <UDID>
    .
    
    Launch via Xcode if needed; attach with xctrace --attach
    .
    
    Ensure debug symbols for meaningful stacks.
    
    Verification Checklist
    
    Confirm trace process path matches target build.
    
    Confirm stacks show expected app frames.
    
    Capture covers the slow operation (startup/refresh).
    
    Export stacks for automated diffing if optimizing.
    
    Read more
    
    Downloads
    
    Security auditPass
    
    Last updated4mo ago
    Current versionv1.0.0
    
    LicenseMIT-0
    Report
    
    Bookmark3
    Downloads
    
    Security auditPass
    
    Last updated4mo ago
    Current versionv1.0.0
    
    LicenseMIT-0
    Report
    
     ClawHubSkills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem.
    Explore docs
    Browse
    SkillsPluginsOfficialAudits
    
    Publish
    Publish SkillPublish PluginCreate org
    
    Ecosystem
    OverviewOpenClawDocsBlog
    
    Community
    GitHubDiscord
    
    Built alongside the OpenClaw ecosystem
    LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects
    
    © 2026 OpenClaw Foundation
    Status·Deployed on Vercel·Powered by Convex
    
    ....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
    >>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
      30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
    :::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
      hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
    openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
    ---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
      safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
    ....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
    >>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
      30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
    :::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
      hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
    openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
    ---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
      safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
    ....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases 

Plain-text copy, no login: /skill-bundles/instruments-profiling.md

// REPO STATS

0 stars