axiom-swiftui-debugging

Diagnose SwiftUI view update, preview crash, and layout issues with decision trees and reference patterns.

61|3|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/joelhooks/joelclaw --skill axiom-swiftui-debugging-joelhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-debugging
Source: https://github.com/joelhooks/joelclaw/tree/main/.agents/skills/axiom-swiftui-debugging
Command: npx skills add https://github.com/joelhooks/joelclaw --skill axiom-swiftui-debugging-joelhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SwiftUI development can be frustrating when views don't update as expected, previews crash, or layouts are misaligned, especially under pressure. This skill provides a systematic approach to diagnose and resolve these common issues quickly.

Core Features & Use Cases

  • View Update Diagnosis: Decision trees to pinpoint why a view isn't updating (struct mutation, lost binding, recreation, missing observer).
  • Preview Crash Resolution: Guides for fixing common preview errors like missing dependencies or state initialization failures.
  • Layout Issue Quick Reference: Patterns for common layout problems like overlapping views, GeometryReader issues, and safe area complications.
  • Use Case: A developer's list view isn't updating when an item is favorited. This skill helps them quickly identify if it's a binding issue or a struct mutation problem, providing the exact fix.

Quick Start

Use the axiom-swiftui-debugging skill to diagnose why a SwiftUI list item is not updating after a button tap.

Frequently Asked Questions about axiom-swiftui-debugging

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

FAQPage Schema
Why does my SwiftUI view not update when state changes?

SwiftUI view update failures usually stem from lost bindings, struct mutation issues, or missing observers. This skill uses decision trees to systematically diagnose whether your state management or binding mechanism is causing the non-updating behavior.

How do I fix SwiftUI preview crashes?

Fix SwiftUI preview crashes by identifying missing dependencies or state initialization failures. This skill provides systematic guides to resolve common preview compilation errors and get your canvas rendering again.

What causes layout issues with GeometryReader in SwiftUI?

Layout issues with GeometryReader in SwiftUI often cause overlapping views or safe area complications. This skill offers quick reference patterns to resolve visual discrepancies and correct misaligned layouts across devices.

How do I debug SwiftUI binding issues when a list item doesn't update?

Debug SwiftUI binding issues by checking if your struct mutation is breaking the state connection. This skill helps determine whether a lost binding or missing observer prevents your list view from reflecting favorited items.

Can I use this skill to diagnose visual layout discrepancies across different iOS devices?

Yes, you can diagnose visual layout discrepancies across iOS devices using this skill. It provides quick reference patterns for common SwiftUI layout problems including overlapping views, GeometryReader issues, and safe area complications.

What is the best way to troubleshoot SwiftUI state management problems?

The best way to troubleshoot SwiftUI state management problems is using systematic decision trees. This skill pinpoints whether unexpected view behavior comes from struct mutations, lost bindings, or recreation issues.