swift-perf-audit

Identify and quantify SwiftUI performance bottlenecks in macOS apps.

2|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/maximgorbatyuk/slothy-terminal --skill swift-perf-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swift-perf-audit
Source: https://github.com/maximgorbatyuk/slothy-terminal/tree/main/.claude/skills/swift-perf-audit
Command: npx skills add https://github.com/maximgorbatyuk/slothy-terminal --skill swift-perf-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SlothyTerminal's SwiftUI and libghostty-based UI can suffer from main-thread blocking, view invalidation storms, and animation overhead, leading to sluggish tab switching and choppy chat streaming. This skill identifies and analyzes these bottlenecks, tracing them to source patterns and proposing safe, minimal changes that respect the app's architecture constraints.

Core Features & Use Cases

  • Orchestrates a full-stack audit across SwiftUI views and terminal integration to surface main-thread blocking, excessive re-renders, and animation overhead.
  • Guides targeted fixes with minimal invasive changes and guardrails to preserve architecture constraints.
  • Use Case: When the UI feels sluggish during tab switches or chat streaming, run the audit to surface symptoms, scan the codebase, and generate concrete optimization steps.

Quick Start

Invoke the swift-perf-audit workflow to collect symptoms, run a three-agent codebase scan, and produce prioritized, minimal-change fixes.

Frequently Asked Questions about swift-perf-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix SwiftUI main-thread blocking during terminal tab switching?

A SwiftUI performance audit identifies main-thread blocking by orchestrating parallel multi-agent codebase scans across SwiftUI views and terminal integration. It classifies severity and proposes concrete, minimal-change fixes to eliminate sluggish transitions without refactoring.

What causes excessive view invalidation storms in SwiftUI apps?

Excessive view invalidation storms in SwiftUI apps are caused by inefficient state management and reactive patterns triggering unnecessary re-renders. A full-stack audit scans the codebase to surface these issues, quantifies their impact on chat streaming, and guides targeted fixes.

How do I audit SwiftUI animation overhead in a macOS terminal app?

Auditing SwiftUI animation overhead in a macOS terminal app requires a phased symptom collection process followed by parallel codebase analysis. The audit traces animation overhead and async anti-patterns to propose minimal invasive changes that respect libghostty integration constraints.

Does the performance audit propose invasive refactoring for SwiftUI bottlenecks?

No, the performance audit explicitly avoids invasive refactoring for SwiftUI bottlenecks. It enforces guardrails to preserve architecture constraints by generating concrete, minimal-change fixes that safely resolve main-thread blocking and view invalidation storms.

What is the best way to quantify SwiftUI performance bottlenecks?

The best way to quantify SwiftUI performance bottlenecks is through a three-agent codebase scan that classifies issues by severity. This multi-agent approach analyzes main-thread blocking, re-renders, and async anti-patterns to produce prioritized optimization steps.

Can I use this audit to fix choppy chat streaming in my macOS app?

Yes, you can use this audit to fix choppy chat streaming in a macOS app. It specifically targets the SwiftUI and terminal integration layers, identifying async anti-patterns and main-thread blocking to guide minimal changes that restore smooth streaming performance.