# Send Swiftui Performance Audit to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "swiftui-performance-audit",
    "name": "Swiftui Performance Audit",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/steipete/swiftui-performance-audit",
    "canonicalUrl": "https://clawhub.ai/steipete/swiftui-performance-audit",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/swiftui-performance-audit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=swiftui-performance-audit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/demystify-swiftui-performance-wwdc23.md",
      "references/optimizing-swiftui-performance-instruments.md",
      "references/understanding-hangs-in-your-app.md",
      "references/understanding-improving-swiftui-performance.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "swiftui-performance-audit",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T08:44:25.115Z",
      "expiresAt": "2026-05-08T08:44:25.115Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=swiftui-performance-audit",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=swiftui-performance-audit",
        "contentDisposition": "attachment; filename=\"swiftui-performance-audit-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "swiftui-performance-audit"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/swiftui-performance-audit"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/swiftui-performance-audit",
    "downloadUrl": "https://openagent3.xyz/downloads/swiftui-performance-audit",
    "agentUrl": "https://openagent3.xyz/skills/swiftui-performance-audit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/swiftui-performance-audit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/swiftui-performance-audit/agent.md"
  }
}
```
## Documentation

### SwiftUI Performance Audit

Attribution: copied from @Dimillian’s Dimillian/Skills (2025-12-31).

### Overview

Audit SwiftUI view performance end-to-end, from instrumentation and baselining to root-cause analysis and concrete remediation steps.

### Workflow Decision Tree

If the user provides code, start with "Code-First Review."
If the user only describes symptoms, ask for minimal code/context, then do "Code-First Review."
If code review is inconclusive, go to "Guide the User to Profile" and ask for a trace or screenshots.

### 1. Code-First Review

Collect:

Target view/feature code.
Data flow: state, environment, observable models.
Symptoms and reproduction steps.

Focus on:

View invalidation storms from broad state changes.
Unstable identity in lists (id churn, UUID() per render).
Heavy work in body (formatting, sorting, image decoding).
Layout thrash (deep stacks, GeometryReader, preference chains).
Large images without downsampling or resizing.
Over-animated hierarchies (implicit animations on large trees).

Provide:

Likely root causes with code references.
Suggested fixes and refactors.
If needed, a minimal repro or instrumentation suggestion.

### 2. Guide the User to Profile

Explain how to collect data with Instruments:

Use the SwiftUI template in Instruments (Release build).
Reproduce the exact interaction (scroll, navigation, animation).
Capture SwiftUI timeline and Time Profiler.
Export or screenshot the relevant lanes and the call tree.

Ask for:

Trace export or screenshots of SwiftUI lanes + Time Profiler call tree.
Device/OS/build configuration.

### 3. Analyze and Diagnose

Prioritize likely SwiftUI culprits:

View invalidation storms from broad state changes.
Unstable identity in lists (id churn, UUID() per render).
Heavy work in body (formatting, sorting, image decoding).
Layout thrash (deep stacks, GeometryReader, preference chains).
Large images without downsampling or resizing.
Over-animated hierarchies (implicit animations on large trees).

Summarize findings with evidence from traces/logs.

### 4. Remediate

Apply targeted fixes:

Narrow state scope (@State/@Observable closer to leaf views).
Stabilize identities for ForEach and lists.
Move heavy work out of body (precompute, cache, @State).
Use equatable() or value wrappers for expensive subtrees.
Downsample images before rendering.
Reduce layout complexity or use fixed sizing where possible.

### Common Code Smells (and Fixes)

Look for these patterns during code review.

### Expensive formatters in body

var body: some View {
    let number = NumberFormatter() // slow allocation
    let measure = MeasurementFormatter() // slow allocation
    Text(measure.string(from: .init(value: meters, unit: .meters)))
}

Prefer cached formatters in a model or a dedicated helper:

final class DistanceFormatter {
    static let shared = DistanceFormatter()
    let number = NumberFormatter()
    let measure = MeasurementFormatter()
}

### Computed properties that do heavy work

var filtered: [Item] {
    items.filter { $0.isEnabled } // runs on every body eval
}

Prefer precompute or cache on change:

@State private var filtered: [Item] = []
// update filtered when inputs change

### Sorting/filtering in body or ForEach

List {
    ForEach(items.sorted(by: sortRule)) { item in
        Row(item)
    }
}

Prefer sort once before view updates:

let sortedItems = items.sorted(by: sortRule)

### Inline filtering in ForEach

ForEach(items.filter { $0.isEnabled }) { item in
    Row(item)
}

Prefer a prefiltered collection with stable identity.

### Unstable identity

ForEach(items, id: \\.self) { item in
    Row(item)
}

Avoid id: \\.self for non-stable values; use a stable ID.

### Image decoding on the main thread

Image(uiImage: UIImage(data: data)!)

Prefer decode/downsample off the main thread and store the result.

### Broad dependencies in observable models

@Observable class Model {
    var items: [Item] = []
}

var body: some View {
    Row(isFavorite: model.items.contains(item))
}

Prefer granular view models or per-item state to reduce update fan-out.

### 5. 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.

### References

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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: steipete
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T08:44:25.115Z
- Expires at: 2026-05-08T08:44:25.115Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/swiftui-performance-audit)
- [Send to Agent page](https://openagent3.xyz/skills/swiftui-performance-audit/agent)
- [JSON manifest](https://openagent3.xyz/skills/swiftui-performance-audit/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/swiftui-performance-audit/agent.md)
- [Download page](https://openagent3.xyz/downloads/swiftui-performance-audit)