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
npx skills add rshankras/claude-code-apple-skills --skill performance -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/performance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/performance/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill performance -a codex2Manually: put the files in place
.agents/skills/performance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill performance -a cursor2Manually: put the files in place
.cursor/skills/performance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rshankras/claude-code-apple-skills skills/performance2Manually: put the files in place
.github/skills/performance/SKILL.md1Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill performance -a gemini-cli2Platform CLI
gemini skills install https://github.com/rshankras/claude-code-apple-skills --path skills/performanceManually: put the files in place
.devin/skills/performance/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rshankras/claude-code-apple-skills --skill performance -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.