macos-capabilities

Implement macOS App Sandbox, extensions, and background execution with entitlements and XPC services.

4|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/k97/dock-tile --skill macos-capabilities-k97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-capabilities
Source: https://github.com/k97/dock-tile/tree/main/.agents/skills/macos-development/macos-capabilities
Command: npx skills add https://github.com/k97/dock-tile --skill macos-capabilities-k97

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides expert guidance on navigating the complexities of macOS platform integration, ensuring your applications are secure, performant, and compliant with Apple's strict sandboxing and system extension requirements.

Core Features & Use Cases

  • Sandboxing & Security: Implement secure file access patterns using security-scoped bookmarks and proper entitlement management.
  • System Integration: Build robust menu bar utilities, background agents, and app extensions that adhere to modern macOS architecture.
  • Use Case: If you are building a utility that needs to monitor file changes in a user-selected folder while remaining Mac App Store compliant, this Skill provides the exact patterns for security-scoped bookmarks and sandbox-friendly file system monitoring.

Quick Start

Use the macos-capabilities skill to provide a code example for implementing a security-scoped bookmark to persist access to a user-selected directory.

Frequently Asked Questions about macos-capabilities

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

FAQPage Schema
How do I implement security-scoped bookmarks for macOS App Sandbox file access?

Security-scoped bookmarks persist access to user-selected directories across app launches in a macOS App Sandbox. You resolve the bookmark data to regenerate a security-scoped URL, enabling continued compliant file system monitoring without repeated user prompts.

What is the best way to build a macOS menu bar utility that runs in the background?

Building a macOS menu bar utility requires an app extension architecture that operates without a main window. You configure the app as a background agent using specific entitlements and system integration patterns to maintain a robust menubar presence.

Why does my sandboxed macOS app lose file access after restarting?

Your sandboxed macOS app loses file access because it lacks security-scoped bookmarks to persist user-granted permissions. Without resolving and retaining these bookmarks, the App Sandbox environment automatically revokes file URLs upon app termination.

Do I need XPC services for Mac App Store compliant app extensions?

Yes, XPC services are often necessary for Mac App Store compliant app extensions requiring privileged operations. They provide secure inter-process communication within the App Sandbox, isolating system-level tasks and entitlements for robust system integration.

Can I monitor file changes in a specific folder while maintaining macOS sandboxing?

You can monitor file changes in a user-selected folder under macOS sandboxing by requesting explicit user access. Implement security-scoped bookmarks to persist directory access, allowing compliant file system monitoring within strict App Sandbox boundaries.

What are the requirements for Mac App Store compatibility regarding system extensions?

Mac App Store compatibility requires strict adherence to App Sandbox entitlements and modern system extension architectures. Applications must utilize platform-native features like XPC services and avoid private APIs to satisfy Apple's robust system-level integration guidelines.