Skip to main content
skill CX Codex

macos-native — Claude Code skill for macOS development

The macos-native Claude Code skill guides native macOS app development with AppKit, Catalyst, and system APIs. It activates for Mac apps, menu bar utilities, system extensions, and macOS-specific features.

MIT 298 installs ★ 114 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill macos-native -a claude-code
Open on GitHub

What macos-native does

The skill covers native macOS development with AppKit and modern system APIs. Swift examples show an app delegate, window setup, and a view controller with a scrollable table.

Separate reference files cover menu bar apps, document-based apps, system integration, sandboxing, and entitlements. A checklist addresses Mac App Store submissions. Catalyst is described as a way to bring iPad apps to Mac, with limitations.

What it helps with

  • set up an AppKit application structure
  • configure a macOS window and main menu
  • build a view controller with a table
  • add an app to the menu bar
  • review sandbox and entitlement topics

Example prompts for the agent

  • Create a native macOS app with an AppKit window.
  • Add a menu bar app to this macOS project.
  • Show how to build a scrollable table in an AppKit view controller.

How to install macos-native

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill macos-native -a claude-code

2Manually: put the files in place

~/.claude/skills/macos-native/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/macos-native/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about macos-native

How do I install macos-native in Claude Code?

Run npx skills add travisjneuman/.claude --skill macos-native -a claude-code. The skill file is at ~/.claude/skills/macos-native/SKILL.md.

What does macos-native do?

It provides guidance for native macOS apps using AppKit, Catalyst, and system APIs. Its examples cover app structure, windows, and table views, with separate references for system features.

What macOS development topics does macos-native cover?

The references cover menu bar and document-based apps, system integration, sandboxing, entitlements, and a Mac App Store submission checklist.

Source text

SKILL.md · MIT
---
name: macos-native
description: Native macOS development with AppKit, Catalyst, and macOS-specific APIs. Use when building Mac-native apps, menu bar apps, system extensions, or macOS-specific features.
---

# macOS Native Development

Comprehensive guide for building native macOS applications with AppKit and modern macOS APIs.

## Framework Overview

| Framework            | Use Case             | Notes                       |
| -------------------- | -------------------- | --------------------------- |
| **AppKit**           | Traditional Mac apps | Full control, mature        |
| **SwiftUI**          | Modern Mac apps      | Cross-platform, declarative |
| **Catalyst**         | iPad apps on Mac     | Quick port, limitations     |
| **AppKit + SwiftUI** | Hybrid approach      | Best of both worlds         |

---

## AppKit Fundamentals

### Application Structure

```swift
// AppDelegate.swift
import Cocoa

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    var mainWindow: NSWindow?

    func applicationDidFinishLaunching(_ notification: Notification) {
        setupMainWindow()
        setupMainMenu()
    }

    func applicationWillTerminate(_ notification: Notification) {
        // Cleanup
    }

    func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
        return true
    }

    private func setupMainWindow() {
        let contentRect = NSRect(x: 0, y: 0, width: 800, height: 600)
        let styleMask: NSWindow.StyleMask = [
            .titled, .closable, .miniaturizable, .resizable
        ]

        mainWindow = NSWindow(
            contentRect: contentRect,
            styleMask: styleMask,
            backing: .buffered,
            defer: false
        )

        mainWindow?.title = "My Mac App"
        mainWindow?.contentViewController = MainViewController()
        mainWindow?.center()
        mainWindow?.makeKeyAndOrderFront(nil)
    }
}
```

### View Controller

```swift
import Cocoa

class MainViewController: NSViewController {
    private let tableView = NSTableView()
    private let scrollView = NSScrollView()
    private var items: [String] = []

    override func loadView() {
        view = NSView(frame: NSRect(x: 0, y: 0, width: 800, height: 600))
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
        loadData()
    }

    private func setupUI() {
        // Setup scroll view
        scrollView.translatesAutoresizingMaskIntoConstraints = false
        scrollView.hasVerticalScroller = true
        scrollView.documentView = tableView
        view.addSubview(scrollView)

        // Setup table view
        let column = NSTableColumn(identifier: NSUserInterfaceItemIdentifier("main"))
        column.title = "Items"
        column.width = 200
        tableView.addTableColumn(column)
        tableView.delegate = self
        tableView.dataSource = self

        // Constraints
        NSLayoutConstraint.activate([
            scrollView.topAnchor.constraint(equalTo: view.topAnchor, constant: 20),
            scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 20),
            scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -20),
            scrollView.bottomAnchor.constraint(equalTo: view.bottomAnchor, constant: -20),
        ])
    }

    private func loadData() {
        items = ["Item 1", "Item 2", "Item 3"]
        tableView.reloadData()
    }
}

extension MainViewController: NSTableViewDataSource, NSTableViewDelegate {
    func numberOfRows(in tableView: NSTableView) -> Int {
        return items.count
    }

    func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {
        let identifier = NSUserInterfaceItemIdentifier("cell")
        var cell = tableView.makeView(withIdentifier: identifier, owner: nil) as? NSTextField

        if cell == nil {
            cell = NSTextField(labelWithString: "")
            cell?.identifier = identifier
        }

        cell?.stringValue = items[row]
        return cell
    }
}
```

---

## Reference files

Detailed material is in separate files so this overview stays short. Read only the file whose topic matches the task; each one is self-contained. Paths are relative to the folder that holds this `SKILL.md` (in the full toolkit install, `~/.claude/skills/macos-native/`).

| Topic | File | Covers |
| --- | --- | --- |
| Menu Bar Apps | [`references/menu-bar-apps.md`](references/menu-bar-apps.md) | Status Item; Menu Construction |
| Document-Based Apps | [`references/document-based-apps.md`](references/document-based-apps.md) | Document Controller |
| System Integration | [`references/system-integration.md`](references/system-integration.md) | Services; Drag and Drop; Notifications |
| Sandboxing & Entitlements | [`references/sandboxing-and-entitlements.md`](references/sandboxing-and-entitlements.md) | Common Entitlements; Security-Scoped Bookmarks |
| Checklist | [`references/checklist.md`](references/checklist.md) | Mac App Store Submission; Best Practices |

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Programming languages →

From the same set117

The whole set →
career-path-planner career-path-planner — a skill for career planning: skills audit, gap analysis, a development plan and milestone tracking. Useful when changing role or industry. CX Codex +1 347installs supply-chain-optimizer supply-chain-optimizer — a skill that hands your agent ready templates for supply chain mapping, inventory math, vendor scoring and demand forecasting. Useful when you need an EOQ figure or a supplier matrix. CX Codex +1 342installs audio-production The audio-production skill for Claude Code guides recording, mixing, mastering, and sound design for music, podcasts, and video. CX Codex +1 328installs ui-animation The ui-animation Claude Code skill guides interface animation, from micro-interactions to page transitions. It applies to motion work on web and mobile screens. CX Codex +1 304installs health-wellness health-wellness is a Claude Code skill that brings together corporate frameworks for employee wellness programs, workplace ergonomics, safety metrics, and healthcare plan design. CX Codex +1 281installs database-expert The database-expert Claude Code skill covers database schema design, query tuning, and administration. It activates for work with PostgreSQL, MongoDB, and Redis. CX Codex +1 255installs generic-react-ux-designer generic-react-ux-designer — a skill for designing React interfaces: interaction patterns, accessibility, forms, micro-interactions with Framer Motion. CX Codex +1 253installs event-planner event-planner structures event planning with 12-month timelines, budget allocation models, venue matrices, and day-of run sheets. CX Codex +1 253installs

Project sponsors

Companies that keep this analytics open