Skip to main content
skill CX Codex

performance · rshankras — Claude Code skill: iOS profiling and SwiftUI debugging

performance diagnoses slow apps, hangs, and memory leaks using Instruments; spots unnecessary SwiftUI re-renders and view identity issues.

MIT 212 installs ★ 905 updated 2026-07-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rshankras/claude-code-apple-skills --skill performance -a claude-code
Open on GitHub

What performance does

Performance routes you to the right diagnostic path. System-level symptoms like slow launches, memory bloat, or energy drain go to profiling workflows—Time Profiler, Allocations, Hangs instruments and how to read them. SwiftUI render problems—frequent body re-evaluations, view identity mismatches—go to the render debugging module with _printChanges() guidance.

The skill includes two sub-skills. Profiling covers Instruments workflows: what each instrument measures, how to spot hangs and leaks, how to interpret timelines. SwiftUI debugging catches unnecessary re-renders, traces slow body evaluations, and untangles view identity problems.

What it helps with

  • measure startup time and find bottlenecks with Time Profiler
  • track memory growth and detect leaks in Allocations
  • diagnose energy drain and battery usage
  • identify why SwiftUI redraws views too often
  • fix view identity bugs and re-render storms

Example prompts for the agent

  • The app freezes for a few seconds when opening a list. Help me profile with Time Profiler and find what's slow.
  • I see a memory leak in Allocations during scroll. What tools should I use and what do I look for?
  • SwiftUI redraws my entire list when one item changes. How do I fix this?

How to install performance

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill performance -a claude-code

2Manually: put the files in place

~/.claude/skills/performance/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/performance/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about performance

How do I install performance in Claude Code?

Run npx skills add rshankras/claude-code-apple-skills --skill performance -a claude-code, then check ~/.claude/skills/performance/SKILL.md. For Cursor, GitHub Copilot, or Gemini CLI, change the -a flag to cursor, github-copilot, or gemini-cli.

What does performance do?

When your app is slow, hangs, or drains battery, the skill routes you through profiling and SwiftUI debugging. It covers Instruments workflows and re-render diagnostics.

Do I need to know Instruments already?

No. The skill includes guidance on which Instruments to use for each symptom, how to capture profiles, and how to read the results.

Source text

SKILL.md · MIT
---
name: performance
description: Performance profiling and SwiftUI debugging skills — Instruments guidance, hangs, memory issues, slow launches, energy drain, unnecessary re-renders, and view identity problems. Use when an app is slow, janky, or resource-hungry.
allowed-tools: [Read, Glob, Grep, Bash]
last_verified: 2026-07-16
review_by: 2027-06-22
---

# Performance Skills

Diagnose and fix performance problems, from system-level profiling to SwiftUI render behavior.

## When This Skill Activates

Use this skill when the user:
- Reports the app is **slow, janky, or hanging**
- Wants to profile with **Instruments** (Time Profiler, Allocations, Hangs)
- Is investigating **memory issues, slow launches, or energy drain**
- Sees SwiftUI views **re-rendering too often** or slow `body` evaluations
- Asks about **view identity** problems or `_printChanges()`

## Available Skills

Paths are relative to THIS file's directory — skills run with cwd set to the
user's project, so resolve each path from this SKILL.md's own location.

| Skill | Read | Covers |
|-------|------|--------|
| profiling | `profiling/SKILL.md` | Instruments workflows; hangs, memory, slow launch, energy diagnosis |
| swiftui-debugging | `swiftui-debugging/SKILL.md` | Unnecessary re-renders, view identity, slow body evaluations |

## How to Route

1. Match the request to a row above — system-level symptoms → profiling; SwiftUI render symptoms → swiftui-debugging.
2. Read that SKILL.md (relative to this file) plus any reference files it lists.
3. Apply the guidance to the user's code.

© rshankras · MIT · rshankras/claude-code-apple-skills

Similar skills

All skills for Mobile →

performance by other authors comes first.

performance millionco This skill measures React runtime performance for one repeatable interaction and ties browser delays to component renders. CX Codex +1 314installs performance daveebbelaar performance — a skill for Claude Code that measures CPU, memory, and energy usage in macOS apps. It identifies causes of freezes and helps offload tasks from the main thread to the GPU. CX Codex +1 1,000installs performance plugin87 This Claude Code skill guides UI performance work against Core Web Vitals. It activates for slow interactions, animation jank, layout shifts, and loading problems. CX Codex +1 562installs performance OrchestKit This skill helps diagnose slow web pages, React renders, backend requests, and LLM inference across a performance review. CX Codex +1 233installs performance cognitedata performance is a Claude Code skill that finds and fixes performance issues in Flows apps. It activates for requests about slow pages, re-renders, CDF queries, bundles, or memory leaks. CX Codex +1 1,900installs swiftui-performance dpearson2699 swiftui-performance — a skill for Claude Code, Cursor, Codex and other agents that takes a reproducible SwiftUI symptom through to a measured fix. CX Codex +1 5,000installs performance-profiling MengTo Guides performance profiling for Apple apps using Instruments and MetricKit. It directs the AI agent to pinpoint hangs and slow launch times. CX Codex +1 1,700installs swiftui-performance-audit official OpenAI swiftui-performance-audit pinpoints SwiftUI runtime issues like frame drops, unresponsive taps, and excessive view body computations. Works code-first and guides Instruments profiling. CX Codex GP ChatGPT +1 109installs axiom-performance CharlesWiltgen axiom-performance routes diagnostics for memory leaks, battery drain, and UI hangs in Apple-platform apps. Guides profiling via Instruments and headless xctrace. CX Codex +1 1,400installs swiftui-expert-skill AvdLee swiftui-expert-skill — a skill for Claude Code, Codex, and Cursor. Guides assistants through writing, reviewing, and diagnosing SwiftUI interfaces on iOS and macOS alongside Instruments trace analysis. CX Codex +1 36,800installs ios-ettrace-performance dpearson2699 ios-ettrace-performance is a Claude Code skill for capturing and inspecting ETTrace data from a defined iOS launch or runtime flow. It handles focused performance investigations and comparable runs. CX Codex +1 1,500installs

From the same set23

The whole set →
monetization monetization is a Claude Code skill for choosing pricing models and setting up app monetization for iOS and macOS. It activates when planning revenue or checking whether an app is ready to charge. CX Codex +1 484installs growth A skill for indie Apple developers: metrics, press outreach, community and business ops. Useful once the app ships and growth stalls. CX Codex +1 452installs core-ml Guides Core ML, Vision, NaturalLanguage and Create ML work in iOS and macOS projects, from model integration to training a custom classifier. CX Codex +1 445installs swiftui swiftui is a Claude Code skill for diagnosing SwiftUI state and rendering issues. It also provides focused guidance on layouts, charts, text editing, toolbars, and WebKit. CX Codex +1 224installs swiftdata A skill for designing hierarchical SwiftData models with class inheritance, polymorphic queries, and type safety. Guides you through inheritance patterns, type-based filtering, and inheritance-versus-enum decisions. CX Codex +1 204installs foundation Guides coding assistants on Foundation AttributedString patterns, styling runs, alignment, and SwiftUI text integration. CX Codex +1 202installs visionos Brings spatial-design patterns for visionOS: layout ergonomics, eyes-and-hands input, motion comfort, and immersive environments. CX Codex +1 202installs mapkit This skill guides agents through MapKit and GeoToolbox patterns for place data. Use it for geocoding or matching place identifiers across services. CX Codex +1 199installs

Project sponsors

Companies that keep this analytics open