macos

Build macOS apps with MenuBarExtra, window management, AppKit integration, and notarized distribution.

1|Updated Jul 29, 2026
One-click install
npx skills add https://github.com/fusengine/kimi-code --skill macos-fusengine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos
Source: https://github.com/fusengine/kimi-code/tree/main/plugins/swift-apple-expert/skills/macos
Command: npx skills add https://github.com/fusengine/kimi-code --skill macos-fusengine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Mac desktop applications requires navigating macOS-specific APIs like MenuBarExtra, multi-window scene management, AppKit bridging, and the code-signing/notarization pipeline for Gatekeeper-safe distribution outside the App Store. ## Core Features & Use Cases - Menu Bar & Window Management: Implement MenuBarExtra utility apps, WindowGroup/Window multi-window scenes, Settings preferences windows, and keyboard shortcuts via SwiftUI commands. - AppKit Integration: Wrap NSTextView, NSTableView, and other AppKit components in SwiftUI using NSViewRepresentable with the Coordinator pattern. - Build & Distribution Tooling: Use XcodeBuildMCP tools (build_macos, test_macos, launch_mac_app) and follow the notarytool/stapler workflow to sign, notarize, and distribute DMG installers. - Use Case: You are building a menu bar utility that monitors system status. Use this Skill to structure the app with MenuBarExtra and a Settings scene, build and test it via XcodeBuildMCP, then notarize and staple a signed DMG for direct download distribution. ## Quick Start Ask the agent to scaffold a macOS menu bar app with a Settings window, build it with build_macos, and walk through notarizing the resulting DMG for distribution.

Frequently Asked Questions about macos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a menu bar app in SwiftUI for macOS?▼

Use the MenuBarExtra scene in your App body to place an icon in the macOS menu bar. Apply .menuBarExtraStyle(.window) for popover content or .menuBarExtraStyle(.menu) for a simple dropdown menu, and combine it with WindowGroup for hybrid apps.

How to notarize a macOS app for distribution outside the App Store?▼

Sign the app with a Developer ID certificate and Hardened Runtime enabled, then submit it with xcrun notarytool using stored credentials. After Apple approves it, attach the ticket with xcrun stapler so Gatekeeper can verify the app offline.

Can I use AppKit views like NSTextView inside SwiftUI on macOS?▼

Yes, wrap AppKit views with NSViewRepresentable by implementing makeNSView and updateNSView. Use a Coordinator to bridge AppKit delegate callbacks such as NSTextViewDelegate back into SwiftUI state.

What XcodeBuildMCP tools are available for macOS builds?▼

The available tools are build_macos for compiling, build_run_macos for build-and-launch iteration, test_macos for running test suites, and launch_mac_app plus stop_mac_app for manually starting and terminating the built application.

When should I use WindowGroup versus Window in a macOS app?▼

Use WindowGroup when users should open multiple instances of a window, such as documents. Use Window for single-instance windows like inspectors or panels, and use the Settings scene for the preferences window opened with Command-comma.