# swift

Скилл для Claude Code и других платформ: дизайн типов, конкурентность и интеграция с Apple-платформами. Включается при правках .swift-файлов, async/await, DispatchQueue или Nitro Modules.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1300 установок · ★ 181 у репозитория
- Автор: margelo
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/margelo/react-native-skills/tree/HEAD/skills/swift/SKILL.md
- Обновлён: 2026-08-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/margelo-swift

## Что делает

Скилл задаёт порядок работы со Swift-кодом: сначала чтение локальных файлов и сгенерированных протоколов, потом выбор публичной модели типов, затем выбор одной модели конкурентности. Синхронные свойства и методы должны оставаться дешёвыми и неблокирующими, а переходы между очередями, ввод-вывод и сбои — явными в API.

Главный акцент — типобезопасное проектирование. Состояния предлагается выражать типами, а не набором опционалов: `enum` с ассоциированными значениями для закрытых множеств или протоколы с конформными структурами, когда варианты делят общий контракт. Связанные поля держат на одном варианте, чтобы компилятор не позволял собрать бессмысленную комбинацию.

По конкурентности правило простое: либо Swift concurrency, либо `DispatchQueue`, но не оба вперемешку. Запрещены синхронные переходы через `DispatchQueue.sync`, особенно в геттерах и сеттерах. Локальную быструю работу не оборачивают в `Task` без нужды. Для Nitro Modules скилл советуют использовать вместе с `build-nitro-modules`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add margelo/react-native-skills --skill swift -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add margelo/react-native-skills --skill swift -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add margelo/react-native-skills --skill swift -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install margelo/react-native-skills skills/swift
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add margelo/react-native-skills --skill swift -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/margelo/react-native-skills --path skills/swift
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add margelo/react-native-skills --skill swift -a opencode
```

### Claude.ai

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

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

## Когда брать
- спроектировать типобезопасный Swift API без опциональных полей-костылей
- выбрать между Swift concurrency и DispatchQueue до написания кода
- не дать геттеру выполнять дорогую или падающую операцию
- убрать лишние переходы между main, background и JS-очередями
- проверить Swift-код Nitro Module на границы потоков

## Примеры запросов агенту
- Спроектируй модель типов для сканера: текст, штрихкод и лицо должны быть разными вариантами
- Проверь этот Swift-класс на лишние переходы между очередями
- Перепиши геттер, который сейчас дергает аппаратный скан, на асинхронный метод

## Похожие
- [swift-concurrency](https://affpapa.org/nevibecode/skills/prisma-labs-dev-swift-concurrency.md) — скилл · 752 установки
- [guide-swift-concurrency](https://affpapa.org/nevibecode/skills/guide-swift-concurrency.md) — скилл · 539 установок
- [swift-concurrency-pro](https://affpapa.org/nevibecode/skills/swift-concurrency-pro.md) — скилл · 13100 установок
- [migrating-to-swift-concurrency](https://affpapa.org/nevibecode/skills/migrating-to-swift-concurrency.md) — скилл · ★ 58 у репозитория
- [swift-expert](https://affpapa.org/nevibecode/skills/swift-expert.md) — скилл · 4500 установок
- [swift-concurrency-expert](https://affpapa.org/nevibecode/skills/swift-concurrency-expert.md) — скилл · 2100 установок

## Другие версии с тем же именем
- [swift · mindrally](https://affpapa.org/nevibecode/skills/mindrally-swift.md) — 748 установок
- [swift · wendylabsinc](https://affpapa.org/nevibecode/skills/swift.md) — ★ 64 у репозитория

Из того же набора: [margelo/react-native-skills](https://affpapa.org/nevibecode/by/margelo/react-native-skills.md) — 9 карточек

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