daveebbelaar/bama

BAMA: Build Any Mac App. Agent skills to research, clone, design, build, optimize, and test native macOS apps with Swift and SwiftUI.

20 skills listed · MIT · 1.2k stars · last pushed 1 Nov 2026

daveebbelaar/bama on GitHub

Across these 20 skills

Pattern check

Nothing flagged in 19

Items to review in 1: app-icon

What it can touch

1 installs more skills
1 changes agent settings
14 run shell commands
+4 more
- 4 bundle scripts
- 2 reach the network
- 2 pre-approve tools
- 1 names web addresses

Checked at commit 639893c on 1 Nov 2026. 1 skill isn't listed while QAI reviews a check result.

Skills

All20 Items to review1

Skill	What it can touch	Pattern check	Licence	Updated
agent-cliOptional command line and MCP server for a macOS app, so Claude Code, Codex, and scripts can drive it (list, add, change, search, act) through the running app. Use when the user wants agents to work with their app or its data, asks for a CLI, an MCP server, or automation for the app, or says "Claude should be able to use my app". Installs more skills +4 more Pattern check: Nothing flaggedMITUpdated 29 Oct 2026	Installs more skills Changes agent settings +3 more	Pattern check: Nothing flagged	MIT	29 Oct 2026
app-briefOne-page brief (docs/BRIEF.md) for a new macOS app, written before any code. Use when the user has an app idea, wants to replace an app they pay for, or the research and clone skills are done. Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026
app-iconLiquid Glass macOS app icon made as an Icon Composer file (Icon/AppIcon.icon, JSON plus SVG layers), compiled with actool, and reviewed in every look with ictool. Use when the user wants an app icon, a better icon, or a Dock icon. Runs shell commands +1 more Pattern check: 1 item to reviewMITUpdated 26 Oct 2026	Runs shell commands Pre-approves tools	Pattern check: 1 item to review	MIT	26 Oct 2026
bamaBuild any Mac app. Start here to pick the next skill for a native macOS app. Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026
build-and-verifyBuild a SwiftUI macOS app from the command line, install it, and check light and dark window snapshots of every page before calling a change done. Use after any UI code change, when a build fails, or when the user asks to run, screenshot, or check the app. Runs shell commands +1 more Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands Pre-approves tools	Pattern check: Nothing flagged	MIT	26 Oct 2026
cloneWalk through any existing app (native Mac app with computer use, web app with a browser), screenshot every screen, menu, and dialog, write a screen index, and turn it into user stories. Use when the user wants to clone, rebuild, replace, or copy the design of an app, or says "screenshot every screen". Runs shell commands +1 more Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands Bundles scripts	Pattern check: Nothing flagged	MIT	26 Oct 2026
design-from-appRebuild the look of an app the user likes as a native SwiftUI design kit, by measuring its screenshots (sizes, spacing, type, colors, icons), building its parts, and comparing pixel by pixel until they match. Use when the user names an app whose look they want, shares screenshots of one, or says "make it look like X". Runs shell commands +1 more Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands Bundles scripts	Pattern check: Nothing flagged	MIT	26 Oct 2026
design-kitCustom design system for a macOS SwiftUI app with its own parts, not Apple's, covering three token layers, type, an icon set, every part in every state, custom window chrome, a parts gallery, and checks. Use when the user wants the app to have its own look and feel, a brand, or custom buttons, rows, and sidebars, when design-from-app has measured a reference app, or when the user asks for a design system or component library. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
design-systemAccent color and design system for a macOS app, from the app's accent and the accent picker in Settings to Swift tokens in code plus a design/DESIGN-SYSTEM.md that says which token to use when. Use when the user wants a brand or accent color, wants people to pick a color, when an app has more than a few screens, when screens drift apart or animations feel inconsistent, or when the user asks for themes, a style guide, or design tokens. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
improve-architectureArchitecture check-in for a growing macOS Swift codebase. Finds hot spots, proposes deeper modules, and refactors one step per commit with behavior proven unchanged. Use at the end of a milestone, before a big feature, when a file passes 600 lines, when one feature touches many files, when bugs repeat in one area, or when the user asks to refactor or clean up the code. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
improve-loopAutonomous loop that works through docs/STORIES.md one story at a time for a macOS app, building, snapshotting, comparing against reference screenshots, fixing, and committing, until a milestone is done. Use when the user says "keep going", "work through the backlog", "make it match the reference", or wants an unattended improvement loop. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
layout-gridGrid and alignment rules for a macOS SwiftUI app, with three checks that catch misalignment (a lint for off-grid numbers, a layout probe that measures real frames in snapshot mode, and a grid overlay). Use when building or reviewing a custom page, card, row, form, or sheet, after every build that touched layout, or when the user says something looks misaligned, crooked, cramped, or unevenly spaced. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
mac-designDesign rules that make a SwiftUI app look and feel like a native Mac app on macOS 26 and later, from Apple's eight design principles to Liquid Glass, layout, toolbars, menus, search, keyboard, type, color, and dark mode. Use when building or reviewing any window, sidebar, toolbar, menu, panel, or settings screen, or when the user asks for a more native, Apple-like, or better designed app. Runs shell commands +3 more Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands Reaches the network +2 more	Pattern check: Nothing flagged	MIT	26 Oct 2026
os-integrationsDeep macOS integrations for a native app, such as global hotkeys, menu bar items, floating panels, window control with Accessibility, screen capture and recording, clipboard, Shortcuts and Spotlight, URL schemes, login items, a CLI, and the permissions each one needs. Use when an app must reach outside its own window or control other apps. Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026
performanceMake a macOS app fast by measuring hangs, stutter, CPU, memory, and energy, then moving work off the main thread and onto the GPU. Use when the app freezes, a shortcut feels slow, dragging stutters, the fan spins, memory grows, or the user asks to optimize or profile. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
researchOnline research for a macOS app before building it, run as parallel researcher subagents, saved to docs/research/. Use when the user asks what to build, which features matter, how the best apps in a category work, how a macOS API or integration works, or wants a feature comparison. Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026
swift-swiftuiSwift 6 and SwiftUI code rules for macOS apps, including concurrency, state, SwiftData, AppKit bridges, and fixes for common compiler errors. Use when writing, reviewing, or debugging Swift code in a Mac app, or on concurrency, Sendable, or "not in scope" errors. Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
test-mac-appTest a macOS app at three levels, from Swift Testing unit tests and an in-app self-test to a debug bridge that lets an agent drive the running app and read its state, plus computer use for real clicks. Use when adding logic, fixing a bug, before a release, or when the user asks for tests, end-to-end checks, or "make sure it works". Runs shell commands Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Runs shell commands	Pattern check: Nothing flagged	MIT	26 Oct 2026
user-storiesPrioritized backlog of user stories with checkable acceptance criteria (docs/STORIES.md) for a macOS app, built from a brief, research, or screen index. Use after app-brief or clone, or when the user asks for user stories, a backlog, a feature list, or "what do we build first". Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026
ux-designUX pass for one feature of a macOS app, covering names, flow, where it opens (inline, popover, sheet, window, alert), states, words, hover help, accessibility, and AI features. Use before coding a story that adds a screen, an action, or text, when user-stories or improve-loop call it, or when the user asks for a UX review, clearer wording, better names, or whether something should be a modal. Instructions only Pattern check: Nothing flaggedMITUpdated 26 Oct 2026	Instructions only	Pattern check: Nothing flagged	MIT	26 Oct 2026