How do I trigger these deep links during development?

You can trigger them from your terminal using the command 'xcrun simctl openurl booted' followed by your debug scheme, such as 'debug://settings'.

Does this support state configuration or just navigation?

It supports both. You can create deep links that navigate to a screen and simultaneously trigger specific states, such as showing an error message or an empty list, via query parameters.

Is this skill compatible with UIKit or only SwiftUI?

While the provided patterns focus on SwiftUI and NavigationStack (iOS 16+), the core concepts of URL scheme handling and Info.plist management can be adapted for UIKit-based applications.

Will these debug links ship in my production app?

No. The skill includes patterns using #if DEBUG macros and custom Build Phase scripts to ensure all debug-only URL schemes and handlers are stripped during the release build process.

Axiom Deep Link Debugging

Name: Axiom Deep Link Debugging
Author: CharlesWiltgen

byCharlesWiltgen

•

233

•

Mobile Development

Implements debug-only deep links to enable rapid simulator navigation and automated state-based testing for Apple platforms.

Axiom Deep Link Debugging is a specialized skill for iOS, iPadOS, and tvOS developers that facilitates closed-loop debugging by creating temporary, debug-only URL schemes. This allow developers and AI agents like Claude Code to bypass manual UI navigation and jump directly to specific screens, error states, or data configurations within the simulator. By integrating with SwiftUI's navigation system and providing automated build scripts to strip debug code from release versions, it ensures that testing remains fast and efficient without compromising production security or code quality.

Key Features

01Integration patterns for automated screenshot and testing workflows

02Build script automation to strip debug navigation from production releases

03State configuration via deep link parameters (e.g., error states, empty lists)

04233 GitHub stars

05Debug-only URL scheme implementation for rapid simulator navigation

06SwiftUI NavigationPath integration for programmatic routing

Use Cases

01Testing specific app states like network errors or authentication failures via URL parameters

02Navigating directly to deeply nested screens for UI verification without manual tapping

03Enabling automated agents to capture screenshots of specific UI components for visual debugging

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom axiom-deep-link-debugging

For use in Claude.ai and ChatGPT

Download Skill