mac-app
Skill1 starsChanged 4 days agoMITView on GitHub
Build, run and verify a desktop app for the Mac in SwiftUI, Electron or Tauri, so it behaves like a native Mac app - project setup, the native window and menu bar, system integrations (hotkeys, menu bar items, permissions), testing, snapshots and performance. Use when starting a Mac app, writing its code, hooking into macOS, making it fast, or checking that a change works in the running app.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- runbear-io/beardrivetheir own version, first seen Aug 3, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- runbear-io/beardrive★ 62same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agents-mdSkill
- app-iconSkill
- buildSkill
- cloneSkill
- debugSkill
- design-systemSkill
- docker-optimizeSkill
- improve-loopSkill
- mac-designSkill
- product-briefSkill
- quality-barSkill
- refactorSkill
- researchSkill
- reviewSkill
- start-hereSkill
- stop-overthinkingSkill
- ui-directorSkill
- user-storiesSkill
- ux-designSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 7 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 20
Write the choice and the reason in docs/BRIEF.md.
- Distinctive: line 39
Follow the stack's reference, the story's acceptance lines and the project's design system.
- Distinctive: line 42
Prefer the API with no permission.
- Very specific: line 44
Every feature is reachable three ways: a menu item with a shortcut, a URL scheme (<app>://action/<name>), and (SwiftUI) an App Intent.
- Distinctive: line 46
Keep files small enough to read in one go (about 300 lines).
- Distinctive: line 57
Behavior: every acceptance line maps to a unit test, a self-test step (a launch flag that runs the same functions the UI calls and prints …
- Distinctive: line 60
Menus and keys: check the real menu bar from outside the app (computer use or Accessibility) on a test copy: items disable when nothing is …
- Distinctive: line 62
Background paths: run every timer, observer and background queue once after a concurrency change.
- Distinctive: line 68
Use computer use only for what nothing else can reach: a real key press in another app, drag and drop from Finder, a permission prompt.
- Very specific: line 73
Commit as build says, one change per commit.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Mac app
The outcome: an app that opens from /Applications like any other, behaves like a native Mac
app in every stack, and has been seen working (not just compiled) after every change. How it
should look and behave is the mac-design skill; this skill is how to build and prove it.
1. Pick the stack
| Stack | Pick when | Read |
| SwiftUI | Mac-only, deep system hooks (hotkeys, Accessibility, screen capture), smallest and fastest app | references/swiftui.md |
| Tauri | A web UI with a small, fast native shell (Rust); Mac first, other platforms later | references/tauri.md |
| Electron | A web UI that must match on Mac, Windows and Linux, or reuse a large web codebase | references/electron.md |
Write the choice and the reason in docs/BRIEF.md. Whatever the stack, the window, menu bar,
shortcuts, Settings and focus rules in mac-design apply in full.
2. Set it up so it is real from day one
The first build proves the toolchain, before feature code. From the first commit the app has:
- A name, a reverse-DNS bundle id, and an install path that never changes (macOS keeps permission grants per signature and path).
- The native window: traffic lights, a draggable top area, a sidebar that can fold away.
- A real menu bar in Apple's order (
mac-designreferences/menus.md) with standard shortcuts, and Settings on Command-comma. - Light and dark mode that follow the Mac, and the person's accent color.
- Its data in
~/Library/Application Support/<App>/, with an override (an environment variable) so tests and snapshots never touch real data. - An icon (the
app-iconskill).
3. Write the code
- Follow the stack's reference, the story's acceptance lines and the project's design system.
- System hooks (global shortcuts, menu bar items, Accessibility, screen capture, launch at login,
Shortcuts, notifications): pick the API and its permission from
references/os-integrations.md. Prefer the API with no permission. Ask for a permission at the moment of use, and show the state of every permission on one Settings page. - Every feature is reachable three ways: a menu item with a shortcut, a URL scheme
(
<app>://action/<name>), and (SwiftUI) an App Intent. One action list backs all three. - Keep files small enough to read in one go (about 300 lines).
4. Verify in the running app
A change is done when you have seen it work, not when it compiles. Code that builds can still show an empty sidebar, clipped text, unreadable dark mode, or a menu item that does nothing.
- Build with zero warnings, install to the same path, open it.
- Look: capture your own window (never the full screen, it shows the person's other windows) for every page you touched, light and dark, with sample data in a test store. The app can have a snapshot mode that walks its pages and saves one image each. Look at every image.
- Behavior: every acceptance line maps to a unit test, a self-test step (a launch flag that runs the same functions the UI calls and prints PASS or FAIL), or a named manual check. Logic lives where it can be tested without the UI.
- Menus and keys: check the real menu bar from outside the app (computer use or Accessibility) on a test copy: items disable when nothing is selected, and do what they say.
- Background paths: run every timer, observer and background queue once after a concurrency change. That is where Swift 6 apps crash at runtime.
- Fast: a key press shows its result in the next frame (under 100 ms), and nothing blocks the
main thread for more than 50 ms. Measure the release build before and after a fix
(
references/performance.md; audio, video and GPU work:references/media.md).
Use computer use only for what nothing else can reach: a real key press in another app, drag and drop from Finder, a permission prompt.
5. Commit
Commit as build says, one change per commit.
Done when
The app builds with zero warnings, opens from its install path, every page you touched was seen in light and dark, every acceptance line passes its check, and the change is committed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

