Axiom Swift
Review and modernize Swift and SwiftUI code—ownership, Transferable, deep links, and tvOS—so Apple platform apps match current APIs and fewer agent hallucinations ship.
Overview
axiom-swift is an agent skill most often used in Build (also Ship) that reviews Swift for modern idioms, noncopyable types, Transferable drag-and-drop, debug deep links, and tvOS.
Install
npx skills add https://github.com/charleswiltgen/axiom --skill axiom-swiftWhat is this skill?
- MUST-use gate for Swift idiom review, noncopyable types, Transferable, debug deep links, and tvOS
- Quick-reference routing to swift-modern, ownership-conventions, transferable-ref, deep-link-debugging topics
- Covers FormatStyle modernization, ~Copyable, borrowing/consuming, InlineArray, Span, and ARC reduction
- Documents .draggable, .dropDestination, PasteButton, ShareLink, UTType, and TransferRepresentation choices
- Flags common Claude Swift hallucinations (Date(), CGFloat, DateFormatter patterns)
- 5 MUST-use trigger domains: idioms, ownership, Transferable, deep links, tvOS
- 5 topical reference tracks in the quick-reference table
Adoption & trust: 1 installs on skills.sh; 958 GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
Your agent keeps emitting outdated Swift patterns, wrong ownership semantics, or broken drag-and-drop and deep-link code on Apple platforms.
Who is it for?
Solo builders shipping SwiftUI or multiplatform Apple apps who want mandatory platform-specific review hooks in the agent loop.
Skip if: Pure backend Kotlin or web-only stacks, or teams that never touch Swift, SwiftUI, or tvOS.
When should I use this skill?
Reviewing Swift for modern idioms, noncopyable types, drag and drop, debug deep links, or building for tvOS.
What do I get? / Deliverables
Swift changes follow Axiom reference paths so UI, sharing, and platform code use current APIs and ownership rules suitable for simulator and device testing.
- Modernized Swift snippets
- Ownership-correct type designs
- Transferable and deep-link patterns aligned to references
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Most usage is while building iOS, macOS, or tvOS UI and platform features where idioms and framework APIs matter day to day. Frontend is the canonical shelf because SwiftUI drag/drop, ShareLink, and platform UX dominate the skill’s MUST-use triggers over server or ops work.
Where it fits
Implement ShareLink and custom UTType while the skill routes to transferable-ref guidance.
Refactor a model to noncopyable semantics with borrowing/consuming parameters per ownership-conventions.
Run a pre-merge pass that catches Date() and CGFloat hallucinations via swift-modern rules.
How it compares
Apple-platform idiom and API checker—not a substitute for XCTest planning or App Store launch checklists.
Common Questions / FAQ
Who is axiom-swift for?
Indie iOS, macOS, and tvOS developers using Claude or Cursor who need enforced Swift modernization and framework-correct UI patterns.
When should I use axiom-swift?
During build/frontend when implementing SwiftUI features, ownership-heavy models, or Transferable sharing; during ship/review before merging large Swift diffs or tvOS builds.
Is axiom-swift safe to install?
It is documentation-style review guidance with no inherent network exfiltration; still review the Security Audits panel on this page before enabling in CI or shared repos.
SKILL.md
READMESKILL.md - Axiom Swift
# Swift Language & Platform **You MUST use this skill for ANY Swift idiom review, ownership/noncopyable types, Transferable/drag-and-drop, debug deep links, or tvOS development.** ## Quick Reference | Symptom / Task | Reference | |----------------|-----------| | Outdated Swift patterns (Date(), CGFloat, DateFormatter) | See `skills/swift-modern.md` | | Foundation modernization (FormatStyle, URL.documentsDirectory) | See `skills/swift-modern.md` | | Common Claude hallucinations in Swift code | See `skills/swift-modern.md` | | Noncopyable types (~Copyable) | See `skills/ownership-conventions.md` | | borrowing/consuming parameter ownership | See `skills/ownership-conventions.md` | | InlineArray, Span, value generics | See `skills/ownership-conventions.md` | | Reducing ARC overhead | See `skills/ownership-conventions.md` | | Drag and drop (.draggable, .dropDestination) | See `skills/transferable-ref.md` | | Copy/paste (.copyable, PasteButton) | See `skills/transferable-ref.md` | | ShareLink, content sharing | See `skills/transferable-ref.md` | | Custom UTType declarations | See `skills/transferable-ref.md` | | TransferRepresentation choices | See `skills/transferable-ref.md` | | Debug-only deep links for simulator testing | See `skills/deep-link-debugging.md` | | Navigate to specific screens for screenshots | See `skills/deep-link-debugging.md` | | tvOS Focus Engine, Siri Remote input | See `skills/tvos.md` | | tvOS storage constraints (no Documents dir) | See `skills/tvos.md` | | tvOS text input, AVPlayer tuning | See `skills/tvos.md` | | TVUIKit components | See `skills/tvos.md` | ## Decision Tree ```dot digraph swift { start [label="Swift task" shape=ellipse]; what [label="What do you need?" shape=diamond]; start -> what; what -> "skills/swift-modern.md" [label="modern idioms,\noutdated patterns,\nFoundation APIs"]; what -> "skills/ownership-conventions.md" [label="~Copyable, borrowing,\nconsuming, InlineArray,\nSpan, ARC reduction"]; what -> "skills/transferable-ref.md" [label="drag & drop, copy/paste,\nShareLink, UTTypes,\nTransferable conformance"]; what -> "skills/deep-link-debugging.md" [label="debug deep links,\nsimulator navigation,\nscreenshot automation"]; what -> "skills/tvos.md" [label="tvOS app,\nFocus Engine,\nSiri Remote, storage"]; } ``` 1. Outdated Swift patterns / modern API replacements / Claude hallucinations? -> `skills/swift-modern.md` 2. ~Copyable / borrowing / consuming / InlineArray / Span? -> `skills/ownership-conventions.md` 3. Drag and drop / copy/paste / ShareLink / Transferable / UTTypes? -> `skills/transferable-ref.md` 4. Debug deep links / simulator navigation / screenshot automation? -> `skills/deep-link-debugging.md` 5. tvOS development / Focus Engine / Siri Remote / storage / AVPlayer? -> `skills/tvos.md` 6. Swift concurrency (async/await, actors, Sendable) -> `/skill axiom-concurrency` 7. Swift performance (COW, ARC, generics optimization) -> See axiom-performance (skills/swift-performance.md) 8. Codable patterns (JSON, CodingKeys, enum serialization) -> See axiom-data (skills/codable.md) ## Conflict Resolution **swift vs concurrency**: When Swift 6 concurrency errors appear: - **Use concurrency, NOT swift** -- Concurrency errors are actor isolation / Sendable issues. `skills/swift-modern.md` covers concurrency *posture* (defaults), but detailed patterns live in axiom-concurrency. **swift vs performance**: When optimizing Swift code: - **Use swift for ownership** if the question is borrowing/consuming/~Copyable/InlineArray/Span -> `skills/ownership-conventions.md` - **Use performance** if the question is COW, ARC profiling, generic specialization, or Instruments workflows -> axiom-performance **swift vs swiftui**: When implementing drag and drop