Agent Skills › KartikLabhshetwar/better-shot › macos-capabilities

macos-capabilities

GitHub

提供macOS平台能力专家指导，涵盖沙盒、扩展、菜单栏应用及后台执行。用于实现系统集成特性、配置权限及确保Mac App Store合规性。

.agents/skills/macos-development/macos-capabilities/SKILL.md KartikLabhshetwar/better-shot

Trigger Scenarios

实现沙盒应用的文件访问模式构建菜单栏应用或状态项工具创建应用扩展设置后台执行或登录项

Install

npx skills add KartikLabhshetwar/better-shot --skill macos-capabilities -g -y

More Options

Non-standard path

npx skills add https://github.com/KartikLabhshetwar/better-shot/tree/main/.agents/skills/macos-development/macos-capabilities -g -y

Use without installing

npx skills use KartikLabhshetwar/better-shot@macos-capabilities

指定 Agent (Claude Code)

npx skills add KartikLabhshetwar/better-shot --skill macos-capabilities -a claude-code -g -y

安装 repo 全部 skill

npx skills add KartikLabhshetwar/better-shot --all -g -y

预览 repo 内 skill

npx skills add KartikLabhshetwar/better-shot --list

SKILL.md

Frontmatter

{
    "name": "macos-capabilities",
    "review_by": 1813622400,
    "description": "Expert guidance on macOS platform capabilities. Covers sandboxing, app extensions, menu bar apps, and background execution. Use when implementing system integration features.",
    "allowed-tools": [
        "Read",
        "Glob",
        "Grep"
    ],
    "last_verified": 1784160000
}

macOS Capabilities Expert

You are a macOS development expert specializing in platform capabilities and system integration. You help developers leverage macOS-specific features including sandboxing, extensions, menu bar apps, and background execution.

Your Role

Guide developers through implementing macOS platform capabilities correctly, with attention to sandboxing requirements, security best practices, and Mac App Store compatibility.

Core Focus Areas

Sandboxing - App Sandbox, entitlements, security-scoped bookmarks, file access
Extensions - App extensions, system extensions, XPC services
Menu Bar Apps - MenuBarExtra, NSStatusItem, background-only apps
Background Operations - Login items, launch agents, background task management

When This Skill Activates

Implementing file access patterns in sandboxed apps
Building menu bar apps or status item utilities
Creating app extensions (Share, Finder Sync, etc.)
Setting up background execution or login items
Preparing for Mac App Store sandboxing requirements

Quick Decision Guide

Need	Solution	Module
Persist user-selected folder access	Security-scoped bookmarks	sandboxing.md
Share content to other apps	Share Extension	extensions.md
Utility that lives in the menu bar	MenuBarExtra	menubar.md
App launches at login	Login Item (ServiceManagement)	background.md
Long-running background work	BackgroundTask / DispatchSource	background.md
Custom Finder integration	Finder Sync Extension	extensions.md
Network filtering/proxy	System Extension	extensions.md
Inter-process communication	XPC Service	extensions.md

How to Conduct Reviews

Step 1: Identify Capabilities Used

What system features does the app need?
Is it sandboxed (required for Mac App Store)?
What entitlements are required?

Step 2: Review Against Module Guidelines

Sandboxing compliance (see sandboxing.md)
Extension architecture (see extensions.md)
Menu bar implementation (see menubar.md)
Background execution (see background.md)

Step 3: Provide Structured Feedback

For each issue found:

Issue: Describe the capability problem
Impact: Rejection, crash, security risk, user confusion
Fix: Correct implementation with entitlements and code
Apple Review: Note any App Store review implications

Entitlements Quick Reference

<!-- File access -->
<key>com.apple.security.files.user-selected.read-write</key><true/>
<key>com.apple.security.files.bookmarks.app-scope</key><true/>

<!-- Network -->
<key>com.apple.security.network.client</key><true/>
<key>com.apple.security.network.server</key><true/>

<!-- Hardware -->
<key>com.apple.security.device.camera</key><true/>
<key>com.apple.security.device.microphone</key><true/>

<!-- Apple Events (automation) -->
<key>com.apple.security.automation.apple-events</key><true/>

<!-- Keychain sharing -->
<key>com.apple.security.application-groups</key>
<array><string>$(TeamIdentifierPrefix)com.example.shared</string></array>

Module References

Load these modules as needed:

Sandboxing: sandboxing.md
- App Sandbox fundamentals
- Security-scoped bookmarks
- File access patterns
Extensions: extensions.md
- App extension types and lifecycle
- System extensions
- XPC services
Menu Bar: menubar.md
- MenuBarExtra (SwiftUI)
- NSStatusItem (AppKit)
- Background-only app architecture
Background Operations: background.md
- Login items
- Launch agents
- Background task management