Guide Skill — This is an expert workflow/pattern guide, not API reference documentation.
Originally from Dimillian/Skills by Thomas Ricouard. MIT License.
SwiftUI Performance Audit
Quick start
Use this skill to diagnose SwiftUI performance issues from code first, then request profiling evidence when code review alone cannot explain the symptoms.
Workflow
- Classify the symptom: slow rendering, janky scrolling, high CPU, memory growth, hangs, or excessive view updates.
- If code is available, start with a code-first review using
references/code-smells.md.
- If code is not available, ask for the smallest useful slice: target view, data flow, reproduction steps, and deployment target.
- If code review is inconclusive or runtime evidence is required, guide the user through profiling with
references/profiling-intake.md.
- Summarize likely causes, evidence, remediation, and validation steps using
references/report-template.md.
1. Intake
Collect:
- Target view or feature code.
- Symptoms and exact reproduction steps.
- Data flow:
@State, @Binding, environment dependencies, and observable models.
- Whether the issue shows up on device or simulator, and whether it was observed in Debug or Release.
Ask the user to classify the issue if possible:
- CPU spike or battery drain
- Janky scrolling or dropped frames
- High memory or image pressure
- Hangs or unresponsive interactions
- Excessive or unexpectedly broad view updates
For the full profiling intake checklist, read references/profiling-intake.md.
2. Code-First Review
Focus on:
- Invalidation storms from broad observation or environment reads.
- Unstable identity in lists and
ForEach.
- Heavy derived work in
body or view builders.
- Layout thrash from complex hierarchies,
GeometryReader, or preference chains.
- Large image decode or resize work on the main thread.
- Animation or transition work applied too broadly.
Use references/code-smells.md for the detailed smell catalog and fix guidance.
Provide:
- Likely root causes with code references.
- Suggested fixes and refactors.
- If needed, a minimal repro or instrumentation suggestion.
3. Guide the User to Profile
If code review does not explain the issue, ask for runtime evidence:
- A trace export or screenshots of the SwiftUI timeline and Time Profiler call tree.
- Device/OS/build configuration.
- The exact interaction being profiled.
- Before/after metrics if the user is comparing a change.
Use references/profiling-intake.md for the exact checklist and collection steps.
4. Analyze and Diagnose
- Map the evidence to the most likely category: invalidation, identity churn, layout thrash, main-thread work, image cost, or animation cost.
- Prioritize problems by impact, not by how easy they are to explain.
- Distinguish code-level suspicion from trace-backed evidence.
- Call out when profiling is still insufficient and what additional evidence would reduce uncertainty.
5. Remediate
Apply targeted fixes:
- Narrow state scope and reduce broad observation fan-out.
- Stabilize identities for
ForEach and lists.
- Move heavy work out of
body into derived state updated from inputs, model-layer precomputation, memoized helpers, or background preprocessing. Use @State only for view-owned state, not as an ad hoc cache for arbitrary computation.
- Use
equatable() only when equality is cheaper than recomputing the subtree and the inputs are truly value-semantic.
- Downsample images before rendering.
- Reduce layout complexity or use fixed sizing where possible.
Use references/code-smells.md for examples, Observation-specific fan-out guidance, and remediation patterns.
6. Verify
Ask the user to re-run the same capture and compare with baseline metrics.
Summarize the delta (CPU, frame drops, memory peak) if provided.
Outputs
Provide:
- A short metrics table (before/after if available).
- Top issues (ordered by impact).
- Proposed fixes with estimated effort.
Use references/report-template.md when formatting the final audit.
References
- Profiling intake and collection checklist:
references/profiling-intake.md
- Common code smells and remediation patterns:
references/code-smells.md
- Audit output template:
references/report-template.md
- Add Apple documentation and WWDC resources under
references/ as they are supplied by the user.
- Optimizing SwiftUI performance with Instruments:
references/optimizing-swiftui-performance-instruments.md
- Understanding and improving SwiftUI performance:
references/understanding-improving-swiftui-performance.md
- Understanding hangs in your app:
references/understanding-hangs-in-your-app.md
- Demystify SwiftUI performance (WWDC23):
references/demystify-swiftui-performance-wwdc23.md
1---
2name: guide-swiftui-performance-audit
3description: Audit and improve SwiftUI runtime performance from code review and architecture. Use for requests to diagnose slow rendering, janky scrolling, high CPU/memory usage, excessive view updates, or layout thrash in SwiftUI apps, and to provide guidance for user-run Instruments profiling when code review alone is insufficient.
4type: guide
5origin: https://github.com/Dimillian/Skills
6license: MIT
7metadata:
8 source: https://skillmd.com/skills/prisma-labs-dev/guide-swiftui-performance-audit
9---
10
11> **Guide Skill** — This is an expert workflow/pattern guide, not API reference documentation.
12> Originally from [Dimillian/Skills](https://github.com/Dimillian/Skills) by Thomas Ricouard. MIT License.
13
14
15# SwiftUI Performance Audit
16
17## Quick start
18
19Use this skill to diagnose SwiftUI performance issues from code first, then request profiling evidence when code review alone cannot explain the symptoms.
20
21## Workflow
22
231. Classify the symptom: slow rendering, janky scrolling, high CPU, memory growth, hangs, or excessive view updates.
242. If code is available, start with a code-first review using `references/code-smells.md`.
253. If code is not available, ask for the smallest useful slice: target view, data flow, reproduction steps, and deployment target.
264. If code review is inconclusive or runtime evidence is required, guide the user through profiling with `references/profiling-intake.md`.
275. Summarize likely causes, evidence, remediation, and validation steps using `references/report-template.md`.
28
29## 1. Intake
30
31Collect:
32- Target view or feature code.
33- Symptoms and exact reproduction steps.
34- Data flow: `@State`, `@Binding`, environment dependencies, and observable models.
35- Whether the issue shows up on device or simulator, and whether it was observed in Debug or Release.
36
37Ask the user to classify the issue if possible:
38- CPU spike or battery drain
39- Janky scrolling or dropped frames
40- High memory or image pressure
41- Hangs or unresponsive interactions
42- Excessive or unexpectedly broad view updates
43
44For the full profiling intake checklist, read `references/profiling-intake.md`.
45
46## 2. Code-First Review
47
48Focus on:
49- Invalidation storms from broad observation or environment reads.
50- Unstable identity in lists and `ForEach`.
51- Heavy derived work in `body` or view builders.
52- Layout thrash from complex hierarchies, `GeometryReader`, or preference chains.
53- Large image decode or resize work on the main thread.
54- Animation or transition work applied too broadly.
55
56Use `references/code-smells.md` for the detailed smell catalog and fix guidance.
57
58Provide:
59- Likely root causes with code references.
60- Suggested fixes and refactors.
61- If needed, a minimal repro or instrumentation suggestion.
62
63## 3. Guide the User to Profile
64
65If code review does not explain the issue, ask for runtime evidence:
66- A trace export or screenshots of the SwiftUI timeline and Time Profiler call tree.
67- Device/OS/build configuration.
68- The exact interaction being profiled.
69- Before/after metrics if the user is comparing a change.
70
71Use `references/profiling-intake.md` for the exact checklist and collection steps.
72
73## 4. Analyze and Diagnose
74
75- Map the evidence to the most likely category: invalidation, identity churn, layout thrash, main-thread work, image cost, or animation cost.
76- Prioritize problems by impact, not by how easy they are to explain.
77- Distinguish code-level suspicion from trace-backed evidence.
78- Call out when profiling is still insufficient and what additional evidence would reduce uncertainty.
79
80## 5. Remediate
81
82Apply targeted fixes:
83- Narrow state scope and reduce broad observation fan-out.
84- Stabilize identities for `ForEach` and lists.
85- Move heavy work out of `body` into derived state updated from inputs, model-layer precomputation, memoized helpers, or background preprocessing. Use `@State` only for view-owned state, not as an ad hoc cache for arbitrary computation.
86- Use `equatable()` only when equality is cheaper than recomputing the subtree and the inputs are truly value-semantic.
87- Downsample images before rendering.
88- Reduce layout complexity or use fixed sizing where possible.
89
90Use `references/code-smells.md` for examples, Observation-specific fan-out guidance, and remediation patterns.
91
92## 6. Verify
93
94Ask the user to re-run the same capture and compare with baseline metrics.
95Summarize the delta (CPU, frame drops, memory peak) if provided.
96
97## Outputs
98
99Provide:
100- A short metrics table (before/after if available).
101- Top issues (ordered by impact).
102- Proposed fixes with estimated effort.
103
104Use `references/report-template.md` when formatting the final audit.
105
106## References
107
108- Profiling intake and collection checklist: `references/profiling-intake.md`
109- Common code smells and remediation patterns: `references/code-smells.md`
110- Audit output template: `references/report-template.md`
111- Add Apple documentation and WWDC resources under `references/` as they are supplied by the user.
112- Optimizing SwiftUI performance with Instruments: `references/optimizing-swiftui-performance-instruments.md`
113- Understanding and improving SwiftUI performance: `references/understanding-improving-swiftui-performance.md`
114- Understanding hangs in your app: `references/understanding-hangs-in-your-app.md`
115- Demystify SwiftUI performance (WWDC23): `references/demystify-swiftui-performance-wwdc23.md`