# macos-settings-ui

Собирает окно настроек для нативного macOS-приложения на SwiftUI: сайдбар, панели с Form и стеклянная отделка окна в духе macOS 26.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 650 установок · ★ 681
- Автор: fayazara
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/fayazara/macos-app-skills/tree/HEAD/settings-ui/SKILL.md
- Обновлён: 2026-05-27
- HTML: https://affpapa.org/nevibecode/skills/macos-settings-ui

## Что делает

Скилл описывает трёхслойную схему окна настроек. Контроллер `SettingsWindowController.swift` создаёт `NSWindow` программно с флагом `.fullSizeContentView` — только так macOS 26 отрисует скруглённые углы и полупрозрачный сайдбар. Корневое представление — `NavigationSplitView` со списком вкладок и историей переходов назад-вперёд в тулбаре. Каждая панель — отдельный файл с `Form { Section { ... } }`.

Внутри лежат готовые файлы-образцы: контроллер окна, корневое представление и пример панели с `Toggle`, `Picker`, `Slider` и `LabeledContent`. Есть пошаговый порядок: завести enum вкладок с заголовком и SF Symbol, скопировать контроллер, подогнать размеры, собрать панели, открывать окно вызовом `SettingsWindowController.show(tab:)`.

Важное ограничение: декларативная сцена `Window` в SwiftUI не даёт доступа к стилевой маске окна, поэтому старую сцену `Window("Settings", id: "SETTINGS")` и `openWindow(id:)` придётся убрать совсем. Если попытаться выставить `.fullSizeContentView` позже через `NSViewRepresentable`, SwiftUI сбросит конфигурацию окна и эффект не появится. В контроллере есть вызовы политики активации — для обычного приложения их надо вырезать.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fayazara/macos-app-skills --skill macos-settings-ui -a claude-code
```
```bash
npx skills add fayazara/macos-app-skills --skill settings-ui -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/settings-ui/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/settings-ui/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fayazara/macos-app-skills --skill settings-ui -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/settings-ui/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fayazara/macos-app-skills --skill settings-ui -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/settings-ui/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fayazara/macos-app-skills settings-ui
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/settings-ui/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add fayazara/macos-app-skills --skill settings-ui -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/fayazara/macos-app-skills --path settings-ui
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/settings-ui/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add fayazara/macos-app-skills --skill settings-ui -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fayazara/macos-app-skills/tree/HEAD/settings-ui/SKILL.md

## Когда брать
- собрать окно настроек с сайдбаром и панелями деталей
- получить стеклянную отделку окна на macOS 26
- починить прозрачный фон формы, который перекрывает эффект стекла
- заменить сцену `Window` на контроллер окна
- добавить навигацию назад-вперёд в тулбар настроек

## Примеры запросов агенту
- добавь окно настроек в моё macOS-приложение на SwiftUI
- сделай панель настроек с grouped Form и прозрачным фоном
- мой экран настроек выглядит неправильно, переделай его по гайдлайнам macOS 26

## Похожие
- [liquid-glass](https://affpapa.org/nevibecode/skills/liquid-glass.md) — скилл · 78 установок
- [macos-development](https://affpapa.org/nevibecode/skills/macos-development.md) — скилл · 1600 установок
- [axiom-macos](https://affpapa.org/nevibecode/skills/axiom-macos.md) — скилл · 1300 установок
- [macos-menubar-tuist-app](https://affpapa.org/nevibecode/skills/macos-menubar-tuist-app.md) — скилл · 681 установка
- [build-macos-apps](https://affpapa.org/nevibecode/plugins/build-macos-apps.md) — плагин · ★ 7596
- [macos-design-guidelines](https://affpapa.org/nevibecode/skills/macos-design-guidelines.md) — скилл · 4300 установок

Из того же набора: [fayazara/macos-app-skills](https://affpapa.org/nevibecode/by/fayazara/macos-app-skills.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md