macos-settings-ui — скилл для Claude Code: окно настроек macOS
Собирает окно настроек для нативного macOS-приложения на SwiftUI: сайдбар, панели с Form и стеклянная отделка окна в духе macOS 26.
npx skills add fayazara/macos-app-skills --skill macos-settings-ui -a claude-code
npx skills add fayazara/macos-app-skills --skill settings-ui -a claude-codeЧто делает 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 сбросит конфигурацию окна и эффект не появится. В контроллере есть вызовы политики активации — для обычного приложения их надо вырезать.
Какие задачи решает
- собрать окно настроек с сайдбаром и панелями деталей
- получить стеклянную отделку окна на macOS 26
- починить прозрачный фон формы, который перекрывает эффект стекла
- заменить сцену
Windowна контроллер окна - добавить навигацию назад-вперёд в тулбар настроек
Примеры запросов агенту
- добавь окно настроек в моё macOS-приложение на SwiftUI
- сделай панель настроек с grouped Form и прозрачным фоном
- мой экран настроек выглядит неправильно, переделай его по гайдлайнам macOS 26
Как установить macos-settings-ui
1Через Skills CLI (Vercel)
npx skills add fayazara/macos-app-skills --skill macos-settings-ui -a claude-codenpx skills add fayazara/macos-app-skills --skill settings-ui -a claude-code2Вручную: положить файлы
~/.claude/skills/settings-ui/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/settings-ui/
1Через Skills CLI (Vercel)
npx skills add fayazara/macos-app-skills --skill settings-ui -a codex2Вручную: положить файлы
.agents/skills/settings-ui/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fayazara/macos-app-skills --skill settings-ui -a cursor2Вручную: положить файлы
.cursor/skills/settings-ui/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fayazara/macos-app-skills settings-ui2Вручную: положить файлы
.github/skills/settings-ui/SKILL.md1Через Skills CLI (Vercel)
npx skills add fayazara/macos-app-skills --skill settings-ui -a gemini-cli2Командой платформы
gemini skills install https://github.com/fayazara/macos-app-skills --path settings-uiВручную: положить файлы
.devin/skills/settings-ui/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add fayazara/macos-app-skills --skill settings-ui -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о macos-settings-ui
Как установить macos-settings-ui в Claude?
Выполните npx skills add fayazara/macos-app-skills --skill macos-settings-ui -a claude-code. Файл скилла окажется в ~/.claude/skills/settings-ui/SKILL.md.
Что делает macos-settings-ui?
Даёт агенту шаблон окна настроек для нативного macOS-приложения: контроллер окна, корневое представление с сайдбаром и примеры панелей с типовыми контролами.
Почему нельзя оставить SwiftUI-сцену Window?
Сцена не открывает стилевую маску NSWindow, а флаг .fullSizeContentView нужен в момент создания окна. Поэтому скилл заменяет сцену на NSWindowController.
