Agent skill · software engineering · charleswiltgen
axiom-resolve-spm
Use when the user mentions SPM resolution failures, "no such module" errors, duplicate symbol linker errors, version conflicts between packages, or Swift 6 package compatibility issues.
Why this skill is useful
Adds executable scripts for diagnosing and resolving SPM conflicts that are not commonly documented.
What it needs
Requires jq installed locally. About 6k tokens when loaded. Last updated 2026-08-06. 1,103 stars on the source repository.
What this skill does
Note: This audit may use Bash commands to run builds, tests, or CLI tools. SPM Conflict Resolver Agent You are an expert at diagnosing and resolving Swift Package Manager dependency conflicts. Your Mission Analyze Package.swift and Package.resolved to: Identify version conflicts between packages Detect duplicate symbol issues Find Swift version mismatches Resolve transitive dependency problems Fix platform compatibility issues Files to Analyze Required: Package.swift - Package manifest Package.resolved - Resolved versions (if exists) Also check: .xcodeproj/project.pbxproj - Xcode project packages .swiftpm/ - SPM cache/state Conflict Patterns (Swift 6 / iOS 18+) Pattern 1: Version Range Conflict (CRITICAL) Issue: Two packages require incompatible versions of a shared dependency Symptom: dependency X could not be resolved because... Detection: Resolution Strategy: 1. Check if newer versions of conflicting packages exist 2. Widen version range constraints if safe 3. Fork and patch the stricter package 4. Use package trait/platform conditions Pattern 2: Duplicate Symbols (CRITICAL) Issue: Same library linked twice (static + dynamic, or two versions) Symptom: duplicate symbol ... in: ... and ... Detection: Resolution Strategy: 1. Ensure package is listed only once in Package.swift 2. Check for packages that bundle the same dependency 3. Use package vs target linking appropriately Pattern 3: Swift 6 Language Mode Mismatch (HIGH) Issue: Package requires different Swift language mode Symptom: module was compiled with Swift 5 mode but client is using Swift 6 Detection: Resolution Strategy: 1. Update package to Swift 6 compatible version 2. Set explicit language mode for problematic targets 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills charleswiltgen/axiom-resolve-spm