bama

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

New — Created in the last 30 days
Active — Updated in the last 14 days

Works with

Claude
Codex

View on GitHub

944 GitHub stars (944)

+944 in 8 days

Stars gained per day · daily snapshots since Oct 27

Stars gained between daily snapshots
Period	New stars
Oct 28	+260
Oct 29	+278
Oct 30	+276
Oct 31	+76

21 skills (21 skills found in its SKILL.md files)
136 forks (136 forks)
2d ago last update (Last updated 2d ago)

Install

Skills CLI

npx skills add daveebbelaar/bama

Asks which skills and agents to install. Just one: npx skills add daveebbelaar/bama --skill agent-cli — add -g for every project.

Claude Code

git clone https://github.com/daveebbelaar/bamacp -r "bama/skills/code/agent-cli" ~/.claude/skills/

Copies the agent-cli skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.

Plugin

/plugin marketplace add daveebbelaar/bama

Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.

Skills can run code on your machine — read the SKILL.md first.

What it does

Filter skills

In the author's own words, from each skill's SKILL.md.

agent-cli

Optional 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".
skills/code/agent-cli/SKILL.md on GitHub (opens in a new tab)
improve-architecture

Architecture 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.
skills/code/improve-architecture/SKILL.md on GitHub (opens in a new tab)
os-integrations

Deep 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.
skills/code/os-integrations/SKILL.md on GitHub (opens in a new tab)
performance

Make 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.
skills/code/performance/SKILL.md on GitHub (opens in a new tab)
swift-swiftui

Swift 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.
skills/code/swift-swiftui/SKILL.md on GitHub (opens in a new tab)
app-icon

Liquid 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.
skills/design/app-icon/SKILL.md on GitHub (opens in a new tab)
design-from-app

Rebuild 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".
skills/design/design-from-app/SKILL.md on GitHub (opens in a new tab)
design-kit

Custom 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 desig…
skills/design/design-kit/SKILL.md on GitHub (opens in a new tab)
design-system

Accent 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 t…
skills/design/design-system/SKILL.md on GitHub (opens in a new tab)
layout-grid

Grid 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 space…
skills/design/layout-grid/SKILL.md on GitHub (opens in a new tab)
mac-design

Design 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.
skills/design/mac-design/SKILL.md on GitHub (opens in a new tab)
ux-design

UX 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.
skills/design/ux-design/SKILL.md on GitHub (opens in a new tab)
clone

Walk 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".
skills/plan/clone/SKILL.md on GitHub (opens in a new tab)
research

Online 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.
skills/plan/research/SKILL.md on GitHub (opens in a new tab)
user-stories

Prioritized 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".
skills/plan/user-stories/SKILL.md on GitHub (opens in a new tab)
build-and-verify

Build 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.
skills/ship/build-and-verify/SKILL.md on GitHub (opens in a new tab)
improve-loop

Autonomous 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.
skills/ship/improve-loop/SKILL.md on GitHub (opens in a new tab)
test-mac-app

Test 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".
skills/ship/test-mac-app/SKILL.md on GitHub (opens in a new tab)
app-brief

One-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.
skills/start/app-brief/SKILL.md on GitHub (opens in a new tab)
bama

Build any Mac app. Start here to pick the next skill for a native macOS app.
skills/start/bama/SKILL.md on GitHub (opens in a new tab)
new-mac-app

Create a native macOS SwiftUI app from a working template (Swift package, SwiftData, build script, icon script, snapshot mode, git), with no Xcode GUI. Use when the user wants to start a new Mac app or scaffold a macOS project.
skills/start/new-mac-app/SKILL.md on GitHub (opens in a new tab)

Review before you install

A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.

Encoders & Decoders

Hash Generators

Code Formatters

HTML Tools

JavaScript Tools

Network Tools

Database Tools

Development Tools

Miscellaneous Tools

bama