Traction scoreGitHub stars can be faked, so popularity alone can be misleading. Traction Score looks for broader signs of recent attention, adoption, and active maintenance.
This collection of six skills handles the complete workflow for building, releasing, and refining native macOS applications. It includes command-line builds with xcodebuild, DMG packaging and Sparkle auto-updates for distribution outside the Mac App Store, a patterns guide for web developers transitioning to macOS, and advanced UI patterns like notch overlays and liquid glass settings windows. It serves macOS developers, indie publishers, and designers who need a reliable, detailed reference for shipping polished apps.
Compatible AgentsThe repository documents support for these agents. The skills may also work with other agents that can load SKILL.md files, but they may need some setup or small changes.
Compatibility not documented
Use this skill collection
Follow the documented setup, then try a first task.
Setup
Install the repository bundle with skills CLI
Installs: The macOS App Skills bundle identified as fayazara/macos-app-skills. The supplied evidence does not authoritatively map the registry-installed bundle to individual SKILL.md paths.
Before you start
npx must be available; the supplied evidence provides no installer for it.
macOS 14+; macOS 26+ is required for liquid glass features, which have graceful fallbacks.
Xcode 15+; Xcode 26 beta is required for Tahoe SDK features.
Swift 5.9+
Platform: macOS 14+
Run this terminal command to add the fayazara/macos-app-skills bundle.
Copy the documented skill set into one OpenCode project
Installs: Per-project installation of the README's documented “all skills” copy set: build, settings-ui, auto-update, release, and notch-ui. · OpenCode
Before you start
A local repository checkout containing the named skill directories.
The target OpenCode project's .agents/skills directory must be available.
macOS 14+; macOS 26+ is required for liquid glass features, which have graceful fallbacks.
Xcode 15+; Xcode 26 beta is required for Tahoe SDK features.
Swift 5.9+
Platform: macOS 14+
Run from: Local fayazara/macos-app-skills checkout containing the named source directories
In a terminal, replace `/path/to/your/project` with the path to the target project, keeping `/.agents/skills/` at the end, then copy the documented set of skill directories.
Installs: Per-project installation of only the settings-ui skill. · OpenCode
Before you start
A local repository checkout containing the settings-ui directory.
The target OpenCode project's .agents/skills directory must be available.
macOS 14+; macOS 26+ is required for liquid glass features, which have graceful fallbacks.
Xcode 15+; Xcode 26 beta is required for Tahoe SDK features.
Swift 5.9+
Platform: macOS 14+
Run from: Local fayazara/macos-app-skills checkout containing the settings-ui directory
In a terminal, replace `/path/to/your/project` with the path to the target project, keeping `/.agents/skills/` at the end, then copy the settings-ui directory.
`<project-directory>`: path to the macOS application's source tree
`<scheme>`: scheme to build, or permission to select it from the discovered schemes
Use the macos-build skill to locate the Xcode project or workspace under `<project-directory>`, identify its available schemes, and run a Debug macOS build for `<scheme>`. Report whether the build succeeded or show the first relevant build errors. Do not change source files.
`<project-directory>`: path to the macOS application's source tree
`<settings-sections>`: the small set of settings tabs or sections needed
Use the macos-settings-ui skill to review the settings-related code in `<project-directory>` and propose a minimal native settings window for `<settings-sections>`. Outline the NSWindowController, NavigationSplitView, and detail-pane files and identify where the required grouped-form modifiers belong. Do not modify files yet.
`<project-directory>`: path to the native macOS project
`<app-target>`: Xcode app target that should link Sparkle
Whether the project manages dependencies through the Xcode project or Package.swift
Use the macos-auto-update skill to add the Sparkle package dependency to the app target in `<project-directory>` and create the initial UpdaterManager singleton using the documented early-initialization pattern. Stop before publishing an appcast or release, and summarize the remaining Info.plist and UI integration work.
