swift-testing-macos

What problem does it solve?

Testing macOS applications presents unique challenges including AppKit main thread isolation requirements, XPC service mocking complexity, macOS-specific UI testing quirks, and xcodebuild configuration for CI pipelines. This Skill eliminates trial-and-error by providing production-ready, Apple-documented patterns for all macOS testing scenarios.

Core Features & Use Cases

• Modern Swift Testing Patterns: Covers @Test, @Suite, #expect, #require, #confirm, traits, and parameterized tests for macOS 26+ with Swift 6.3, including async testing and completion handler bridging.
• AppKit & XPC Unit Testing: Provides validated patterns for testing NSDocument I/O, NSViewController/NSWindow behavior, and mocking XPC services with protocol mocks to test client logic in isolation.
• XCTest UI & CI Workflows: Includes macOS-specific UI test patterns for menu bar interaction, window queries, and accessibility identifier setup, plus xcodebuild test commands, test plan configuration, and GitHub Actions CI setup.
• Use Case: For a document-based macOS app with XPC-backed preferences, use this Skill to write unit tests for NSDocument save/load logic, mock the preferences XPC service to test error handling, and automate UI tests for File menu workflows.

Quick Start

Use the swift-testing-macos skill to write a parameterized Swift Testing suite that validates round-trip NSDocument file I/O for plain text, markdown, and JSON formats.