Skip to main content
skill CX Codex

bama — Claude Code skill: what it does, how to install

The bama skill for Claude Code picks the next step in building a native macOS app. It routes work from an initial idea through research, implementation, and verification.

MIT 1,000 installs ★ 1,933 updated 2026-11-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add daveebbelaar/bama --skill bama -a claude-code
Open on GitHub

What bama does

bama checks the project's current stage and calls the skill for the next step. An early idea goes to research and an app brief; a new project goes to app creation, while a release-stage project goes to build and verification. It calls one skill at a time.

Choose the app name and create <parent>/<AppName>/docs/ before research so skills put their materials in one folder. From there, the workflow can move into Swift and SwiftUI, macOS design, testing, or system integrations. For a rebuild of an existing app, bama routes to clone.

What it helps with

  • choose the next stage of a macOS app project
  • find a skill for a new app or an existing brief
  • route a rebuild of an existing app
  • move from building an app to testing it

Example prompts for the agent

  • Use the bama skill to map out the first steps for a macOS app.
  • I have an app brief. Use bama to pick the next skill.
  • I want to rebuild an existing app. Use bama to choose the right skill.

How to install bama

1Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill bama -a claude-code

2Manually: put the files in place

~/.claude/skills/bama/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bama/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about bama

How do I install bama in Claude Code?

Run npx skills add daveebbelaar/bama --skill bama -a claude-code. The skill file is at ~/.claude/skills/bama/SKILL.md.

What does bama do?

It identifies the project's current stage and calls the skill for the next step in building a macOS app. Each call selects one skill.

Where does bama put project materials?

Set the app name and create <parent>/<AppName>/docs/ before research. Skills use that folder for their materials.

Source text

SKILL.md · MIT
---
name: bama
description: Build any Mac app. Start here to pick the next skill for a native macOS app.
disable-model-invocation: true
---

# 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.

```text
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.

© daveebbelaar · MIT · daveebbelaar/bama

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set21

The whole set →
design-kit design-kit — a skill for Claude Code and Cursor builds a custom macOS SwiftUI design system with tokens and components. Runs when you need a brand look or custom controls. CX Codex +1 1,000installs design-system The design-system Claude Code skill organizes a macOS app’s accent color and design tokens. It activates for requests about themes, shared screen styles, or a style guide. CX Codex +1 1,000installs new-mac-app new-mac-app is a Claude Code skill that scaffolds a native SwiftUI macOS app from a working template. It starts when a new Mac app or project skeleton is requested. CX Codex +1 1,000installs test-mac-app The test-mac-app Claude Code skill lays out a testing flow for macOS apps, from Swift tests to controlling a running app. It activates when adding logic, fixing bugs, or checking a release. CX Codex +1 1,000installs ux-design The ux-design skill for Claude Code runs a UX pass for a macOS app feature before coding, covering terminology, flows, surface selection, and accessibility. Runs before coding a story that adds a screen, an action, or text. CX Codex +1 1,000installs clone This Claude Code skill explores an existing app and documents its screens for a rebuild. It starts when asked to clone, replace, or recreate an app’s design. CX Codex +1 1,000installs mac-design The mac-design Claude Code skill guides SwiftUI design for native Mac apps on macOS 26 and later. It activates while building or reviewing windows, sidebars, menus, and settings screens. CX Codex +1 1,000installs app-icon Builds macOS app icons in Icon Composer format using actool and ictool. CX Codex +1 1,000installs

Project sponsors

Companies that keep this analytics open