К основному содержанию
скилл CX Codex

new-mac-app — скилл для Claude Code: что делает и установка

Скилл new-mac-app для Claude Code создаёт нативное macOS-приложение на SwiftUI из готового шаблона. Он запускается, когда нужен новый проект или каркас приложения.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add daveebbelaar/bama --skill new-mac-app -a claude-code
Открыть на GitHub

Что делает new-mac-app

Скилл new-mac-app создаёт нативное macOS-приложение на SwiftUI без графического интерфейса Xcode. Он копирует Swift package с одним executable target, подставляет имя и bundle id, запускает git init и делает первый коммит. В шаблоне есть SwiftData, build.sh, генератор иконки, настройки, навигация, тесты и режим снимков интерфейса.

Сценарий включает сборку .app, подпись и открытие приложения из ~/Applications, затем swift test, самопроверку и снимки в светлой и тёмной темах. Для работы нужны Swift 6.2 или новее и macOS 26. На macOS 15 требуется указать .macOS(.v15) в Package.swift, выставить минимум 15 в Info.plist.in и не использовать Liquid Glass API.

Шаблон подходит для приложений на Swift package. Если нужны App Intents, расширения, виджеты или asset catalog, проект переключается на XcodeGen и сборку через xcodebuild. Подпись берётся из первого сертификата «Apple Development», а без него используется ad hoc.

Какие задачи решает

  • создать каркас нативного macOS-приложения на SwiftUI
  • собрать Swift package в .app и открыть его
  • сгенерировать и проверить иконку приложения
  • запустить тесты, самопроверку и снимки интерфейса

Примеры запросов агенту

  • Создай приложение Tasks с bundle id com.yourname.tasks в папке ~/Developer.
  • Собери новый macOS-проект на SwiftUI из шаблона и открой его после сборки.
  • Подготовь каркас приложения с SwiftData, настройками и снимками светлой и тёмной темы.

Как установить new-mac-app

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill new-mac-app -a claude-code

2Вручную: положить файлы

~/.claude/skills/new-mac-app/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/new-mac-app/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о new-mac-app

Как установить new-mac-app в Claude Code?

Выполни npx skills add daveebbelaar/bama --skill new-mac-app -a claude-code, затем проверь файл ~/.claude/skills/new-mac-app/SKILL.md.

Что делает new-mac-app?

Скилл создаёт macOS-приложение на SwiftUI из рабочего Swift package, добавляет сборку .app, иконку, SwiftData, git и проверки интерфейса.

Что нужно для работы new-mac-app?

Нужны Swift 6.2 или новее и macOS 26. Для подписи используется сертификат «Apple Development», а без него сборка подписывается ad hoc.

Исходный текст

SKILL.md · MIT
---
name: new-mac-app
description: 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.
argument-hint: "<AppName> <bundle-id> [parent-folder]"
allowed-tools: Bash(*/new-app.sh *) Bash(git *) Bash(swift *) Read Write Edit
---

# New Mac app

The template builds and runs as is. The first build proves the toolchain
works before you write feature code.

## What the template is

A Swift package with one executable target, plus a script that wraps the
binary in a real `.app` bundle. An agent can read and edit every file.

```text
<AppName>/
  Package.swift          macOS 26, Swift 6.2 tools, main-actor default isolation
  Info.plist.in          bundle id, name, icon, minimum macOS
  Icon/AppIcon.icon      the app icon: Icon Composer file, JSON plus SVG layers
  build.sh               swift build -> .app bundle -> codesign -> ~/Applications
  CLAUDE.md              build, check, and design rules for agents
  Sources/<AppName>/
    App.swift            window, menus, Settings, database location
    Models.swift         SwiftData models, sidebar pages, AppModel
    ContentView.swift    NavigationSplitView: sidebar, list, detail
    Snapshot.swift       APP_SNAPSHOT mode: PNG and layout file per page and Settings tab, light and dark
    UI/Theme.swift       accent colors, saved choice, accent tokens
    SettingsView.swift   Settings window: one tab per topic, sized to content
    UI/AppearanceSettings.swift  Settings: accent picker (mode follows the Mac)
    UI/WindowBehavior.swift  no focus ring on open, fit to content
    UI/Grid.swift        the 4 pt spacing scale, layout probes, grid overlay
  tools/
    grid-lint.sh         flags spacing numbers off the 4 pt grid
    check-layout.swift   checks the layout files from snapshot mode
    make_icon.sh         Icon/AppIcon.icon -> Resources/Assets.car + AppIcon.icns (actool)
    icon_review.sh       renders every icon look into one PNG (ictool)
    icon_sheet.swift     joins the renders for icon_review.sh
```

## Steps

1. Check the toolchain:

   ```bash
   swift --version            # Swift 6.2 or later
   sw_vers -productVersion    # 26.0 or later
   ```

   On macOS 15, set `.macOS(.v15)` in `Package.swift` and
   `LSMinimumSystemVersion` to 15 in `Info.plist.in`, and skip Liquid Glass APIs.

2. Pick the name (one UpperCamelCase word) and bundle id (reverse DNS). If
   `docs/BRIEF.md` exists, use its name.

3. Run the script with the parent folder. It copies the template, fills in
   the name and bundle id, runs `git init`, and commits. It keeps a folder
   that holds only a brief.

   ```bash
   "${CLAUDE_SKILL_DIR}/scripts/new-app.sh" Tasks com.yourname.tasks ~/Developer
   ```

   In a Dropbox or iCloud Drive folder the script can take minutes: run it
   in the background.

4. Build the app and its icon, then open it:

   ```bash
   cd ~/Developer/Tasks && ./build.sh --open
   ```

5. Run the checks the template ships with, then look at the snapshots
   (`build-and-verify` skill):

   ```bash
   swift test --scratch-path ~/Library/Developer/Tasks/test-build   # Kit unit tests
   tools/selftest.sh                                                # PASS per check, exit 0
   tools/snap.sh                                                    # sample data, light and dark PNGs
   ```

6. If `docs/BRIEF.md` exists, rename `Item` to the brief's main type and the
   sidebar pages to the brief's pages. Nothing else: features go through
   `improve-loop`, one story at a time. Build, snapshot, commit.

## When to switch to an Xcode project

The Swift package covers most personal apps. Switch to an XcodeGen project
(`project.yml` -> generated `.xcodeproj`, built with `xcodebuild`) when the
app needs App Intents for Shortcuts and Spotlight, an asset catalog, app
extensions, or widgets. Keep `project.yml` in git and the `.xcodeproj` out
of it. Put build output outside Dropbox with `-derivedDataPath`.

## Signing

`build.sh` signs with the first "Apple Development" certificate in the
keychain, or ad hoc without one. Permissions (Accessibility, Screen
Recording, camera) are stored per signature and path. Ad hoc builds ask
again after every rebuild. A free Apple ID makes a certificate in Xcode >
Settings > Accounts > Manage Certificates. Install to the same path every
time.

## A CLI for agents

To let Claude Code, Codex, or scripts read and change the app's data, call
the Skill tool with `agent-cli`. The app binary becomes its own CLI and
sends each command to the running app, so the database keeps one writer
and the window updates live.

## When the build fails

- `cannot find 'X' in scope` after adding a file: SwiftPM cached the file
  list. Run `swift package clean --scratch-path ~/Library/Developer/<AppName>/build`.
- `binary is older than ...`: a file did not compile. Read the first errors.
- Concurrency errors: call the Skill tool with `swift-swiftui`.

Done when the app opens from `~/Applications`, the snapshots show every
page in light and dark, and the first commit exists.

© daveebbelaar · MIT · daveebbelaar/bama

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
swiftui-whats-new-27 superagents-lab Скилл swiftui-whats-new-27 для Claude Code описывает изменения SwiftUI в SDK 27. Помогает адаптировать проект к новым API и исправить сборку после перехода @State на макросы. CX Codex +1 822установок macos-menubar-tuist-app Dimillian Скилл macos-menubar-tuist-app для Claude Code и других платформ: собирает и правит macOS menubar-приложения на Tuist и SwiftUI. Держит сеть, состояние и UI по разным слоям. CX Codex +1 736установок test-macos-app официальный OpenAI Команда test-macos-app для Codex выбирает узкий сценарий тестирования macOS и распределяет сбои по категориям. Проверяет Xcode- и Swift-проекты. CX Codex GP ChatGPT +1 ★ 8 052звёзд репо mac-maintenance steipete Скилл mac-maintenance запускает рутинную очистку macOS: обновляет Homebrew, подтягивает чистые git-репозитории и очищает корзину Finder. CX Codex +1 117установок build-macos-apps Lex Christopherson Скилл build-macos-apps для Claude Code помогает создавать и развивать нативные macOS-приложения на SwiftUI и AppKit. Он подключается к задачам сборки, отладки, тестирования, оптимизации и выпуска. CX Codex +1 ★ 1 988звёзд репо clerk-swift clerk Скилл clerk-swift для Claude Code настраивает UI аутентификации Clerk в нативных приложениях Swift на iOS и macOS. Помогает внедрить готовые экраны ClerkKitUI или собрать собственный флоу через ClerkKit. CX Codex +1 15 200установок

Из того же набора21

Весь набор →
user-stories Скилл user-stories для Claude Code, который превращает описание приложения в бэклог пользовательских историй с проверяемыми критериями. CX Codex +1 1 000установок swift-swiftui Скилл swift-swiftui для Claude Code задаёт правила Swift 6 и SwiftUI для приложений macOS. Подключается при написании, проверке и отладке Swift-кода, в том числе при ошибках конкуренции и Sendable. CX Codex +1 1 000установок design-kit Скилл design-kit для Claude Code и Cursor собирает дизайн-систему для macOS SwiftUI на токенах и компонентах. Включается, когда нужна своя тема интерфейса, фирменный стиль или библиотека элементов. CX Codex +1 1 000установок design-system Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов. CX Codex +1 1 000установок test-mac-app Скилл test-mac-app для Claude Code помогает проверять macOS-приложение на нескольких уровнях — от Swift-тестов до управления запущенной программой. Активируется при добавлении логики, исправлении ошибок и проверке перед релизом. CX Codex +1 1 000установок ux-design Скилл ux-design для Claude Code проводит UX-проверку фичи macOS-приложения перед написанием кода, охватывая термины, сценарии, выбор поверхности и доступность. Запускается перед кодингом задачи со скрином, действием или текстом. CX Codex +1 1 000установок bama Скилл bama для Claude Code помогает выбрать следующий этап разработки нативного приложения для macOS. По запросу он направляет работу от идеи и исследования до сборки и проверки приложения. CX Codex +1 1 000установок clone Скилл clone для Claude Code исследует существующее приложение и описывает его экраны для пересборки интерфейса. Запускается по просьбе клонировать, заменить или повторить дизайн приложения. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой