macos-system-integration

Implement macOS 26 system integrations with SMAppService and security-scoped bookmarks.

1|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/LaughingJackalope/macos-skills --skill macos-system-integration
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: macos-system-integration
Source: https://github.com/LaughingJackalope/macos-skills/tree/main/macos-system-integration
Command: npx skills add https://github.com/LaughingJackalope/macos-skills --skill macos-system-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of scattered, outdated documentation for macOS system-level integrations, providing a single, Apple-vetted resource for implementing sandboxed app features, system services, and cross-process workflows that meet current platform requirements.

Core Features & Use Cases

  • SMAppService & Launch Services: Register login items, launch agents, and launch daemons with modern async/await APIs, replacing the deprecated SMLoginItemSetEnabled, with built-in handling for user approval flows in System Settings.
  • Sandboxed File Access: Persist user-selected file access across app launches with security-scoped bookmarks, and coordinate cross-process file reads/writes with NSFileCoordinator to prevent data corruption.
  • System Interaction Workflows: Implement custom clipboard and drag-and-drop types with NSPasteboard, index app content for Spotlight search with Core Spotlight, embed Quick Look previews, and automate other apps with AppleScript.
  • Use Case: For example, use this Skill to add a background sync agent that launches at user login, implement drag-and-drop for custom project file types between your app and Finder, or index user documents so they appear in Spotlight search without manual reindexing logic.

Quick Start

Use the macos-system-integration skill to add a login item toggle to your macOS app that automatically directs users to System Settings for approval when the system requires it.

Frequently Asked Questions about macos-system-integration

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

FAQPage Schema
How do I register a login item in macOS 26+ using SMAppService?โ–ผ

macOS sandboxed file access requires security-scoped bookmarks to persist user-selected file access across app launches. It also requires coordinating cross-process file reads and writes with NSFileCoordinator to prevent data corruption during these operations.

What's the best way to index app content for Spotlight search?โ–ผ

macOS custom drag-and-drop workflows handle custom UTType handling by using NSPasteboard to implement custom clipboard types. This enables drag-and-drop for custom project file types between your application and Finder seamlessly.

Does this macOS system integration approach work for sandboxed apps?โ–ผ

Yes, this macOS system integration approach works for sandboxed apps. It implements production-grade system-level integration patterns that satisfy strict sandboxed app system integration requirements, including security-scoped bookmarks and SMAppService registration.

Why does SMLoginItemSetEnabled not work for launch agents anymore?โ–ผ

SMLoginItemSetEnabled does not work for launch agents anymore because it is deprecated. Modern macOS requires using SMAppService to register launch agents and daemons, which includes built-in handling for necessary user approval flows in System Settings.