[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83109":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":14,"starSnapshotCount":14,"syncStatus":26,"lastSyncTime":27,"discoverSource":28},83109,"macos-app-skills","fayazara\u002Fmacos-app-skills","fayazara","AI coding agent skills for building, shipping, and maintaining native macOS apps",null,"Swift",517,12,115,0,8,269,35,7.34,false,"main",true,[],"2026-06-12 02:04:31","# macOS App Skills\n\n[![skills.sh](https:\u002F\u002Fskills.sh\u002Fb\u002Ffayazara\u002Fmacos-app-skills)](https:\u002F\u002Fskills.sh\u002Ffayazara\u002Fmacos-app-skills)\n\nAI coding agent skills for building, shipping, and maintaining native macOS apps with SwiftUI + AppKit.\n\n```bash\nnpx skills add fayazara\u002Fmacos-app-skills\n```\n\nThese skills are designed for [OpenCode](https:\u002F\u002Fopencode.ai), [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code), [Cursor](https:\u002F\u002Fcursor.sh), and any AI coding agent that supports skills. They encode hard-won patterns for building production macOS apps -- the kind of stuff that's underdocumented, spread across WWDC sessions, and easy to get wrong.\n\n## Skills\n\n### `build\u002F` -- Build macOS App\n\nBuild any native macOS Xcode project from the command line using `xcodebuild`. Handles project discovery, scheme detection, beta toolchains, and common build failures.\n\n### `settings-ui\u002F` -- Settings Window with Liquid Glass\n\nCreate a proper macOS settings\u002Fpreferences window with liquid glass support for macOS 26 (Tahoe). Uses `NSWindowController` with `.fullSizeContentView` for the rounded liquid glass window chrome, `NavigationSplitView` with sidebar, grouped Forms with transparent backgrounds, and back\u002Fforward toolbar navigation.\n\nIncludes complete reference Swift files you can copy into any project.\n\n### `auto-update\u002F` -- Sparkle Auto-Update\n\nAdd [Sparkle](https:\u002F\u002Fsparkle-project.org\u002F) auto-update support to a macOS app distributed outside the Mac App Store. Covers SPM dependency setup, the `UpdaterManager` singleton pattern, Info.plist configuration, EdDSA key generation, and UI integration (settings toggle + menu bar button).\n\nIncludes a reference `UpdaterManager.swift` ready to drop into any project.\n\n### `macos-patterns\u002F` -- Native Patterns for Web Developers\n\nThe \"how things actually work on macOS\" reference. Covers menu bar apps (MenuBarExtra vs NSStatusItem vs NSPopover), activation policy (Dock icon toggling), NSPanel vs NSWindow, window levels and collection behaviors, screen geometry (frame vs visibleFrame, Y-axis flip, multi-monitor), keyboard shortcuts (3 tiers: SwiftUI, NSEvent monitors, Carbon hotkeys), file pickers, clipboard\u002Fpasteboard, drag and drop, NavigationSplitView + inspector layout, launch at login, Quick Look, NSWorkspace, ScreenCaptureKit, and UserDefaults\u002F@AppStorage.\n\nThis is the skill to load proactively on any macOS project to prevent the AI from applying web patterns that don't work.\n\n### `notch-ui\u002F` -- Dynamic Island \u002F Notch Extender\n\nCreate a Dynamic Island-style overlay that extends from the MacBook's hardware notch. Uses a borderless NSPanel at `CGShieldingWindowLevel` positioned flush against the top of the screen, with a custom `NotchShape` that has concave Bezier \"ear\" curves matching the hardware notch. Includes spring animations for the expand\u002Fcollapse effect and a fallback pill mode for non-notch Macs.\n\nIncludes reference `NotchWindow.swift` (the panel) and `NotchShape.swift` (the shape).\n\n### `release\u002F` -- Release Pipeline + CLI Tool\n\nRelease a macOS app to GitHub with DMG packaging and Sparkle appcast updates. Covers the full pipeline: version bump, archive, notarize, export, DMG creation via `create-dmg`, EdDSA signing via Sparkle's `sign_update`, appcast.xml updates, and GitHub release creation via `gh`.\n\nIncludes a **Go CLI tool** (`release\u002Fcli\u002F`) that automates the entire pipeline in a single command. Just add a `release.json` to your project root and run:\n\n```bash\ngo run github.com\u002Ffayazara\u002Fmacos-app-skills\u002Frelease\u002Fcli@latest\n```\n\n## Installation\n\n### OpenCode (per-project)\n\nCopy the skills you need into your project's `.agents\u002Fskills\u002F` directory:\n\n```bash\n# Copy all skills\ncp -r build settings-ui auto-update release notch-ui \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.agents\u002Fskills\u002F\n\n# Or just the ones you need\ncp -r settings-ui \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.agents\u002Fskills\u002F\n```\n\n### OpenCode (global)\n\nCopy into your global skills directory:\n\n```bash\ncp -r build settings-ui auto-update release notch-ui ~\u002F.config\u002Fopencode\u002Fskills\u002F\n```\n\n### Other AI agents\n\nEach skill is a self-contained directory with a `SKILL.md` file and optional `references\u002F` folder. The `SKILL.md` is a markdown file with YAML frontmatter -- adapt to your agent's skill format.\n\n## What These Skills Solve\n\nBuilding native macOS apps with AI coding agents is great until you hit the parts where the AI confidently generates code that doesn't work:\n\n- **Settings windows** look wrong because SwiftUI's `Window` scene doesn't support `.fullSizeContentView`, which is required for liquid glass on macOS 26\n- **Sparkle integration** has subtle timing requirements (`SPUStandardUpdaterController` must be created before `applicationDidFinishLaunching` returns) that are easy to miss\n- **Release pipelines** involve 8+ manual steps that are error-prone and tedious to explain every time\n- **`xcodebuild`** invocations have enough flags and edge cases that the AI frequently gets them wrong\n- **Notch overlays** require specific NSPanel configuration, screen geometry math, and a custom shape with concave Bezier curves that no AI gets right from scratch\n- **Native patterns** like NSPanel vs NSWindow, activation policy toggling, window levels, Carbon hotkeys, pasteboard clearing, and screen geometry have no web equivalents and the AI defaults to web-like approaches that don't work\n\nThese skills encode the correct patterns so the AI gets it right the first time.\n\n## Requirements\n\n- macOS 14+ (macOS 26+ for liquid glass features, with graceful fallbacks)\n- Xcode 15+ (Xcode 26 beta for Tahoe SDK features)\n- Swift 5.9+\n\n## License\n\nMIT\n","该项目提供了一组AI编码代理技能，用于构建、发布和维护基于SwiftUI和AppKit的原生macOS应用程序。核心功能包括通过命令行构建Xcode项目、创建具有液态玻璃效果的设置窗口、集成Sparkle自动更新机制、为Web开发者提供macOS原生模式参考以及实现类似Dynamic Island的界面扩展。这些技能支持OpenCode、Claude Code等AI编码工具，并封装了构建macOS应用时常见的复杂模式与最佳实践。适用于需要快速开发高质量macOS应用且希望减少常见错误发生的场景。",2,"2026-06-11 04:10:09","CREATED_QUERY"]