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

kotlin-multiplatform · travisjneuman — скилл для Claude Code: обзор и установка

Набор инструкций по Kotlin Multiplatform и Compose Multiplatform для шаринга бизнес-логики и UI между Android, iOS, десктопом и вебом.

MIT 183 установок ★ 114 обновлён 2026-10-25

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

Что делает kotlin-multiplatform

Скилл задаёт структуру проекта с модулями shared и composeApp, объясняя организацию слоёв commonMain, androidMain и iosMain. Он направляет агента при настройке сетевых запросов через Ktor, локальной базы данных SQLDelight и общего UI на Compose Multiplatform.

Внутри описаны связки expect/actual для вызова системных API вроде контекста платформы или платформенных HTTP-клиентов: OkHttp под Android и Darwin под iOS. Дополнительно скилл регламентирует интеграцию общего модуля в Xcode через CocoaPods или SPM и настройку тестов в commonTest.

Скилл рекомендует использовать механизм expect/actual умеренно, отдавая предпочтение обычным интерфейсам с внедрением платформенных реализаций через Koin.

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

  • спроектировать структуру модулей KMP и Compose Multiplatform
  • настроить кроссплатформенный сетевой клиент на Ktor
  • написать схему базы данных и запросы SQLDelight в commonMain
  • связать платформенный код Android и iOS через expect и actual
  • настроить экспорт Kotlin-модуля во фреймворк для Swift через CocoaPods

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

  • Сделай сетевой клиент на Ktor в commonMain для получения списка пользователей
  • Напиши объявление expect/actual для платформенного контекста под Android и iOS
  • Создай таблицу и запросы SQLDelight для кэширования профилей

Как установить kotlin-multiplatform

1Через Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill kotlin-multiplatform -a claude-code

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

~/.claude/skills/kotlin-multiplatform/SKILL.md

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

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

Вопросы о kotlin-multiplatform

Как установить kotlin-multiplatform в Claude Code?

Выполните команду npx skills add travisjneuman/.claude --skill kotlin-multiplatform -a claude-code. Файл скилла запишется в ~/.claude/skills/kotlin-multiplatform/SKILL.md.

Что делает скилл kotlin-multiplatform?

Он подсказывает агенту правила проектирования кроссплатформенных приложений на Kotlin, шаблоны expect/actual, настройку Ktor, SQLDelight и Compose Multiplatform.

Какие библиотеки рекомендует использовать скилл?

В стек входят Ktor, kotlinx.serialization, kotlinx.coroutines, SQLDelight, Koin, Compose Multiplatform, kotlinx.datetime и Napier.

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

SKILL.md · MIT
---
name: kotlin-multiplatform
description: >-
  KMP/CMP shared business logic, Compose Multiplatform, expect/actual, Ktor, SQLDelight, and platform-specific implementations. Use when building cross-platform Kotlin applications for Android, iOS, desktop, or web.
---

# Kotlin Multiplatform Skill

Shared business logic and optional shared UI across Android, iOS, desktop, and web.

---

## Project Structure

```
project/
├── composeApp/                    # Shared Compose UI (if using CMP)
│   └── src/
│       ├── commonMain/            # Shared UI code
│       ├── androidMain/           # Android-specific UI
│       ├── iosMain/               # iOS-specific UI
│       └── desktopMain/          # Desktop-specific UI
├── shared/                        # Shared business logic (KMP)
│   └── src/
│       ├── commonMain/            # Shared code
│       │   └── kotlin/
│       │       ├── data/          # Repositories, data sources
│       │       ├── domain/        # Use cases, models
│       │       └── platform/      # expect declarations
│       ├── androidMain/           # actual implementations
│       ├── iosMain/               # actual implementations
│       └── commonTest/            # Shared tests
├── androidApp/                    # Android entry point
├── iosApp/                        # iOS entry point (Xcode project)
├── build.gradle.kts
└── settings.gradle.kts
```

---

## expect/actual Pattern

```kotlin
// commonMain - expect declaration
expect class PlatformContext

expect fun getPlatformName(): String

expect fun createHttpClient(): HttpClient

// androidMain - actual implementation
actual class PlatformContext(val context: android.content.Context)

actual fun getPlatformName(): String = "Android ${Build.VERSION.SDK_INT}"

actual fun createHttpClient(): HttpClient = HttpClient(OkHttp) {
    install(ContentNegotiation) { json() }
}

// iosMain - actual implementation
actual class PlatformContext

actual fun getPlatformName(): String = UIDevice.currentDevice.systemName()

actual fun createHttpClient(): HttpClient = HttpClient(Darwin) {
    install(ContentNegotiation) { json() }
}
```

---

## Key Libraries

| Library | Purpose | Multiplatform? |
|---------|---------|----------------|
| Ktor | HTTP client | Yes |
| kotlinx.serialization | JSON parsing | Yes |
| kotlinx.coroutines | Async/concurrency | Yes |
| SQLDelight | Local database | Yes |
| Koin | Dependency injection | Yes |
| Compose Multiplatform | Shared UI | Yes |
| kotlinx.datetime | Date/time | Yes |
| Napier | Logging | Yes |

---

## Networking with Ktor

```kotlin
// commonMain
class ApiClient(private val httpClient: HttpClient) {
    suspend fun getUsers(): List<User> {
        return httpClient.get("https://api.example.com/users").body()
    }

    suspend fun createUser(input: CreateUserInput): User {
        return httpClient.post("https://api.example.com/users") {
            contentType(ContentType.Application.Json)
            setBody(input)
        }.body()
    }
}

@Serializable
data class User(
    val id: String,
    val name: String,
    val email: String,
)
```

---

## Local Storage with SQLDelight

```sql
-- src/commonMain/sqldelight/com/example/UserQueries.sq
CREATE TABLE user (
    id TEXT NOT NULL PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT NOT NULL,
    cached_at INTEGER NOT NULL
);

selectAll:
SELECT * FROM user ORDER BY name;

insertOrReplace:
INSERT OR REPLACE INTO user (id, name, email, cached_at)
VALUES (?, ?, ?, ?);

deleteById:
DELETE FROM user WHERE id = ?;
```

---

## Compose Multiplatform UI

```kotlin
// commonMain - Shared composable
@Composable
fun UserListScreen(viewModel: UserListViewModel) {
    val users by viewModel.users.collectAsState()
    val isLoading by viewModel.isLoading.collectAsState()

    Scaffold(
        topBar = { TopAppBar(title = { Text("Users") }) }
    ) { padding ->
        if (isLoading) {
            CircularProgressIndicator(modifier = Modifier.padding(padding))
        } else {
            LazyColumn(modifier = Modifier.padding(padding)) {
                items(users) { user ->
                    UserRow(user = user, onClick = { viewModel.onUserClick(user.id) })
                }
            }
        }
    }
}
```

---

## iOS Integration

### Swift Interop

```swift
// iosApp - Using shared Kotlin code from Swift
import shared

class UserViewController: UIViewController {
    private let viewModel = UserListViewModel()

    override func viewDidLoad() {
        super.viewDidLoad()
        viewModel.users.collect(collector: FlowCollector { users in
            // Update UI with users
        })
    }
}
```

### CocoaPods or SPM Integration

```kotlin
// build.gradle.kts
kotlin {
    iosX64()
    iosArm64()
    iosSimulatorArm64()

    cocoapods {
        summary = "Shared module"
        homepage = "https://example.com"
        ios.deploymentTarget = "16.0"
        framework { baseName = "shared" }
    }
}
```

---

## Testing

```kotlin
// commonTest
class UserRepositoryTest {
    private val fakeApi = FakeApiClient()
    private val repository = UserRepository(fakeApi)

    @Test
    fun fetchUsersReturnsListFromApi() = runTest {
        fakeApi.setUsers(listOf(User("1", "Alice", "[email protected]")))

        val users = repository.getUsers()

        assertEquals(1, users.size)
        assertEquals("Alice", users.first().name)
    }
}
```

---

## Best Practices

- Share business logic (networking, storage, models) — keep platform UI native if needed
- Use `expect`/`actual` sparingly — prefer interfaces with platform implementations via DI
- Keep the shared module thin — avoid pulling in platform-heavy dependencies
- Test shared code in `commonTest` — it runs on all targets
- Use Compose Multiplatform for new projects where native look isn't critical

---

## Related Resources

- `~/.claude/skills/android-development/SKILL.md` - Android patterns
- `~/.claude/skills/ios-development/SKILL.md` - iOS patterns
- `agent-flutter-developer` skill - Alternative cross-platform

---

_Share logic, respect platforms. KMP gives you the best of both worlds._

© travisjneuman · MIT · travisjneuman/.claude

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

Все скиллы по теме «Мобильная разработка» →

Сначала — kotlin-multiplatform от других авторов.

kotlin-multiplatform vitorpamplona Скилл для работы с Kotlin Multiplatform и Gradle в репозитории Amethyst: подсказывает, в какой модуль положить код, и ловит сборку на типовых граблях. CX Codex +1 1 600установок compose-multiplatform-patterns affaan-m Скилл compose-multiplatform-patterns подсказывает паттерны Compose Multiplatform и Jetpack Compose для KMP-проектов: состояние, навигация, темы и UI под разные платформы. CX Codex +1 6 300установок kotlin-specialist VoltAgent Community Субагент kotlin-specialist для разработки на Kotlin 1.9+, Android и Ktor. Помогает проектировать корутины, настраивать общий код в Kotlin Multiplatform и следить за качеством через Detekt. CX Codex 501установок compose-multiplatform AThevon Скилл помогает писать кроссплатформенный интерфейс на Compose Multiplatform для Android, iOS, Desktop и Web. Пригодится при переносе общих компонентов в commonMain. CX Codex +1 961установок android-clean-architecture affaan-m Скилл android-clean-architecture подсказывает агенту, как раскладывать Android- и KMP-проект по слоям: модули, зависимости, UseCase, репозитории, работа с Room, SQLDelight и Ktor. CX Codex +1 7 200установок apollo-kotlin apollographql Скилл ведёт агента по настройке Apollo Kotlin в Gradle-проекте: схема, кодогенерация, ApolloClient с авторизацией и кэшем, запросы и подписки. CX Codex +1 1 900установок kotlin-tooling-cocoapods-spm-migration JetBrains Скилл kotlin-tooling-cocoapods-spm-migration для Claude Code переносит KMP-проект с CocoaPods на Swift Package Manager, меняя Gradle DSL, импорты Kotlin и настройки Xcode. Выполняет миграцию поэтапно. CX Codex +1 2 100установок

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

Весь набор →
ios-development Скилл ios-development для Claude Code помогает проектировать приложения под iOS, iPadOS, tvOS и watchOS на Swift. Включается при сборке экранов, настройке навигации и согласовании верстки с гайдлайнами Apple. CX Codex +1 186установок volunteer-coordinator Скилл volunteer-coordinator для Claude Code помогает проектировать программу волонтёров: роли, расписание, подбор по навыкам и коммуникации. Задача — запуск или перестройка такой программы. CX Codex +1 184установок recipe-card-creator Скилл recipe-card-creator оформляет рецепты, пересчитывает ингредиенты под число порций и помогает собрать меню, список покупок или коллекцию. CX Codex +1 183установок grant-proposal-builder Скилл grant-proposal-builder для Claude Code собирает заявки на гранты для некоммерческих и исследовательских проектов. Запускается при составлении заявок, обоснований бюджета и планов оценки. CX Codex +1 183установок process-flowchart-designer Скилл process-flowchart-designer превращает текстовые описания процессов в текстовые блок-схемы, дорожки swimlane, матрицы SIPOC и расчёты узких мест. CX Codex +1 183установок application-security Скилл application-security для Claude Code помогает защищать веб-приложения и разбирать их риски безопасности. Подключается при проверке кода, настройке защиты или поиске уязвимостей. CX Codex +1 181установок marketing Скилл marketing для Claude Code собирает фреймворки архитектуры бренда, позиционирования, исследований, сегментации, персон и метрик каналов для маркетингового анализа. CX Codex +1 181установок generic-fullstack-feature-developer Скилл generic-fullstack-feature-developer направляет разработку полностековых фич в связке Next.js App Router, NestJS и Prisma. Пригодится при проектировании новых модулей, добавлении эндпоинтов и миграций базы данных. CX Codex +1 180установок

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

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