Axiom Uikit
Debug and implement UIKit bridging, Auto Layout, Combine, TextKit, and UIKit animations with symptom-driven reference guides.
Overview
Axiom UIKit is an agent skill for the Build phase that routes UIKit–SwiftUI bridging, Auto Layout, Combine, TextKit, and UIKit animation problems to structured reference guides.
Install
npx skills add https://github.com/charleswiltgen/axiom --skill axiom-uikitWhat is this skill?
- Mandatory skill gate: use for ANY UIKit bridging, Auto Layout, Combine, TextKit, or UIKit animation work
- Symptom table routes constraints conflicts, missing views, and animation completion issues to dedicated references
- Covers UIViewRepresentable, UIHostingController embedding, and Coordinator/updateUIView lifecycle
- Combine publishers, AnyCancellable lifecycle, and Combine vs async/await guidance
- TextKit 2 / NSTextLayoutManager reference for rich text layout work
Adoption & trust: 1 installs on skills.sh; 958 GitHub stars; 3/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
Your hybrid SwiftUI/UIKit screen throws constraint conflicts, broken animations, or lifecycle bugs and generic web frontend advice does not apply.
Who is it for?
Indie iOS developers debugging representables, hosting controllers, constraint ambiguity, or Combine/async boundaries in production UI code.
Skip if: Pure SwiftUI-only apps with no UIKit integration, or non-Apple platforms where UIKit does not exist.
When should I use this skill?
Bridging UIKit and SwiftUI, debugging Auto Layout constraints, working with Combine, TextKit, or UIKit animations.
What do I get? / Deliverables
The agent follows the mandated skill path and the correct reference doc for your symptom so bridging, layout, Combine wiring, or TextKit layout converges faster.
- Correct reference-guided fixes for bridging, constraints, animations, or text layout
- Documented pattern choice (e.g. Combine vs async/await) aligned to the symptom table
Recommended Skills
Journey fit
How it compares
Use as a symptom-indexed skill package, not a generic “mobile frontend” chat prompt, when UIKit-specific failure modes appear.
Common Questions / FAQ
Who is axiom-uikit for?
Solo builders and small teams shipping iOS apps that mix SwiftUI with UIKit, Combine, TextKit, or UIKit-driven animations.
When should I use axiom-uikit?
During build frontend work when embedding SwiftUI in UIKit, fixing Auto Layout conflicts, debugging CAAnimation completion, or working with TextKit 2 layout managers.
Is axiom-uikit safe to install?
Check the Security Audits panel on this Prism page; the skill is MIT-licensed reference material and does not by itself execute shell or network actions.
SKILL.md
READMESKILL.md - Axiom Uikit
# UIKit & Bridging **You MUST use this skill for ANY UIKit bridging, Auto Layout, Combine, TextKit, or UIKit animation work.** ## Quick Reference | Symptom / Task | Reference | |----------------|-----------| | UIViewRepresentable, UIViewControllerRepresentable | See `skills/uikit-bridging.md` | | Embedding SwiftUI in UIKit (UIHostingController) | See `skills/uikit-bridging.md` | | Coordinator pattern, updateUIView lifecycle | See `skills/uikit-bridging.md` | | "Unable to simultaneously satisfy constraints" | See `skills/auto-layout-debugging.md` | | Constraint conflicts, ambiguous layout | See `skills/auto-layout-debugging.md` | | Views not appearing, positioned incorrectly | See `skills/auto-layout-debugging.md` | | CAAnimation completion handler not firing | See `skills/uikit-animation-debugging.md` | | Spring physics wrong on device, duration mismatch | See `skills/uikit-animation-debugging.md` | | Animation jank, CATransaction timing | See `skills/uikit-animation-debugging.md` | | Combine publishers, AnyCancellable lifecycle | See `skills/combine-patterns.md` | | @Published properties, Combine ↔ async/await | See `skills/combine-patterns.md` | | When to use Combine vs async/await | See `skills/combine-patterns.md` | | TextKit 2 architecture, NSTextLayoutManager | See `skills/textkit-ref.md` | | Writing Tools integration (iOS 26) | See `skills/textkit-ref.md` | | SwiftUI TextEditor, TextKit 1 migration | See `skills/textkit-ref.md` | | PencilKit canvas, PKToolPicker, drawing persistence | See `skills/pencilkit-paperkit.md` | | Apple Pencil Pro (squeeze, barrel roll, hover, haptics) | See `skills/pencilkit-paperkit.md` | | PaperKit markup canvas (shapes, images, text + drawing) | See `skills/pencilkit-paperkit-ref.md` | ## Decision Tree ```dot digraph uikit { start [label="UIKit task" shape=ellipse]; what [label="What do you need?" shape=diamond]; start -> what; what -> "skills/uikit-bridging.md" [label="wrap UIKit in SwiftUI\nor SwiftUI in UIKit"]; what -> "skills/auto-layout-debugging.md" [label="constraint errors,\nlayout issues"]; what -> "skills/uikit-animation-debugging.md" [label="CAAnimation bugs,\nspring physics,\ncompletion handlers"]; what -> "skills/combine-patterns.md" [label="publishers, sinks,\n@Published,\nasync/await bridge"]; what -> "skills/textkit-ref.md" [label="text layout,\nWriting Tools,\nTextKit migration"]; what -> "skills/pencilkit-paperkit.md" [label="drawing canvas,\nApple Pencil,\nPaperKit markup"]; } ``` 1. UIViewRepresentable / UIViewControllerRepresentable / UIHostingController? → `skills/uikit-bridging.md` 2. "Unable to simultaneously satisfy constraints" / layout bugs? → `skills/auto-layout-debugging.md` 3. CAAnimation completion missing / spring physics wrong / animation jank? → `skills/uikit-animation-debugging.md` 4. Combine publishers / AnyCancellable / @Published / Combine ↔ async bridge? → `skills/combine-patterns.md` 5. TextKit 2 / Writing Tools / TextEditor / TextKit 1 migration? → `skills/textkit-ref.md` 6. PencilKit canvas / Apple Pencil / PaperKit markup? → `skills/pencilkit-paperkit.md` 7. Pure SwiftUI view question (no UIKit bridging)? → `/skill axiom-swiftui` 8. Design decisions, HIG, Liquid Glass, SF Symbols, typography? → `/skill axiom-design` 9. Block retain cycles in UIKit callbacks? → See axiom-performance (`skills/objc-block-retain-cycles.md`) 10. Memory leaks from Combine subscriptions? → Start with `skills/combine-patterns.md`, then axiom-performance if leak persists ## Conflict Resolution **uikit vs swiftui**: When working with UI code: - **Use uikit** when wrapping UIKit in SwiftUI or vice versa, or debugging UIKit-specific issues (Auto Layout, CAAnimation) - **Use swiftui** for pure SwiftUI views, navigation, layout, animations **uikit vs concurre