Agent-Skills.md

Agent Skills: macOS Platform

macOS platform-specific development with menu bar apps, window management, AppKit integration, and notarization. Use when building Mac apps, creating menu bar extras, or distributing outside App Store.

UncategorizedID: fusengine/agents/macos

Repository

fusengine/agents
fusengineLicense: MIT
7

Install this agent skill to your local

pnpm dlx add-skill https://github.com/fusengine/agents/tree/HEAD/plugins/swift-apple-expert/skills/macos

Skill Files

Browse the full folder contents for macos.

Download Skill

Loading file tree…

plugins/swift-apple-expert/skills/macos/SKILL.md

Skill Metadata

Name
macos
Description
macOS platform-specific development with menu bar apps, window management, AppKit integration, and notarization. Use when building Mac apps, creating menu bar extras, or distributing outside App Store.

macOS Platform

macOS-specific development with window management and distribution tools.

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

  1. fuse-ai-pilot:explore-codebase - Analyze existing macOS patterns
  2. fuse-ai-pilot:research-expert - Verify latest macOS 26 docs via Context7/Exa
  3. mcp__XcodeBuildMCP__build_macos - Build for macOS validation

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

When to Use

  • Building Mac desktop applications
  • Creating menu bar apps (MenuBarExtra)
  • Multi-window applications
  • Keyboard shortcuts and menus
  • Notarization for distribution
  • AppKit integration

Why macOS Skill

| Feature | Benefit | |---------|---------| | MenuBarExtra | Background utility apps | | Window management | Multi-window support | | Keyboard shortcuts | Power user productivity | | Notarization | Gatekeeper-safe distribution |

MCP Tools Available

Build Tools

  • build_macos - Build for macOS
  • build_run_macos - Build and launch
  • test_macos - Run macOS tests
  • launch_mac_app - Start built app
  • stop_mac_app - Terminate app

Reference Guide

| Need | Reference | |------|-----------| | MenuBarExtra, Settings, Windows | app-structure.md | | XcodeBuildMCP macOS tools | build-tools.md | | NSViewRepresentable, menus | appkit-integration.md | | Code signing, notarization | notarization.md |

Best Practices

  1. Keyboard shortcuts - Support power users
  2. Menu bar integration - For utility apps
  3. Multiple windows - Use WindowGroup/Window
  4. Settings window - Use Settings scene
  5. Notarization - Required for distribution
  6. Sandbox - Enable for App Store