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

integration-swift — скилл для Claude Code: что делает и как установить

Скилл integration-swift помогает настроить аналитику PostHog в приложениях на Swift под iOS и macOS по готовой четырёхшаговой схеме.

MIT 108 установок ★ 80 обновлён 2026-10-24

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

Что делает integration-swift

Скилл инструктирует ассистента, как встроить SDK PostHog в Swift-проекты под iOS и macOS без изменения существующей кодовой базы. Процесс разбит на четыре стадии: старт интеграции, правки, проверка и финализация. Инструкции требуют брать токен и хост строго из переменных окружения POSTHOG_PROJECT_TOKEN и POSTHOG_HOST через перечисление PostHogEnv.

При правке файла project.pbxproj для добавления пакета Swift Package Manager агент формирует три объекта с собственными UUID: PBXBuildFile, XCSwiftPackageProductDependency и XCRemoteSwiftPackageReference. Версию posthog-ios берёт из свежих релизов, а не прописывает старую вручную. Если в проекте macOS включён App Sandbox, скилл требует включить параметр ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES, сохраняя сам sandbox активным.

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

  • подключить PostHog SDK в проект на Swift через SPM
  • настроить идентификацию пользователей при авторизации и регистрации
  • добавить сквозные заголовки X-POSTHOG-DISTINCT-ID и X-POSTHOG-SESSION-ID в API-запросы
  • отслеживать ошибки в критических пользовательских сценариях

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

  • Интегрируй аналитику PostHog в моё приложение для iOS
  • Добавь идентификацию пользователей через PostHog при входе в систему
  • Настрой отправку ошибок в PostHog на границах сетевых вызовов

Как установить integration-swift

1Через Skills CLI (Vercel)

npx skills add PostHog/skills --skill integration-swift -a claude-code

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

~/.claude/skills/integration-swift/SKILL.md

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

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

Вопросы об integration-swift

Как установить integration-swift в Claude Code?

Выполните команду npx skills add PostHog/skills --skill integration-swift -a claude-code.

Что делает скилл integration-swift?

Он даёт пошаговые инструкции по встраиванию PostHog в Swift-приложения под iOS и macOS с сохранением App Sandbox и конфигурацией через переменные схемы Xcode.

Как передаются ключи PostHog в проекте?

Ключи не зашиваются в исходный код. Скилл создаёт PostHogEnv и читает POSTHOG_PROJECT_TOKEN и POSTHOG_HOST из настроек схемы запуска Xcode.

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

SKILL.md · MIT
---
name: integration-swift
description: PostHog integration for Swift iOS and macOS applications
metadata:
  author: PostHog
  version: 1.9.4
---

# PostHog integration for Swift (iOS/macOS)

This skill helps you add PostHog analytics to Swift (iOS/macOS) applications.

## Workflow

Follow these steps in order to complete the integration:

1. `basic-integration-1.0-begin.md` - PostHog Setup - Begin ← **Start here**
2. `basic-integration-1.1-edit.md` - PostHog Setup - Edit
3. `basic-integration-1.2-revise.md` - PostHog Setup - Revise
4. `basic-integration-1.3-conclude.md` - PostHog Setup - Conclusion

## Reference files

- `references/EXAMPLE.md` - Swift (iOS/macOS) example project code
- `references/ios.md` - Ios - docs
- `references/identify-users.md` - Identify users - docs
- `references/basic-integration-1.0-begin.md` - PostHog setup - begin
- `references/basic-integration-1.1-edit.md` - PostHog setup - edit
- `references/basic-integration-1.2-revise.md` - PostHog setup - revise
- `references/basic-integration-1.3-conclude.md` - PostHog setup - conclusion

The example project shows the target implementation pattern. Consult the documentation for API details.

## Key principles

- **Environment variables**: Always use environment variables for PostHog keys. Never hardcode them.
- **Minimal changes**: Add PostHog code alongside existing integrations. Don't replace or restructure existing code.
- **Match the example**: Your implementation should follow the example project's patterns as closely as possible.

## Framework guidelines

- Read configuration from environment variables via a `PostHogEnv` enum with a `value` computed property that calls `ProcessInfo.processInfo.environment[rawValue]` and `fatalError`s if missing — cases should be `projectToken = "POSTHOG_PROJECT_TOKEN"` and `host = "POSTHOG_HOST"`, set in the Xcode scheme's Run environment variables
- When adding SPM dependencies to project.pbxproj, create three distinct objects with unique UUIDs — a `PBXBuildFile` (with `productRef`), an `XCSwiftPackageProductDependency` (with `package` and `productName`), and an `XCRemoteSwiftPackageReference` (with `repositoryURL` and `requirement`). The build file goes in the Frameworks phase `files`, the product dependency goes in the target's `packageProductDependencies`, and the package reference goes in the project's `packageReferences`.
- Check the latest release version of posthog-ios at `https://github.com/PostHog/posthog-ios/releases` before setting the `minimumVersion` in the SPM package reference — do not hardcode a stale version
- If the project uses App Sandbox (macOS), add `ENABLE_OUTGOING_NETWORK_CONNECTIONS = YES` to the target's build settings so PostHog can reach its servers — do NOT disable the sandbox entirely

## Identifying users

Identify users during login and signup events. Refer to the example code and documentation for the correct identify pattern for this framework. If both frontend and backend code exist, pass the client-side session and distinct ID using `X-POSTHOG-DISTINCT-ID` and `X-POSTHOG-SESSION-ID` headers to maintain correlation.

## Error tracking

Add PostHog error tracking to relevant files, particularly around critical user flows and API boundaries.

© PostHog · MIT · PostHog/skills

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

Все скиллы по теме «Мобильная разработка» →
swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок swift Mindrally Настраивает агента на разработку приложений под iOS, macOS, watchOS и tvOS на Swift и SwiftUI с архитектурой MVVM. CX Codex +1 748установок swift-development rshankras Скилл swift-development разбирает конкурентность, память и размер Swift-кода: подскажет, как перейти на строгую модель Swift 6 и убрать лишние аллокации. CX Codex +1 520установок swift-diagnostics John Rogers (@johnrogers) Скилл swift-diagnostics помогает разбирать сбои навигации, сборки и памяти в проектах iOS и macOS. Он ведёт по диагностическим шагам до проверки исправления. CX Codex +1 ★ 233звёзд репо swift-engineering John Rogers (@johnrogers) Плагин swift-engineering для Claude Code включает субагентов и скиллы для планирования, разработки на Swift и TCA, тестирования и ревью iOS- и macOS-приложений. ★ 233звёзд репо clerk-swift clerk Скилл clerk-swift для Claude Code настраивает UI аутентификации Clerk в нативных приложениях Swift на iOS и macOS. Помогает внедрить готовые экраны ClerkKitUI или собрать собственный флоу через ClerkKit. CX Codex +1 15 200установок

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

Весь набор →
feature-flags-api Скилл feature-flags-api помогает добавить feature flags от PostHog в API-приложение. Он пригодится, когда нужно встроить проверки флагов в существующий код. CX Codex +1 111установок integration-react-native Скилл integration-react-native помогает добавить аналитику PostHog в React Native-приложение, настроить идентификацию пользователей и отслеживание ошибок. CX Codex +1 109установок feature-flags-react-native Скилл feature-flags-react-native внедряет флаги функциональности PostHog в приложения на React Native без ручной настройки обвязки и лишних вызовов useEffect. CX Codex +1 109установок integration-astro-ssr Скилл integration-astro-ssr встраивает аналитику PostHog в SSR-проекты на Astro с API-роутами. Помогает связать клиентские и серверные события. CX Codex +1 109установок integration-react-vite Скилл integration-react-vite встраивает аналитику PostHog в React-приложение на Vite без роутера: четыре шага настройки, идентификация пользователей, фича-флаги и трекинг ошибок. CX Codex +1 107установок omnibus-instrument-llm-analytics Скилл omnibus-instrument-llm-analytics добавляет в код трейсинг вызовов LLM через PostHog: токены, задержки и стоимость каждой генерации. Заодно поставит SDK, если его ещё нет. CX Codex +1 106установок integration-nextjs-pages-router Скилл integration-nextjs-pages-router добавляет PostHog в приложения Next.js с Pages Router. Он ведёт агента по настройке аналитики, идентификации пользователей и отслеживанию ошибок. CX Codex +1 103установок integration-react-react-router-7-declarative Скилл integration-react-react-router-7-declarative для Claude Code пошагово подключает аналитику PostHog к приложениям на React Router v7 в декларативном режиме. CX Codex +1 102установок

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

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