Skip to content
cccskills
FreePublished on GitHub

axiom-macos

Use when building ANY macOS app — windows, menus, sandboxing, distribution, AppKit bridging or modernization (control events, state restoration, concentric corners), or macOS-specific SwiftUI patterns.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (13)

  • SKILL.md4.8 KB
  • agents/openai.yaml81 B
  • skills/appkit-interop.md21.3 KB
  • skills/appkit-modernization.md12.7 KB
  • skills/direct-distribution.md19.2 KB
  • skills/ios-apps-on-mac.md6.2 KB
  • skills/menus-and-commands.md13.5 KB
  • skills/sandbox-and-file-access.md19.7 KB
  • skills/screencapturekit-ref.md14.4 KB
  • skills/screencapturekit.md10.7 KB
  • skills/settings.md15.8 KB
  • skills/swiftui-differences.md19.5 KB
  • skills/windows.md14.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

macOS Development

You MUST use this skill for ANY macOS-specific development including windows, menus, sandboxing, distribution, AppKit bridging, and macOS SwiftUI differences.

Quick Reference

Symptom / TaskReference
Window management (WindowGroup, Window, MenuBarExtra, DocumentGroup)See skills/windows.md
Menu bar, commands, keyboard shortcutsSee skills/menus-and-commands.md
Table, Inspector, NavigationSplitView, focusSee skills/swiftui-differences.md
App Sandbox, file access, security-scoped bookmarksSee skills/sandbox-and-file-access.md
Another team's app or app group container access denied without a prompt (OS27)See skills/sandbox-and-file-access.md
Developer ID, notarization, Sparkle auto-updatesSee skills/direct-distribution.md
NSViewRepresentable, NSHostingController, AppKit bridging, @Observable in AppKit, NSHostingMenu, SwiftUI scenes from AppKitSee skills/appkit-interop.md
Modernizing AppKit: mouseDown replacement, control events, status-item sessions, state restoration, concentric corners, touch (OS27)See skills/appkit-modernization.md
Screen recording, sharing, or capture (ScreenCaptureKit)See skills/screencapturekit.md
SCStream / SCContentFilter / screenshots / file recording API, clip buffering, recording editor (OS27)See skills/screencapturekit-ref.md
Bring an iOS app to Mac: Catalyst adoption, Designed for iPad, Mac availability opt-outSee skills/ios-apps-on-mac.md
Apple Pay on Mac / CatalystSee axiom-payments/skills/apple-pay.md (Catalyst section)

Cross-Suite Routes

These topics overlap with macOS development but live in separate suites:

SwiftUI (shared iOS/macOS)

  • View state, data flow, @Observable → See axiom-swiftui
  • Navigation (NavigationStack basics) → See axiom-swiftui (skills/nav.md)
  • Layout (ViewThatFits, AnyLayout) → See axiom-swiftui (skills/layout.md)
  • Animations → See axiom-swiftui (skills/animation-ref.md)

Data & persistence

  • SwiftData, Core Data, GRDB → See axiom-data
  • CloudKit sync → See axiom-data

Concurrency

  • Swift 6 concurrency, actors, Sendable → See axiom-concurrency

Other

  • Accessibility (VoiceOver, Dynamic Type) → See axiom-accessibility
  • Networking (URLSession, Network.framework) → See axiom-networking
  • Security (Keychain, passkeys, encryption) → See axiom-security

Conflict Resolution

axiom-macos vs axiom-swiftui: When working on a macOS SwiftUI app:

  1. Use axiom-macos for macOS-only concerns: windows, menus, commands, sandboxing, distribution, Table, Inspector, AppKit bridging
  2. Use axiom-swiftui for cross-platform SwiftUI: navigation, layout, state management, animations
  3. Both may apply: A macOS app using NavigationSplitView with Table needs axiom-macos for Table specifics and axiom-swiftui for NavigationSplitView basics

axiom-macos vs axiom-security: For sandbox and code signing:

  1. Use axiom-macos for macOS App Sandbox, security-scoped bookmarks, file access entitlements, Developer ID signing
  2. Use axiom-security for Keychain storage, encryption, passkeys, certificate management

Decision Tree

digraph macos {
    start [label="macOS development task" shape=ellipse];
    what [label="What area?" shape=diamond];

    start -> what;
    what -> "skills/windows.md" [label="windows/scenes"];
    what -> "skills/menus-and-commands.md" [label="menus/commands/shortcuts"];
    what -> "skills/swiftui-differences.md" [label="Table/Inspector/focus/macOS SwiftUI"];
    what -> "skills/sandbox-and-file-access.md" [label="sandbox/file access"];
    what -> "skills/direct-distribution.md" [label="distribution/notarization/updates"];
    what -> "skills/appkit-interop.md" [label="AppKit bridging"];
    what -> "skills/appkit-modernization.md" [label="modernize AppKit\n(input/restoration/27 look)"];
    what -> "skills/ios-apps-on-mac.md" [label="iOS app to Mac\n(Catalyst / Designed for iPad)"];
    what -> "skills/screencapturekit.md" [label="screen capture/\nrecording/sharing"];
    what -> "axiom-swiftui" [label="cross-platform SwiftUI"];
    what -> "axiom-security" [label="Keychain/encryption"];
}

iOS screen capture? ScreenCaptureKit is macOS-only. For iOS screen recording, use ReplayKit — see axiom-media.

Resources

WWDC: 2021-10062, 2022-10061, 2022-10075, 2023-10148, 2024-10149, 2026-272, 2026-289

Docs: /security/app-sandbox, /swiftui/windowgroup, /swiftui/table

Skills: axiom-swiftui, axiom-security, axiom-concurrency, axiom-uikit

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when fixing or auditing ANY accessibility issue — VoiceOver, Dynamic Type, color contrast, touch targets, WCAG compliance, App Store accessibility review.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

Use when implementing, testing, or evaluating ANY Apple Intelligence, on-device AI, or speech-to-text feature. Covers Foundation Models, @Generable, LanguageModelSession, Tool protocol, eval suites, model-as-judge scoring, SpeechTranscriber, CoreML.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

Use when the user has a crash log (.ips, MetricKit JSON, legacy .crash text, .xccrashpoint bundle, or pasted text) that needs analysis.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

Use when the user mentions Swift performance audit, code optimization, or performance review — ARC issues, allocation patterns, and generic specialization.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

Use when the user mentions SwiftUI performance, janky scrolling, slow animations, or view update issues — expensive bodies, formatters, whole-collection dependencies, and missing lazy containers.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

Use when the user mentions flaky tests, tests that pass locally but fail in CI, race conditions in tests, or needs to diagnose WHY a specific test fails.

The English summary is being prepared. Showing the original description.

CharlesWiltgen/Axiom1.2KUpdated Oct 21, 2026

See all skills by CharlesWiltgen

Report a problem with this skill