axiom-ios-build

Diagnose and route iOS build and environment issues before debugging code.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-ios-build-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-ios-build
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-ios-build
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-ios-build-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This router helps identify and route environment-related issues that block iOS builds before diving into code changes, reducing time wasted on debugging non-code problems.

Core Features & Use Cases

  • Environment-first diagnostics: Detects common causes of build failures, simulator issues, and Xcode misbehavior to guide immediate next steps.
  • Automated routing to specialized skills: Directs issues to targeted agents like axiom-xcode-debugging, axiom-build-performance, spm-conflict-resolver, security-privacy-scanner, and modernization-helper based on triggers.
  • CI and local development coverage: Works across macOS CI pipelines and local machines to streamline debugging workflows.

Quick Start

Diagnose an iOS build failure by invoking the appropriate router before modifying code.

Frequently Asked Questions about axiom-ios-build

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

FAQPage Schema
Why does my iOS build fail in Xcode before I even start debugging?

iOS build failures often stem from environment issues like Xcode misbehavior or simulator problems rather than code errors. Diagnosing environment-related issues first prevents wasting time debugging non-code problems.

How do I diagnose iOS simulator problems and Xcode misbehavior on my local machine?

You can diagnose iOS simulator and Xcode issues by applying environment-first decision logic. This detects common causes of local development build failures and routes them to targeted diagnostic steps.

What is the best way to troubleshoot iOS build failures in a CI pipeline?

Troubleshooting iOS build failures in CI pipelines requires environment-first diagnostics that work across macOS CI environments. This approach identifies dependency conflicts and environment issues blocking builds.

Can I resolve Swift Package Manager dependency conflicts during an iOS build?

Yes, resolving SPM dependency conflicts during an iOS build is handled by routing the issue to a specialized dependency resolver. The router identifies the conflict and invokes the targeted sub-skill.

Does environment-first diagnostics work for both local macOS development and CI pipelines?

Environment-first diagnostics works across both local macOS development machines and CI pipelines. It streamlines debugging workflows by routing Xcode, simulator, and dependency issues to specialized agents.