auto-layout-debugging

Diagnose iOS Auto Layout constraint conflicts using Xcode debugging tools.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill auto-layout-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auto-layout-debugging
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/plugins/axiom/skills/auto-layout-debugging
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill auto-layout-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the frustration and time wasted on debugging "Unable to simultaneously satisfy constraints" errors, incorrect view positioning, and ambiguous layouts in iOS Auto Layout. It provides a systematic workflow to pinpoint and resolve issues quickly.

Core Features & Use Cases

  • Systematic Debugging Workflow: Step-by-step guidance for identifying and resolving Auto Layout issues using Xcode's built-in tools.
  • Visual Tools Integration: Leverage Debug View Hierarchy, symbolic breakpoints, and lldb commands for precise diagnosis of constraint conflicts.
  • Prevention Strategies: Best practices like naming constraints and views, and understanding common conflict patterns to prevent future layout problems.
  • Use Case: When a view is unexpectedly off-screen or overlapping, use this skill to quickly pinpoint the conflicting constraints and apply a targeted fix, saving hours of trial-and-error.

Quick Start

Set a symbolic breakpoint at UIViewAlertForUnsatisfiableConstraints in Xcode, then run your app to catch Auto Layout conflicts at the source before the system attempts recovery.

Frequently Asked Questions about auto-layout-debugging

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

FAQPage Schema
How do I debug 'Unable to simultaneously satisfy constraints' errors in iOS?

Auto Layout constraint conflicts occur when your view's constraints are contradictory. Set a symbolic breakpoint at `UIViewAlertForUnsatisfiableConstraints` in Xcode, run your app, and use Debug View Hierarchy and lldb commands to inspect the conflicting constraints and identify which rules need adjustment.

What causes ambiguous layouts and mispositioned views in Auto Layout?

Ambiguous layouts happen when constraints don't fully specify a view's position or size; misposition occurs when constraints conflict or are over-constrained. Use Debug View Hierarchy to visualize the hierarchy, inspect constraint listings, and apply systematic analysis to identify missing or conflicting rules.

How do I use Xcode's Debug View Hierarchy to fix Auto Layout issues?

Debug View Hierarchy visualizes your app's view structure at runtime. Enable it during a debug session to inspect individual views, examine their applied constraints, and use memory addresses to correlate console warnings with specific UI elements, then adjust constraints accordingly.

Can I prevent Auto Layout constraint conflicts before they happen?

Yes. Name your constraints and views descriptively, understand common conflict patterns, and follow best practices during design. Combined with symbolic breakpoints and early testing, these strategies catch issues during development rather than at runtime.

What's the systematic workflow for resolving Auto Layout conflicts?

Set breakpoints at constraint warnings, capture the view hierarchy, list active constraints using lldb, identify the conflicting rules, remove or modify the lowest-priority constraint, and verify the layout with autolayoutTrace output and visual inspection.

How do I use lldb commands to diagnose Auto Layout problems?

Use lldb commands and autolayoutTrace to inspect constraints at the memory-address level during debug sessions. This lets you correlate console warnings with specific views and constraints, enabling precise identification of which rules conflict or are missing.