Build any Mac app
Find where the user is on the path below, then call the Skill tool with the
skill for that step. One skill per call.
idea -> research -> clone (optional) -> app-brief -> user-stories -> new-mac-app
-> mac-design + design-system + app-icon -> improve-loop (ux, code, design, verify, commit) -> repeat
Pick the app's name first (app-brief, step 1) and create
<parent>/<AppName>/docs/ before research, so every skill writes into the
same folder. Design comes right after the scaffold: tokens from the first
view, and the real icon in every snapshot.
Plan
| The user has |
Skill |
| A vague idea, or asks "what should I build" |
research, then app-brief |
| An app they want to replace or rebuild |
clone |
| A brief or a screen index, no backlog |
user-stories |
A spec from BAMA's specs/ folder |
app-brief (it copies the spec) |
Build
| The user wants to |
Skill |
| Start a new project |
new-mac-app |
| Write or fix Swift and SwiftUI code |
swift-swiftui |
| Hook into macOS: hotkeys, menu bar, windows, screen capture, Shortcuts |
os-integrations |
| Make it fast: hangs, stutter, GPU, video, memory |
performance |
| Let Claude Code, Codex, or scripts drive the app: a CLI, an MCP server |
agent-cli |
| Refactor, clean up, or check the code as it grows |
improve-architecture |
Design
| The user wants to |
Skill |
| Decide how a feature works and what it says: names, flow, modals, accessibility |
ux-design |
| Make it look and feel like a Mac app |
mac-design |
| An accent or brand color, a color picker, tokens |
design-system |
| Their own parts and feel, not Apple's: buttons, rows, sidebar, icons |
design-kit |
| The look of an app they name, or screenshots of one |
design-from-app |
| One set of colors, radii, motion, and controls for the whole app |
design-system |
| Fix spacing and alignment, or check the layout on the grid |
layout-grid |
| An app icon |
app-icon |
Ship
| The user wants to |
Skill |
| Build it and look at every page |
build-and-verify |
| Tests, a self-test, or an agent that drives the running app |
test-mac-app |
| Work through the backlog on its own |
improve-loop |
Done when
You named the step, called its skill, and told the user which skill comes
after it.
1---2name: bama3description: Build any Mac app. Start here to pick the next skill for a native macOS app.4disable-model-invocation: true5metadata:6 source: https://skillmd.com/skills/tuyv/bama7---89# Build any Mac app1011Find where the user is on the path below, then call the Skill tool with the12skill for that step. One skill per call.1314```text15idea -> research -> clone (optional) -> app-brief -> user-stories -> new-mac-app16 -> mac-design + design-system + app-icon -> improve-loop (ux, code, design, verify, commit) -> repeat17```1819Pick the app's name first (app-brief, step 1) and create20`<parent>/<AppName>/docs/` before research, so every skill writes into the21same folder. Design comes right after the scaffold: tokens from the first22view, and the real icon in every snapshot.2324## Plan2526| The user has | Skill |27| --- | --- |28| A vague idea, or asks "what should I build" | `research`, then `app-brief` |29| An app they want to replace or rebuild | `clone` |30| A brief or a screen index, no backlog | `user-stories` |31| A spec from BAMA's `specs/` folder | `app-brief` (it copies the spec) |3233## Build3435| The user wants to | Skill |36| --- | --- |37| Start a new project | `new-mac-app` |38| Write or fix Swift and SwiftUI code | `swift-swiftui` |39| Hook into macOS: hotkeys, menu bar, windows, screen capture, Shortcuts | `os-integrations` |40| Make it fast: hangs, stutter, GPU, video, memory | `performance` |41| Let Claude Code, Codex, or scripts drive the app: a CLI, an MCP server | `agent-cli` |42| Refactor, clean up, or check the code as it grows | `improve-architecture` |4344## Design4546| The user wants to | Skill |47| --- | --- |48| Decide how a feature works and what it says: names, flow, modals, accessibility | `ux-design` |49| Make it look and feel like a Mac app | `mac-design` |50| An accent or brand color, a color picker, tokens | `design-system` |51| Their own parts and feel, not Apple's: buttons, rows, sidebar, icons | `design-kit` |52| The look of an app they name, or screenshots of one | `design-from-app` |53| One set of colors, radii, motion, and controls for the whole app | `design-system` |54| Fix spacing and alignment, or check the layout on the grid | `layout-grid` |55| An app icon | `app-icon` |5657## Ship5859| The user wants to | Skill |60| --- | --- |61| Build it and look at every page | `build-and-verify` |62| Tests, a self-test, or an agent that drives the running app | `test-mac-app` |63| Work through the backlog on its own | `improve-loop` |6465## Done when6667You named the step, called its skill, and told the user which skill comes68after it.